49 lines
1.8 KiB
ReStructuredText
49 lines
1.8 KiB
ReStructuredText
跟我一起写Makefile (PDF重制版)
|
||
##############################
|
||
|
||
简介
|
||
----
|
||
|
||
《跟我一起写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中文支持
|
||
--------------
|
||
|
||
sphinx和readthedocs网站默认是不支持中文的，因为对 ``conf.py`` 和 ``Makefile`` 做了些许修改。详情参考 `sphinx生成中文PDF <http://seisman.info/chinese-support-for-sphinx.html>`_ 或 `Commit 35288db <https://github.com/seisman/how-to-write-makefile/commit/35288dbcd859abf5107dd6900dca25f0d1b44db7>`_
|
||
|
||
.. _`陈皓`: http://coolshell.cn/haoel
|
||
.. _`Andriki`: http://andriki.com/mediawiki/index.php?title=Linux:%E8%B7%9F%E6%88%91%E4%B8%80%E8%B5%B7%E5%86%99Makefile
|
||
.. _`Sphinx`: http://sphinx-doc.org/
|