Schéma XML - DocBook XML en détail

Être capable d'écrire un document puis de le créer dans différents formats de sortie a été le rêve de nombreuses équipes de développement au fil des années. Ceci peut être réalisé grâce à DocBook XML, qui non seulement maintient le balisage sémantique, mais maintient également le contrôle sur le formatage et la sortie des données. La sémantique de contrôle peut spécifier les chapitres et les paragraphes qui composent le document. Les éléments inclus peuvent être spécifiés plus en détail dans le paragraphe. Par exemple, être capable d’écrire un document puis de le créer dans de nombreux formats de sortie différents est le rêve de nombreuses équipes de développement depuis de nombreuses années. Ceci peut être réalisé grâce à DocBook
XML, qui non seulement maintient le balisage sémantique, mais maintient également le contrôle sur le formatage et la sortie des données. La sémantique du contrôle peut préciser les chapitres et paragraphes qui composent le document. Les éléments inclus peuvent être spécifiés plus en détail dans le paragraphe. Par exemple, vous pouvez placer les noms de commande et de
fonction dans des balises distinctes, comme indiqué dans le listing 8.
Listing 8. Enveloppement des commandes et des fonctions dans des balises séparées ​                                                                                                                                                                                                                                                                        

<para>The <command>compile</command> takes the source code of the 

material and builds a new class based on the filename. For example, if the filename is

<filename>HelloWorld</filename> then the name of the class generated will be

<classname>HelloWorld</classname>.

Lors de l'affichage de différents éléments, vous pouvez choisir différents styles et formats de sortie, ou vous pouvez choisir le même style. Plus important encore, étant donné que des informations sémantiques sont renvoyées (par exemple, le document peut contenir une

référence à un nom de classe), elles peuvent être utilisées pour générer une liste lors de l'écriture de l'index Contient tout noms de classes détaillés dans la documentation). En plus du balisage sémantique, les sections et différentes parties d'un document peuvent être marquées avec des identifiants spéciaux, et ces identifiants peuvent être utilisés pour créer des liens entre différentes parties du document. Certains types peuvent être
auto-complétés (chapitres, sections et autres types qui génèrent une table des matières), d'autres doivent établir explicitement des liens vers d'autres sections. Ces liens peuvent être automatiquement convertis au format approprié une fois convertis au format cible. Par exemple, le lien sera converti vers la page HTML appropriée ou vers une ancre dans la page. Si vous générez un PDF, vous pouvez inclure le numéro de page du chapitre cible.
Cette conversion est effectuée par la feuille de style
XSLT. Les feuilles de style DocBook XSLT standard existantes prennent en charge la conversion vers les pages HTML, XHTML, PDF (via la norme FO), Texinfo, Java™ Help et Man pages standard. Les données peuvent également être transformées en une variété de tailles et de styles différents, en livres, en pages A4 et en diapositives à l'aide de feuilles de style standard. La flexibilité des différents formats de sortie et balisages signifie que lors de la création de la documentation, le même code source de la documentation peut être utilisé pour fournir des manuels imprimés, une aide intégrée, des pages de manuel, des informations en ligne et contextuelles. En utilisant le
modèle plus traditionnel, ces éléments peuvent être écrits séparément. DocBook
XML a été largement reconnu dans la communauté des articles techniques, et tous les documents de nombreuses entreprises adoptent la norme DocBook XML (ou un sous-ensemble de celle-ci).                                                                                                                                                   

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!