将重构文本生成为HTML、PDF和文本
fx-doc的Python项目详细描述
外汇单据
从structuredtext构建html、pdf。
安装
$ pip install fx-doc
使用
将structuredText编译为文档文件
$ fx-doc build SRC DEST [OPTIONS]
src:目录包含structuredText源文件。
dest:目录包含生成文件。
选项:
- --dist:编译和优化,平均分布。
- --没有pdf:不要生成pdf文件。
- --没有html:不要生成html文件。
- --没有文本:不要生成文本文件。
- --强制:编译时不使用缓存文件。
服务器在http上生成文件
$ fx-doc serve DEST [OPTIONS]
dest:目录包含已编译的文件。它是
fx-doc build
的目的地 命令。选项:
- --端口:要侦听的端口,默认值为8080
开发
安装以下包装:
$ apt-get install python
$ apt-get install texlive-full # required for PDF building
$ sudo pip install virtualenv
$ ./env init
$ . ./venv/bin/activate
$ ./env install
$ fx-doc build doc dest
$ fx-doc serve dest
注意:对于mac,我们可以使用mactex[1]而不是texlive-full
。
分发
创建文件“~/”
$ ./push-pip.sh
链接
[1]https://www.tug.org/mactex/mactex-download.html