La documentation de l'API JavaScript pour Apache Cordova.
La documentation est disponible à docs.cordova.io.
Toute la documentation Apache Cordova est écrit avec markdown, un langage de balisage léger qui peut être composé au format HTML. Markdown offre un moyen simple et flexible pour documenter le noyau de Cordova API et API spécifique à la plateforme.
docs/ docs/LANGUAGE docs/LANGUAGE/VERSION docs/LANGUAGE/VERSION/cordova/ docs/LANGUAGE/VERSION/guide/platforms/PLATFORMNAME/
Nous utilisons JIRA Apache
Par ailleurs, vous bercer ! Merci de nous aider à améliorer la documentation !
Vous êtes nouveau sur Git ou contribuer sur GitHub ?
Nous avons écrit quelques Git tutoriaux pour vous aider à commencer à contribuer à la documentation.
Requêtes d'extraction sont les bienvenus !
Nous apprécions l'utilisation des branches du sujet.
git checkout -b issue_23 # code git commit -m "Issue 23: Fix a bad bug." git push origin issue_23 # send pull request from branch issue_23 to cordova:master
Voulez-vous la documentation Apache Cordova, dans une autre langue ? Nous faisons aussi ! Avec le soutien de la plateforme de gestion de Crowdin, une traduction et de localisation, traducteurs peuvent vous connecter à l‘outillage facile à utiliser et fournissent autant ou aussi peu d’assistance traduction comme ils le voudraient. Si vous connaissez une autre langue s‘il vous plaît soutenir Cordova et contribuer. http://crowdin.net/project/cordova. Pour certaines meilleures pratiques pour utiliser l’outil Crowdin, veuillez consulter notre wiki http://wiki.apache.org/cordova/CordovaTranslations.
Administrateurs de langue de Cordova, n'oubliez pas les étapes suivantes :
1. config.json
Pour chaque langue et chaque version, il y a un config.json
qui définit le nom de la langue et comment fusionner les fichiers.
2. personnalisation de modèle HTML
Chaque langue peut remplacer le modèle par défaut dans le template/docs/LANGUAGE
.
S‘il vous plaît voir le fichier STYLESHEET.md
pour connaître les instructions sur l’utilisation et de la langue.
Ce moment documentation pouvait être exécutée à l'aide de Node.js sur GNU / Linux ou sous Windows.
$ rm -r tmp public # Clear out old docs $ ./bin/genjs # compile all docs $ ./bin/genjs en edge # compile English Edge docs $ ./bin/genjs ru edge # compile Russian Edge docs $ ./bin/genjs es 3.5.0 # compile Spanish 3.5.0 docs
Aller à Node.JS téléchargements de page
Téléchargez et installez le paquet pour votre système d'exploitation.
Commander ce référentiel à l'aide de Git
git clone https://github.com/apache/cordova-docs
Installer les dépendances. Dans la racine du dossier clonés cordova-docs exécuter
npm install
Maintenant vous en mesure de construire la documentation localement.
Lorsque vous effectuez des modifications mineures, il est généralement sans danger pour simplement rendre l'édité de Markdown au format HTML. De nombreux éditeurs de code ont plugins pour restituer Markdown en HTML et il ya une poignée de bons rédacteurs en ligne.
Actuellement, un script de Node.JS et joDoc-js sont utilisés pour générer la documentation HTML.
Il y a une tâche de Rake pour incrémenter la version, générer le répertoire de version et mettre à jour la documentation de bord.
# generate version 4.1.0 for english. .\bin\incrementversion en 4.1.0