Python 2.7 Fügen Sie Dash.app japanische Dokumentation hinzu

Ich habe hier auf die grundlegende Methode Bezug genommen. [Hinzufügen einer Sphinx-basierten Dokumentation zu Dash.app (japanische Dokumentation ist in Ordnung) - Programmierer März Kapitel 2](http://takuan-osho.hatenablog.com/entry/2013/02/20 / How-to-Add-Sphinx-basierte-Dokumentation-in-Dash-App)

Wie auf dieser Site erwähnt, konnte ich Klassen oder Module nicht einfach durch einfaches Konvertieren indizieren.

Im Folgenden finden Sie die Schritte für Mac OS X 10.9.2.

Schritt 1 Installieren Sie doc2dash

Da pip nicht enthalten ist, habe ich es mit easy_install installiert. Sie müssen Befehlszeilentools installieren. Wenn beim Erstellen des abhängigen Pakets lxml eine Fehlermeldung angezeigt wird,

sudo ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future easy_install doc2dash

Es war in Ordnung, wenn ich das Flag setzte und es ausführte. Wahrscheinlich das gleiche mit pip. Referenz: Fehler beim Installieren des Python-Moduls lxml auf osx mavericks --Stack Overflow

Schritt 2 Japanisches Dokument konvertieren

Laden Sie einen HTML-Satz von python-doc-ja - Python-Dokument Japanisches Übersetzungsprojekt - Google Project Hosting herunter und konvertieren Sie ihn mit doc2dash.

doc2dash -n Python2.7ja -i _static/py.png -I index.html -d pathto/output pathto/python-doc-2.7ja1-html

Als ich versuchte, dies Dash zuzuführen, wurde der Index doch nicht erstellt.

Schritt 3 Konvertieren Sie ein englisches Dokument und extrahieren Sie den Index

Also habe ich beschlossen, dieselbe Version des englischen Dokuments zu konvertieren und den Unterschied zu sehen. Laden Sie eine HTML-Datei aus Download - Python v2.7.6-Dokumentation herunter und konvertieren Sie sie mit doc2dash. Es dauerte länger als das japanische Dokument, und der Index wurde normal ausgefüllt. Im Docset war die Größe von "docSet.dsidx" deutlich unterschiedlich, daher habe ich sie in das japanische Docset kopiert. Dann bekam ich eine Liste von Klassen und Modulen und die Links funktionierten gut. Ich habe nicht alle Indizes validiert, daher kann es irgendwo inkonsistent sein.

Es ist möglicherweise möglich, aus dem echten Dash-Docset zu extrahieren, aber es scheint, dass sich die Konvertierungsmethode von doc2dash unterscheidet und der Indexdateityp unterschiedlich ist.

Ich denke, Sie können dasselbe mit der Python 3-Serie tun, aber ich habe es nicht ausprobiert, da es anscheinend keinen Ort gibt, an dem japanische Dokumente auf einmal heruntergeladen werden können.

Dash - Documentation Browser, Snippet Manager - Kapeli doc2dash 1.2.0 : Python Package Index

Nachtrag 2017-05-17: Python 3.6.1

Ich habe die Version 3.6.1 erstellt, indem ich das HTML der englischen Version von docset zwangsweise ersetzt habe. Sie können den vollständigen Index der englischen Version unverändert verwenden. Es ist ein etwas kompliziertes Skript, da Sie einen Anker in HTML einbetten müssen. https://gist.github.com/hetima/26f21023c417e68be1d4db2d1e388816