gnome-doc-utils

paquets gnome-doc-utils contient une collection d'utilitaires de documentation pour le projet Gnome. Notamment, il contient des outils pour la construction de la documentation et tous les fichiers auxiliaires dans votre arborescence des sources, et il contient les feuilles de style XSLT DocBook qui étaient autrefois distribués avec Yelp. À partir de GNOME 2.8, Yelp exigera gnome-doc-utils pour le XSLT. Essai
de
ORGANISATION /
Le répertoire de test contient un certain nombre de tests pour gnome -doc-utils. Répertoires de la forme testdocn, où n est un entier positif, sont des arbres de source squelette contenant la documentation, avec la même disposition qui serait utilisé par des projets réels. Le répertoire contient les testdocs tests unitaires de docbook-testdocs, développés par Norm and Co. pour les pan-galactiques feuilles de style DocBook. Un fichier README supplémentaire est dans ce répertoire, donnant des instructions sur l'extension ou la modification de l'un des fichiers dans gnome-doc-utils CVS.
Doc /
Le répertoire doc contient la documentation pour gnome-doc -utils. Dans la plupart des cas, gnome-doc-utils est nécessaire pour construire sa documentation. Des mécanismes sont en place pour l'amorçage.
Xslt /
Le répertoire xslt contient toutes les XSLT dans gnome-doc-utils. Notamment, le répertoire xslt / docbook contient le DocBook XSLT et xslt / gettext contient l'utilitaire XSLT gettext pour la traduction de texte automatique.
Bac à sable /
Le répertoire sandbox ne est pas DistEd, est ne apparaissent que si vous avez le CVS. Ce est un terrain de jeu pour de nouvelles idées.
Xml2po /
Le répertoire xml2po contient l'outil de xml2po développé par Danilo Segan pour la traduction de formats XML arbitraires. Il est utilisé par gnome-doc-utils pour la traduction DocBook.
ESSAI
Sous le répertoire de test sont un certain nombre de tests pour gnome-doc-utils. Pour tester le système de construction (gnome-doc-utils.m4 et gnome-doc-utils.make), vous pouvez utiliser l'un des testdocn (pour na entier positif) répertoires. Ceux-ci sont mis en place les arbres comme source de skeleton, de se comporter exactement comme le ferait un véritable projet. Aussi, gnome-doc-utils lui-même utilise pour construire sa propre documentation (sous doc), afin gnome-doc-utils lui-même est un test des outils de construction.
Pour tester les feuilles de style DocBook, utilisez le test / répertoire testdocs. Ces tests unitaires sont de l'emballage docbook-testdocs sur docbook.sourceforge.net, développé par Norm and Co. Il suffit de taper faire dans ce répertoire va construire chaque test. Si le nom du fichier de test est foo.001.xml, la sortie sera html / foo.001 / foo.001.html. Chaque test teste généralement un petit nombre d'éléments liés DocBook. La plupart des fonctions de DocBook ou de le XSLT dans gnome-doc-utils pourrait ne pas être testés par ces derniers. Des tests supplémentaires peuvent être ajoutés; suivez les instructions de test / testdocs / README pour cela.
également utile pour tester le XSLT est de transformer certains documents volumineux utilisent. Le Gnome Guide de l'utilisateur et le Manuel Gnumeric deux sont d'excellents documents de test.
PIRATAGE
Contrairement à la plupart des programmes C, en travaillant sur une grande partie de gnome-doc-utils vraiment ne implique isolé des améliorations progressives. Il n'y a pas moyen de donner une courte liste de grands traits dans une liste des choses à faire.
À travailler sur les outils de construction (gnome-doc-utils.m4 et gnome-doc-utils.make), construire la docs d'essai et voir ce qui ne fonctionne pas. gnome-doc-utils.make a une liste de toutes les cibles de haut niveau qui méritent d'être soutenus.
à travailler sur les DocBook XSLT, trouver un élément qui ne est pas encore mise en œuvre et l'appliquer . Si vous avez XML Starlet (xmlstar.sourceforge.net) installé, vous pouvez taper «faire report.html 'dans le xslt / répertoire docbook / html pour obtenir
un rapport HTML bien sur quels éléments sont mis en œuvre. Il ya aussi un fichier TODO dans ce répertoire avec une liste très succincte de matches qui doivent être fait qui ne peut être pris par report.html.
Notez que le XSLT est documenté en ligne avec xsldoc, qui est elle-même une partie de gnome-doc-utils. Ne hésitez pas à travailler sur xsldoc ainsi. La documentation générée par xsldoc est inclus dans le manuel sous doc / xslt

Quoi de neuf dans cette version:.

• fixe problèmes avec dist et installer avec trop de fichiers
• Mise à jour des traductions:
• km (Morn Met)

Quoi de neuf dans la version 0.20.9:

• ajouter temporairement RNG fichiers de retour pour la compatibilité. Maintenant que les fichiers de RNG ne sont plus appelés (à partir de 0.20.8), les fichiers de RNG seront supprimés après une période de transition.

Ce qui est nouveau dans la version 0.20.6:

• Mise à jour du schéma Mallard
• fixe »font pot 'règle pour Mallard
• Mise à jour des traductions:
• ca (Jordi Serratosa)
• es (Jorge González, Daniel Mustieles)
• ug (Abduxukur Abdurixit)

Ce qui est nouveau dans la version 0.20.5:

• Mise à jour des fichiers Mallard RNG
• Mise à jour des traductions:
• que (Amitakhya Phukan)
• bn_IN (Runa Bhattacharjee)
• eo (Kristjan SCHMIDT)
• es (Jorge Gonzalez)
• gu (Sweta Kothari)
• ou (Manoj Kumar Giri)

Qu'est-ce que de nouveaux dans la version 0.20.3:

• substitution de commande fixe imbriquée dans gnome-doc-utils .make (Chris Coleman)
• Mise à jour des traductions:
• ca @ valencia (Carles Ferrando)
• de (Christian Kirbach)
• de (Mario Blattermann)
• el (Michael Kotsarinis)
• es (Jorge Gonzalez)
• et (Ivar Smolin)
• fa (Mahyar Moghimi)
• fr (Bruno Brouard)
• gl (Fran Dieguez)
• sl (Matej Urbancic)
• ug (Gheyret T.Kenji)

Ce qui est nouveau dans la version 0.20.2:

• Mise à jour des traductions:
• de (Mario Blattermann)
• fr @ shaw (Thomas Thurman)
• es (Jorge Gonzalez)
• fr (Geode)
• gl (Fran Dieguez)
• il (Yaron Shahrabani)
• hu (Gabor Kelemen)
• id (Dirgita)
• ja (Takayuki KUSANO)
• lv (Rudols Mazurs)
• sl (Andrej Znidarsic)
• zh_CH (Aron Xu)