workflow:
make
make serve
make watch
这是我的博客源码，用 Markdown 写，用 Makefile 管理，用 travis 自动生成 HTML 并
同步到七牛（具体看我的 .travis.yml）。
使用了 git（版本控制，文档历史信息提取）、make（管理输出）、 perl（文本处理、从 git 提取文档历史信息）、pandoc（文档转化）。
- 源码打包：https://github.com/district10/blog/archive/master.zip
- HTML 输出打包：https://coding.net/u/dvorak4tzx/p/dvorak4tzx/git/archive/coding-pages
如果你想自己从 markdown 生成 html，只需要简单几步。
Windows 操作系统：
- 下载安装 git for windows，地址：http://whudoc.qiniudn.com/Git-2.7.2-64-bit.exe （安装指南）
- perl 已经包含在 git for windows 里了，不过可能需要手工添加到 %PATH%，到文件夹下找找，看看 CMD 里
perl -v有没有反应 - 安装 make，下载地址：https://github.com/whudoc/statics/raw/master/winbin/make.exe，放到 PATH 里即可
- 安装 Pandoc，下载地址：http://doi-2014.qiniudn.com/pandoc/pandoc-1.17.0.2-windows.msi（20.4 MB）
- 获取源码，zip 压缩包地址：https://github.com/district10/blog/archive/master.zip
- 解压源码 zip 压缩包，进入文件夹下，右键打开 Git Bash，输入
make，publish 文件夹下就有了生成的 html 文件
Linux 操作系统（debian 系）：
- make 和 perl 系统应该已经自带
- 安装 git：
sudo apt-get install git - 安装 Pandoc，下载地址（官方源里那个太老）：http://doi-2014.qiniudn.com/pandoc/pandoc-1.17.0.2-1-amd64.deb（19.9 MB），
然后
sudo dkpg -i pandoc*.deb安装它 - 获取源码，zip 压缩包地址：https://github.com/district10/blog/archive/master.zip
- 解压源码 zip 压缩包，命令行进入文件夹，
make，publish 文件夹下就有了生成的 html 文件
$ java -jar watcher.jar- travis 的虚拟机下载国内的七牛云，速度居然有 40M/s！速度平均 20M/s+ 的样子。
- 但是如果装一个 texlive-full，下载 2G 多的文件，还是有点捉急……
- 所以啊，即便能够用 travis 帮我把所有 post 编译出 pdf 版本和 docx 版本，我也只弄过一次。
- 一个是我提供这样的连接，自己的七牛流量就要爆！二是，太不节能。
- 为了节能我现在已经把编译 md-> html 优化到只处理修改了的：见
filter.pl。 - 但后来我不怎么 filter 了，因为……反正是 travis 帮我编译……
- For Windows
- add gvim path to
%PATH% - set
%EDITOR%togvim, like Configure EDITOR - in your
.bashrcor.zshrc:export EDITOR="gvim -u ~/git/blog/vimrc.vim", be sure to use export echo "source /path/to/_vimrc/file" > ~/.vimrc（%HOME%on win:/c/Users/Administrator）
- add gvim path to
- For Linux
- set
$EDITORtogvim(vim file.txt &会出错，而我 Makefile 里都是$(EDITOR $< &)，所以小心罗。)
- set
- script to tranlate
vimrctoperlcode highlight, etc. - 把 notes.md 分成多个文本，比如 note{001..999}.md，然后分别生成 html（非 standalone），然后用 ajax 来 load 各个 html 片段， 这样的好处是可以依旧在一个文本里编辑（反正 vim 编辑 100M+ 的文本都是无压力的），但会自动转化为多个片段，加载起来更快。 唯一的不好的地方在于，可能会和图片延迟加载冲突。
Customized Markdown
- tags, indexes
- anchoring via `@`{.tzx-anchor #id}
- tagging/anchoring via `tag`{.tzx-tag}
- tagging/anchoring via <#>(@tag1 @tag2), <#id>(@tag1 @tag2)
- including other file via <#>(%filename option1=value1) => format: dl{[dd, dt[ ,->dt]]}
- checking
+ 首字母是中文标点
+ 但行长度过长
- links
+ [title](#section)
+ [word](%meaning,`[pronunciation]`,url)
「Koan | 吐槽」
发现自己在重复造轮子，而且造得不好！Pandoc 有 --filter 和 --file-scope 的概
念，正好对应我的 filter.pl 和 merger.pl，我……只能说英雄所见略同了…… 这些
Perl 脚本还在用，但计划以后用 Pandoc 的 filter。
「Refs | 参考文档」
- Pandoc - Scripting with pandoc
- Pandoc::Filter - process Pandoc abstract syntax tree - metacpan.org
- jgm/pandocfilters: A python module for writing pandoc filters, with a collection of examples
「New Plan | 新的计划」
- 不再用 Perl 的正则表达式转换 Markdown，而是用 Perl 或者 Haskell 直接修改 Pandoc 的 AST；
- CSS 也不再大的调整，有了图片的延迟加载，差不多就够用了。用上 jQuery 后感觉自己原来用纯 JavaScript 实在太累太愚蠢。可能用 Less 或者 Sass
- Dogfalo/materialize: Materialize, a CSS Framework based on Material Design
