Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tianhao/alfred-mweb-workflow
搜索、打开MWeb 内部文档和外部 Markdown 文档
https://github.com/tianhao/alfred-mweb-workflow
alfred alfred-workflow markdown mweb quicksearch
Last synced: 12 days ago
JSON representation
搜索、打开MWeb 内部文档和外部 Markdown 文档
- Host: GitHub
- URL: https://github.com/tianhao/alfred-mweb-workflow
- Owner: tianhao
- License: mit
- Created: 2017-09-26T07:07:54.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-17T06:46:29.000Z (almost 2 years ago)
- Last Synced: 2024-08-02T03:11:59.853Z (3 months ago)
- Topics: alfred, alfred-workflow, markdown, mweb, quicksearch
- Language: Shell
- Homepage:
- Size: 45.8 MB
- Stars: 222
- Watchers: 8
- Forks: 16
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MWeb workflow
[下载](https://github.com/tianhao/alfred-mweb-workflow/raw/master/MWeb.alfredworkflow)
使用前请参照最后一节 "设置环境变量" 配置
**更新日志**
* [2022年12月03日] 增加新功能：手动git备份
* [2022年02月10日] 增加新功能：快速笔记
* [2021年10月06日] 增加新功能：自动格式化文章标题
* [2019年03月03日] 修复 [issue-13](https://github.com/tianhao/alfred-mweb-workflow/issues/13)
* [2018年11月29日] 修复 [issue-12](https://github.com/tianhao/alfred-mweb-workflow/issues/12)
* [2018年8月5日] 修复 [issue-11](https://github.com/tianhao/alfred-mweb-workflow/issues/11),将script内容移到shell文件，方便调整
* [2017年12月18日] 修复 [issue-5](https://github.com/tianhao/alfred-mweb-workflow/issues/5)
* [2017年11月25日] 修复 [issue-4](https://github.com/tianhao/alfred-mweb-workflow/issues/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]...
```
示例
```BASH
# 不输入任何参数，按最近修改时间排序文档
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
```
**功能说明**：
1. 如果不输入任何参数，会列出最近修改过的20个文档，按照最近修改时间安倒序排序，即使输入了参数过滤，也最多输出20条记录；
2. 目前支持3种可选过滤参数，tag参数(-t)、title参数和关键字参数，会根据参数过滤文档并做好排序,tag参数参考下面[tag选项]，title参数参考下面[title选项]；
3. 你可以输入多个关键字过滤，中间以空格隔开，workflow 会用查找包含所有关键的的文档，只有包含所有关键字的文档才会列出来，所以关键字越多越精确；
4. 选中对应行，回车，会用MWeb app打开该文档；
5. 关键字不区分大小写，输入"MWeb" 与 "mweb"效果相同。
**tag选项(-t)**:
1. 输入 `-t tag1[,tag2,...]` 触发workflow查找包含所有输入tag的文档，只有包含所有输入tag的文档才会显示；
2. tag之间以逗号","隔开，tag不区分大小写，逗号也不区分中英文；
3. 当输入-t 时，会触发展示可选的tag列表，选中需要的tag回车，workflow会将选中的tag加入选项中，并让你可以继续选择别的tag，如果你已经选好了需要的tag；
4. 如果你已经选好了需要的tag，再输入一个空格会关闭tag列表，并且展示过滤后的文档，这是敲回车会打开对应的文档。
**title选项(-h),由于-t用在了tag上，所以用-h(header)触发标题过滤**:
1. 使用 `-h keyword1[,keyword2,...]` 触发标题过滤；
2. 可以输入多个关键字，标题的关键字之间以","号隔开，关键字不区分大小写，逗号也不区分中英文；
3. 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功能
使用方法：
1. 按设置环境变量的方法设置 MBLOG_HOME 变量 MBLOG_URL变量(一次性)
2. 用MWeb生成生成网站
3. 使用mpush 一键推送到GitHub或者别的远程git地址
4. push完成之后会打开博客地址(用浏览器)
静态博客使用方法请参考 MWeb 官方文档，这里只是做了一键push操作
## 4. "mf" 自动格式化文章的标题前缀
自动格式化文章标题的前缀。
* 使用方法："mf + 空格 + 关键字" 搜索对应的文章，并选中
* 
* P.S. "mfd + 空格 + 关键字" 则是顶层标题的序号递减
* 注意事项：修改之前的文章备份在 `/tmp` 目录下。
* 使用效果：如下图所示。
* 文章1，格式化之前
* 
* 文章1，格式化之后
* 
* 文章2，格式化之前
* 
* 文章2，格式化之后
* 
## 5. "mn" 快速创建笔记
* 
* 
## 6. "mb" 手动git备份
### 6.1. 初始化设置
```shell
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`的快捷键，用户可以按照自己的需要设置快捷键
