PIB

• Sphinx (ja)

• Sphinx Themes Gallery

• Sphinxの日本ユーザ会
• 渋川よしきのウェブサイト。 / 翻訳 Sphinxドキュメント / 0.6系
• Qiita / @pashango2(株式会社ゼロワン) / 2017-03-06: Sphinxを便利にして、みんなに使ってもらいたい
• Sphinxでウェブサイトを作ろう

sudo apt install ruby python3-pip texlive-extra-utils texlive-lang-japanese texlive-latex-extra latexmk librsvg2-bin
pip3 install sphinx sphinx-rtd-theme sphinxcontrib-imagesvg sphinxcontrib-svg2pdfconverter
gem install --user-install unicode-blocks
( mkdir -p ~/git; cd ~/git; git clone https://github.com/kou1okada/sphinx-BXcoloremoji )

• Sphinx Themes Gallery

の中だと、PC, Mobile 双方でバランスが良さそうなのは、Book, Sizzle なのだが、Book はページ内目次の動作やPCの3ペインレイアウトが微妙に見辛いく、Sizzle はなぜか

Theme error:
no theme named 'sphinx_sizzle_theme' found (missing theme.conf?)

と言われて動かん。
次点が Read the Docs (mobile で≡が流れる), Furo, Press, Karma、Python Documentation, Redactor(PC で見出し一覧が流れる), Awesome (PC でハンバーガーメニューが大き過ぎる), Murray (PC で≡が流れる, フォントが微妙)。
総合的にバランス良いのはやっぱり Read the Docs かな？

HTML は

• sphinxcontrib-imagesvg

LaTeX は

• sphinxcontrib-svg2pdfconverter

を入れておいて、conf.py の extensions に以下の設定を追加しておく。

extensions = [
    'sphinxcontrib.imagesvg',
    'sphinxcontrib.inkscapeconverter',
#    'sphinxcontrib.rsvgconverter',
#    'sphinxcontrib.cairosvgconverter',
]

SVG to PDF の変換は以下のパッケージが必要。

• inkscape
• librsvg2-bin
• cairosvg

入ってるパッケージ合わせて、上記の config を調整。
多分 rsvg が一番コンパクト。変換性能が高いのは Inkscape だろうか？