Index: jrst2/src/test/org/codelutin/jrst/frEntier.rst diff -u jrst2/src/test/org/codelutin/jrst/frEntier.rst:1.1 jrst2/src/test/org/codelutin/jrst/frEntier.rst:1.2 --- jrst2/src/test/org/codelutin/jrst/frEntier.rst:1.1 Tue Jun 5 15:52:14 2007 +++ jrst2/src/test/org/codelutin/jrst/frEntier.rst Wed Jun 20 13:58:59 2007 @@ -7,14 +7,16 @@ :date: $date: 01/06/2007$ :copyright: © 2007. JRST - Code Lutin - GPL +---------------------- + .. sectnum:: .. contents:: Sommaire - Documentation utilisateur ========================= + Présentation ------------ @@ -33,7 +35,10 @@ Usage ----- -Le parser JRST prend un fichier reStructuredText en entré et génère un fichier XML qui pourra ensuite servir à produire divers formats de fichiers grâce à des fichiers XSL de générations. Les formats de sortie disponibles sont le html, le xhtml, le rst, le pdf, le docbook, le odt (Open-Office), le rtf, ou encore le XML. +Le parser JRST prend un fichier reStructuredText en entré et génère un fichier XML +qui pourra ensuite servir à produire divers formats de fichiers grâce à des fichiers +XSL de générations. Les formats de sortie disponibles sont le html, le xhtml, le rst, +le pdf, le docbook, le odt (Open-Office), le rtf, ou encore le XML [1]_. :: @@ -42,9 +47,9 @@ Cette commande aura pour effet de convertir le fichier myfile.rst en XML qui sera affiché sur la sortie standard (console). Plusieurs options sont disponibles : --o file, --outFile=file pour rediriger la sortie vers un fichier. --t format, --outType format pour préciser un format de sortie, donc utiliser un fichier XSL de génération. Plusieurs formats sont disponibles xhtml, docbook, xml, html, xdoc, rst, pdf, odt, rtf. --x xslFile, --xslFile xslFile sert à préciser le fichier xsl de génération à utiliser. +-o file,--outFile=file pour rediriger la sortie vers un fichier. +-t format,--outType format pour préciser un format de sortie, donc utiliser un ou des fichiers XSL de génération. Plusieurs formats sont disponibles xhtml, docbook, xml, html, xdoc, rst, pdf, odt, rtf. +-x xslFile,--xslFile xslFile sert à préciser le fichier xsl de génération à utiliser. --force forcer l'écriture d'un fichier, si le fichier de sortie existe, il sera remplacé. --help pour afficher les options disponibles : @@ -65,16 +70,23 @@ JRST --force -t html -o myfile.html myfile.rst -Cette commande produira un fichier html (myfile.html) à partir du fichier reStructuredText (myfile.rst) même si myfile.html existe déjà. +Cette commande produira un fichier html (myfile.html) à partir du fichier reStructuredText (myfile.rst) +même si myfile.html existe déjà. -Plugin maven +Plugin Maven ------------ -Un plugin maven est disponnible à l'adresse suivante +Un plugin Maven est disponible à l'adresse suivante http://jrst.labs.libre-entreprise.org/maven-jrst-plugin. Il permet l'utilisation -depuis maven de JRst. +depuis Maven de JRst. +.. [1] Seul les formats html, xhtml, DocBook, xdoc et pdf sont disponible pour le moment. + +Maven : http://maven.apache.org/ +XSL : http://jrst.labs.libre-entreprise.org/fr/devel/presentationXSL.rst +DocBook : http://www.docbook.org/ +LaTex : http://www.latex-project.org/ Introduction à ReStructuredText =============================== @@ -82,14 +94,13 @@ Document adaptée du document de Richard Jones : http://docutils.sourceforge.net/sandbox/wilk/french/quickstart-fr.html -Ce texte contient des liens de la forme "(quickref__)". Ils sont -relatifs au manuel de référence utilisateur `Quick reStructuredText`_. -S'ils ne fonctionnent pas, référez vous au document `master quick -reference`_. - -__ http://docutils.sourceforge.net/docs/rst/quickref.html -.. _Quick reStructuredText: http://docutils.sourceforge.net/docs/rst/quickref.html -.. _master quick reference: http://docutils.sourceforge.net/docs/rst/quickref.html +Ce texte contient des liens de la forme. Ils sont +relatifs au manuel de référence utilisateur Quick reStructuredText. +S'ils ne fonctionnent pas, référez vous au document master quick +reference. + +Quick reStructuredText : http://docutils.sourceforge.net/docs/rst/quickref.html +master quick reference : http://docutils.sourceforge.net/docs/rst/quickref.html Structure @@ -101,7 +112,7 @@ HTML pour produire "Very Structured Text" (un texte très structuré) qui pourra être utilisé par un navigateur web. -Le schéma le plus simple est le **paragraphe** (quickref__). +Le schéma le plus simple est le **paragraphe**. C'est un bloc de texte séparé par des lignes vides (une seule suffit). Les paragraphes doivent avoir le même décalage -- c'est à dire des espaces à gauche. Ces paragraphes produiront un texte décalé. Par exemple:: @@ -124,14 +135,10 @@ En voilà un autre -__ http://docutils.sourceforge.net/docs/rst/quickref.html#paragraphs Styles de texte --------------- -(quickref__) - -__ http://docutils.sourceforge.net/docs/rst/quickref.html#inline-markup Dans les paragraphes et le corps du texte, nous pouvons utiliser des marqueurs pour *italique* avec "`` *italique* ``" ou **gras** @@ -148,7 +155,7 @@ souhaitez par contre ``*``entourer un texte par des astérisques``*`` **sans** qu'il soit en italique, il est nécessaire d'indiquer que l'astérisque ne doit pas être interprété. Pour cela il suffit de placer -une barre oblique inversée juste avant lui, comme ça "``\*``" (quickref__), ou +une barre oblique inversée juste avant lui, comme ça "``\*``", ou en l'entourant de doubles apostrophes inversées (litteral), comme cela :: ``\*`` @@ -156,7 +163,6 @@ (``\*`` n'est pas implanté dans le JRST seul les `` fonctionnent) -__ http://docutils.sourceforge.net/docs/rst/quickref.html#escaping Listes ------ @@ -169,10 +175,8 @@ Les listes doivent toujours démarrer un nouveau paragraphe -- c'est à dire qu'il doit y avoir un saut de ligne juste avant. -Listes **numérotées** (par des nombres, lettres, chiffres romains; -quickref__) +Listes **numérotées** (par des nombres, lettres, chiffres romains;) -__ http://docutils.sourceforge.net/docs/rst/quickref.html#enumerated-lists En démarrant une ligne avec un numéro ou une lettre suivie d'un point ".", une parenthèse droite ")" ou entouré par des parenthèses @@ -222,9 +226,8 @@ 1) et encore -Listes **à puces** (quickref__) +Listes **à puces** -__ http://docutils.sourceforge.net/docs/rst/quickref.html#bullet-lists De la même manière que pour les listes numérotées, il faut démarrer la première ligne avec une puce -- soit "-", "+" ou "*":: @@ -239,17 +242,16 @@ Le résultat: -* une puce "*" + * une puce "*" - - une sous-liste avec "-" + - une sous-liste avec "-" - + à nouveau une sous-liste + + à nouveau une sous-liste - - une autre option + - une autre option -Les listes de **définitions** (quickref__) +Les listes de **définitions** -__ http://docutils.sourceforge.net/docs/rst/quickref.html#definition-lists Comme les deux autres, les listes de définitions consistent en un terme et la définition de ce terme. Le format est le suivant:: @@ -274,9 +276,6 @@ Préformatage ------------ -(quickref__) - -__ http://docutils.sourceforge.net/docs/rst/quickref.html#literal-blocks Pour inclure un texte préformaté sans traitement il suffit de terminer le paragraphe par "``::``". Le texte préformaté est @@ -287,20 +286,16 @@ Espaces, nouvelles lignes, lignes vides, et toutes sortes de marqueurs (comme *ceci* ou \cela) sont préservés dans les bloc préformatés. - Fin de l'exemple Le résultat: -Un exemple: - - :: + Un exemple:: Espaces, nouvelles lignes, lignes vides, et toutes sortes de marqueurs (comme *ceci* ou \cela) sont préservés dans les bloc préformatés. - -Fin de l'exemple + Fin de l'exemple Notez que si le paragraphe contient seulement "``::``", il est ignoré. @@ -311,9 +306,6 @@ Sections -------- -(quickref__) - -__ http://docutils.sourceforge.net/docs/rst/quickref.html#section-structure Pour diviser un texte en plusieurs sections, nous utilisons des **en-têtes de section**. C'est à dire une seule ligne de texte (d'un @@ -365,9 +357,9 @@ ce document avec le résultat.) Notez que les en-têtes de section sont utilisable comme cible de liens, -simplement en utilisant leur nom. Pour créer un lien sur la section Listes_, +simplement en utilisant leur nom. Pour créer un lien sur la section Listes, j'écris "``Listes_``". Si le titre comporte des espaces, il est nécessaire -d'utiliser les doubles apostrophes inversées "```Styles de texte`_``". +d'utiliser les doubles apostrophes inversées "```Styles de texte```". Pour indiquer le titre du document, utilisez un style d'ornement unique en début de document. Pour indiquer un sous-titre de document, utilisez @@ -393,35 +385,31 @@ Images ------ -(quickref__) - -__ http://docutils.sourceforge.net/docs/rst/quickref.html#directives -Pour inclure une image dans votre document, vous devez utiliser la directive__ +Pour inclure une image dans votre document, vous devez utiliser la directive ``image``. Par exemple:: - .. image:: biohazard.png + .. image:: /home/letellier/PROJET/jrst2/src/site/fr/rst/user/images/biohazard.png Le résultat: -.. image:: biohazard.png +.. image:: /home/letellier/PROJET/jrst2/src/site/fr/rst/user/images/biohazard.png La partie ``images/biohazard.png`` indique le chemin d'accès au fichier de l'image qui doit apparaître. Il n'y a pas de restriction sur l'image (format, taille etc). Si l'image doit apparaître en HTML et que vous souhaitez lui ajouter des informations:: - .. image:: biohazard.png + .. image:: /home/letellier/PROJET/jrst2/src/site/fr/rst/user/image/biohazard.png :height: 100 :width: 200 :scale: 50 :alt: texte alternatif -Consultez la documentation__ complète de la directive image pour plus d'informations. +Consultez la documentation complète de la directive image pour plus d'informations. -__ http://docutils.sourceforge.net/spec/rst/directives.html -__ http://docutils.sourceforge.net/spec/rst/directives.html#images +Documentation images : http://docutils.sourceforge.net/spec/rst/directives.html#images Et ensuite ? @@ -429,25 +417,295 @@ Cette introduction montre les possibilités les plus courantes de reStructuredText, mais il y en a bien d'autres à explorer. Le manuel de référence utilisateur -'Quick reStructuredText`_ est recommandé pour aller plus loin. Pour les détails complets -consultez `reStructuredText Markup Specification`_ [#]_. +Quick reStructuredText est recommandé pour aller plus loin. Pour les détails complets +consultez reStructuredText Markup Specification [#]_. .. [#] Si ce lien relatif ne fonctionne pas, consultez le document principal: http://docutils.sourceforge.net/spec/rst/reStructuredText.html. -.. _reStructuredText Markup Specification: http://docutils.sourceforge.net/spec/rst/reStructuredText.html -.. _poster un message: mailto:docutils-users@lists.sourceforge.net -.. _Docutils-Users mailing list: http://lists.sourceforge.net/lists/listinfo/docutils-users -.. _Docutils project web site: http://docutils.sourceforge.net/ +reStructuredText Markup Specification : http://docutils.sourceforge.net/spec/rst/reStructuredText.html +Docutils-Users mailing list : http://lists.sourceforge.net/lists/listinfo/docutils-users +Docutils project web site : http://docutils.sourceforge.net/ + +Fonctionnalités proposées +========================= + +La DTD de Docutils : http://docutils.sourceforge.net/docs/ref/doctree.html + + +Fonctionnalités implantées +-------------------------- + +Element racine +~~~~~~~~~~~~~~ + +- document + +Elements titre +~~~~~~~~~~~~~~ + +- subtitle +- title + +Elements bibliographiques +~~~~~~~~~~~~~~~~~~~~~~~~~ + +- docinfo +- author +- authors +- organization +- address +- contact +- version +- revision +- status +- date +- copyright + +Elements de décoration +~~~~~~~~~~~~~~~~~~~~~~ + +- decoration +- footer +- header + +Elements structurels +~~~~~~~~~~~~~~~~~~~~ + +- section +- topic +- sidebar +- transition + +Elements du corps +~~~~~~~~~~~~~~~~~ + +- admonition +- attention +- block_quote +- bullet_list +- caution +- classifier +- danger +- definition +- definition_list +- definition_list_item +- description +- doctest_block +- enumerated_list +- error +- field +- field_body +- field_list +- field_name +- footnote +- hint +- image +- important +- line +- line_block +- list_item +- literal_block +- note +- option +- option_argument +- option_group +- option_list +- option_list_item +- option_string +- paragraph +- term +- tip +- warning + +Elements des tableaux +~~~~~~~~~~~~~~~~~~~~~ + +- table +- tbody +- entry +- row +- colspec +- thead +- tgroup + +Elements de la ligne +~~~~~~~~~~~~~~~~~~~~ + +- emphasis +- strong +- literal +- reference +- footnote_reference + +Fonctionnalités non-implantées +------------------------------ + +- abbreviation +- acronym +- attribution +- caption +- citation +- citation_reference +- comment +- compound +- container +- figure +- generated +- inline +- label +- legend +- pending +- problematic +- raw +- rubric +- subscript +- substitution_definition +- substitution_reference +- superscript +- system_message +- target +- title_reference + + +Documentation développeur +========================= + +Le diagramme de Class +--------------------- + +|classDiagramme| + +La Class **AdvancedReader** à pour fonction de faciliter la lecture du fichier RST grâce à différentes méthodes : + - String readLine() : renvoie une ligne + - String[] readLines(int nombresLigne) : renvoie un certain nombre de lignes + - Stringn[] readWhile(Pattern p) : renvoie les lignes tant qu'elles correspondent au pattern + +... + +La Class **JRSTLexer** utilise **AdvancedReader** pour construire un fichier XML, il parcours +l'ensemble du document pour isoler les types de données, leurs paramètres et leurs contenus, +donc rassembler toutes les informations utiles à la mise en forme du XML final. Il va commencer par +l'entête du document (peekHeader(), peekDocInfo()) pour ensuite s'intéresser au corps (peekBody()). + +La Class **JRSTReader** utilise **JRSTLexer**, il interprète le XML qui lui est renvoyé pour construire +le XML final. Celui-ci est conforme à la DTD définie par DocUtils. Cette Class à parfois besoin de +s'appeler elle même lorsque une partie du document doit être interprétée indépendamment du reste. +Par exemple, s'il y a une liste dans une case d'un tableau, l'on extrait les informations de la case +et on les interprètes, le contenu d'une admoniton (une note) doit lui aussi être considéré comme un +document indépendant. Lorsque la génération est terminée, la Class compose le sommaire (composeContent()) +puis s'occupe de toutes les spécificités « inline » (inline()), comme par exemple les mots en italique ou +gras, les références, les footnotes... Tout ce qui peut apparaître à l'intérieur d'une ligne. + +La Class **reStructuredText** référence toutes les variables nécessaires à la génération du XML final. + +La Class **JRST** contient la méthode main(), elle gère les options, la lecture et l'écriture des fichiers. +Elle lit le document, le parse grâce à la class **JRSTReader** puis applique le XSL désiré (si besoin) +grâce à la class **JRSTGenerator**. + +La génération +------------- + +|diagrammegeneration| + +Référence : + +- xml2rst.xsl (convertion de xml de docutils vers rst) : http://www.merten-home.de/FreeSoftware/xml2rst +- dn2dbk.xsl (convertion de xml de docutils vers docbook) : http://membres.lycos.fr/ebellot/dn2dbk +- les xsl de nwalsh (convertion de docbook vers FO et xhtml) : http://nwalsh.com + +- XMLmind (convertion de FO vers ODT et RTF) : http://www.xmlmind.com/foconverter/what_is_xfc.html +- FOP (convertion de FO vers PDF) : http://xmlgraphics.apache.org/fop + +Exemple d'utilisation +--------------------- + +L'on souhaite convertir le document rst (text.rst) suivant en html (text.html) : + +:: + + ===== + Titre + ===== + + :Author: Letellier Sylvain + + .. Attention:: texte à être réinterprété comme un fichier rst indépendant + ceci est considéré comme un **paragraphe** + +On utilise donc la commande suivante:: + + JRST -t html -o text.html text.rst + +Ce diagramme de séquence décrit le fonctionnement du parseur tout au long de la génération : + +|sequanceDiagramme| + +La Classe **JRSTGenerator**, grâce au fichier XSL rst2xhtml.xsl, renvoie le fichier html suivant:: + + + + + + + Titre + + +

Titre

+ + + + + + + + + +
author :Letellier Sylvain
+
+

attention :

+

+

texte à être réinterprété comme un fichier rst indépendant + ceci est considéré comme un paragraphe

+

+
+ + + +Qui affiche la page (un CSS [2]_ à été ajouté pour la mise en forme) : +.. topic:: Titre + + :Author: Letellier Sylvain + + .. Attention:: texte à être réinterprété comme un fichier rst indépendant + ceci est considéré comme un **paragraphe** + +Utilisation de XSL externe +-------------------------- + +JRST propose de transformer le XML de docutils avec des fichiers XSL externe. +Pour cela, il faut utiliser la commande:: + + JRST -x fichierXSL, fichierXSL2 fichierRST +ou:: + + JRST --xslFile fichierXSL, fichierXSL2 fichierRST + +JRST traitera le fichierRST, le XML de DocUtils qui est retourné sera transformé par la Class JRSTgenerator +en commençant par le fichierXSL puis par le fichierXSL2... + +.. [2] Cascading Style Sheets : http://fr.wikipedia.org/wiki/Feuilles_de_style_en_cascade +.. |diagrammegeneration| image:: /home/letellier/PROJET/jrst2/src/site/fr/rst/devel/images/diagrammeGeneration.png +.. |classDiagramme| image:: /home/letellier/PROJET/jrst2/src/site/fr/rst/devel/images/diagrammeClass.png +.. |sequanceDiagramme| image:: /home/letellier/PROJET/jrst2/src/site/fr/rst/devel/images/diagrammeSequance.png Le XSL (Extensible Stylesheets Language) ======================================== - -Présentation du XSL -------------------- +Introduction +------------ XML est un langage de structuration des données, et non de représentation des données. Ainsi XSL (eXtensible StyleSheet Language) est un langage recommandé par le W3C pour effectuer la représentation @@ -606,386 +864,41 @@ - Article : http://www.commentcamarche.net/xml/xmlxsl.php3 - Schéma : http://fr.wikipedia.org/wiki/Extended_stylesheet_language_transformations -.. |presentationxsl| image:: presentationXSL.png - -Documentation développeur -========================= - -Le diagramme de Class ---------------------- - -|classDiagramme| - -La Class **AdvancedReader** à pour fonction de faciliter la lecture du fichier RST grâce à différentes méthodes : - - String readLine() : renvoie une ligne - - String[] readLines(int nombresLigne) : renvoie un certain nombre de lignes - - Stringn[] readWhile(Pattern p) : renvoie les lignes tant qu'elles correspondent au pattern - -... - -La Class **JRSTLexer** utilise **AdvancedReader** pour construire un fichier XML, il parcours l'ensemble du document pour isoler les types de données, leurs paramètres et leurs contenus, donc rassembler toutes les informations utiles à la mise en forme du XML final. Il va commencer par l'entête du document (peekHeader(), peekDocInfo()) pour ensuite s'intéresser au corps (peekBody()). - -La Class **JRSTReader** utilise **JRSTLexer**, il interprète le XML qui lui est renvoyé pour construire le XML final. Celui-ci est conforme à la DTD définie par DocUtils_. Cette Class à parfois besoin de s'appeler elle même lorsque une partie du document doit être interprétée indépendamment du reste. Par exemple, s'il y a une liste dans une case d'un tableau, l'on extrait les informations de la case et on les interprètes, le contenu d'une admoniton (une note) doit lui aussi être considéré comme un document indépendant. Lorsque la génération est terminée, la Class compose le sommaire (composeContent()) puis s'occupe de toutes les spécificités « inline » (inline()), comme par exemple les mots en italique ou gras, les références, les footnotes... Tout ce qui peut apparaître à l'intérieur d'une ligne. - -La Class **reStructuredText** référence toutes les variables nécessaires à la génération du XML final. - -La Class **JRST** contient la méthode main(), elle gère les options, la lecture et l'écriture des fichiers. Elle lit le document, le parse grâce à la class **JRSTReader** puis applique le XSL désiré (si besoin) grâce à la class **JRSTGenerator**. - -La génération -------------- - -|diagrammegeneration| - -Références : - -- xml2rst.xsl (convertion de xml de docutils vers rst) : http://www.merten-home.de/FreeSoftware/xml2rst -- dn2dbk.xsl (convertion de xml de docutils vers docbook) : http://membres.lycos.fr/ebellot/dn2dbk -- les xsl de nwalsh (convertion de docbook vers FO et xhtml) : http://nwalsh.com - -- XMLmind (convertion de FO vers ODT et RTF) : http://www.xmlmind.com/foconverter/what_is_xfc.html -- FOP (convertion de FO vers PDF) : http://xmlgraphics.apache.org/fop - -Exemple d'utilisation ---------------------- - -L'on souhaite convertir le document rst (text.rst) suivant en html (text.html) : - -:: - - ===== - Titre - ===== - - :Author: Letellier Sylvain - - .. Attention:: texte à être réinterprété comme un fichier rst indépendant - -On utilise donc la commande suivante:: - - JRST -t html -o text.html text.rst - -Ce diagramme de séquence décrit le fonctionnement du parseur tout au long de la génération : - -|sequanceDiagramme| - -La Classe **JRSTGenerator**, grâce au fichier XSL rst2xhtml.xsl, renvoie le fichier html suivant:: - - - - - - - Titre - - -

Titre

- - - - - - - - - -
author :Letellier Sylvain
-
-

attention :

-

-

texte à être réinterprété comme un fichier rst indépendant

-

-
- - - -Qui affiche la page (un CSS à été ajouté pour la mise en forme) : - -.. topic:: Titre - - :Author: Letellier Sylvain - - .. attention:: texte à être réinterprété comme un fichier rst indépendant - - -.. _DocUtils: http://docutils.sourceforge.net/docs/ref/doctree.html -.. |diagrammegeneration| image:: DiagrammeGeneration.png -.. |classDiagramme| image:: DiagrammeClass.png -.. |sequanceDiagramme| image:: DiagrammeSequance.png +.. |presentationxsl| image:: images/presentationXSL.png Les différentes librairies utilisées ------------------------------------- - - -dom4j_ -~~~~~~ - -Dom4j_ est une API Open Source Java permettant de travailler avec XML, XPath et XSLT. Cette bibliothèque est compatible avec les standards DOM, SAX et JAXP. - -javax.xml.transform_ -~~~~~~~~~~~~~~~~~~~~ - -Librairie permettant la transformation XSL. - -SDoc_ -~~~~~ +==================================== -SDoc_ fournit des composants Swing qui inclut la coloration syntaxique pour de nombreux langages. - -Xmlunit_ -~~~~~~~~ - -Xmlunit_ permet de comparer deux fichiers XML pour mettre en évidences les différences. - -.. _dom4j: http://www.dom4j.org -.. _javax.xml.transform: http://java.sun.com/j2se/1.4.2/docs/api/javax/xml/transform/package-summary.html -.. _SDoc: http://sdoc.sourceforge.net/wiki/pmwiki.php -.. _Xmlunit: http://xmlunit.sourceforge.net/ - -Fonctionnalités proposées -========================= - -La DTD de Docutils : http://docutils.sourceforge.net/docs/ref/doctree.html - - -Fonctionnalités implantées --------------------------- - -Element racine -~~~~~~~~~~~~~~ - -- document_ - -Elements titre -~~~~~~~~~~~~~~ - -- subtitle_ -- title_ - -Elements bibliographiques -~~~~~~~~~~~~~~~~~~~~~~~~~ - -- docinfo_ -- author_ -- authors_ -- organization_ -- address_ -- contact_ -- version_ -- revision_ -- status_ -- date_ -- copyright_ +dom4j +----- -Elements de décoration -~~~~~~~~~~~~~~~~~~~~~~ +Dom4j est une API Open Source Java permettant de travailler avec XML, XPath et XSLT. Cette bibliothèque +est compatible avec les standards DOM, SAX et JAXP. -- decoration_ -- footer_ -- header_ +javax.xml.transform et Xalan +---------------------------- -Elements structurels -~~~~~~~~~~~~~~~~~~~~ +javax.xml.transform et Xalan sont deux librairies permettant la transformation XSL. -- section_ -- topic_ -- sidebar_ -- transition_ +SDoc +---- -Elements du corps -~~~~~~~~~~~~~~~~~ +SDoc fournit des composants Swing qui inclut la coloration syntaxique pour de nombreux langages. -- admonition_ -- attention_ -- block_quote_ -- bullet_list_ -- caution_ -- classifier_ -- danger_ -- definition_ -- definition_list_ -- definition_list_item_ -- description_ -- doctest_block_ -- enumerated_list_ -- error_ -- field_ -- field_body_ -- field_list_ -- field_name_ -- footnote_ -- hint_ -- image_ -- important_ -- line_ -- line_block_ -- list_item_ -- literal_block_ -- note_ -- option_ -- option_argument_ -- option_group_ -- option_list_ -- option_list_item_ -- option_string_ -- paragraph_ -- term_ -- tip_ -- warning_ +Xmlunit +------- -Elements des tableaux -~~~~~~~~~~~~~~~~~~~~~ +Xmlunit permet de comparer deux fichiers XML pour mettre en évidences les différences. -- table_ -- tbody_ -- entry_ -- row_ -- colspec_ -- thead_ -- tgroup_ +dom4j : http://www.dom4j.org -Elements de la ligne -~~~~~~~~~~~~~~~~~~~~ +javax.xml.transform : http://java.sun.com/j2se/1.4.2/docs/api/javax/xml/transform/package-summary.html -- emphasis_ -- strong_ -- literal_ -- reference_ -- footnote_reference_ +Xalan : http://xml.apache.org/xalan-j/ -Fonctionnalités non-implantées ------------------------------- +SDoc : http://sdoc.sourceforge.net/wiki/pmwiki.php -- abbreviation_ -- acronym_ -- attribution_ -- caption_ -- citation_ -- citation_reference_ -- comment_ -- compound_ -- container_ -- figure_ -- generated_ -- inline_ -- label_ -- legend_ -- pending_ -- problematic_ -- raw_ -- rubric_ -- subscript_ -- substitution_definition_ -- substitution_reference_ -- superscript_ -- system_message_ -- target_ -- title_reference_ - -.. _abbreviation: http://docutils.sourceforge.net/docs/ref/doctree.html#abbreviation -.. _acronym: http://docutils.sourceforge.net/docs/ref/doctree.html#acronym -.. _address: http://docutils.sourceforge.net/docs/ref/doctree.html#address -.. _admonition: http://docutils.sourceforge.net/docs/ref/doctree.html#admonition -.. _attention: http://docutils.sourceforge.net/docs/ref/doctree.html#attention - -.. _attribution: http://docutils.sourceforge.net/docs/ref/doctree.html#attribution -.. _author: http://docutils.sourceforge.net/docs/ref/doctree.html#author -.. _authors: http://docutils.sourceforge.net/docs/ref/doctree.html#authors -.. _block_quote: http://docutils.sourceforge.net/docs/ref/doctree.html#block-quote -.. _bullet_list: http://docutils.sourceforge.net/docs/ref/doctree.html#bullet-list -.. _caption: http://docutils.sourceforge.net/docs/ref/doctree.html#caption -.. _caution: http://docutils.sourceforge.net/docs/ref/doctree.html#caution -.. _citation: http://docutils.sourceforge.net/docs/ref/doctree.html#citation -.. _citation_reference: http://docutils.sourceforge.net/docs/ref/doctree.html#citation-reference - -.. _classifier: http://docutils.sourceforge.net/docs/ref/doctree.html#classifier -.. _colspec: http://docutils.sourceforge.net/docs/ref/doctree.html#colspec -.. _comment: http://docutils.sourceforge.net/docs/ref/doctree.html#comment -.. _compound: http://docutils.sourceforge.net/docs/ref/doctree.html#compound -.. _contact: http://docutils.sourceforge.net/docs/ref/doctree.html#contact -.. _container: http://docutils.sourceforge.net/docs/ref/doctree.html#container -.. _copyright: http://docutils.sourceforge.net/docs/ref/doctree.html#copyright -.. _danger: http://docutils.sourceforge.net/docs/ref/doctree.html#danger -.. _date: http://docutils.sourceforge.net/docs/ref/doctree.html#date - -.. _decoration: http://docutils.sourceforge.net/docs/ref/doctree.html#decoration -.. _definition: http://docutils.sourceforge.net/docs/ref/doctree.html#definition -.. _definition_list: http://docutils.sourceforge.net/docs/ref/doctree.html#definition-list -.. _definition_list_item: http://docutils.sourceforge.net/docs/ref/doctree.html#definition-list-item -.. _description: http://docutils.sourceforge.net/docs/ref/doctree.html#description -.. _docinfo: http://docutils.sourceforge.net/docs/ref/doctree.html#docinfo -.. _doctest_block: http://docutils.sourceforge.net/docs/ref/doctree.html#doctest-block -.. _document: http://docutils.sourceforge.net/docs/ref/doctree.html#document -.. _emphasis: http://docutils.sourceforge.net/docs/ref/doctree.html#emphasis - -.. _entry: http://docutils.sourceforge.net/docs/ref/doctree.html#entry -.. _enumerated_list: http://docutils.sourceforge.net/docs/ref/doctree.html#enumerated-list -.. _error: http://docutils.sourceforge.net/docs/ref/doctree.html#error -.. _field: http://docutils.sourceforge.net/docs/ref/doctree.html#field -.. _field_body: http://docutils.sourceforge.net/docs/ref/doctree.html#field-body -.. _field_list: http://docutils.sourceforge.net/docs/ref/doctree.html#field-list -.. _field_name: http://docutils.sourceforge.net/docs/ref/doctree.html#field-name -.. _figure: http://docutils.sourceforge.net/docs/ref/doctree.html#figure -.. _footer: http://docutils.sourceforge.net/docs/ref/doctree.html#footer - -.. _footnote: http://docutils.sourceforge.net/docs/ref/doctree.html#footnote -.. _footnote_reference: http://docutils.sourceforge.net/docs/ref/doctree.html#footnote-reference -.. _generated: http://docutils.sourceforge.net/docs/ref/doctree.html#generated -.. _header: http://docutils.sourceforge.net/docs/ref/doctree.html#header -.. _hint: http://docutils.sourceforge.net/docs/ref/doctree.html#hint -.. _image: http://docutils.sourceforge.net/docs/ref/doctree.html#image -.. _important: http://docutils.sourceforge.net/docs/ref/doctree.html#important -.. _inline: http://docutils.sourceforge.net/docs/ref/doctree.html#inline -.. _label: http://docutils.sourceforge.net/docs/ref/doctree.html#label - -.. _legend: http://docutils.sourceforge.net/docs/ref/doctree.html#legend -.. _line: http://docutils.sourceforge.net/docs/ref/doctree.html#line -.. _line_block: http://docutils.sourceforge.net/docs/ref/doctree.html#line-block -.. _list_item: http://docutils.sourceforge.net/docs/ref/doctree.html#list-item -.. _literal: http://docutils.sourceforge.net/docs/ref/doctree.html#literal -.. _literal_block: http://docutils.sourceforge.net/docs/ref/doctree.html#literal-block -.. _note: http://docutils.sourceforge.net/docs/ref/doctree.html#note -.. _option: http://docutils.sourceforge.net/docs/ref/doctree.html#option -.. _option_argument: http://docutils.sourceforge.net/docs/ref/doctree.html#option-argument - -.. _option_group: http://docutils.sourceforge.net/docs/ref/doctree.html#option-group -.. _option_list: http://docutils.sourceforge.net/docs/ref/doctree.html#option-list -.. _option_list_item: http://docutils.sourceforge.net/docs/ref/doctree.html#option-list-item -.. _option_string: http://docutils.sourceforge.net/docs/ref/doctree.html#option-string -.. _organization: http://docutils.sourceforge.net/docs/ref/doctree.html#organization -.. _paragraph: http://docutils.sourceforge.net/docs/ref/doctree.html#paragraph -.. _pending: http://docutils.sourceforge.net/docs/ref/doctree.html#pending -.. _problematic: http://docutils.sourceforge.net/docs/ref/doctree.html#problematic -.. _raw: http://docutils.sourceforge.net/docs/ref/doctree.html#raw - -.. _reference: http://docutils.sourceforge.net/docs/ref/doctree.html#reference -.. _revision: http://docutils.sourceforge.net/docs/ref/doctree.html#revision -.. _row: http://docutils.sourceforge.net/docs/ref/doctree.html#row -.. _rubric: http://docutils.sourceforge.net/docs/ref/doctree.html#rubric -.. _section: http://docutils.sourceforge.net/docs/ref/doctree.html#section -.. _sidebar: http://docutils.sourceforge.net/docs/ref/doctree.html#sidebar -.. _status: http://docutils.sourceforge.net/docs/ref/doctree.html#status -.. _strong: http://docutils.sourceforge.net/docs/ref/doctree.html#strong -.. _subscript: http://docutils.sourceforge.net/docs/ref/doctree.html#subscript - -.. _substitution_definition: http://docutils.sourceforge.net/docs/ref/doctree.html#substitution-definition -.. _substitution_reference: http://docutils.sourceforge.net/docs/ref/doctree.html#substitution-reference -.. _subtitle: http://docutils.sourceforge.net/docs/ref/doctree.html#subtitle -.. _superscript: http://docutils.sourceforge.net/docs/ref/doctree.html#superscript -.. _system_message: http://docutils.sourceforge.net/docs/ref/doctree.html#system-message -.. _table: http://docutils.sourceforge.net/docs/ref/doctree.html#table -.. _target: http://docutils.sourceforge.net/docs/ref/doctree.html#target -.. _tbody: http://docutils.sourceforge.net/docs/ref/doctree.html#tbody -.. _term: http://docutils.sourceforge.net/docs/ref/doctree.html#term - -.. _tgroup: http://docutils.sourceforge.net/docs/ref/doctree.html#tgroup -.. _thead: http://docutils.sourceforge.net/docs/ref/doctree.html#thead -.. _tip: http://docutils.sourceforge.net/docs/ref/doctree.html#tip -.. _title: http://docutils.sourceforge.net/docs/ref/doctree.html#title -.. _title_reference: http://docutils.sourceforge.net/docs/ref/doctree.html#title-reference -.. _topic: http://docutils.sourceforge.net/docs/ref/doctree.html#topic -.. _transition: http://docutils.sourceforge.net/docs/ref/doctree.html#transition -.. _version: http://docutils.sourceforge.net/docs/ref/doctree.html#version -.. _warning: http://docutils.sourceforge.net/docs/ref/doctree.html#warning +Xmlunit : http://xmlunit.sourceforge.net/ Documentation externe @@ -999,6 +912,4 @@ Pour la génération de la javaDoc en RST : http://java.sun.com/j2se/1.3/docs/tooldocs/javadoc/overview.html -.. footer:: Afficher le `code source`__ -__ frEntier.rst