https://github.com/qiwihui/docker-sphinx-cjk-pdf

https://github.com/qiwihui/docker-sphinx-cjk-pdf

Last synced: 6 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/qiwihui/docker-sphinx-cjk-pdf
• Owner: qiwihui
• Created: 2021-03-19T09:34:19.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2021-04-12T08:11:22.000Z (over 4 years ago)
• Last Synced: 2024-10-13T13:14:22.002Z (12 months ago)
• Language: Dockerfile
• Size: 6.84 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Sphinx 中文 PDF

该 Docker 镜像用于从 Sphinx 文档生成含有中文的 PDF。

## 用法

将文档根目录（Makefile所在的目录）挂载到 ``/sphinx`` 上，运行 ``make latexpdf`` 即可。

```

docker run -it --rm -v $PWD:/sphinx init2/sphinx-cjk-pdf make latexpdf

```

镜像中的命令会以 `Makefile` 的用户ID的身份来运行，而不是以root或其他帐号运行，

因此生成的 `/build/` 目录中的文件都将拥有正确的属主。

如果执行 `docker run` 时不添加命令，那么会默认运行 `make latexpdf` ，

如果指定了命令，则会执行相应的命令。

``conf.py`` 中相关的配置：

```

latex_engine = 'xelatex'

latex_elements = {

    'papersize': 'a4paper',

    'utf8extra': '',

    'inputenc': '',

    'babel': '',

    'preamble': r'''

    \usepackage{xeCJK}

    \usepackage{indentfirst}

    \setlength{\parindent}{2em}

    # 镜像中只安装了 Noto Sans CJK 字体（https://www.google.com/get/noto/help/cjk/）

    # 如果需要其他字体，可以基于本镜像自行安装其他字体

    \setCJKmainfont{Noto Sans CJK SC}

    \setCJKmonofont{Noto Sans Mono CJK SC}

    \XeTeXlinebreaklocale "zh"

    \XeTeXlinebreakskip = 0pt plus 1pt

    ''',

}

```