- Created by tianhao
- 🗓 Last Updated: 17/12/22 06:46:29
- 🌟 Stars on GitHub: 221
- Please consider supporting the creator by Starring or Sponsoring them on GitHub!
- Get Workflow
- Get Latest Release
- Get Source Code
From their README
MWeb workflow
使用前请参照最后一节 "设置环境变量" 配置
更新日志
- [2022年12月03日] 增加新功能:手动git备份
- [2022年02月10日] 增加新功能:快速笔记
- [2021年10月06日] 增加新功能:自动格式化文章标题
- [2019年03月03日] 修复 issue-13
- [2018年11月29日] 修复 issue-12
- [2018年8月5日] 修复 issue-11,将script内容移到shell文件,方便调整
- [2017年12月18日] 修复 issue-5
- [2017年11月25日] 修复 issue-4; 提升速度
- [2017年11月20日] 添加外部文档库搜索
1. 搜索&打开内部文档
使用方法: 用户可以使用关键字 "mo" 或者自定义快捷键触发 workflow
mo [-t tag1,tag2...] [-h keyword1,keyword2,...] [keyword1] [keyword2]...
hotkey-> [-t tag1,tag2...] [-h keyword1,keyword2,...] [keyword1] [keyword2]...
示例
# 不输入任何参数,按最近修改时间排序文档
mo
# 查找有 alfred 关键字的文档
mo alfred
# 查找有 alfred 和 workflow 两个关键字的文档
mo alfred workflow
# 查找tag含有 TODO 的文档,tag不区分大小写
mo -t TODO
# 查找tag同时包含 TODO 和 DONE 的文档, tag之间以,隔开(中文逗号,也可以),但tag名称不能有空格
mo -t TODO,DONE
# 查找 tag含有 TODO, 且有alfred 和 workflow 两个关键字的文档
mo -t TODO alfred workflow
# 与上面输入等效
mo alfred workflow -t TODO
# 查找标题包含关键字 alfred 和 workflow 的文档
mo -h alfred,workflow
# 查找标题包含关键字 alfred 和 workflow,且文档包含 mweb 关键字的文档
mo -h alfred,workflow mweb
功能说明:
- 如果不输入任何参数,会列出最近修改过的20个文档,按照最近修改时间安倒序排序,即使输入了参数过滤,也最多输出20条记录;
- 目前支持3种可选过滤参数,tag参数(-t)、title参数和关键字参数,会根据参数过滤文档并做好排序,tag参数参考下面[tag选项],title参数参考下面[title选项];
- 你可以输入多个关键字过滤,中间以空格隔开,workflow 会用查找包含所有关键的的文档,只有包含所有关键字的文档才会列出来,所以关键字越多越精确;
- 选中对应行,回车,会用MWeb app打开该文档;
- 关键字不区分大小写,输入"MWeb" 与 "mweb"效果相同。
tag选项(-t):
- 输入
-t tag1[,tag2,...]
触发workflow查找包含所有输入tag的文档,只有包含所有输入tag的文档才会显示; - tag之间以逗号","隔开,tag不区分大小写,逗号也不区分中英文;
- 当输入-t 时,会触发展示可选的tag列表,选中需要的tag回车,workflow会将选中的tag加入选项中,并让你可以继续选择别的tag,如果你已经选好了需要的tag;
- 如果你已经选好了需要的tag,再输入一个空格会关闭tag列表,并且展示过滤后的文档,这是敲回车会打开对应的文档。
title选项(-h),由于-t用在了tag上,所以用-h(header)触发标题过滤:
- 使用
-h keyword1[,keyword2,...]
触发标题过滤; - 可以输入多个关键字,标题的关键字之间以","号隔开,关键字不区分大小写,逗号也不区分中英文;
- title过滤会过滤第一行包含所有标题关键字的文档,与其它选项组合使用
不带关键字,列出前20个最近改过的文档
一个关键字
多个关键字
tag列表: -t
触发 tag 选项
tag列表:输入一个tag后,输入下一个tag前会将上一个从列表剔除
tag输入完成再输入一个空格,会展示tag过滤结果
tag(todo) 和 关键字(pg_) 组合过滤文档
2. 搜索&打开外部文档
如果你喜欢使用外部文档,甚至有多个外部文档库,那么这个外部文档库搜索就很重要,它能搜索多个文档目录将最佳匹配且最近更新文档列出来,然后使用你指定的Markdown app(默认是MWeb)打开。
配置
- MARKDOWN_PATH 变量,可以配置多个路径,路径之间以
:
隔开,例如:${HOME}/working:${HOME}/blog:${HOME}/fun
- MARKDOWN_APP 变量,默认是
/Applications/MWeb.app
,你可以设置为其它App。
使用
moe [-h keyword1,keyword2,...] [keyword1 keyword2]
- 使用方法跟打开内部文档一样,只是触发关键字改成了moe, 另外没有 tag 过滤功能(-t),因为外部文档没有tag。
- 由于每次搜索都会查找路径下所有的 .md 文件,所以目录结构太深或无关文件太多的目录会影响速度(例如复杂项目的源代码目录),建议集中管理你的文档,以提高搜索效率。
效果图:
3. "mpush" (提交生成的静态博客到远端Git(Hub)
我用的是GitHub做静态博客,在用MWeb生成网站之后,需要做 git add ...; git commit ;git push
等一序列操作才能把最新文章推送到GitHub,博客才更新,所以做了一个一键push功能
使用方法:
- 按设置环境变量的方法设置 MBLOG_HOME 变量 MBLOG_URL变量(一次性)
- 用MWeb生成生成网站
- 使用mpush 一键推送到GitHub或者别的远程git地址
- push完成之后会打开博客地址(用浏览器)
静态博客使用方法请参考 MWeb 官方文档,这里只是做了一键push操作
4. "mf" 自动格式化文章的标题前缀
自动格式化文章标题的前缀。
- 使用方法:"mf + 空格 + 关键字" 搜索对应的文章,并选中
- P.S. "mfd + 空格 + 关键字" 则是顶层标题的序号递减
- 注意事项:修改之前的文章备份在
/tmp
目录下。 - 使用效果:如下图所示。
- 文章1,格式化之前
- 文章1,格式化之后
- 文章2,格式化之前
- 文章2,格式化之后
5. "mn" 快速创建笔记
6. "mb" 手动git备份
6.1. 初始化设置
cd ~/Library/Containers/com.coderforart.MWeb3/Data/Library/Application Support/MWebLibrary
echo 'mainlib.db' >> .gitignore
echo '/docs/media' >> .gitignore
echo '/metadata' >> .gitignore
git init
git checkout -b main
git add .
git commit -m "first commit"
git remote add origin 【你申请的git仓库地址】
git push -u origin main
6.2. 使用
设置环境变量(必须设置)
1.打开MWeb workflow 的环境变量设置页面
2.打开MWeb偏好设置,复制对应路径到workflow变量中
MWeb 2内部文档的配置
- 默认文档位置:
${HOME}/Library/Containers/com.coderforart.MWeb/Data/Documents/mainlib/
- iCloud 文档位置:
${HOME}/Library/Mobile Documents/iCloud~com~coderforart~iOS~MWeb/Documents/mweb_documents_library/
- 静态博客保存位置
${HOME}/Library/Containers/com.coderforart.MWeb/Data/Documents/themes/Site/
MWeb 3内部配置
- 默认文档位置:
${HOME}/Library/Containers/com.coderforart.MWeb3/Data/Documents/mainlib/
- iCloud 文档位置:
${HOME}/Library/Mobile Documents/iCloud~com~coderforart~iOS~MWeb/Documents/mweb_documents_library/
- 静态博客保存位置
${HOME}/Library/Containers/com.coderforart.MWeb3/Data/Documents/themes/Site/
MWeb 4内部配置
- 默认文档位置:
${HOME}/Library/Containers/com.coderforart.MWeb3/Data/Documents/mainlib/
- iCloud 文档位置:
~/Library/Containers/com.coderforart.MWeb3/Data/Library/Application Support/MWebLibrary
- 静态博客保存位置
${HOME}/Library/Containers/com.coderforart.MWeb3/Data/Documents/themes/Site/
外部文档配置
- MARKDOWN_PATH 变量,外部文档搜索路径,可以配置多个路径,路径之间以
:
隔开,例如:${HOME}/working:${HOME}/blog:${HOME}/fun
- MARKDOWN_APP 变量,打开外部文档的App,默认是
/Applications/MWeb.app
,你可以设置为其它App,设置后会用该App打开外部文档。
静态博客配置(可选)
- MBLOG_HOME 填静态博客生成目录;
- MBLOG_URL 填上的你Blog地址(如果使用了MWeb的静态博客功能);
3.设置快捷键(可选)
workflow 默认没有设置mo
、moe
和mpush
的快捷键,用户可以按照自己的需要设置快捷键