diff options
-rw-r--r-- | BUILD.md | 45 | ||||
-rw-r--r-- | pdf/template.tex | 4 |
2 files changed, 47 insertions, 2 deletions
diff --git a/BUILD.md b/BUILD.md new file mode 100644 index 0000000..95d1ef3 --- /dev/null +++ b/BUILD.md @@ -0,0 +1,45 @@ +# 如何构建《自由软件,自由社会》 + +这里给出如何在自己的机器上构建此书的简单介绍。因作者经验有限,此文仅列出 GNU/Linux 发行版下的构建,欢迎各位增补。 + +## 在线 HTML 整站 + +这里使用的是`mkdocs`工具。直接使用 + +``` +sudo pip3 install mkdocs +``` + +安装即可,如果使用 Python 2.7,只需要替换成`pip`命令。 + +`mkdocs build --clean` + +运行以上命令会在当前目录下生成`site`目录,里面就是生成的 HTML 文档了。 + +## 单个 HTML 页面 + +使用的是 Pandoc 工具。可以在 GNU/Linux 发行版的包管理器搜索并安装`pandoc`和`pandoc-citeproc`即可(Fedora 还需要安装`pandoc-pdf`)。 + +然后运行`make html`即可,此命令会调用 mkdocs 和 pandoc 来生成 HTML 整站和单页 HTML。 + +## EPUB 文件 + +如上文安装好 pandoc 之后,直接运行`make epub`即可,会在当前目录下生成`fsfs-zh.epub`文件。 + +如何在 Amazon Swindle(RMS 对 Kindle 的蔑称)上阅读?通过包管理器安装 Calibre 这款软件(此软件亦支持 M$ Windows 和 macO$ 系统),然后将 epub 文件生成 mobi 文件导入阅读器即可。我们并不推荐在 Swindle 上阅读此书,但兼容 Swindle 格式可以让你看完此书后抛弃这个产品。 + +## PDF 文件 + +这里使用了 texlive 2015 工具集,越新越好。Debian Stretch 和 Ubuntu 16.04/16.10 可直接运行`install.latex.ubuntu.sh`脚本安装所有需要的包。Fedora 24 可以运行如下命令: + +`sudo dnf -y install @"Authoring and Publishing" pandoc pandoc-pdf pandoc-citeproc texlive-textpos texlive-tocbibind texlive-framed texlive-appendix texlive-tabulary texlive-fandol google-noto-cjk-fonts texlive-bigfoot` + +以便安装必须的包。除 Fedora 24 以外均需要安装 Fandol 系列字体,可以运行`install.fandol.sh`脚本安装。 + +安装好后执行`make pdf`即可,会在当前目录下生成`fsfs-zh.pdf`文件。 + +## 在M$ Windows 和 macO$ 上构建 + +[TODO] + + diff --git a/pdf/template.tex b/pdf/template.tex index f119676..2c508a8 100644 --- a/pdf/template.tex +++ b/pdf/template.tex @@ -106,8 +106,8 @@ framexleftmargin=20pt \setCJKsansfont{Noto Sans CJK SC} %\setCJKsansfont{WenQuanYi Micro Hei} -\setCJKmonofont{WenQuanYi Micro Hei Mono} -%\setCJKmonofont{Noto Sans Mono CJK SC} % uncomment for release build +%\setCJKmonofont{WenQuanYi Micro Hei Mono} +\setCJKmonofont{Noto Sans Mono CJK SC} % uncomment for release build %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % 使用 DejaVu Sans 显示 ⚠ ☢ ☠ ✔ 这四个 dingbats 字符 |