| ||
1 安装
sphinx 官方安装说明: http://www.sphinx-doc.org/en/master/usage/installation.html
readthedoc 官方说明: https://docs.readthedocs.io/en/stable/intro/getting-started-with-sphinx.html
总的来说步骤如下:
• 安装 python3
• 通过 python3 安装 sphinx 包
python3 -m pip install sphinx
# 国内用户推荐使用清华源安装,使用-i 指定源
python3 -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple sphinx
2 测试
sphinx-quickstart
生成中文文档时:中文代码: zh_CN
# 在文档的 makefile 目录下执行
make html
3 安装LeX Live
下载的TeXlive是最新版的,下载地址:清华Texlive镜像。安装程序为texlive-xxxx.iso。
打开cmd,分别输入tex -v, latex -v, xelatex -v, pdflatex - v 出现版本号证明安装成功!
4 测试
make latexpdf