《跟我一起写Makefile》是陈皓发表在其CSDN博客上的系列文章,一直受到读者的推荐,是很多人学习Makefile的首选文档。目前网络上流传的PDF版本多为祝冬华整理的版本。这个版本的排版一般,代码部分没有做任何语法高亮。

2010年初学Makefile的时候,读了前几章皮毛,一直用到了现在。最近想着重新学习一下Makefile,顺便学习一下Sphinx,重新制作一个更精美的PDF版本。

• 书的文字部分来自于 Andriki 提供的Mediawiki源码;
• 使用 Sphinx 制作文档
• 项目主页: https://github.com/seisman/how-to-write-makefile
• 网页在线版: http://seisman.github.io/how-to-write-makefile/
• PDF下载: https://github.com/seisman/how-to-write-makefile/raw/pdf/Makefile.pdf

1. Clone项目到本地:

   $ git clone https://github.com/seisman/how-to-write-makefile.git
   

2. 安装依赖:

   $ pip install -r requirements.txt
   

3. 编译生成HTML:

   $ make html
   $ firefox build/html/index.html&
   

4. 编译生成PDF(要求安装TeXLive 2015):

   $ make xelatexpdf
   $ evince build/latex/Makefile.pdf&
   

sphinx和readthedocs网站默认是不支持中文的,因为对 conf.py 和 Makefile 做了些许修改。详情参考 sphinx生成中文PDF 或 Commit 35288db