Mit dem Python-Dokumenterstellungstool "Sphinx" können Sie zusätzlich zu HTML auch im PDF-Format ausgeben. Dieser Eintrag beschreibt das Verfahren zur Ausgabe im PDF-Format.
--Installation des Python3-Systems --Sphinx 1.5 oder höher muss installiert sein
Referenz (Sphinx-Wenn Sie die beim Ausführen des Schnellstarts gestellte Frage wie folgt beantworten, wird das Verzeichnis getrennt. )
#Englische Ausgabe
$ sphinx-quickstart
> Separate source and build directories (y/N) [n]:y
#japanische Version
$ sphinx-quickstart
>Trennen Sie das Quellverzeichnis und das Erstellungsverzeichnis (y/ n） [n]:y
$ python -V
Python 3.7.4
$ pip show sphinx
Name: Sphinx
Version: 2.4.4
(Danach wird es weggelassen)
$ brew --version
Homebrew 2.2.11
(Danach wird es weggelassen)
Sphinx kann reStructuredText im PDF-Format über ein Format namens TeX (genauer gesagt LaTeX) ausgeben.
Geben Sie den folgenden Befehl ein, um eine TeX-Umgebung unter macOS zu erstellen.
"Break cask install mactex-no-gui" nimmt viel Zeit in Anspruch. In meiner Umgebung hat es übrigens ungefähr 6 Stunden gedauert.
$ brew cask install mactex-no-gui
Das nächste "sudo tlmgr update --self --all" Abhängig von Ihrer Umgebung wird möglicherweise die Fehlermeldung "sudo tlmgr-Befehl nicht gefunden" angezeigt. Schließen Sie in diesem Fall das Terminal, öffnen Sie es erneut und geben Sie den Befehl ein.
Dieser Befehl braucht übrigens auch Zeit. In meiner Umgebung hat es ungefähr 2 Stunden gedauert.
$ sudo tlmgr update --self --all
Öffnen Sie conf.py im Verzeichnis "source", ändern / fügen Sie es wie folgt hinzu und speichern Sie es.
#Der Sprachteil'ja'Ändern
language = 'ja'
#Fügen Sie die folgende Zeile am Ende der Datei hinzu
latex_docclass = {'manual': 'jsbook'}
Wenn Sie den folgenden Befehl in dem Verzeichnis ausführen, in dem sich Makefile befindet, wird pdf in "build / latex" erstellt.
$ make latefpdf
Recommended Posts