Python 2.7 Ajout de la documentation japonaise à Dash.app

Je me suis référé ici pour la méthode de base. [Comment ajouter une documentation basée sur Sphinx à Dash.app (la documentation japonaise est OK) --Programmer March Chapter 2](http://takuan-osho.hatenablog.com/entry/2013/02/20 / comment-ajouter-une-documentation-dans-une-application-basée sur sphinx)

Donc, comme mentionné sur ce site, je ne pouvais pas indexer des classes ou des modules simplement en convertissant.

Voici les étapes pour Mac OS X 10.9.2.

Étape 1 Installez doc2dash

Comme pip n'est pas inclus, je l'ai installé avec easy_install. Vous devez installer les outils de ligne de commande. Si vous obtenez une erreur lors de la construction du package dépendant lxml,

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

Ce n'était pas grave si je réglais le drapeau et l'exécutais. Probablement la même chose avec pip. Référence: Erreur lors de l'installation du module python lxml sur osx mavericks --Stack Overflow

Étape 2 Convertissez un document japonais

Téléchargez un ensemble de fichiers HTML à partir de python-doc-ja - Projet de traduction japonaise de document Python - Hébergement de projet Google et convertissez-le avec doc2dash.

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

Quand j'ai essayé de fournir ceci à Dash, l'index n'a pas été créé après tout.

Étape 3 Convertissez le document anglais et extrayez l'index

J'ai donc décidé de convertir la même version du document anglais et de voir la différence. Téléchargez un ensemble de html depuis Téléchargement - Documentation Python v2.7.6 et convertissez-le avec doc2dash. Cela prenait plus de temps que le document japonais, et l'index était terminé normalement. En regardant à l'intérieur du docset, la taille de docSet.dsidx était clairement différente, donc je l'ai copié dans le docset japonais. Ensuite, j'ai eu une liste de classes et de modules et les liens fonctionnaient bien. Je n'ai pas validé tous les index, donc cela peut être incohérent quelque part.

Il peut être possible d'extraire du véritable docset Dash, mais il semble que la méthode de conversion soit différente de doc2dash et le type de fichier d'index est différent.

Je pense que vous pouvez faire la même chose avec la série Python 3, mais je ne l'ai pas essayé car il ne semble y avoir aucun endroit pour télécharger des documents japonais en même temps.

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

Addendum 2017-05-17: Python 3.6.1

J'ai fait la version 3.6.1 en remplaçant de force le html de la version anglaise de docset. Vous pouvez utiliser l'index complet de la version anglaise tel quel. C'est un script un peu compliqué car vous devez intégrer une ancre en html. https://gist.github.com/hetima/26f21023c417e68be1d4db2d1e388816