Erstellen unter macOS¶
Umwandlung der RST-Dateien in wohlformatierte HTML-Seiten.
Öffnen Sie ein Terminal zum Ordner ~/blender_docs` und führen Sie einfach aus:
make
Dies ist der Befehl, den Sie beim Erzeugen der docs immer benutzen werden. Beim ersten Mal (oder nach jeder größeren Änderung) kann der Erstellvorgang mehrere Minuten dauern, aber beim nächsten Mal sollte er nur ein paar Sekunden benötigen.
Das lokale Handbuch betrachten¶
Sobald die Dokumente erstellt wurden, können alle HTML-Dateien in C:\blender_docs\build\html gefunden werden. Versuchen Sie die \build\html\contents.html in Ihrem Web-Browser zu öffnen und lesen Sie das Handbuch:
open build/html/index.html
Nun da Sie in der Lage sind, das Handbuch zu erstellen, folgt im nächsten Abschnitt eine optionale Expresserstellung.
Ein einzelnes Kapitel erstellen¶
Falls Sie an einem spezifischen Kapitel des Handbuches arbeiten, können Sie es mit folgendem Befehl schnell erstellen:
make <chapter name>
Als Beispiel: Um nur die Dokumentation für die Modifier zu erstellen, benutzen Sie make modifiers. Sie können diesen „Quick-Build“ dann unter build/html/contents_quicky.html betrachten.
Dies wird die Erstellung sehr beschleunigen, doch es bedeutet auch, dass Ihre nächste, vollständige Erstellung aller Kapitel langsam sein wird.
Weiter mit dem nächsten Schritt: Bearbeiten.