《跟我一起写Makefile》是陈皓发表在其CSDN博客上的系列文章,一直受到读者的推荐,是很多人学习Makefile的首选文档。目前网络上流传的PDF版本多为祝冬华整理的版本。这个版本的排版一般,代码部分没有做任何语法高亮。
2010年初学Makefile的时候,读了前几章皮毛,一直用到了现在。最近想着重新学习一下Makefile,顺便学习一下Sphinx,重新制作一个更精美的PDF版本。
- 书的文字部分来自于 Andriki 提供的Mediawiki源码;
- 使用 Sphinx 制作文档
- 项目主页:https://github.com/seisman/how-to-write-makefile
- 网页在线版:http://htwm.readthedocs.org/zh_CN/latest/
- PDF下载:http://readthedocs.org/projects/htwm/downloads/pdf/latest/
Clone项目到本地:
$ git clone https://github.com/seisman/how-to-write-makefile.git
安装依赖:
$ pip install sphinx sphinx_rtd_theme pygments
编译生成HTML:
$ make html $ firefox build/html/index.html&
编译生成PDF(要求安装TeXLive 2015):
$ make xelatexpdf $ evince build/latex/Makefile.pdf&
sphinx和readthedocs网站默认是不支持中文的,因为对 conf.py
和 Makefile
做了些许修改。详情参考 sphinx生成中文PDF 或 Commit 35288db