Jrst-commits

Download

jrst-commits@list.nuiton.org

August 2008

2 participants
12 discussions

r177 - in trunk: jrst2 jrst2/doc jrst2/doc/fr jrst2/src/java jrst2/src/java/org/codelutin/jrst jrst2/src/java/org/codelutin/jrst/directive jrst2/src/resources jrst2/src/resources/xsl jrst2/src/site jrst2/src/site/en/rst/devel jrst2/src/site/fr/rst jrst2/src/site/fr/rst/devel jrst2/src/site/fr/rst/user jrst2/src/test/org/codelutin/jrst maven-jrst-plugin maven-jrst-plugin/doc maven-jrst-plugin/src/java/org/codelutin/jrst/plugin
by tchemit＠users.labs.libre-entreprise.org 05 Aug '08

05 Aug '08

Author: tchemit Date: 2008-08-05 08:35:30 +0000 (Tue, 05 Aug 2008) New Revision: 177 Removed: trunk/jrst2/.classpath trunk/jrst2/.project trunk/jrst2/profiles.xml trunk/maven-jrst-plugin/.classpath trunk/maven-jrst-plugin/.project trunk/maven-jrst-plugin/.settings/ trunk/maven-jrst-plugin/profiles.xml Modified: trunk/jrst2/doc/Parser.rst trunk/jrst2/doc/fr/Todo.rst trunk/jrst2/doc/fr/docDeveloppeur.rst trunk/jrst2/doc/fr/docExterne.rst trunk/jrst2/doc/fr/fonctionnalites.rst trunk/jrst2/doc/fr/librairies.rst trunk/jrst2/doc/fr/presentationRST.rst trunk/jrst2/doc/fr/presentationXSL.rst trunk/jrst2/doc/index.rst trunk/jrst2/doc/new_implementation.rst trunk/jrst2/pom.xml trunk/jrst2/src/java/language-fr_FR.properties trunk/jrst2/src/java/org/codelutin/jrst/AdvancedReader.java trunk/jrst2/src/java/org/codelutin/jrst/DocumentHandler.java trunk/jrst2/src/java/org/codelutin/jrst/DocumentWalker.java trunk/jrst2/src/java/org/codelutin/jrst/JRST.java trunk/jrst2/src/java/org/codelutin/jrst/JRSTDirective.java trunk/jrst2/src/java/org/codelutin/jrst/JRSTGenerator.java trunk/jrst2/src/java/org/codelutin/jrst/JRSTLexer.java trunk/jrst2/src/java/org/codelutin/jrst/JRSTReader.java trunk/jrst2/src/java/org/codelutin/jrst/directive/DateDirective.java trunk/jrst2/src/java/org/codelutin/jrst/directive/ImageDirective.java trunk/jrst2/src/resources/language-fr_FR.properties trunk/jrst2/src/resources/xsl/dn2dbk.xsl trunk/jrst2/src/resources/xsl/rst2xdoc.xsl trunk/jrst2/src/resources/xsl/rst2xhtml.xsl trunk/jrst2/src/site/en/rst/devel/XSLpresentation.rst trunk/jrst2/src/site/en/rst/devel/developerDoc.rst trunk/jrst2/src/site/fr/rst/devel/Todo.rst trunk/jrst2/src/site/fr/rst/devel/docDeveloppeur.rst trunk/jrst2/src/site/fr/rst/devel/docExterne.rst trunk/jrst2/src/site/fr/rst/devel/librairies.rst trunk/jrst2/src/site/fr/rst/devel/presentationXSL.rst trunk/jrst2/src/site/fr/rst/index.rst trunk/jrst2/src/site/fr/rst/user/fonctionnalites.rst trunk/jrst2/src/site/fr/rst/user/index.rst trunk/jrst2/src/site/fr/rst/user/presentationRST.rst trunk/jrst2/src/site/site_en.xml trunk/jrst2/src/site/site_fr.xml trunk/jrst2/src/test/org/codelutin/jrst/AdvancedReaderTest.java trunk/jrst2/src/test/org/codelutin/jrst/JRSTGeneratorTest.java trunk/jrst2/src/test/org/codelutin/jrst/JRSTReaderTest.java trunk/jrst2/src/test/org/codelutin/jrst/comparePython.xml trunk/jrst2/src/test/org/codelutin/jrst/frEntier.rst trunk/jrst2/src/test/org/codelutin/jrst/test4.rst trunk/jrst2/src/test/org/codelutin/jrst/text.rst trunk/jrst2/src/test/org/codelutin/jrst/textEntier.rst trunk/maven-jrst-plugin/doc/index.rst trunk/maven-jrst-plugin/pom.xml trunk/maven-jrst-plugin/src/java/org/codelutin/jrst/plugin/JRstPlugin.java Log: convert to UTF-8 suppression fichiers eclispes, profiles.xml optimisation des imports Deleted: trunk/jrst2/.classpath =================================================================== --- trunk/jrst2/.classpath 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/.classpath 2008-08-05 08:35:30 UTC (rev 177) @@ -1,45 +0,0 @@ -<classpath> - <classpathentry kind="src" path="src/java"/> - <classpathentry kind="src" path="src/resources"/> - <classpathentry kind="src" path="src/test" output="target/test-classes"/> - <classpathentry kind="output" path="target/classes"/> - <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/> - <classpathentry kind="var" path="M2_REPO/jgoodies/looks/1.2.2/looks-1.2.2.jar"/> - <classpathentry kind="var" path="M2_REPO/xmlunit/xmlunit/1.1beta1/xmlunit-1.1beta1.jar"/> - <classpathentry kind="var" path="M2_REPO/org/ccil/cowan/tagsoup/tagsoup/0.9.7/tagsoup-0.9.7.jar"/> - <classpathentry kind="var" path="M2_REPO/xalan/xalan/2.7.0/xalan-2.7.0.jar"/> - <classpathentry kind="var" path="M2_REPO/externallib/l2fprod-common/0.1/l2fprod-common-0.1.jar"/> - <classpathentry kind="var" path="M2_REPO/org/apache/xmlgraphics/xmlgraphics-commons/1.1/xmlgraphics-commons-1.1.jar"/> - <classpathentry kind="var" path="M2_REPO/commons-collections/commons-collections/3.1/commons-collections-3.1.jar"/> - <classpathentry kind="var" path="M2_REPO/xerces/xercesImpl/2.6.2/xercesImpl-2.6.2.jar"/> - <classpathentry kind="var" path="M2_REPO/avalon-framework/avalon-framework/4.1.3/avalon-framework-4.1.3.jar"/> - <classpathentry kind="var" path="M2_REPO/sdoc/sdoc/0.5.0-beta/sdoc-0.5.0-beta.jar"/> - <classpathentry kind="var" path="M2_REPO/lutinlib/lutinxml/0.7/lutinxml-0.7.jar"/> - <classpathentry kind="var" path="M2_REPO/commons-primitives/commons-primitives/1.0/commons-primitives-1.0.jar"/> - <classpathentry kind="var" path="M2_REPO/xml-apis/xml-apis/1.0.b2/xml-apis-1.0.b2.jar"/> - <classpathentry kind="var" path="M2_REPO/batik/batik-util/1.6-1/batik-util-1.6-1.jar"/> - <classpathentry kind="var" path="M2_REPO/fop/fop/0.93/fop-0.93-jdk15.jar"/> - <classpathentry kind="var" path="M2_REPO/batik/batik-ext/1.6-1/batik-ext-1.6-1.jar"/> - <classpathentry kind="var" path="M2_REPO/nwalsh/docbook-xsl-nwalsh/1.71.1/docbook-xsl-nwalsh-1.71.1.jar"/> - <classpathentry kind="var" path="M2_REPO/ant/ant/1.6.5/ant-1.6.5.jar"/> - <classpathentry kind="var" path="M2_REPO/dom4j/dom4j/1.6.1/dom4j-1.6.1.jar"/> - <classpathentry kind="var" path="M2_REPO/jdom/jdom/1.0/jdom-1.0.jar"/> - <classpathentry kind="var" path="M2_REPO/jewelcli/jewelcli/0.41/jewelcli-0.41.jar"/> - <classpathentry kind="var" path="M2_REPO/jaxen/jaxen/1.1-beta-6/jaxen-1.1-beta-6.jar"/> - <classpathentry kind="var" path="M2_REPO/batik/batik-gui-util/1.6-1/batik-gui-util-1.6-1.jar"/> - <classpathentry kind="var" path="M2_REPO/commons-lang/commons-lang/2.1/commons-lang-2.1.jar"/> - <classpathentry kind="var" path="M2_REPO/javax/activation/activation/1.0.2/activation-1.0.2.jar"/> - <classpathentry kind="var" path="M2_REPO/logkit/logkit/1.0.1/logkit-1.0.1.jar"/> - <classpathentry kind="var" path="M2_REPO/commons-logging/commons-logging/1.1/commons-logging-1.1.jar"/> - <classpathentry kind="var" path="M2_REPO/commons-io/commons-io/1.3.1/commons-io-1.3.1.jar"/> - <classpathentry kind="var" path="M2_REPO/javax/mail/mail/1.3.3/mail-1.3.3.jar"/> - <classpathentry kind="var" path="M2_REPO/lutinlib/lutinutil/0.24/lutinutil-0.24.jar"/> - <classpathentry kind="var" path="M2_REPO/xml-apis/xmlParserAPIs/2.0.2/xmlParserAPIs-2.0.2.jar"/> - <classpathentry kind="var" path="M2_REPO/com/ibm/icu/icu4j/2.6.1/icu4j-2.6.1.jar"/> - <classpathentry kind="var" path="M2_REPO/xom/xom/1.0b3/xom-1.0b3.jar"/> - <classpathentry kind="var" path="M2_REPO/lutinlib/lutinwidget/0.9/lutinwidget-0.9.jar"/> - <classpathentry kind="var" path="M2_REPO/junit/junit/3.8.1/junit-3.8.1.jar"/> - <classpathentry kind="var" path="M2_REPO/log4j/log4j/1.2.12/log4j-1.2.12.jar"/> - <classpathentry kind="var" path="M2_REPO/javax/servlet/servlet-api/2.3/servlet-api-2.3.jar"/> - <classpathentry kind="var" path="M2_REPO/xerces/xmlParserAPIs/2.6.2/xmlParserAPIs-2.6.2.jar"/> -</classpath> \ No newline at end of file Deleted: trunk/jrst2/.project =================================================================== --- trunk/jrst2/.project 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/.project 2008-08-05 08:35:30 UTC (rev 177) @@ -1,14 +0,0 @@ -<projectDescription> - <name>jrst</name> - <comment>Parser RST en Java.</comment> - <projects/> - <buildSpec> - <buildCommand> - <name>org.eclipse.jdt.core.javabuilder</name> - <arguments/> - </buildCommand> - </buildSpec> - <natures> - <nature>org.eclipse.jdt.core.javanature</nature> - </natures> -</projectDescription> \ No newline at end of file Modified: trunk/jrst2/doc/Parser.rst =================================================================== --- trunk/jrst2/doc/Parser.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/doc/Parser.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -20,7 +20,7 @@ +-------------+---------+----+ Elle nous indique qu'il y aura 3 colonnes en dessous. Si maintenant on prend -la troisi�me ligne:: +la troisième ligne:: +=======+=====+====+====+====+ @@ -29,7 +29,7 @@ Donc si sur les lignes du dessous on a un | on ne doit le prendre que si sur la ligne determinant la separation de ligne il y a un + au meme niveau. Sinon -cela veut dire que nous sommes toujours dans la m�me cellule. +cela veut dire que nous sommes toujours dans la même cellule. On peut donc decouper le tableau en en 4 sous tableaux:: @@ -50,12 +50,12 @@ | | | | +-------------+---------+----+ -Les + suppl�mentaires sur les lignes ne doivent pas �tre pris comme des +Les + supplémentaires sur les lignes ne doivent pas être pris comme des erreurs, car en fait ils peuvent avoir servit pour des colonnes d'une autre partie du tableau. Tant que l'on ne retrouve pas une ligne de la meme longueur que la premiere et -ne contenante que les caract�res + =- +ne contenante que les caractères + =- Donc on detecte un tableau si la ligne correspond a l'expression:: @@ -68,7 +68,7 @@ (\+=)+\+ -pour les s�parations:: +pour les séparations:: [+|]( +|-+)(\+( +|-+))+[+|] Modified: trunk/jrst2/doc/fr/Todo.rst =================================================================== --- trunk/jrst2/doc/fr/Todo.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/doc/fr/Todo.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -2,23 +2,23 @@ Todo ==== -Voici la liste des t�ches qui reste � faire. Si quelqu'un souhaite aider, ou -a une id�e � proposer il ne faut pas h�siter. +Voici la liste des tâches qui reste à faire. Si quelqu'un souhaite aider, ou +a une idée à proposer il ne faut pas hésiter. -- int�grer une date multiformat +- intégrer une date multiformat - faire une feuille de style de conversion de xhtml -> xdoc - la documentation en anglais -- faire une r�gle ant pour aider � la g�n�ration +- faire une règle ant pour aider à la génération <jrst include="..." exclude="..." destination="" extension="...."/> - destination est le r�pertoire destination + destination est le répertoire destination extension est la modification de l'extension des fichiers sources avec cette extension -- un export vers pretion, magic, ou autre outil de pr�sentation. +- un export vers pretion, magic, ou autre outil de présentation. - finir l'export en rst (tableau) - permettre l'import de d'autre format que rst, par exemple .sxw ce qui permettra de convertir simple du .sxw en rst. -- Faire une doclet qui permette d'�crire les Javadocs en RST +- Faire une doclet qui permette d'écrire les Javadocs en RST Modified: trunk/jrst2/doc/fr/docDeveloppeur.rst =================================================================== --- trunk/jrst2/doc/fr/docDeveloppeur.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/doc/fr/docDeveloppeur.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -1,5 +1,5 @@ ========================= -Documentation d�veloppeur +Documentation développeur ========================= .. contents:: Sommaire @@ -9,20 +9,20 @@ |classDiagramme| -La Class **AdvancedReader** a pour fonction de faciliter la lecture du fichier RST gr�ce � diff�rentes m�thodes : +La Class **AdvancedReader** a 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 va parcourir 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 **JRSTLexer** utilise **AdvancedReader** pour construire un fichier XML, il va parcourir 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 a 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 **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 a 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 **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 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**. Exemple d'utilisation ===================== @@ -37,7 +37,7 @@ :Author: Letellier Sylvain - .. Attention:: texte � �tre r�interpr�t� comme un fichier rst ind�pendant + .. Attention:: texte à être réinterprété comme un fichier rst indépendant On utilise donc la commande suivante : @@ -45,7 +45,7 @@ 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 : +Ce diagramme de séquence décrit le fonctionnement du parseur tout au long de la génération : |sequanceDiagramme| @@ -54,7 +54,7 @@ <?xml version="1.0" encoding="UTF-8"?> <html xmlns="http://www.w3.org/TR/xhtml1/strict"> <head> - <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-15"/> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/> <meta name="generator" content="JRST http://jrst.labs.libre-entreprise.org/"/> <title>Titre</title> </head> @@ -73,18 +73,18 @@ <div class="attention"> <p class="title">attention :</p> <p class="body"> - <p>texte � �tre r�interpr�t� comme un fichier rst ind�pendant</p> + <p>texte à être réinterprété comme un fichier rst indépendant</p> </p> </div> </body> </html> -Qui affiche la page (un CSS � �t� ajout� pour la mise en forme) : +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 + .. Attention:: texte à être réinterprété comme un fichier rst indépendant .. _DocUtils: http://docutils.sourceforge.net/docs/ref/doctree.html Modified: trunk/jrst2/doc/fr/docExterne.rst =================================================================== --- trunk/jrst2/doc/fr/docExterne.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/doc/fr/docExterne.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -8,4 +8,4 @@ Un XSL permetant de convertir le XML en RST : http://www.merten-home.de/FreeSoftware/xml2rst/ -Pour la g�n�ration de la javaDoc en RST : http://java.sun.com/j2se/1.3/docs/tooldocs/javadoc/overview.html \ No newline at end of file +Pour la génération de la javaDoc en RST : http://java.sun.com/j2se/1.3/docs/tooldocs/javadoc/overview.html \ No newline at end of file Modified: trunk/jrst2/doc/fr/fonctionnalites.rst =================================================================== --- trunk/jrst2/doc/fr/fonctionnalites.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/doc/fr/fonctionnalites.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -1,12 +1,12 @@ ========================= -Fonctionnalit�s propos�es +Fonctionnalités proposées ========================= La DTD de Docutils : http://docutils.sourceforge.net/docs/ref/doctree.html .. contents:: Sommaire -Fonctionnalit�s implant�es +Fonctionnalités implantées ========================== Element racine @@ -35,7 +35,7 @@ - date_ - copyright_ -Elements de d�coration +Elements de décoration ---------------------- - decoration_ @@ -111,7 +111,7 @@ - reference_ - footnote_reference_ -Fonctionnalit�s non-implant�es +Fonctionnalités non-implantées ============================== - abbreviation_ Modified: trunk/jrst2/doc/fr/librairies.rst =================================================================== --- trunk/jrst2/doc/fr/librairies.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/doc/fr/librairies.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -1,5 +1,5 @@ ==================================== -Les diff�rentes librairies utilis�es +Les différentes librairies utilisées ==================================== .. contents:: Sommaire @@ -7,7 +7,7 @@ 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. +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_ ==================== @@ -22,7 +22,7 @@ Xmlunit_ ======== -Xmlunit_ permet de comparer deux fichiers XML pour mettre en �vidences les diff�rences. +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… Modified: trunk/jrst2/doc/fr/presentationRST.rst =================================================================== --- trunk/jrst2/doc/fr/presentationRST.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/doc/fr/presentationRST.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -1,14 +1,14 @@ -Introduction � ReStructuredText +Introduction à ReStructuredText =============================== -Document adapt�e du document de Richard Jones : http://docutils.sourceforge.net/sandbox/wilk/french/quickstart-fr.html +Document adaptée du document de Richard Jones : http://docutils.sourceforge.net/sandbox/wilk/french/quickstart-fr.html .. contents:: Sommaire 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 +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 @@ -19,34 +19,34 @@ Structure --------- -Pour commencer, il me semble que "Structured Text" n'est pas tout � fait la -bonne appellation. Nous devrions plut�t le nommer "Relaxed Text" qui contient -quelques sch�mas logiques. Ces sch�mas sont interpr�t�s par un convertisseur -HTML pour produire "Very Structured Text" (un texte tr�s structur�) qui pourra -�tre utilis� par un navigateur web. +Pour commencer, il me semble que "Structured Text" n'est pas tout à fait la +bonne appellation. Nous devrions plutôt le nommer "Relaxed Text" qui contient +quelques schémas logiques. Ces schémas sont interprétés par un convertisseur +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__). -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:: +Le schéma le plus simple est le **paragraphe** (quickref__). +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:: Ceci est un paragraphe. - Tr�s court. + Très court. - Le texte de ce paragraphe sera d�cal�, - g�n�ralement utilis� pour des citations. + Le texte de ce paragraphe sera décalé, + généralement utilisé pour des citations. - En voil� un autre + En voilà un autre -Le r�sultat donne : +Le résultat donne : Ceci est un paragraphe. - Tr�s court. + Très court. - Le texte de ce paragraphe sera d�cal�, - g�n�ralement utilis� pour des citations. + Le texte de ce paragraphe sera décalé, + généralement utilisé pour des citations. - En voil� un autre + En voilà un autre __ http://docutils.sourceforge.net/docs/rst/quickref.html#paragraphs @@ -61,23 +61,23 @@ des marqueurs pour *italique* avec "`` *italique* ``" ou **gras** avec "`` **gras** ``". -Notez qu'aucun traitement suppl�mentaire n'est apport� entre deux -doubles apostrophes invers�es -- les ast�risques, comme dans "`` * ``", -sont donc conserv�es en l'�tat. +Notez qu'aucun traitement supplémentaire n'est apporté entre deux +doubles apostrophes inversées -- les astérisques, comme dans "`` * ``", +sont donc conservées en l'état. -Si vous souhaitez utiliser un de ces caract�res "sp�ciaux" dans -le texte, il n'y a g�n�ralement pas de probl�me -- reStructuredText +Si vous souhaitez utiliser un de ces caractères "spéciaux" dans +le texte, il n'y a généralement pas de problème -- reStructuredText est assez malin. -Par exemple, cet ast�risque ``*`` est trait� correctement. Si vous -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 -en l'entourant de doubles apostrophes invers�es (litteral), comme cela :: +Par exemple, cet astérisque ``*`` est traité correctement. Si vous +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 +en l'entourant de doubles apostrophes inversées (litteral), comme cela :: ``\*`` -(``\*`` n'est pas implant� dans le JRST seul les `` fonctionnent) +(``\*`` n'est pas implanté dans le JRST seul les `` fonctionnent) __ http://docutils.sourceforge.net/docs/rst/quickref.html#escaping @@ -85,22 +85,22 @@ Listes ------ -Il y a trois types de listes: **num�rot�es**, **avec puces** et -de **d�finitions**. Dans chaque cas, nous pouvons avoir autant +Il y a trois types de listes: **numérotées**, **avec puces** et +de **définitions**. Dans chaque cas, nous pouvons avoir autant de paragraphes, sous-listes, etc. que l'on souhaite, tant que -le d�calage � gauche est align� sur la premi�re ligne. +le décalage à gauche est aligné sur la première ligne. -Les listes doivent toujours d�marrer un nouveau paragraphe --- c'est � dire qu'il doit y avoir un saut de ligne juste avant. +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; +Listes **numérotées** (par des nombres, lettres, chiffres romains; quickref__) __ 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 - -- comme vous pr�f�rez. Toutes ces formes sont reconnues:: + 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 + -- comme vous préférez. Toutes ces formes sont reconnues:: 1. nombres @@ -111,19 +111,19 @@ a. lettres minuscules - 3. avec une sous-liste qui d�marre � un nombre diff�rent - 4. faites attention � garder une s�quence de nombre correcte ! + 3. avec une sous-liste qui démarre à un nombre différent + 4. faites attention à garder une séquence de nombre correcte ! I. majuscules en chiffres romains i. minuscules en chiffres romains - (1) des nombres � nouveau + (1) des nombres à nouveau 1) et encore - Le r�sultat (note : Tous les styles de listes ne sont pas toujours - support�s par tous les navigateurs, vous ne verrez donc pas forc�ment + Le résultat (note : Tous les styles de listes ne sont pas toujours + supportés par tous les navigateurs, vous ne verrez donc pas forcément les effets complets) : 1. nombres @@ -135,105 +135,105 @@ a. lettres minuscules - 3. avec une sous-liste qui d�marre � un nombre diff�rent - 4. faites attention � garder une s�quence de nombre correcte ! + 3. avec une sous-liste qui démarre à un nombre différent + 4. faites attention à garder une séquence de nombre correcte ! I. majuscules en chiffres romains i. minuscules en chiffres romains - (1) des nombres � nouveau + (1) des nombres à nouveau 1) et encore -Listes **� puces** (quickref__) +Listes **à puces** (quickref__) __ 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 "*":: + 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 "*":: * une puce "*" - une sous-liste avec "-" - + � nouveau une sous-liste + + à nouveau une sous-liste - une autre option - Le r�sultat: + Le résultat: * une puce "*" - une sous-liste avec "-" - + � nouveau une sous-liste + + à nouveau une sous-liste - une autre option -Les listes de **d�finitions** (quickref__) +Les listes de **définitions** (quickref__) __ 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:: + 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:: Quoi - Les listes de d�finitions associent un terme avec une d�finition. + Les listes de définitions associent un terme avec une définition. *Comment* - Le terme est une phrase d'une ligne, et la d�finition est d'un - ou plusieurs paragraphes ou �l�ments, d�cal�s par rapport au terme. - Les lignes vides ne sont pas autoris�es entre le terme et la d�finition. + Le terme est une phrase d'une ligne, et la définition est d'un + ou plusieurs paragraphes ou éléments, décalés par rapport au terme. + Les lignes vides ne sont pas autorisées entre le terme et la définition. - Le r�sultat: + Le résultat: Quoi - Les listes de d�finitions associent un terme avec une d�finition. + Les listes de définitions associent un terme avec une définition. *Comment* - Le terme est une phrase d'une ligne, et la d�finition est d'un - ou plusieurs paragraphes ou �l�ments, d�cal�s par rapport au terme. - Les lignes vides ne sont pas autoris�es entre le terme et la d�finition. + Le terme est une phrase d'une ligne, et la définition est d'un + ou plusieurs paragraphes ou éléments, décalés par rapport au terme. + Les lignes vides ne sont pas autorisées entre le terme et la définition. -Pr�formatage +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 -termin� lorsqu'une ligne retombe au niveau du d�calage pr�c�dent. Par exemple:: +Pour inclure un texte préformaté sans traitement +il suffit de terminer le paragraphe par "``::``". Le texte préformaté est +terminé lorsqu'une ligne retombe au niveau du décalage précédent. Par 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. + (comme *ceci* ou \cela) sont préservés dans les bloc préformatés. Regardez ici, je suis descendu d'un niveau. (mais pas assez) Fin de l'exemple -Le r�sultat: +Le résultat: 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. + (comme *ceci* ou \cela) sont préservés dans les bloc préformatés. Regardez ici, je suis descendu d'un niveau. (mais pas assez) Fin de l'exemple -Notez que si le paragraphe contient seulement "``::``", il est ignor�. +Notez que si le paragraphe contient seulement "``::``", il est ignoré. :: - Ceci est un texte pr�format�, - le paragraphe "::" est ignor�. + Ceci est un texte préformaté, + le paragraphe "::" est ignoré. Sections -------- @@ -242,14 +242,14 @@ __ 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 -ou plusieurs mots) avec un ornement : juste en dessous et �ventuellement -dessus aussi, avec des tirets "``-----``", �gal "``=====``", tildes -"``~~~~~``" ou n'importe quel de ces caract�res ``= - ` : ' " ~ ^ _ * + # < >`` +**en-têtes de section**. C'est à dire une seule ligne de texte (d'un +ou plusieurs mots) avec un ornement : juste en dessous et éventuellement +dessus aussi, avec des tirets "``-----``", égal "``=====``", tildes +"``~~~~~``" ou n'importe quel de ces caractères ``= - ` : ' " ~ ^ _ * + # < >`` qui vous semble convenir. Un ornement simplement en dessous n'a pas la -m�me signification qu'un ornement dessus-dessous avec le m�me caract�re. -Les ornements doivent avoir au moins la taille du texte. Soyez coh�rent, -les ornements identiques sont cens�s �tre du m�me niveau:: +même signification qu'un ornement dessus-dessous avec le même caractère. +Les ornements doivent avoir au moins la taille du texte. Soyez cohérent, +les ornements identiques sont censés être du même niveau:: Chapitre 1 ========== @@ -266,7 +266,7 @@ Chapitre 2 ========== -Le r�sultat de cette structure, sous la forme pseudo-XML:: +Le résultat de cette structure, sous la forme pseudo-XML:: <section> <title> @@ -285,19 +285,19 @@ Chapitre 2 (Pseudo-XML utilise une indentation et n'as pas de balises finale. Il -n'est pas possible de montrer le r�sultat, comme dans les autres exemples, -du fait que les sections ne peuvent �tre utilis�es � l'int�rieur d'un -paragraphe d�cal�. Pour un exemple concret, comparez la structure de -ce document avec le r�sultat.) +n'est pas possible de montrer le résultat, comme dans les autres exemples, +du fait que les sections ne peuvent être utilisées à l'intérieur d'un +paragraphe décalé. Pour un exemple concret, comparez la structure de +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_, -j'�cris "``Listes_``". Si le titre comporte des espaces, il est n�cessaire -d'utiliser les doubles apostrophes invers�es "```Styles de texte`_``". +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_, +j'écris "``Listes_``". Si le titre comporte des espaces, il est nécessaire +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 -un autre ornement unique juste apr�s le titre. +en début de document. Pour indiquer un sous-titre de document, utilisez +un autre ornement unique juste après le titre. Par exemple:: ================= @@ -313,8 +313,8 @@ ... Notez que "Titre du document" et "Titre de la section" utilisent le signe -�gal, mais sont diff�rents et sans relation. Le texte et l'ornement peuvent -�tre de la m�me taille pour des questions d'esth�tisme. +égal, mais sont différents et sans relation. Le texte et l'ornement peuvent +être de la même taille pour des questions d'esthétisme. Images @@ -329,13 +329,13 @@ .. image:: images/biohazard.png -Le r�sultat: +Le résultat: .. image:: 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 +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:: images/biohazard.png @@ -344,7 +344,7 @@ :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 @@ -353,9 +353,9 @@ Et ensuite ? ------------ -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 +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`_ [#]_. Modified: trunk/jrst2/doc/fr/presentationXSL.rst =================================================================== --- trunk/jrst2/doc/fr/presentationXSL.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/doc/fr/presentationXSL.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -4,16 +4,16 @@ .. contents:: Sommaire -Pr�sentation +Présentation ============ -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 des donn�es de documents XML. XSL est lui-m�me d�fini avec le formalisme XML, cela signifie qu'une feuille de style XSL est un document XML bien form�. +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 des données de documents XML. XSL est lui-même défini avec le formalisme XML, cela signifie qu'une feuille de style XSL est un document XML bien formé. -XSL est un langage permettant de d�finir des feuilles de style pour les documents XML au m�me titre que les CSS (Cascading StyleSheets) pour le langage HTML ou bien DSSSL (Document Style Semantics and Specification Language) pour le SGML. XSL est d'ailleurs inspir� de DSSSL dont il reprend beaucoup de fonctionnalit�s et est compatible avec les CSS (il s'agit d'un sur-ensemble des CSS). +XSL est un langage permettant de définir des feuilles de style pour les documents XML au même titre que les CSS (Cascading StyleSheets) pour le langage HTML ou bien DSSSL (Document Style Semantics and Specification Language) pour le SGML. XSL est d'ailleurs inspiré de DSSSL dont il reprend beaucoup de fonctionnalités et est compatible avec les CSS (il s'agit d'un sur-ensemble des CSS). -Toutefois, contrairement aux CSS, XSL permet aussi de retraiter un document XML afin d'en modifier totalement sa structure, ce qui permet � partir d'un document XML d'�tre capable de g�n�rer d'autres types de documents (PostScript, HTML, Tex, RTF, ...) ou bien un fichier XML de structure diff�rente. +Toutefois, contrairement aux CSS, XSL permet aussi de retraiter un document XML afin d'en modifier totalement sa structure, ce qui permet à partir d'un document XML d'être capable de générer d'autres types de documents (PostScript, HTML, Tex, RTF, ...) ou bien un fichier XML de structure différente. -Ainsi la structuration des donn�es (d�finie par XML) et leur repr�sentation (d�finie par un langage tel que XSL) sont s�par�es. Cela signifie qu'il est possible � partir d'un document XML de cr�er des documents utilisant diff�rentes repr�sentations (HTML pour cr�er des pages web, WML pour les mobiles WAP, ...). +Ainsi la structuration des données (définie par XML) et leur représentation (définie par un langage tel que XSL) sont séparées. Cela signifie qu'il est possible à partir d'un document XML de créer des documents utilisant différentes représentations (HTML pour créer des pages web, WML pour les mobiles WAP, ...). |presentationxsl| @@ -21,47 +21,47 @@ Structure d'un document XSL =========================== -Un document XSL �tant un document XML, il commence obligatoirement par la balise suivante:: +Un document XSL étant un document XML, il commence obligatoirement par la balise suivante:: - <?xml version="1.0" encoding="ISO-8859-1"?> + <?xml version="1.0" encoding="UTF-8"?> D'autre part, toute feuille de style XSL est comprise entre les balises <xsl:stylesheet ...> et </xsl:stylesheet>. -La balise xsl:stylesheet encapsule des balises xsl:template d�finissant les transformations � faire subir � certains �l�ments du document XML. +La balise xsl:stylesheet encapsule des balises xsl:template définissant les transformations à faire subir à certains éléments du document XML. :: - <?xml version="1.0" encoding="ISO-8859-1"?> + <?xml version="1.0" encoding="UTF-8"?> <xsl:stylesheet xmlns:xsl="http://www.w3.org/TR/WD-xsl" xmlns="http://www.w3.org/TR/REC-html40" result-ns=""> <xsl:template ... > -  +  </xsl:template > </xsl:stylesheet> -Association d'une feuille XSL � un document XML +Association d'une feuille XSL à un document XML =============================================== -Une feuille de style XSL (enregistr� dans un fichier dont l'extension est .xsl) peut �tre li�e � un document XML (de telle mani�re � ce que le document XML utilise la feuille XSL) en ins�rant la balise suivante au d�but du document XML:: +Une feuille de style XSL (enregistré dans un fichier dont l'extension est .xsl) peut être liée à un document XML (de telle manière à ce que le document XML utilise la feuille XSL) en insérant la balise suivante au début du document XML:: - <?xml version="1.0" encoding="ISO-8859-1"?> + <?xml version="1.0" encoding="UTF-8"?> <?xml-stylesheet href="fichier.xsl" type="text/xsl"?> -Les template rules (r�gles de gabarit) +Les template rules (règles de gabarit) ====================================== -Les template rules sont des balises XSL permettant de d�finir des op�rations � r�aliser sur certains �l�ments du document XML utilisant la page XSL, c'est-�-dire g�n�ralement de transformer un tag XML en au moins un tag HTML (g�n�ralement plusieurs). +Les template rules sont des balises XSL permettant de définir des opérations à réaliser sur certains éléments du document XML utilisant la page XSL, c'est-à-dire généralement de transformer un tag XML en au moins un tag HTML (généralement plusieurs). Ainsi le tag XML suivant:: <personne> <nom>Pillou</nom> - <prenom>Jean-Fran�ois</prenom> + <prenom>Jean-François</prenom> </personne> <personne> <nom>VanHaute</nom> @@ -72,38 +72,38 @@ <prenom>Seb</prenom> </personne> -pourra �tre transform� en les tags HTML suivants:: +pourra être transformé en les tags HTML suivants:: <ul> - <li>Pillou - Jean-Fran�ois</li> + <li>Pillou - Jean-François</li> <li>VanHaute - Nico</li> <li>Andrieu - Seb</li> </ul> -L'attribut "match" de la balise <xsl:template> permet de d�finir (gr�ce � la notation XPath) le ou les �l�ments du document XML sur lesquels s'applique la transformation. +L'attribut "match" de la balise <xsl:template> permet de définir (grâce à la notation XPath) le ou les éléments du document XML sur lesquels s'applique la transformation. -La notation Xpath permet de d�finir des patterns, c'est-�-dire des cha�nes de caract�res permettant de rep�rer un noeud dans le document XML. Les principaux patterns sont : +La notation Xpath permet de définir des patterns, c'est-à-dire des chaînes de caractères permettant de repérer un noeud dans le document XML. Les principaux patterns sont : ======= ============= ================================================================= Pattern Exemple Signification ======= ============= ================================================================= ``|`` Gauche|Milieu Indique une alternative (un noeud ou bien l'autre (ou les deux)) -/ personne/nom Chemin d'acc�s aux �l�ments (personne/bras/gauche) -* * Motif "joker" d�signant n'importe quel �l�ment +/ personne/nom Chemin d'accès aux éléments (personne/bras/gauche) +* * Motif "joker" désignant n'importe quel élément // //personne Indique tous les descendants d'un noeud -. . Caract�rise le noeud courant -``..`` ``..`` D�signe le noeud parent -@ @valeur Indique un attribut caract�ristique +. . Caractérise le noeud courant +``..`` ``..`` Désigne le noeud parent +@ @valeur Indique un attribut caractéristique ======= ============= ================================================================= -La transformation peut �tre r�alis�e : +La transformation peut être réalisée : - soit par ajout de texte, -- soit en d�finissant des �l�ments de transformation, c'est-�-dire des �l�ments permettant de d�finir des r�gles de transformation � appliquer aux �l�ments s�lectionn�s par l'attribut match +- soit en définissant des éléments de transformation, c'est-à-dire des éléments permettant de définir des règles de transformation à appliquer aux éléments sélectionnés par l'attribut match -Voici un exemple de feuille XSL permettant d'effectuer la transformation XML vers HTML d�crite ci-dessus:: +Voici un exemple de feuille XSL permettant d'effectuer la transformation XML vers HTML décrite ci-dessus:: - <?xml version="1.0" encoding="ISO-8859-1"?> + <?xml version="1.0" encoding="UTF-8"?> <xsl:stylesheet xmlns:xsl="http://www.w3.org/TR/WD-xsl" xmlns="http://www.w3.org/TR/REC-html40" @@ -132,15 +132,15 @@ Voici la signification de cette feuille XSL -* Le premier tag <xsl:template> permet d'appliquer une transformation � l'ensemble du document (la valeur "/" de l'attribut match indique l'�l�ment racine du document XML). Ce tag contient des balises HTML qui seront transmises dans l'arbre r�sultat -* L'�l�ment <xsl:apply-templates/> indique le traitement de tous les enfants directs de la racine. -* La balise <xsl:template match="personne" > permet d'aller traiter les �l�ments de type personne -* Enfin les deux �l�ments <xsl:value-of select="nom"/> et <xsl:value-of select="prenom"/> permettent de recuperer les valeurs des balises nom et prenom +* Le premier tag <xsl:template> permet d'appliquer une transformation à l'ensemble du document (la valeur "/" de l'attribut match indique l'élément racine du document XML). Ce tag contient des balises HTML qui seront transmises dans l'arbre résultat +* L'élément <xsl:apply-templates/> indique le traitement de tous les enfants directs de la racine. +* La balise <xsl:template match="personne" > permet d'aller traiter les éléments de type personne +* Enfin les deux éléments <xsl:value-of select="nom"/> et <xsl:value-of select="prenom"/> permettent de recuperer les valeurs des balises nom et prenom -R�f�rences +Références ========== - Article : http://www.commentcamarche.net/xml/xmlxsl.php3 -- Sch�ma : http://fr.wikipedia.org/wiki/Extended_stylesheet_language_transformations +- Schéma : http://fr.wikipedia.org/wiki/Extended_stylesheet_language_transformations .. |presentationxsl| image:: presentationXSL.png \ No newline at end of file Modified: trunk/jrst2/doc/index.rst =================================================================== --- trunk/jrst2/doc/index.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/doc/index.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -2,41 +2,41 @@ Parseur reStructuredText : le JRst ================================== -Pr�sentation +Présentation ------------ Le format reStructuredText est un format de description de documents. A l'image -d'autres LaTeX ou DocBook, il peut �tre d�clin� en une multitude de formats. Ces +d'autres LaTeX ou DocBook, il peut être décliné en une multitude de formats. Ces formats souffrent habituellement d'une syntaxe envahissante qui, si elle est -n�cessaire pour des documents tr�s sp�cifiques, devient g�nante quand il s'agit -de cr�er rapidement un document pas trop complexe. RST dispose quant � lui d'une +nécessaire pour des documents très spécifiques, devient gênante quand il s'agit +de créer rapidement un document pas trop complexe. RST dispose quant à lui d'une syntaxe tellement simple qu'elle en devient presque invisible. -JRST est un parseur RST en Java permettant de cr�er une repr�sentation en arbre -d'un document. Il devient alors facile de g�n�rer une repr�sentation du document -vers diff�rents formats. +JRST est un parseur RST en Java permettant de créer une représentation en arbre +d'un document. Il devient alors facile de générer une représentation du document +vers différents formats. 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 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. :: JRST myfile.rst -Cette commande aura pour effet de convertir le fichier myfile.rst en XML qui sera affich� sur la sortie standard (console). +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 ou des fichiers XSL de g�n�ration. +-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�. +-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 : @@ -57,12 +57,12 @@ 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 ------------ -Un plugin Maven est disponible � l'adresse suivante http://jrst.labs.libre-entreprise.org/maven-jrst-plugin. +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. Modified: trunk/jrst2/doc/new_implementation.rst =================================================================== --- trunk/jrst2/doc/new_implementation.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/doc/new_implementation.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -3,7 +3,7 @@ un objet RSTReader qui permet de lire un flux avec des methodes pratiques pour le RST int getLine(); retourne le numero de ligne courant boolean eof(); retourne vrai si la fin du fichier - int skip_blank_lines(); passe les lignes blanches, et retourne le nombre pass�e + int skip_blank_lines(); passe les lignes blanches, et retourne le nombre passée String [] read_all(); lit toutes les lignes du fichier String [] read_lines(int count); lit un certain nombre de ligne String [] read_ahead(int count); lit un certain nombre de ligne sans avancer le curseur Modified: trunk/jrst2/pom.xml =================================================================== --- trunk/jrst2/pom.xml 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/pom.xml 2008-08-05 08:35:30 UTC (rev 177) @@ -1,4 +1,4 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> @@ -30,7 +30,15 @@ <issueManagement> <url>http://labs.libre-entreprise.org/tracker/?group_id=54</url> </issueManagement> - + <properties> +  + <maven.src.dir>${basedir}/src</maven.src.dir> + +  + <maven.compile.source>1.5</maven.compile.source> + <maven.compile.target>1.5</maven.compile.target> + </properties> +  <repositories> <repository> @@ -151,4 +159,4 @@ </url> </site> </distributionManagement> -</project> \ No newline at end of file +</project> Deleted: trunk/jrst2/profiles.xml =================================================================== --- trunk/jrst2/profiles.xml 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/profiles.xml 2008-08-05 08:35:30 UTC (rev 177) @@ -1,20 +0,0 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> -<settings> - <profiles> - <profile> - <id>project</id> - <activation> - <activeByDefault>true</activeByDefault> - </activation> - <properties> - <maven.test.skip>true</maven.test.skip> -  - <maven.src.dir>${basedir}/src</maven.src.dir> - -  - <maven.compile.source>1.5</maven.compile.source> - <maven.compile.target>1.5</maven.compile.target> - </properties> - </profile> - </profiles> -</settings> \ No newline at end of file Modified: trunk/jrst2/src/java/language-fr_FR.properties =================================================================== --- trunk/jrst2/src/java/language-fr_FR.properties 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/java/language-fr_FR.properties 2008-08-05 08:35:30 UTC (rev 177) @@ -1,7 +1,7 @@ help?=JRST --help pour afficher l'aide rstFile?=Veuillez saisir le chemin du fichier reStructuredText (Laissez vide pour quitter) dontExist=Ce fichier n'existe pas -outputFormat?=Veuillez saisir le format de sortie (xhtml, docbook, xml(par d�fault), html, xdoc, rst, pdf, odt ou rtf)\n(Laissez vide pour sp�cifier le ou les XSL de g�n�rations � utiliser) +outputFormat?=Veuillez saisir le format de sortie (xhtml, docbook, xml(par défault), html, xdoc, rst, pdf, odt ou rtf)\n(Laissez vide pour spécifier le ou les XSL de générations à utiliser) xslFile?=Veuillez saisir le chemin du fichier XSL (Sortie XML si vide) outputFile?=Veuillez saisir le chemin du fichier sortie (Laissez vide pour l'afficher dans la sortie standard) Modified: trunk/jrst2/src/java/org/codelutin/jrst/AdvancedReader.java =================================================================== --- trunk/jrst2/src/java/org/codelutin/jrst/AdvancedReader.java 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/java/org/codelutin/jrst/AdvancedReader.java 2008-08-05 08:35:30 UTC (rev 177) @@ -1,6 +1,6 @@ /* *##% * Copyright (C) 2006 - * Code Lutin, C�dric Pineau, Benjamin Poussin + * Code Lutin, Cédric Pineau, Benjamin Poussin * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License @@ -31,6 +31,9 @@ package org.codelutin.jrst; +import org.apache.commons.collections.primitives.ArrayCharList; +import org.apache.commons.collections.primitives.CharList; + import java.io.BufferedReader; import java.io.IOException; import java.io.LineNumberReader; @@ -38,9 +41,6 @@ import java.io.Reader; import java.util.ArrayList; -import org.apache.commons.collections.primitives.ArrayCharList; -import org.apache.commons.collections.primitives.CharList; - /** * Le principe est d'avoir dans cette classe le moyen de lire, et de retourner * la ou on etait avant la lecture (mark et reset de {@link BufferedReader}). @@ -315,7 +315,7 @@ } /** - * lit les lignes jusqu'a la premiere ligne blanche (non retourn�e) + * lit les lignes jusqu'a la premiere ligne blanche (non retournée) * * @return * @throws IOException Modified: trunk/jrst2/src/java/org/codelutin/jrst/DocumentHandler.java =================================================================== --- trunk/jrst2/src/java/org/codelutin/jrst/DocumentHandler.java 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/java/org/codelutin/jrst/DocumentHandler.java 2008-08-05 08:35:30 UTC (rev 177) @@ -1,6 +1,6 @@ /* *##% * Copyright (C) 2006 - * Code Lutin, C�dric Pineau, Benjamin Poussin + * Code Lutin, Cédric Pineau, Benjamin Poussin * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License Modified: trunk/jrst2/src/java/org/codelutin/jrst/DocumentWalker.java =================================================================== --- trunk/jrst2/src/java/org/codelutin/jrst/DocumentWalker.java 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/java/org/codelutin/jrst/DocumentWalker.java 2008-08-05 08:35:30 UTC (rev 177) @@ -1,6 +1,6 @@ /* *##% * Copyright (C) 2006 - * Code Lutin, C�dric Pineau, Benjamin Poussin + * Code Lutin, Cédric Pineau, Benjamin Poussin * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License @@ -31,8 +31,6 @@ package org.codelutin.jrst; -import java.util.List; - import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; import org.dom4j.Document; @@ -40,6 +38,8 @@ import org.dom4j.Node; import org.dom4j.Text; +import java.util.List; + /** * @author poussin * Modified: trunk/jrst2/src/java/org/codelutin/jrst/JRST.java =================================================================== --- trunk/jrst2/src/java/org/codelutin/jrst/JRST.java 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/java/org/codelutin/jrst/JRST.java 2008-08-05 08:35:30 UTC (rev 177) @@ -1,6 +1,6 @@ /* *##% * Copyright (C) 2006 - * Code Lutin, C�dric Pineau, Benjamin Poussin + * Code Lutin, Cédric Pineau, Benjamin Poussin * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License @@ -30,34 +30,6 @@ */ package org.codelutin.jrst; -import java.awt.GraphicsDevice; -import java.awt.GraphicsEnvironment; -import java.io.BufferedOutputStream; -import java.io.BufferedReader; -import java.io.File; -import java.io.FileNotFoundException; -import java.io.FileOutputStream; -import java.io.IOException; -import java.io.InputStreamReader; -import java.io.OutputStream; -import java.io.Reader; -import java.io.StringReader; -import java.lang.reflect.Method; -import java.net.URL; -import java.util.HashMap; -import java.util.Locale; -import java.util.Map; -import java.util.ResourceBundle; - -import javax.xml.transform.Result; -import javax.xml.transform.Source; -import javax.xml.transform.Transformer; -import javax.xml.transform.TransformerException; -import javax.xml.transform.TransformerFactory; -import javax.xml.transform.URIResolver; -import javax.xml.transform.sax.SAXResult; -import javax.xml.transform.stream.StreamSource; - import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; import org.apache.fop.apps.FOUserAgent; @@ -67,18 +39,41 @@ import org.codelutin.i18n.I18n; import org.codelutin.util.FileCompletion; import org.codelutin.util.FileUtil; -import org.codelutin.util.Resource; import org.codelutin.util.StringUtil; import org.dom4j.Document; import org.dom4j.io.OutputFormat; import org.dom4j.io.XMLWriter; - import uk.co.flamingpenguin.jewel.cli.Cli; import uk.co.flamingpenguin.jewel.cli.CliFactory; import uk.co.flamingpenguin.jewel.cli.CommandLineInterface; import uk.co.flamingpenguin.jewel.cli.Option; import uk.co.flamingpenguin.jewel.cli.Unparsed; +import javax.xml.transform.Result; +import javax.xml.transform.Source; +import javax.xml.transform.Transformer; +import javax.xml.transform.TransformerFactory; +import javax.xml.transform.sax.SAXResult; +import javax.xml.transform.stream.StreamSource; +import java.awt.GraphicsDevice; +import java.awt.GraphicsEnvironment; +import java.io.BufferedOutputStream; +import java.io.BufferedReader; +import java.io.File; +import java.io.FileNotFoundException; +import java.io.FileOutputStream; +import java.io.IOException; +import java.io.InputStreamReader; +import java.io.OutputStream; +import java.io.Reader; +import java.io.StringReader; +import java.lang.reflect.Method; +import java.net.URL; +import java.util.HashMap; +import java.util.Locale; +import java.util.Map; +import java.util.ResourceBundle; + /** * FIXME: 'JRST --help' doesn't work, but 'JRST --help toto' work :( FIXME: * 'JRST -c' doesn't work, but 'JRST -c toto' @@ -371,8 +366,8 @@ public static void generate(String xslListOrOutType, File fileIn, File fileOut, Overwrite overwrite) throws Exception { - generate(xslListOrOutType, fileIn, "ISO-8859-15", fileOut, - "ISO-8859-15", overwrite); + generate(xslListOrOutType, fileIn, "UTF-8", fileOut, + "UTF-8", overwrite); } /** Modified: trunk/jrst2/src/java/org/codelutin/jrst/JRSTDirective.java =================================================================== --- trunk/jrst2/src/java/org/codelutin/jrst/JRSTDirective.java 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/java/org/codelutin/jrst/JRSTDirective.java 2008-08-05 08:35:30 UTC (rev 177) @@ -1,6 +1,6 @@ /* *##% * Copyright (C) 2006 - * Code Lutin, C�dric Pineau, Benjamin Poussin + * Code Lutin, Cédric Pineau, Benjamin Poussin * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License Modified: trunk/jrst2/src/java/org/codelutin/jrst/JRSTGenerator.java =================================================================== --- trunk/jrst2/src/java/org/codelutin/jrst/JRSTGenerator.java 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/java/org/codelutin/jrst/JRSTGenerator.java 2008-08-05 08:35:30 UTC (rev 177) @@ -1,6 +1,6 @@ /* *##% * Copyright (C) 2006 - * Code Lutin, C�dric Pineau, Benjamin Poussin + * Code Lutin, Cédric Pineau, Benjamin Poussin * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License @@ -31,55 +31,9 @@ package org.codelutin.jrst; -import static org.codelutin.jrst.ReStructuredText.ADDRESS; -import static org.codelutin.jrst.ReStructuredText.AUTHOR; -import static org.codelutin.jrst.ReStructuredText.AUTHORS; -import static org.codelutin.jrst.ReStructuredText.BULLET_LIST; -import static org.codelutin.jrst.ReStructuredText.CLASSIFIER; -import static org.codelutin.jrst.ReStructuredText.CONTACT; -import static org.codelutin.jrst.ReStructuredText.COPYRIGHT; -import static org.codelutin.jrst.ReStructuredText.DATE; -import static org.codelutin.jrst.ReStructuredText.DEFINITION; -import static org.codelutin.jrst.ReStructuredText.DEFINITION_LIST; -import static org.codelutin.jrst.ReStructuredText.DOCINFO; -import static org.codelutin.jrst.ReStructuredText.EMPHASIS; -import static org.codelutin.jrst.ReStructuredText.ENUMERATED_LIST; -import static org.codelutin.jrst.ReStructuredText.FIELD_BODY; -import static org.codelutin.jrst.ReStructuredText.FIELD_LIST; -import static org.codelutin.jrst.ReStructuredText.FIELD_NAME; -import static org.codelutin.jrst.ReStructuredText.LIST_ITEM; -import static org.codelutin.jrst.ReStructuredText.LITERAL; -import static org.codelutin.jrst.ReStructuredText.LITERAL_BLOCK; -import static org.codelutin.jrst.ReStructuredText.ORGANIZATION; -import static org.codelutin.jrst.ReStructuredText.PARAGRAPH; -import static org.codelutin.jrst.ReStructuredText.REVISION; -import static org.codelutin.jrst.ReStructuredText.SECTION; -import static org.codelutin.jrst.ReStructuredText.STATUS; -import static org.codelutin.jrst.ReStructuredText.STRONG; -import static org.codelutin.jrst.ReStructuredText.TABLE; -import static org.codelutin.jrst.ReStructuredText.TITLE; -import static org.codelutin.jrst.ReStructuredText.TITLE_CHAR; -import static org.codelutin.jrst.ReStructuredText.TRANSITION; -import static org.codelutin.jrst.ReStructuredText.VERSION; - -import java.io.File; -import java.io.IOException; -import java.io.Writer; -import java.net.MalformedURLException; -import java.net.URL; -import java.util.LinkedList; - -import javax.xml.transform.Source; -import javax.xml.transform.Transformer; -import javax.xml.transform.TransformerException; -import javax.xml.transform.TransformerFactory; -import javax.xml.transform.URIResolver; -import javax.xml.transform.sax.SAXResult; -import javax.xml.transform.stream.StreamResult; -import javax.xml.transform.stream.StreamSource; - import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; +import static org.codelutin.jrst.ReStructuredText.*; import org.dom4j.Document; import org.dom4j.Element; import org.dom4j.Node; @@ -91,6 +45,21 @@ import org.xml.sax.InputSource; import org.xml.sax.SAXException; +import javax.xml.transform.Source; +import javax.xml.transform.Transformer; +import javax.xml.transform.TransformerException; +import javax.xml.transform.TransformerFactory; +import javax.xml.transform.URIResolver; +import javax.xml.transform.sax.SAXResult; +import javax.xml.transform.stream.StreamResult; +import javax.xml.transform.stream.StreamSource; +import java.io.File; +import java.io.IOException; +import java.io.Writer; +import java.net.MalformedURLException; +import java.net.URL; +import java.util.LinkedList; + /** * Cette classe contient plusieurs methode pour generer, soit en utilisant une * feuille de style {@link #generate(Document, URL, Writer)}, soit un @@ -583,7 +552,7 @@ } else if (CLASSIFIER.equals(e.getName())) { write(" : "); } else if (DEFINITION.equals(e.getName())) { - // pour une fois on est oblig� de passer une ligne dans le + // pour une fois on est obligé de passer une ligne dans le // start, car on ne sait pas determiner la fin des classifiers // qui doivent etre tous sur la ligne du TERM newLine(); @@ -644,7 +613,7 @@ } /** - * Ecrit le text, si indent est vrai, alors chaque ligne est indent�e + * Ecrit le text, si indent est vrai, alors chaque ligne est indentée * * @param text * @param indent Modified: trunk/jrst2/src/java/org/codelutin/jrst/JRSTLexer.java =================================================================== --- trunk/jrst2/src/java/org/codelutin/jrst/JRSTLexer.java 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/java/org/codelutin/jrst/JRSTLexer.java 2008-08-05 08:35:30 UTC (rev 177) @@ -1,6 +1,6 @@ /* *##% * Copyright (C) 2006 - * Code Lutin, C�dric Pineau, Benjamin Poussin + * Code Lutin, Cï¿½dric Pineau, Benjamin Poussin * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License @@ -31,6 +31,11 @@ package org.codelutin.jrst; +import org.apache.commons.logging.Log; +import org.apache.commons.logging.LogFactory; +import org.dom4j.DocumentHelper; +import org.dom4j.Element; + import java.io.IOException; import java.io.Reader; import java.util.ArrayList; @@ -39,18 +44,13 @@ import java.util.regex.Matcher; import java.util.regex.Pattern; -import org.apache.commons.logging.Log; -import org.apache.commons.logging.LogFactory; -import org.dom4j.DocumentHelper; -import org.dom4j.Element; - /** * Le principe est de positionner la mark du {@link AdvancedReader} lors du * debut d'une methode peek*, puis a la fin de la methode de regarder le nombre - * de caractere utilis� pour la methode et de faire un reset. + * de caractere utilisï¿½ pour la methode et de faire un reset. * <p> - * Le nombre de caractere utilis� servira pour le remove lorsque l'utilisateur - * indiquera qu'il utilise l'element retourn�, si l'utilisateur n'appelle pas + * Le nombre de caractere utilisï¿½ servira pour le remove lorsque l'utilisateur + * indiquera qu'il utilise l'element retournï¿½, si l'utilisateur n'appelle pas * remove alors il peut relire autant de fois qu'il veut le meme element, ou * essayer d'en lire un autre. * <p> @@ -609,7 +609,7 @@ * Ex : -a command-line option "a" * -1 file, --one=file, --two file * Multiple options with arguments. - * Sch�ma : ________________________________ + * Schéma : ________________________________ * v | | * -{1,2}\w+ ->|',' | * |'='-----|-> \w+ --->|',' @@ -617,7 +617,7 @@ * |" " -----> \w+ ---> end | * &circ; | * |_________________________| - * L�gende : + * Légende : * * -{1,2} --> 1 or 2 tirets * \w+ -----> word characters one or more times Modified: trunk/jrst2/src/java/org/codelutin/jrst/JRSTReader.java =================================================================== --- trunk/jrst2/src/java/org/codelutin/jrst/JRSTReader.java 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/java/org/codelutin/jrst/JRSTReader.java 2008-08-05 08:35:30 UTC (rev 177) @@ -1,6 +1,6 @@ /* *##% * Copyright (C) 2006 - * Code Lutin, Cédric Pineau, Benjamin Poussin + * Code Lutin, CÃ©dric Pineau, Benjamin Poussin * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License @@ -31,82 +31,23 @@ package org.codelutin.jrst; +import org.apache.commons.lang.ObjectUtils; +import org.apache.commons.lang.StringEscapeUtils; +import org.apache.commons.logging.Log; +import org.apache.commons.logging.LogFactory; import static org.codelutin.i18n.I18n._; -import static org.codelutin.jrst.ReStructuredText.ADDRESS; -import static org.codelutin.jrst.ReStructuredText.ADMONITION; -import static org.codelutin.jrst.ReStructuredText.ATTRIBUTION; -import static org.codelutin.jrst.ReStructuredText.AUTHOR; -import static org.codelutin.jrst.ReStructuredText.AUTHORS; -import static org.codelutin.jrst.ReStructuredText.BLOCK_QUOTE; -import static org.codelutin.jrst.ReStructuredText.BULLET_LIST; -import static org.codelutin.jrst.ReStructuredText.COLSPEC; -import static org.codelutin.jrst.ReStructuredText.COMMENT; -import static org.codelutin.jrst.ReStructuredText.CONTACT; -import static org.codelutin.jrst.ReStructuredText.COPYRIGHT; -import static org.codelutin.jrst.ReStructuredText.DATE; -import static org.codelutin.jrst.ReStructuredText.DECORATION; -import static org.codelutin.jrst.ReStructuredText.DEFINITION; -import static org.codelutin.jrst.ReStructuredText.DEFINITION_LIST; -import static org.codelutin.jrst.ReStructuredText.DEFINITION_LIST_ITEM; -import static org.codelutin.jrst.ReStructuredText.DESCRIPTION; -import static org.codelutin.jrst.ReStructuredText.DOCINFO; -import static org.codelutin.jrst.ReStructuredText.DOCTEST_BLOCK; -import static org.codelutin.jrst.ReStructuredText.DOCUMENT; -import static org.codelutin.jrst.ReStructuredText.EMPHASIS; -import static org.codelutin.jrst.ReStructuredText.ENTRY; -import static org.codelutin.jrst.ReStructuredText.ENUMERATED_LIST; -import static org.codelutin.jrst.ReStructuredText.FIELD; -import static org.codelutin.jrst.ReStructuredText.FIELD_BODY; -import static org.codelutin.jrst.ReStructuredText.FIELD_LIST; -import static org.codelutin.jrst.ReStructuredText.FIELD_NAME; -import static org.codelutin.jrst.ReStructuredText.FOOTER; -import static org.codelutin.jrst.ReStructuredText.FOOTNOTE; -import static org.codelutin.jrst.ReStructuredText.FOOTNOTE_REFERENCE; -import static org.codelutin.jrst.ReStructuredText.FOOTNOTE_SYMBOL; -import static org.codelutin.jrst.ReStructuredText.HEADER; -import static org.codelutin.jrst.ReStructuredText.IMAGE; -import static org.codelutin.jrst.ReStructuredText.LINE; -import static org.codelutin.jrst.ReStructuredText.LINE_BLOCK; -import static org.codelutin.jrst.ReStructuredText.LIST_ITEM; -import static org.codelutin.jrst.ReStructuredText.LITERAL; -import static org.codelutin.jrst.ReStructuredText.LITERAL_BLOCK; -import static org.codelutin.jrst.ReStructuredText.OPTION; -import static org.codelutin.jrst.ReStructuredText.OPTION_ARGUMENT; -import static org.codelutin.jrst.ReStructuredText.OPTION_GROUP; -import static org.codelutin.jrst.ReStructuredText.OPTION_LIST; -import static org.codelutin.jrst.ReStructuredText.OPTION_LIST_ITEM; -import static org.codelutin.jrst.ReStructuredText.OPTION_STRING; -import static org.codelutin.jrst.ReStructuredText.ORGANIZATION; -import static org.codelutin.jrst.ReStructuredText.PARAGRAPH; -import static org.codelutin.jrst.ReStructuredText.REFERENCE; -import static org.codelutin.jrst.ReStructuredText.REGEX_ANONYMOUS_HYPERLINK_REFERENCE; -import static org.codelutin.jrst.ReStructuredText.REGEX_EMAIL; -import static org.codelutin.jrst.ReStructuredText.REGEX_EMPHASIS; -import static org.codelutin.jrst.ReStructuredText.REGEX_FOOTNOTE_REFERENCE; -import static org.codelutin.jrst.ReStructuredText.REGEX_HYPERLINK_REFERENCE; -import static org.codelutin.jrst.ReStructuredText.REGEX_INLINE_REFERENCE; -import static org.codelutin.jrst.ReStructuredText.REGEX_LITERAL; -import static org.codelutin.jrst.ReStructuredText.REGEX_REFERENCE; -import static org.codelutin.jrst.ReStructuredText.REGEX_STRONG; -import static org.codelutin.jrst.ReStructuredText.REGEX_SUBSTITUTION_REFERENCE; -import static org.codelutin.jrst.ReStructuredText.REVISION; -import static org.codelutin.jrst.ReStructuredText.ROW; -import static org.codelutin.jrst.ReStructuredText.SECTION; -import static org.codelutin.jrst.ReStructuredText.SIDEBAR; -import static org.codelutin.jrst.ReStructuredText.STATUS; -import static org.codelutin.jrst.ReStructuredText.STRONG; -import static org.codelutin.jrst.ReStructuredText.SUBSTITUTION_DEFINITION; -import static org.codelutin.jrst.ReStructuredText.SUBTITLE; -import static org.codelutin.jrst.ReStructuredText.TABLE; -import static org.codelutin.jrst.ReStructuredText.TARGET; -import static org.codelutin.jrst.ReStructuredText.TBODY; -import static org.codelutin.jrst.ReStructuredText.TERM; -import static org.codelutin.jrst.ReStructuredText.TGROUP; -import static org.codelutin.jrst.ReStructuredText.THEAD; -import static org.codelutin.jrst.ReStructuredText.TITLE; -import static org.codelutin.jrst.ReStructuredText.TOPIC; -import static org.codelutin.jrst.ReStructuredText.TRANSITION; -import static org.codelutin.jrst.ReStructuredText.VERSION; +import static org.codelutin.jrst.ReStructuredText.*; +import org.codelutin.jrst.directive.ContentDirective; +import org.codelutin.jrst.directive.DateDirective; +import org.codelutin.jrst.directive.ImageDirective; +import org.codelutin.jrst.directive.SectnumDirective; +import org.codelutin.util.StringUtil; +import org.dom4j.Document; +import org.dom4j.DocumentException; +import org.dom4j.DocumentHelper; +import org.dom4j.Element; +import org.dom4j.Node; +import org.dom4j.VisitorSupport; import java.io.BufferedReader; import java.io.File; @@ -124,22 +65,6 @@ import java.util.regex.Matcher; import java.util.regex.Pattern; -import org.apache.commons.lang.ObjectUtils; -import org.apache.commons.lang.StringEscapeUtils; -import org.apache.commons.logging.Log; -import org.apache.commons.logging.LogFactory; -import org.codelutin.jrst.directive.ContentDirective; -import org.codelutin.jrst.directive.DateDirective; -import org.codelutin.jrst.directive.ImageDirective; -import org.codelutin.jrst.directive.SectnumDirective; -import org.codelutin.util.StringUtil; -import org.dom4j.Document; -import org.dom4j.DocumentException; -import org.dom4j.DocumentHelper; -import org.dom4j.Element; -import org.dom4j.Node; -import org.dom4j.VisitorSupport; - /* * * <pre> +--------------------------------------------------------------------+ | @@ -678,7 +603,7 @@ } } - // les el�ments a enlever (deja parser : header, footer...) + // les eléments a enlever (deja parser : header, footer...) item = lexer.peekRemove(); if (itemEquals("remove", item)) lexer.remove(); Modified: trunk/jrst2/src/java/org/codelutin/jrst/directive/DateDirective.java =================================================================== --- trunk/jrst2/src/java/org/codelutin/jrst/directive/DateDirective.java 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/java/org/codelutin/jrst/directive/DateDirective.java 2008-08-05 08:35:30 UTC (rev 177) @@ -1,6 +1,6 @@ /* *##% * Copyright (C) 2006 - * Code Lutin, C�dric Pineau, Benjamin Poussin + * Code Lutin, Cédric Pineau, Benjamin Poussin * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License @@ -31,15 +31,15 @@ package org.codelutin.jrst.directive; -import java.text.SimpleDateFormat; -import java.util.Date; - import org.codelutin.jrst.JRSTDirective; import org.dom4j.DocumentHelper; import org.dom4j.Element; import org.dom4j.Node; import org.dom4j.Text; +import java.text.SimpleDateFormat; +import java.util.Date; + /** * .. date:: .. time:: * Modified: trunk/jrst2/src/java/org/codelutin/jrst/directive/ImageDirective.java =================================================================== --- trunk/jrst2/src/java/org/codelutin/jrst/directive/ImageDirective.java 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/java/org/codelutin/jrst/directive/ImageDirective.java 2008-08-05 08:35:30 UTC (rev 177) @@ -1,6 +1,6 @@ /* *##% * Copyright (C) 2006 - * Code Lutin, C�dric Pineau, Benjamin Poussin + * Code Lutin, Cédric Pineau, Benjamin Poussin * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License @@ -31,18 +31,17 @@ package org.codelutin.jrst.directive; -import static org.codelutin.jrst.ReStructuredText.IMAGE; -import static org.codelutin.jrst.ReStructuredText.SUBSTITUTION_DEFINITION; - -import java.util.regex.Matcher; -import java.util.regex.Pattern; - import org.codelutin.jrst.JRSTDirective; import org.codelutin.jrst.JRSTLexer; +import static org.codelutin.jrst.ReStructuredText.IMAGE; +import static org.codelutin.jrst.ReStructuredText.SUBSTITUTION_DEFINITION; import org.dom4j.DocumentHelper; import org.dom4j.Element; import org.dom4j.Node; +import java.util.regex.Matcher; +import java.util.regex.Pattern; + /** * .. image:: picture.jpeg :height: 100 :width: 200 :scale: 50 :alt: alternate * text :align: right Modified: trunk/jrst2/src/resources/language-fr_FR.properties =================================================================== --- trunk/jrst2/src/resources/language-fr_FR.properties 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/resources/language-fr_FR.properties 2008-08-05 08:35:30 UTC (rev 177) @@ -1,7 +1,7 @@ help?=JRST --help pour afficher l'aide rstFile?=Veuillez saisir le chemin du fichier reStructuredText (Laissez vide pour quitter) dontExist=Ce fichier n'existe pas -outputFormat?=Veuillez saisir le format de sortie (xhtml, docbook, xml(par default), html, xdoc, rst, pdf, odt ou rtf)\n(Laissez vide pour specifier le ou les XSL de generations � utiliser) +outputFormat?=Veuillez saisir le format de sortie (xhtml, docbook, xml(par default), html, xdoc, rst, pdf, odt ou rtf)\n(Laissez vide pour specifier le ou les XSL de generations à utiliser) xslFile?=Veuillez saisir le chemin du fichier XSL (Sortie XML si vide) outputFile?=Veuillez saisir le chemin du fichier sortie (Laissez vide pour l'afficher dans la sortie standard) overwrite?=Ce fichier existe, etes-vous sur de vouloir ecraser le fichier \?$o\/n$ Modified: trunk/jrst2/src/resources/xsl/dn2dbk.xsl =================================================================== --- trunk/jrst2/src/resources/xsl/dn2dbk.xsl 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/resources/xsl/dn2dbk.xsl 2008-08-05 08:35:30 UTC (rev 177) @@ -1,4 +1,4 @@ -<?xml version="1.0" encoding="ISO-8859-1" ?> +<?xml version="1.0" encoding="UTF-8" ?>  +  </xsl:template > </xsl:stylesheet> -Association d'une feuille XSL � un document XML +Association d'une feuille XSL à un document XML =============================================== -Une feuille de style XSL (enregistr� dans un fichier dont l'extension est .xsl) peut �tre li�e � un document -XML (de telle mani�re � ce que le document XML utilise la feuille XSL) en ins�rant la balise suivante au d�but +Une feuille de style XSL (enregistré dans un fichier dont l'extension est .xsl) peut être liée à un document +XML (de telle manière à ce que le document XML utilise la feuille XSL) en insérant la balise suivante au début du document XML:: - <?xml version="1.0" encoding="ISO-8859-1"?> + <?xml version="1.0" encoding="UTF-8"?> <?xml-stylesheet href="fichier.xsl" type="text/xsl"?> -Les template rules (r�gles de gabarit) +Les template rules (règles de gabarit) ====================================== -Les template rules sont des balises XSL permettant de d�finir des op�rations � r�aliser sur certains �l�ments -du document XML utilisant la page XSL, c'est-�-dire g�n�ralement de transformer un tag XML en au moins un tag -HTML (g�n�ralement plusieurs). +Les template rules sont des balises XSL permettant de définir des opérations à réaliser sur certains éléments +du document XML utilisant la page XSL, c'est-à-dire généralement de transformer un tag XML en au moins un tag +HTML (généralement plusieurs). Ainsi le tag XML suivant:: <personne> <nom>Pillou</nom> - <prenom>Jean-Fran�ois</prenom> + <prenom>Jean-François</prenom> </personne> <personne> <nom>VanHaute</nom> @@ -87,41 +87,41 @@ <prenom>Seb</prenom> </personne> -pourra �tre transform� en les tags HTML suivants:: +pourra être transformé en les tags HTML suivants:: <ul> - <li>Pillou - Jean-Fran�ois</li> + <li>Pillou - Jean-François</li> <li>VanHaute - Nico</li> <li>Andrieu - Seb</li> </ul> -L'attribut "match" de la balise <xsl:template> permet de d�finir (gr�ce � la notation XPath) le ou les �l�ments +L'attribut "match" de la balise <xsl:template> permet de définir (grâce à la notation XPath) le ou les éléments du document XML sur lesquels s'applique la transformation. -La notation Xpath permet de d�finir des patterns, c'est-�-dire des cha�nes de caract�res permettant de rep�rer +La notation Xpath permet de définir des patterns, c'est-à-dire des chaînes de caractères permettant de repérer un noeud dans le document XML. Les principaux patterns sont : ======= ============= ================================================================= Pattern Exemple Signification ======= ============= ================================================================= ``|`` Gauche|Milieu Indique une alternative (un noeud ou bien l'autre (ou les deux)) -/ personne/nom Chemin d'acc�s aux �l�ments (personne/bras/gauche) -* * Motif "joker" d�signant n'importe quel �l�ment +/ personne/nom Chemin d'accès aux éléments (personne/bras/gauche) +* * Motif "joker" désignant n'importe quel élément // //personne Indique tous les descendants d'un noeud -. . Caract�rise le noeud courant -``..`` ``..`` D�signe le noeud parent -@ @valeur Indique un attribut caract�ristique +. . Caractérise le noeud courant +``..`` ``..`` Désigne le noeud parent +@ @valeur Indique un attribut caractéristique ======= ============= ================================================================= -La transformation peut �tre r�alis�e : +La transformation peut être réalisée : - soit par ajout de texte, -- soit en d�finissant des �l�ments de transformation, c'est-�-dire des �l�ments permettant de d�finir - des r�gles de transformation � appliquer aux �l�ments s�lectionn�s par l'attribut match +- soit en définissant des éléments de transformation, c'est-à-dire des éléments permettant de définir + des règles de transformation à appliquer aux éléments sélectionnés par l'attribut match -Voici un exemple de feuille XSL permettant d'effectuer la transformation XML vers HTML d�crite ci-dessus:: +Voici un exemple de feuille XSL permettant d'effectuer la transformation XML vers HTML décrite ci-dessus:: - <?xml version="1.0" encoding="ISO-8859-1"?> + <?xml version="1.0" encoding="UTF-8"?> <xsl:stylesheet xmlns:xsl="http://www.w3.org/TR/WD-xsl" xmlns="http://www.w3.org/TR/REC-html40" @@ -150,18 +150,18 @@ Voici la signification de cette feuille XSL : -* Le premier tag <xsl:template> permet d'appliquer une transformation � l'ensemble du document (la valeur - "/" de l'attribut match indique l'�l�ment racine du document XML). Ce tag contient des balises HTML qui - seront transmises dans l'arbre r�sultat. -* L'�l�ment <xsl:apply-templates/> indique le traitement de tous les enfants directs de la racine. -* La balise <xsl:template match="personne"> permet d'aller traiter les �l�ments de type personne. -* Enfin les deux �l�ments <xsl:value-of select="nom"/> et <xsl:value-of select="prenom"/> permettent de +* Le premier tag <xsl:template> permet d'appliquer une transformation à l'ensemble du document (la valeur + "/" de l'attribut match indique l'élément racine du document XML). Ce tag contient des balises HTML qui + seront transmises dans l'arbre résultat. +* L'élément <xsl:apply-templates/> indique le traitement de tous les enfants directs de la racine. +* La balise <xsl:template match="personne"> permet d'aller traiter les éléments de type personne. +* Enfin les deux éléments <xsl:value-of select="nom"/> et <xsl:value-of select="prenom"/> permettent de recuperer les valeurs des balises nom et prenom. -R�f�rences +Références ========== - Article : http://www.commentcamarche.net/xml/xmlxsl.php3 -- Sch�ma : http://fr.wikipedia.org/wiki/Extended_stylesheet_language_transformations +- Schéma : http://fr.wikipedia.org/wiki/Extended_stylesheet_language_transformations .. |presentationxsl| image:: images/presentationXSL.png \ No newline at end of file Modified: trunk/jrst2/src/site/fr/rst/index.rst =================================================================== --- trunk/jrst2/src/site/fr/rst/index.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/site/fr/rst/index.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -8,40 +8,40 @@ .. contents:: Sommaire -Pr�sentation +Présentation ------------ Le format reStructuredText_ est un format de description de documents. A l'image -d'autres LaTeX_ ou DocBook_, il peut �tre d�clin� en une multitude de formats. Ces +d'autres LaTeX_ ou DocBook_, il peut être décliné en une multitude de formats. Ces formats souffrent habituellement d'une syntaxe envahissante qui, si elle est -n�cessaire pour des documents tr�s sp�cifiques, devient g�nante quand il s'agit -de cr�er rapidement un document pas trop complexe. RST_ dispose quant � lui d'une +nécessaire pour des documents très spécifiques, devient gênante quand il s'agit +de créer rapidement un document pas trop complexe. RST_ dispose quant à lui d'une syntaxe tellement simple qu'elle en devient presque invisible. -JRST est un parseur RST_ en Java permettant de cr�er une repr�sentation en arbre -d'un document. Il devient alors facile de g�n�rer une repr�sentation du document -vers diff�rents formats. +JRST est un parseur RST_ en Java permettant de créer une représentation en arbre +d'un document. Il devient alors facile de générer une représentation du document +vers différents formats. 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 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]_. :: JRST myfile.rst -Cette commande aura pour effet de convertir le fichier myfile.rst en XML qui sera affich� sur la sortie standard (console). +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 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�. +-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 : @@ -61,14 +61,14 @@ 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_ ------------- -Un plugin Maven_ est disponible � 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. Modified: trunk/jrst2/src/site/fr/rst/user/fonctionnalites.rst =================================================================== --- trunk/jrst2/src/site/fr/rst/user/fonctionnalites.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/site/fr/rst/user/fonctionnalites.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -1,12 +1,12 @@ ========================= -Fonctionnalit�s propos�es +Fonctionnalités proposées ========================= La DTD de Docutils : http://docutils.sourceforge.net/docs/ref/doctree.html .. contents:: Sommaire -Fonctionnalit�s implant�es +Fonctionnalités implantées ========================== Element racine @@ -35,7 +35,7 @@ - date_ - copyright_ -Elements de d�coration +Elements de décoration ---------------------- - decoration_ @@ -111,7 +111,7 @@ - reference_ - footnote_reference_ -Fonctionnalit�s non-implant�es +Fonctionnalités non-implantées ============================== - abbreviation_ Modified: trunk/jrst2/src/site/fr/rst/user/index.rst =================================================================== --- trunk/jrst2/src/site/fr/rst/user/index.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/site/fr/rst/user/index.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -8,40 +8,40 @@ .. contents:: Sommaire -Pr�sentation +Présentation ------------ Le format reStructuredText_ est un format de description de documents. A l'image -d'autres LaTeX_ ou DocBook_, il peut �tre d�clin� en une multitude de formats. Ces +d'autres LaTeX_ ou DocBook_, il peut être décliné en une multitude de formats. Ces formats souffrent habituellement d'une syntaxe envahissante qui, si elle est -n�cessaire pour des documents tr�s sp�cifiques, devient g�nante quand il s'agit -de cr�er rapidement un document pas trop complexe. RST_ dispose quant � lui d'une +nécessaire pour des documents très spécifiques, devient gênante quand il s'agit +de créer rapidement un document pas trop complexe. RST_ dispose quant à lui d'une syntaxe tellement simple qu'elle en devient presque invisible. -JRST est un parseur RST_ en Java permettant de cr�er une repr�sentation en arbre -d'un document. Il devient alors facile de g�n�rer une repr�sentation du document -vers diff�rents formats. +JRST est un parseur RST_ en Java permettant de créer une représentation en arbre +d'un document. Il devient alors facile de générer une représentation du document +vers différents formats. 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 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]_. :: JRST myfile.rst -Cette commande aura pour effet de convertir le fichier myfile.rst en XML qui sera affich� sur la sortie standard (console). +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 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�. +-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 : @@ -61,14 +61,14 @@ 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_ ------------- -Un plugin Maven_ est disponible � 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. Modified: trunk/jrst2/src/site/fr/rst/user/presentationRST.rst =================================================================== --- trunk/jrst2/src/site/fr/rst/user/presentationRST.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/site/fr/rst/user/presentationRST.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -1,15 +1,15 @@ =============================== -Introduction � ReStructuredText +Introduction à ReStructuredText =============================== -Document adapt� de celui de Richard Jones : http://docutils.sourceforge.net/sandbox/wilk/french/quickstart-fr.html +Document adapté de celui de Richard Jones : http://docutils.sourceforge.net/sandbox/wilk/french/quickstart-fr.html .. contents:: Sommaire 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 +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 @@ -20,34 +20,34 @@ Structure --------- -Pour commencer, il me semble que "Structured Text" n'est pas tout � fait la -bonne appellation. Nous devrions plut�t le nommer "Relaxed Text" qui contient -quelques sch�mas logiques. Ces sch�mas sont interpr�t�s par un convertisseur -HTML pour produire "Very Structured Text" (un texte tr�s structur�) qui pourra -�tre utilis� par un navigateur web. +Pour commencer, il me semble que "Structured Text" n'est pas tout à fait la +bonne appellation. Nous devrions plutôt le nommer "Relaxed Text" qui contient +quelques schémas logiques. Ces schémas sont interprétés par un convertisseur +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__). -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:: +Le schéma le plus simple est le **paragraphe** (quickref__). +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:: Ceci est un paragraphe. - Tr�s court. + Très court. - Le texte de ce paragraphe sera d�cal�, - g�n�ralement utilis� pour des citations. + Le texte de ce paragraphe sera décalé, + généralement utilisé pour des citations. - En voil� un autre + En voilà un autre -Le r�sultat donne : +Le résultat donne : Ceci est un paragraphe. - Tr�s court. + Très court. - Le texte de ce paragraphe sera d�cal�, - g�n�ralement utilis� pour des citations. + Le texte de ce paragraphe sera décalé, + généralement utilisé pour des citations. - En voil� un autre + En voilà un autre __ http://docutils.sourceforge.net/docs/rst/quickref.html#paragraphs @@ -62,23 +62,23 @@ des marqueurs pour *italique* avec "`` *italique* ``" ou **gras** avec "`` **gras** ``". -Notez qu'aucun traitement suppl�mentaire n'est apport� entre deux -doubles apostrophes invers�es -- les ast�risques, comme dans "`` * ``", -sont donc conserv�es en l'�tat. +Notez qu'aucun traitement supplémentaire n'est apporté entre deux +doubles apostrophes inversées -- les astérisques, comme dans "`` * ``", +sont donc conservées en l'état. -Si vous souhaitez utiliser un de ces caract�res "sp�ciaux" dans -le texte, il n'y a g�n�ralement pas de probl�me -- reStructuredText +Si vous souhaitez utiliser un de ces caractères "spéciaux" dans +le texte, il n'y a généralement pas de problème -- reStructuredText est assez malin. -Par exemple, cet ast�risque ``*`` est trait� correctement. Si vous -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 -en l'entourant de doubles apostrophes invers�es (litteral), comme cela :: +Par exemple, cet astérisque ``*`` est traité correctement. Si vous +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 +en l'entourant de doubles apostrophes inversées (litteral), comme cela :: ``\*`` -(``\*`` n'est pas implant� dans le JRST seul les `` fonctionnent) +(``\*`` n'est pas implanté dans le JRST seul les `` fonctionnent) __ http://docutils.sourceforge.net/docs/rst/quickref.html#escaping @@ -86,22 +86,22 @@ Listes ------ -Il y a trois types de listes: **num�rot�es**, **avec puces** et -de **d�finitions**. Dans chaque cas, nous pouvons avoir autant +Il y a trois types de listes: **numérotées**, **avec puces** et +de **définitions**. Dans chaque cas, nous pouvons avoir autant de paragraphes, sous-listes, etc. que l'on souhaite, tant que -le d�calage � gauche est align� sur la premi�re ligne. +le décalage à gauche est aligné sur la première ligne. -Les listes doivent toujours d�marrer un nouveau paragraphe --- c'est � dire qu'il doit y avoir un saut de ligne juste avant. +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; +Listes **numérotées** (par des nombres, lettres, chiffres romains; quickref__) __ 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 --- comme vous pr�f�rez. Toutes ces formes sont reconnues:: +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 +-- comme vous préférez. Toutes ces formes sont reconnues:: 1. nombres @@ -112,19 +112,19 @@ a. lettres minuscules - 3. avec une sous-liste qui d�marre � un nombre diff�rent - 4. faites attention � garder une s�quence de nombre correcte ! + 3. avec une sous-liste qui démarre à un nombre différent + 4. faites attention à garder une séquence de nombre correcte ! I. majuscules en chiffres romains i. minuscules en chiffres romains - (1) des nombres � nouveau + (1) des nombres à nouveau 1) et encore -Le r�sultat (note : Tous les styles de listes ne sont pas toujours -support�s par tous les navigateurs, vous ne verrez donc pas forc�ment +Le résultat (note : Tous les styles de listes ne sont pas toujours +supportés par tous les navigateurs, vous ne verrez donc pas forcément les effets complets) : 1. nombres @@ -136,99 +136,99 @@ a. lettres minuscules - 3. avec une sous-liste qui d�marre � un nombre diff�rent - 4. faites attention � garder une s�quence de nombre correcte ! + 3. avec une sous-liste qui démarre à un nombre différent + 4. faites attention à garder une séquence de nombre correcte ! I. majuscules en chiffres romains i. minuscules en chiffres romains -(1) des nombres � nouveau +(1) des nombres à nouveau 1) et encore -Listes **� puces** (quickref__) +Listes **à puces** (quickref__) __ 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 "*":: +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 "*":: * une puce "*" - une sous-liste avec "-" - + � nouveau une sous-liste + + à nouveau une sous-liste - une autre option -Le r�sultat: +Le résultat: * une puce "*" - une sous-liste avec "-" - + � nouveau une sous-liste + + à nouveau une sous-liste - une autre option -Les listes de **d�finitions** (quickref__) +Les listes de **définitions** (quickref__) __ 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:: +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:: Quoi - Les listes de d�finitions associent un terme avec une d�finition. + Les listes de définitions associent un terme avec une définition. *Comment* - Le terme est une phrase d'une ligne, et la d�finition est d'un - ou plusieurs paragraphes ou �l�ments, d�cal�s par rapport au terme. - Les lignes vides ne sont pas autoris�es entre le terme et la d�finition. + Le terme est une phrase d'une ligne, et la définition est d'un + ou plusieurs paragraphes ou éléments, décalés par rapport au terme. + Les lignes vides ne sont pas autorisées entre le terme et la définition. -Le r�sultat: +Le résultat: Quoi - Les listes de d�finitions associent un terme avec une d�finition. + Les listes de définitions associent un terme avec une définition. *Comment* - Le terme est une phrase d'une ligne, et la d�finition est d'un - ou plusieurs paragraphes ou �l�ments, d�cal�s par rapport au terme. - Les lignes vides ne sont pas autoris�es entre le terme et la d�finition. + Le terme est une phrase d'une ligne, et la définition est d'un + ou plusieurs paragraphes ou éléments, décalés par rapport au terme. + Les lignes vides ne sont pas autorisées entre le terme et la définition. -Pr�formatage +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 -termin� lorsqu'une ligne retombe au niveau du d�calage pr�c�dent. Par exemple:: +Pour inclure un texte préformaté sans traitement +il suffit de terminer le paragraphe par "``::``". Le texte préformaté est +terminé lorsqu'une ligne retombe au niveau du décalage précédent. Par 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. + (comme *ceci* ou \cela) sont préservés dans les bloc préformatés. Fin de l'exemple -Le r�sultat: +Le résultat: 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. + (comme *ceci* ou \cela) sont préservés dans les bloc préformatés. Fin de l'exemple -Notez que si le paragraphe contient seulement "``::``", il est ignor�. +Notez que si le paragraphe contient seulement "``::``", il est ignoré. :: - Ceci est un texte pr�format�, - le paragraphe "::" est ignor�. + Ceci est un texte préformaté, + le paragraphe "::" est ignoré. Sections -------- @@ -237,14 +237,14 @@ __ 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 -ou plusieurs mots) avec un ornement : juste en dessous et �ventuellement -dessus aussi, avec des tirets "``-----``", �gal "``=====``", tildes -"``~~~~~``" ou n'importe quel de ces caract�res ``= - ` : ' " ~ ^ _ * + # < >`` +**en-têtes de section**. C'est à dire une seule ligne de texte (d'un +ou plusieurs mots) avec un ornement : juste en dessous et éventuellement +dessus aussi, avec des tirets "``-----``", égal "``=====``", tildes +"``~~~~~``" ou n'importe quel de ces caractères ``= - ` : ' " ~ ^ _ * + # < >`` qui vous semble convenir. Un ornement simplement en dessous n'a pas la -m�me signification qu'un ornement dessus-dessous avec le m�me caract�re. -Les ornements doivent avoir au moins la taille du texte. Soyez coh�rent, -les ornements identiques sont cens�s �tre du m�me niveau:: +même signification qu'un ornement dessus-dessous avec le même caractère. +Les ornements doivent avoir au moins la taille du texte. Soyez cohérent, +les ornements identiques sont censés être du même niveau:: Chapitre 1 ========== @@ -261,7 +261,7 @@ Chapitre 2 ========== -Le r�sultat de cette structure, sous la forme pseudo-XML:: +Le résultat de cette structure, sous la forme pseudo-XML:: <section> <title> @@ -280,15 +280,15 @@ Chapitre 2 (Pseudo-XML utilise une indentation et n'as pas de balises finale. Il -n'est pas possible de montrer le r�sultat, comme dans les autres exemples, -du fait que les sections ne peuvent �tre utilis�es � l'int�rieur d'un -paragraphe d�cal�. Pour un exemple concret, comparez la structure de -ce document avec le r�sultat.) +n'est pas possible de montrer le résultat, comme dans les autres exemples, +du fait que les sections ne peuvent être utilisées à l'intérieur d'un +paragraphe décalé. Pour un exemple concret, comparez la structure de +ce document avec le résultat.) 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 -un autre ornement unique juste apr�s le titre. +en début de document. Pour indiquer un sous-titre de document, utilisez +un autre ornement unique juste après le titre. Par exemple:: ================= @@ -304,8 +304,8 @@ ... Notez que "Titre du document" et "Titre de la section" utilisent le signe -�gal, mais sont diff�rents et sans relation. Le texte et l'ornement peuvent -�tre de la m�me taille pour des questions d'esth�tisme. +égal, mais sont différents et sans relation. Le texte et l'ornement peuvent +être de la même taille pour des questions d'esthétisme. Images @@ -320,13 +320,13 @@ .. image:: images/biohazard.png -Le r�sultat: +Le résultat: .. image:: 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 +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:: images/biohazard.png @@ -335,7 +335,7 @@ :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 @@ -344,9 +344,9 @@ Et ensuite ? ------------ -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 +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`_ [#]_. Modified: trunk/jrst2/src/site/site_en.xml =================================================================== --- trunk/jrst2/src/site/site_en.xml 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/site/site_en.xml 2008-08-05 08:35:30 UTC (rev 177) @@ -1,4 +1,4 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <project name="JRst"> <skin> Modified: trunk/jrst2/src/site/site_fr.xml =================================================================== --- trunk/jrst2/src/site/site_fr.xml 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/site/site_fr.xml 2008-08-05 08:35:30 UTC (rev 177) @@ -1,4 +1,4 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <project name="JRst"> <skin> @@ -32,16 +32,16 @@ </links> <menu name="Utilisateur"> - <item href="/user/index.html" name="Pr�sentation du JRST"></item> - <item href="/user/presentationRST.html" name="Introduction � ReStructuredText"></item> - <item href="/user/fonctionnalites.html" name="Fonctionnalit�s incluses"></item> - <item href="http://labs.libre-entreprise.org/frs/?group_id=54&release_id=252" name="T�l�charger"/> + <item href="/user/index.html" name="Présentation du JRST"></item> + <item href="/user/presentationRST.html" name="Introduction à ReStructuredText"></item> + <item href="/user/fonctionnalites.html" name="Fonctionnalités incluses"></item> + <item href="http://labs.libre-entreprise.org/frs/?group_id=54&release_id=252" name="Télécharger"/> </menu> <menu name="Developpeur"> <item name="Fonctionnement" href="/devel/docDeveloppeur.html"/> <item name="Presentation au XSL" href="/devel/presentationXSL.html"/> - <item name="Librairies utilis�es" href="/devel/librairies.html"/> + <item name="Librairies utilisées" href="/devel/librairies.html"/> <item name="Todo" href="/devel/Todo.html"/> <item name="Documentation externe" href="/devel/docExterne.html"/> </menu> Modified: trunk/jrst2/src/test/org/codelutin/jrst/AdvancedReaderTest.java =================================================================== --- trunk/jrst2/src/test/org/codelutin/jrst/AdvancedReaderTest.java 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/test/org/codelutin/jrst/AdvancedReaderTest.java 2008-08-05 08:35:30 UTC (rev 177) @@ -1,6 +1,6 @@ /* *##% * Copyright (C) 2006 - * Code Lutin, C�dric Pineau, Benjamin Poussin + * Code Lutin, Cédric Pineau, Benjamin Poussin * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License @@ -31,6 +31,8 @@ package org.codelutin.jrst; +import junit.framework.TestCase; + import java.io.BufferedWriter; import java.io.File; import java.io.FileReader; @@ -38,9 +40,7 @@ import java.io.StringReader; import java.io.Writer; -import junit.framework.TestCase; - /** * @author poussin * Modified: trunk/jrst2/src/test/org/codelutin/jrst/JRSTGeneratorTest.java =================================================================== --- trunk/jrst2/src/test/org/codelutin/jrst/JRSTGeneratorTest.java 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/test/org/codelutin/jrst/JRSTGeneratorTest.java 2008-08-05 08:35:30 UTC (rev 177) @@ -1,6 +1,6 @@ /* *##% * Copyright (C) 2006 - * Code Lutin, C�dric Pineau, Benjamin Poussin + * Code Lutin, Cédric Pineau, Benjamin Poussin * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License Modified: trunk/jrst2/src/test/org/codelutin/jrst/JRSTReaderTest.java =================================================================== --- trunk/jrst2/src/test/org/codelutin/jrst/JRSTReaderTest.java 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/test/org/codelutin/jrst/JRSTReaderTest.java 2008-08-05 08:35:30 UTC (rev 177) @@ -1,6 +1,6 @@ /* *##% * Copyright (C) 2006 - * Code Lutin, C�dric Pineau, Benjamin Poussin + * Code Lutin, Cédric Pineau, Benjamin Poussin * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License @@ -31,18 +31,16 @@ package org.codelutin.jrst; -import java.io.InputStreamReader; -import java.io.Reader; -import java.io.StringWriter; -import java.net.URL; - import junit.framework.TestCase; - import org.dom4j.Document; import org.dom4j.io.OutputFormat; import org.dom4j.io.XMLWriter; +import java.io.InputStreamReader; +import java.io.Reader; +import java.net.URL; + /** * @author poussin * Modified: trunk/jrst2/src/test/org/codelutin/jrst/comparePython.xml =================================================================== --- trunk/jrst2/src/test/org/codelutin/jrst/comparePython.xml 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/test/org/codelutin/jrst/comparePython.xml 2008-08-05 08:35:30 UTC (rev 177) @@ -185,8 +185,8 @@ sa structure, ce qui permet à partir d'un document XML d'être capable de générer d'autres types de documents (PostScript, HTML, Tex, RTF, ...) ou bien un fichier XML de structure différente.</paragraph><paragraph>Ainsi la structuration des données (définie par XML) et leur représentation (définie par un langage tel que XSL) sont séparées. Cela signifie qu'il est possible à partir d'un document XML de créer des documents -utilisant différentes représentations (HTML pour créer des pages web, WML pour les mobiles WAP, ...).</paragraph><paragraph><image alt="presentationxsl" uri="presentationXSL.png"/></paragraph></section><section id="structure-d-un-document-xsl" name="structure d'un document xsl"><title auto="1" refid="id39"><generated class="sectnum">3.2 </generated>Structure d'un document XSL</title><paragraph>Un document XSL étant un document XML, il commence obligatoirement par la balise suivante:</paragraph><literal_block xml:space="preserve"><?xml version="1.0" encoding="ISO-8859-1"?></literal_block><paragraph>D'autre part, toute feuille de style XSL est comprise entre les balises <xsl:stylesheet ...> et </xsl:stylesheet>.</paragraph><paragraph>La balise xsl:stylesheet encapsule des balises xsl:template définissant les transformations à faire subir à certains -éléments du document XML.</paragraph><literal_block xml:space="preserve"><?xml version="1.0" encoding="ISO-8859-1"?> +utilisant différentes représentations (HTML pour créer des pages web, WML pour les mobiles WAP, ...).</paragraph><paragraph><image alt="presentationxsl" uri="presentationXSL.png"/></paragraph></section><section id="structure-d-un-document-xsl" name="structure d'un document xsl"><title auto="1" refid="id39"><generated class="sectnum">3.2 </generated>Structure d'un document XSL</title><paragraph>Un document XSL étant un document XML, il commence obligatoirement par la balise suivante:</paragraph><literal_block xml:space="preserve"><?xml version="1.0" encoding="UTF-8"?></literal_block><paragraph>D'autre part, toute feuille de style XSL est comprise entre les balises <xsl:stylesheet ...> et </xsl:stylesheet>.</paragraph><paragraph>La balise xsl:stylesheet encapsule des balises xsl:template définissant les transformations à faire subir à certains +éléments du document XML.</paragraph><literal_block xml:space="preserve"><?xml version="1.0" encoding="UTF-8"?> <xsl:stylesheet xmlns:xsl="http://www.w3.org/TR/WD-xsl" xmlns="http://www.w3.org/TR/REC-html40" @@ -196,7 +196,7 @@ </xsl:template > </xsl:stylesheet></literal_block></section><section id="association-d-une-feuille-xsl-un-document-xml" name="association d'une feuille xsl à un document xml"><title auto="1" refid="id40"><generated class="sectnum">3.3 </generated>Association d'une feuille XSL à un document XML</title><paragraph>Une feuille de style XSL (enregistré dans un fichier dont l'extension est .xsl) peut être liée à un document XML (de telle manière à ce que le document XML utilise la feuille XSL) en insérant la balise suivante au début -du document XML:</paragraph><literal_block xml:space="preserve"><?xml version="1.0" encoding="ISO-8859-1"?> +du document XML:</paragraph><literal_block xml:space="preserve"><?xml version="1.0" encoding="UTF-8"?> <?xml-stylesheet href="fichier.xsl" type="text/xsl"?></literal_block></section><section id="les-template-rules-r-gles-de-gabarit" name="les template rules (règles de gabarit)"><title auto="1" refid="id41"><generated class="sectnum">3.4 </generated>Les template rules (règles de gabarit)</title><paragraph>Les template rules sont des balises XSL permettant de définir des opérations à réaliser sur certains éléments du document XML utilisant la page XSL, c'est-à-dire généralement de transformer un tag XML en au moins un tag HTML (généralement plusieurs).</paragraph><paragraph>Ainsi le tag XML suivant:</paragraph><literal_block xml:space="preserve"><personne> @@ -217,7 +217,7 @@ </ul></literal_block><paragraph>L'attribut "match" de la balise <xsl:template> permet de définir (grâce à la notation XPath) le ou les éléments du document XML sur lesquels s'applique la transformation.</paragraph><paragraph>La notation Xpath permet de définir des patterns, c'est-à-dire des chaînes de caractères permettant de repérer un noeud dans le document XML. Les principaux patterns sont :</paragraph><table><tgroup cols="3"><colspec colwidth="7"/><colspec colwidth="13"/><colspec colwidth="65"/><thead><row><entry><paragraph>Pattern</paragraph></entry><entry><paragraph>Exemple</paragraph></entry><entry><paragraph>Signification</paragraph></entry></row></thead><tbody><row><entry><paragraph><literal>|</literal></paragraph></entry><entry><paragraph>Gauche|Milieu</paragraph></entry><entry><paragraph>Indique une alternative (un noeud ou bien l'autre (ou les deux))</paragraph></entry></row><row><entry><paragraph>/</paragraph></entry><entry><paragraph>personne/nom</paragraph></entry><entry><paragraph>Chemin d'accès aux éléments (personne/bras/gauche)</paragraph></entry></row><row><entry><bullet_list bullet="*"><list_item/></bullet_list></entry><entry><bullet_list bullet="*"><list_item/></bullet_list></entry><entry><paragraph>Motif "joker" désignant n'importe quel élément</paragraph></entry></row><row><entry><paragraph>//</paragraph></entry><entry><paragraph>//personne</paragraph></entry><entry><paragraph>Indique tous les descendants d'un noeud</paragraph></entry></row><row><entry><paragraph>.</paragraph></entry><entry><paragraph>.</paragraph></entry><entry><paragraph>Caractérise le noeud courant</paragraph></entry></row><row><entry><paragraph><literal>..</literal></paragraph></entry><entry><paragraph><literal>..</literal></paragraph></entry><entry><paragraph>Désigne le noeud parent</paragraph></entry></row><row><entry><paragraph>@</paragraph></entry><entry><paragraph>@valeur</paragraph></entry><entry><paragraph>Indique un attribut caractéristique</paragraph></entry></row></tbody></tgroup></table><paragraph>La transformation peut être réalisée :</paragraph><bullet_list bullet="-"><list_item><paragraph>soit par ajout de texte,</paragraph></list_item><list_item><paragraph>soit en définissant des éléments de transformation, c'est-à-dire des éléments permettant de définir -des règles de transformation à appliquer aux éléments sélectionnés par l'attribut match</paragraph></list_item></bullet_list><paragraph>Voici un exemple de feuille XSL permettant d'effectuer la transformation XML vers HTML décrite ci-dessus:</paragraph><literal_block xml:space="preserve"><?xml version="1.0" encoding="ISO-8859-1"?> +des règles de transformation à appliquer aux éléments sélectionnés par l'attribut match</paragraph></list_item></bullet_list><paragraph>Voici un exemple de feuille XSL permettant d'effectuer la transformation XML vers HTML décrite ci-dessus:</paragraph><literal_block xml:space="preserve"><?xml version="1.0" encoding="UTF-8"?> <xsl:stylesheet xmlns:xsl="http://www.w3.org/TR/WD-xsl" xmlns="http://www.w3.org/TR/REC-html40" @@ -253,7 +253,7 @@ .. Attention:: texte à être réinterprété comme un fichier rst indépendant</literal_block><paragraph>On utilise donc la commande suivante:</paragraph><literal_block xml:space="preserve">JRST -t html -o text.html text.rst</literal_block><paragraph>Ce diagramme de séquence décrit le fonctionnement du parseur tout au long de la génération :</paragraph><paragraph><image alt="sequanceDiagramme" uri="DiagrammeSequance.png"/></paragraph><paragraph>La Classe <strong>JRSTGenerator</strong>, grâce au fichier XSL rst2xhtml.xsl, renvoie le fichier html suivant:</paragraph><literal_block xml:space="preserve"><?xml version="1.0" encoding="UTF-8"?> <html xmlns="http://www.w3.org/TR/xhtml1/strict"> <head> - <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-15"/> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/> <meta name="generator" content="JRST http://jrst.labs.libre-entreprise.org/"/> <title>Titre</title> </head> Modified: trunk/jrst2/src/test/org/codelutin/jrst/frEntier.rst =================================================================== --- trunk/jrst2/src/test/org/codelutin/jrst/frEntier.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/test/org/codelutin/jrst/frEntier.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -5,7 +5,7 @@ :author: Sylvain LETELLIER <letellier@codelutin> :organization: Code Lutin :date: $date: 01/06/2007$ -:copyright: � 2007. JRST - Code Lutin - GPL +:copyright: © 2007. JRST - Code Lutin - GPL ---------------------- @@ -17,40 +17,40 @@ ========================= -Pr�sentation +Présentation ------------ Le format reStructuredText est un format de description de documents. A l'image -d'autres LaTeX ou DocBook, il peut �tre d�clin� en une multitude de formats. Ces +d'autres LaTeX ou DocBook, il peut être décliné en une multitude de formats. Ces formats souffrent habituellement d'une syntaxe envahissante qui, si elle est -n�cessaire pour des documents tr�s sp�cifiques, devient g�nante quand il s'agit -de cr�er rapidement un document pas trop complexe. RST dispose quant � lui d'une +nécessaire pour des documents très spécifiques, devient gênante quand il s'agit +de créer rapidement un document pas trop complexe. RST dispose quant à lui d'une syntaxe tellement simple qu'elle en devient presque invisible. -JRST est un parseur RST en Java permettant de cr�er une repr�sentation en arbre -d'un document. Il devient alors facile de g�n�rer une repr�sentation du document -vers diff�rents formats. +JRST est un parseur RST en Java permettant de créer une représentation en arbre +d'un document. Il devient alors facile de générer une représentation du document +vers différents formats. 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 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]_. :: JRST myfile.rst -Cette commande aura pour effet de convertir le fichier myfile.rst en XML qui sera affich� sur la sortie standard (console). +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 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�. +-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 : @@ -70,14 +70,14 @@ 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 ------------ -Un plugin Maven est disponible � 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. @@ -88,15 +88,15 @@ DocBook : http://www.docbook.org/ LaTex : http://www.latex-project.org/ -Introduction � ReStructuredText +Introduction à ReStructuredText =============================== -Document adapt�e du document de Richard Jones : http://docutils.sourceforge.net/sandbox/wilk/french/quickstart-fr.html +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. 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 +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 @@ -106,34 +106,34 @@ Structure --------- -Pour commencer, il me semble que "Structured Text" n'est pas tout � fait la -bonne appellation. Nous devrions plut�t le nommer "Relaxed Text" qui contient -quelques sch�mas logiques. Ces sch�mas sont interpr�t�s par un convertisseur -HTML pour produire "Very Structured Text" (un texte tr�s structur�) qui pourra -�tre utilis� par un navigateur web. +Pour commencer, il me semble que "Structured Text" n'est pas tout à fait la +bonne appellation. Nous devrions plutôt le nommer "Relaxed Text" qui contient +quelques schémas logiques. Ces schémas sont interprétés par un convertisseur +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**. -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:: +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:: Ceci est un paragraphe. - Tr�s court. + Très court. - Le texte de ce paragraphe sera d�cal�, - g�n�ralement utilis� pour des citations. + Le texte de ce paragraphe sera décalé, + généralement utilisé pour des citations. - En voil� un autre + En voilà un autre -Le r�sultat donne : +Le résultat donne : Ceci est un paragraphe. - Tr�s court. + Très court. - Le texte de ce paragraphe sera d�cal�, - g�n�ralement utilis� pour des citations. + Le texte de ce paragraphe sera décalé, + généralement utilisé pour des citations. - En voil� un autre + En voilà un autre Styles de texte @@ -144,43 +144,43 @@ des marqueurs pour *italique* avec "`` *italique* ``" ou **gras** avec "`` **gras** ``". -Notez qu'aucun traitement suppl�mentaire n'est apport� entre deux -doubles apostrophes invers�es -- les ast�risques, comme dans "`` * ``", -sont donc conserv�es en l'�tat. +Notez qu'aucun traitement supplémentaire n'est apporté entre deux +doubles apostrophes inversées -- les astérisques, comme dans "`` * ``", +sont donc conservées en l'état. -Si vous souhaitez utiliser un de ces caract�res "sp�ciaux" dans -le texte, il n'y a g�n�ralement pas de probl�me -- reStructuredText +Si vous souhaitez utiliser un de ces caractères "spéciaux" dans +le texte, il n'y a généralement pas de problème -- reStructuredText est assez malin. -Par exemple, cet ast�risque ``*`` est trait� correctement. Si vous -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 "``\*``", ou -en l'entourant de doubles apostrophes invers�es (litteral), comme cela :: +Par exemple, cet astérisque ``*`` est traité correctement. Si vous +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 "``\*``", ou +en l'entourant de doubles apostrophes inversées (litteral), comme cela :: ``\*`` -(``\*`` n'est pas implant� dans le JRST seul les `` fonctionnent) +(``\*`` n'est pas implanté dans le JRST seul les `` fonctionnent) Listes ------ -Il y a trois types de listes: **num�rot�es**, **avec puces** et -de **d�finitions**. Dans chaque cas, nous pouvons avoir autant +Il y a trois types de listes: **numérotées**, **avec puces** et +de **définitions**. Dans chaque cas, nous pouvons avoir autant de paragraphes, sous-listes, etc. que l'on souhaite, tant que -le d�calage � gauche est align� sur la premi�re ligne. +le décalage à gauche est aligné sur la première ligne. -Les listes doivent toujours d�marrer un nouveau paragraphe --- c'est � dire qu'il doit y avoir un saut de ligne juste avant. +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;) +Listes **numérotées** (par des nombres, lettres, chiffres romains;) -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 --- comme vous pr�f�rez. Toutes ces formes sont reconnues:: +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 +-- comme vous préférez. Toutes ces formes sont reconnues:: 1. nombres @@ -191,19 +191,19 @@ a. lettres minuscules - 3. avec une sous-liste qui d�marre � un nombre diff�rent - 4. faites attention � garder une s�quence de nombre correcte ! + 3. avec une sous-liste qui démarre à un nombre différent + 4. faites attention à garder une séquence de nombre correcte ! I. majuscules en chiffres romains i. minuscules en chiffres romains - (1) des nombres � nouveau + (1) des nombres à nouveau 1) et encore -Le r�sultat (note : Tous les styles de listes ne sont pas toujours -support�s par tous les navigateurs, vous ne verrez donc pas forc�ment +Le résultat (note : Tous les styles de listes ne sont pas toujours +supportés par tous les navigateurs, vous ne verrez donc pas forcément les effets complets) : 1. nombres @@ -215,107 +215,107 @@ a. lettres minuscules - 3. avec une sous-liste qui d�marre � un nombre diff�rent - 4. faites attention � garder une s�quence de nombre correcte ! + 3. avec une sous-liste qui démarre à un nombre différent + 4. faites attention à garder une séquence de nombre correcte ! I. majuscules en chiffres romains i. minuscules en chiffres romains -(1) des nombres � nouveau +(1) des nombres à nouveau 1) et encore -Listes **� puces** +Listes **à puces** -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 "*":: +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 "*":: * une puce "*" - une sous-liste avec "-" - + � nouveau une sous-liste + + à nouveau une sous-liste - une autre option -Le r�sultat: +Le résultat: * une puce "*" - une sous-liste avec "-" - + � nouveau une sous-liste + + à nouveau une sous-liste - une autre option -Les listes de **d�finitions** +Les listes de **définitions** -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:: +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:: Quoi - Les listes de d�finitions associent un terme avec une d�finition. + Les listes de définitions associent un terme avec une définition. *Comment* - Le terme est une phrase d'une ligne, et la d�finition est d'un - ou plusieurs paragraphes ou �l�ments, d�cal�s par rapport au terme. - Les lignes vides ne sont pas autoris�es entre le terme et la d�finition. + Le terme est une phrase d'une ligne, et la définition est d'un + ou plusieurs paragraphes ou éléments, décalés par rapport au terme. + Les lignes vides ne sont pas autorisées entre le terme et la définition. -Le r�sultat: +Le résultat: Quoi - Les listes de d�finitions associent un terme avec une d�finition. + Les listes de définitions associent un terme avec une définition. *Comment* - Le terme est une phrase d'une ligne, et la d�finition est d'un - ou plusieurs paragraphes ou �l�ments, d�cal�s par rapport au terme. - Les lignes vides ne sont pas autoris�es entre le terme et la d�finition. + Le terme est une phrase d'une ligne, et la définition est d'un + ou plusieurs paragraphes ou éléments, décalés par rapport au terme. + Les lignes vides ne sont pas autorisées entre le terme et la définition. -Pr�formatage +Préformatage ------------ -Pour inclure un texte pr�format� sans traitement -il suffit de terminer le paragraphe par "``::``". Le texte pr�format� est -termin� lorsqu'une ligne retombe au niveau du d�calage pr�c�dent. Par exemple:: +Pour inclure un texte préformaté sans traitement +il suffit de terminer le paragraphe par "``::``". Le texte préformaté est +terminé lorsqu'une ligne retombe au niveau du décalage précédent. Par 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. + (comme *ceci* ou \cela) sont préservés dans les bloc préformatés. Fin de l'exemple -Le r�sultat: +Le résultat: 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. + (comme *ceci* ou \cela) sont préservés dans les bloc préformatés. Fin de l'exemple -Notez que si le paragraphe contient seulement "``::``", il est ignor�. +Notez que si le paragraphe contient seulement "``::``", il est ignoré. :: - Ceci est un texte pr�format�, - le paragraphe "::" est ignor�. + Ceci est un texte préformaté, + le paragraphe "::" est ignoré. Sections -------- 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 -ou plusieurs mots) avec un ornement : juste en dessous et �ventuellement -dessus aussi, avec des tirets "``-----``", �gal "``=====``", tildes -"``~~~~~``" ou n'importe quel de ces caract�res ``= - ` : ' " ~ ^ _ * + # < >`` +**en-têtes de section**. C'est à dire une seule ligne de texte (d'un +ou plusieurs mots) avec un ornement : juste en dessous et éventuellement +dessus aussi, avec des tirets "``-----``", égal "``=====``", tildes +"``~~~~~``" ou n'importe quel de ces caractères ``= - ` : ' " ~ ^ _ * + # < >`` qui vous semble convenir. Un ornement simplement en dessous n'a pas la -m�me signification qu'un ornement dessus-dessous avec le m�me caract�re. -Les ornements doivent avoir au moins la taille du texte. Soyez coh�rent, -les ornements identiques sont cens�s �tre du m�me niveau:: +même signification qu'un ornement dessus-dessous avec le même caractère. +Les ornements doivent avoir au moins la taille du texte. Soyez cohérent, +les ornements identiques sont censés être du même niveau:: Chapitre 1 ========== @@ -332,7 +332,7 @@ Chapitre 2 ========== -Le r�sultat de cette structure, sous la forme pseudo-XML:: +Le résultat de cette structure, sous la forme pseudo-XML:: <section> <title> @@ -351,19 +351,19 @@ Chapitre 2 (Pseudo-XML utilise une indentation et n'as pas de balises finale. Il -n'est pas possible de montrer le r�sultat, comme dans les autres exemples, -du fait que les sections ne peuvent �tre utilis�es � l'int�rieur d'un -paragraphe d�cal�. Pour un exemple concret, comparez la structure de -ce document avec le r�sultat.) +n'est pas possible de montrer le résultat, comme dans les autres exemples, +du fait que les sections ne peuvent être utilisées à l'intérieur d'un +paragraphe décalé. Pour un exemple concret, comparez la structure de +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, -j'�cris "``Listes_``". Si le titre comporte des espaces, il est n�cessaire -d'utiliser les doubles apostrophes invers�es "```Styles de texte```". +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, +j'écris "``Listes_``". Si le titre comporte des espaces, il est nécessaire +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 -un autre ornement unique juste apr�s le titre. +en début de document. Pour indiquer un sous-titre de document, utilisez +un autre ornement unique juste après le titre. Par exemple:: ================= @@ -379,8 +379,8 @@ ... Notez que "Titre du document" et "Titre de la section" utilisent le signe -�gal, mais sont diff�rents et sans relation. Le texte et l'ornement peuvent -�tre de la m�me taille pour des questions d'esth�tisme. +égal, mais sont différents et sans relation. Le texte et l'ornement peuvent +être de la même taille pour des questions d'esthétisme. Images @@ -392,13 +392,13 @@ .. image:: /home/letellier/PROJET/jrst2/src/site/fr/rst/user/images/biohazard.png -Le r�sultat: +Le résultat: .. 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 +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:: /home/letellier/PROJET/jrst2/src/site/fr/rst/user/image/biohazard.png @@ -407,7 +407,7 @@ :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. Documentation images : http://docutils.sourceforge.net/spec/rst/directives.html#images @@ -415,9 +415,9 @@ Et ensuite ? ------------ -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 +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 [#]_. @@ -428,13 +428,13 @@ Docutils-Users mailing list : http://lists.sourceforge.net/lists/listinfo/docutils-users Docutils project web site : http://docutils.sourceforge.net/ -Fonctionnalit�s propos�es +Fonctionnalités proposées ========================= La DTD de Docutils : http://docutils.sourceforge.net/docs/ref/doctree.html -Fonctionnalit�s implant�es +Fonctionnalités implantées -------------------------- Element racine @@ -463,7 +463,7 @@ - date - copyright -Elements de d�coration +Elements de décoration ~~~~~~~~~~~~~~~~~~~~~~ - decoration @@ -539,7 +539,7 @@ - reference - footnote_reference -Fonctionnalit�s non-implant�es +Fonctionnalités non-implantées ------------------------------ - abbreviation @@ -569,7 +569,7 @@ - title_reference -Documentation d�veloppeur +Documentation développeur ========================= Le diagramme de Class @@ -577,7 +577,7 @@ |classDiagramme| -La Class **AdvancedReader** � pour fonction de faciliter la lecture du fichier RST gr�ce � diff�rentes m�thodes : +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 @@ -585,31 +585,31 @@ ... 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()). +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. +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. +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 **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 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 +La génération ------------- |diagrammegeneration| -R�f�rence : +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 @@ -631,23 +631,23 @@ :Author: Letellier Sylvain - .. Attention:: texte � �tre r�interpr�t� comme un fichier rst ind�pendant - ceci est consid�r� comme un **paragraphe** + .. 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 : +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:: +La Classe **JRSTGenerator**, grâce au fichier XSL rst2xhtml.xsl, renvoie le fichier html suivant:: <?xml version="1.0" encoding="UTF-8"?> <html xmlns="http://www.w3.org/TR/xhtml1/strict"> <head> - <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-15"/> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/> <meta name="generator" content="JRST http://jrst.labs.libre-entreprise.org/"/> <title>Titre</title> </head> @@ -666,21 +666,21 @@ <div class="attention"> <p class="title">attention :</p> <p class="body"> - <p>texte � �tre r�interpr�t� comme un fichier rst ind�pendant - ceci est consid�r� comme un <strong>paragraphe</strong></p> + <p>texte à être réinterprété comme un fichier rst indépendant + ceci est considéré comme un <strong>paragraphe</strong></p> </p> </div> </body> </html> -Qui affiche la page (un CSS [2]_ � �t� ajout� pour la mise en forme) : +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** + .. Attention:: texte à être réinterprété comme un fichier rst indépendant + ceci est considéré comme un **paragraphe** Utilisation de XSL externe -------------------------- @@ -693,8 +693,8 @@ 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... +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 @@ -707,23 +707,23 @@ 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 -des donn�es de documents XML. XSL est lui-m�me d�fini avec le formalisme XML, cela signifie qu'une -feuille de style XSL est un document XML bien form�. +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 +des données de documents XML. XSL est lui-même défini avec le formalisme XML, cela signifie qu'une +feuille de style XSL est un document XML bien formé. -XSL est un langage permettant de d�finir des feuilles de style pour les documents XML au m�me titre que +XSL est un langage permettant de définir des feuilles de style pour les documents XML au même titre que les CSS (Cascading StyleSheets) pour le langage HTML ou bien DSSSL (Document Style Semantics and -Specification Language) pour le SGML. XSL est d'ailleurs inspir� de DSSSL dont il reprend beaucoup -de fonctionnalit�s et est compatible avec les CSS (il s'agit d'un sur-ensemble des CSS). +Specification Language) pour le SGML. XSL est d'ailleurs inspiré de DSSSL dont il reprend beaucoup +de fonctionnalités et est compatible avec les CSS (il s'agit d'un sur-ensemble des CSS). Toutefois, contrairement aux CSS, XSL permet aussi de retraiter un document XML afin d'en modifier totalement -sa structure, ce qui permet � partir d'un document XML d'�tre capable de g�n�rer d'autres types de documents -(PostScript, HTML, Tex, RTF, ...) ou bien un fichier XML de structure diff�rente. +sa structure, ce qui permet à partir d'un document XML d'être capable de générer d'autres types de documents +(PostScript, HTML, Tex, RTF, ...) ou bien un fichier XML de structure différente. -Ainsi la structuration des donn�es (d�finie par XML) et leur repr�sentation (d�finie par un langage tel que -XSL) sont s�par�es. Cela signifie qu'il est possible � partir d'un document XML de cr�er des documents -utilisant diff�rentes repr�sentations (HTML pour cr�er des pages web, WML pour les mobiles WAP, ...). +Ainsi la structuration des données (définie par XML) et leur représentation (définie par un langage tel que +XSL) sont séparées. Cela signifie qu'il est possible à partir d'un document XML de créer des documents +utilisant différentes représentations (HTML pour créer des pages web, WML pour les mobiles WAP, ...). |presentationxsl| @@ -731,52 +731,52 @@ Structure d'un document XSL --------------------------- -Un document XSL �tant un document XML, il commence obligatoirement par la balise suivante:: +Un document XSL étant un document XML, il commence obligatoirement par la balise suivante:: - <?xml version="1.0" encoding="ISO-8859-1"?> + <?xml version="1.0" encoding="UTF-8"?> D'autre part, toute feuille de style XSL est comprise entre les balises <xsl:stylesheet ...> et </xsl:stylesheet>. -La balise xsl:stylesheet encapsule des balises xsl:template d�finissant les transformations � faire subir � certains -�l�ments du document XML. +La balise xsl:stylesheet encapsule des balises xsl:template définissant les transformations à faire subir à certains +éléments du document XML. :: - <?xml version="1.0" encoding="ISO-8859-1"?> + <?xml version="1.0" encoding="UTF-8"?> <xsl:stylesheet xmlns:xsl="http://www.w3.org/TR/WD-xsl" xmlns="http://www.w3.org/TR/REC-html40" result-ns=""> <xsl:template ... > -  +  </xsl:template > </xsl:stylesheet> -Association d'une feuille XSL � un document XML +Association d'une feuille XSL à un document XML ----------------------------------------------- -Une feuille de style XSL (enregistr� dans un fichier dont l'extension est .xsl) peut �tre li�e � un document -XML (de telle mani�re � ce que le document XML utilise la feuille XSL) en ins�rant la balise suivante au d�but +Une feuille de style XSL (enregistré dans un fichier dont l'extension est .xsl) peut être liée à un document +XML (de telle manière à ce que le document XML utilise la feuille XSL) en insérant la balise suivante au début du document XML:: - <?xml version="1.0" encoding="ISO-8859-1"?> + <?xml version="1.0" encoding="UTF-8"?> <?xml-stylesheet href="fichier.xsl" type="text/xsl"?> -Les template rules (r�gles de gabarit) +Les template rules (règles de gabarit) -------------------------------------- -Les template rules sont des balises XSL permettant de d�finir des op�rations � r�aliser sur certains �l�ments -du document XML utilisant la page XSL, c'est-�-dire g�n�ralement de transformer un tag XML en au moins un tag -HTML (g�n�ralement plusieurs). +Les template rules sont des balises XSL permettant de définir des opérations à réaliser sur certains éléments +du document XML utilisant la page XSL, c'est-à-dire généralement de transformer un tag XML en au moins un tag +HTML (généralement plusieurs). Ainsi le tag XML suivant:: <personne> <nom>Pillou</nom> - <prenom>Jean-Fran�ois</prenom> + <prenom>Jean-François</prenom> </personne> <personne> <nom>VanHaute</nom> @@ -787,41 +787,41 @@ <prenom>Seb</prenom> </personne> -pourra �tre transform� en les tags HTML suivants:: +pourra être transformé en les tags HTML suivants:: <ul> - <li>Pillou - Jean-Fran�ois</li> + <li>Pillou - Jean-François</li> <li>VanHaute - Nico</li> <li>Andrieu - Seb</li> </ul> -L'attribut "match" de la balise <xsl:template> permet de d�finir (gr�ce � la notation XPath) le ou les �l�ments +L'attribut "match" de la balise <xsl:template> permet de définir (grâce à la notation XPath) le ou les éléments du document XML sur lesquels s'applique la transformation. -La notation Xpath permet de d�finir des patterns, c'est-�-dire des cha�nes de caract�res permettant de rep�rer +La notation Xpath permet de définir des patterns, c'est-à-dire des chaînes de caractères permettant de repérer un noeud dans le document XML. Les principaux patterns sont : ======= ============= ================================================================= Pattern Exemple Signification ======= ============= ================================================================= ``|`` Gauche|Milieu Indique une alternative (un noeud ou bien l'autre (ou les deux)) -/ personne/nom Chemin d'acc�s aux �l�ments (personne/bras/gauche) -* * Motif "joker" d�signant n'importe quel �l�ment +/ personne/nom Chemin d'accès aux éléments (personne/bras/gauche) +* * Motif "joker" désignant n'importe quel élément // //personne Indique tous les descendants d'un noeud -. . Caract�rise le noeud courant -``..`` ``..`` D�signe le noeud parent -@ @valeur Indique un attribut caract�ristique +. . Caractérise le noeud courant +``..`` ``..`` Désigne le noeud parent +@ @valeur Indique un attribut caractéristique ======= ============= ================================================================= -La transformation peut �tre r�alis�e : +La transformation peut être réalisée : - soit par ajout de texte, -- soit en d�finissant des �l�ments de transformation, c'est-�-dire des �l�ments permettant de d�finir - des r�gles de transformation � appliquer aux �l�ments s�lectionn�s par l'attribut match +- soit en définissant des éléments de transformation, c'est-à-dire des éléments permettant de définir + des règles de transformation à appliquer aux éléments sélectionnés par l'attribut match -Voici un exemple de feuille XSL permettant d'effectuer la transformation XML vers HTML d�crite ci-dessus:: +Voici un exemple de feuille XSL permettant d'effectuer la transformation XML vers HTML décrite ci-dessus:: - <?xml version="1.0" encoding="ISO-8859-1"?> + <?xml version="1.0" encoding="UTF-8"?> <xsl:stylesheet xmlns:xsl="http://www.w3.org/TR/WD-xsl" xmlns="http://www.w3.org/TR/REC-html40" @@ -850,29 +850,29 @@ Voici la signification de cette feuille XSL : -* Le premier tag <xsl:template> permet d'appliquer une transformation � l'ensemble du document (la valeur - "/" de l'attribut match indique l'�l�ment racine du document XML). Ce tag contient des balises HTML qui - seront transmises dans l'arbre r�sultat. -* L'�l�ment <xsl:apply-templates/> indique le traitement de tous les enfants directs de la racine. -* La balise <xsl:template match="personne"> permet d'aller traiter les �l�ments de type personne. -* Enfin les deux �l�ments <xsl:value-of select="nom"/> et <xsl:value-of select="prenom"/> permettent de +* Le premier tag <xsl:template> permet d'appliquer une transformation à l'ensemble du document (la valeur + "/" de l'attribut match indique l'élément racine du document XML). Ce tag contient des balises HTML qui + seront transmises dans l'arbre résultat. +* L'élément <xsl:apply-templates/> indique le traitement de tous les enfants directs de la racine. +* La balise <xsl:template match="personne"> permet d'aller traiter les éléments de type personne. +* Enfin les deux éléments <xsl:value-of select="nom"/> et <xsl:value-of select="prenom"/> permettent de recuperer les valeurs des balises nom et prenom. -R�f�rences +Références ---------- - Article : http://www.commentcamarche.net/xml/xmlxsl.php3 -- Sch�ma : http://fr.wikipedia.org/wiki/Extended_stylesheet_language_transformations +- Schéma : http://fr.wikipedia.org/wiki/Extended_stylesheet_language_transformations .. |presentationxsl| image:: images/presentationXSL.png -Les diff�rentes librairies utilis�es +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 +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 et Xalan @@ -888,7 +888,7 @@ Xmlunit ------- -Xmlunit permet de comparer deux fichiers XML pour mettre en �vidences les diff�rences. +Xmlunit permet de comparer deux fichiers XML pour mettre en évidences les différences. dom4j : http://www.dom4j.org @@ -910,6 +910,6 @@ Un XSL permettant de convertir le XML en RST : http://www.merten-home.de/FreeSoftware/xml2rst/ -Pour la g�n�ration de la javaDoc en RST : http://java.sun.com/j2se/1.3/docs/tooldocs/javadoc/overview.html +Pour la génération de la javaDoc en RST : http://java.sun.com/j2se/1.3/docs/tooldocs/javadoc/overview.html Modified: trunk/jrst2/src/test/org/codelutin/jrst/test4.rst =================================================================== --- trunk/jrst2/src/test/org/codelutin/jrst/test4.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/test/org/codelutin/jrst/test4.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -1,5 +1,5 @@ ===================================== -Tutoriel pour la cr�ation d'un module +Tutoriel pour la création d'un module ===================================== :Author: Ruchaud Julien <ruchaud(a)codelutin.com> @@ -12,33 +12,33 @@ Exemple ------- -Ce tutoriel montre le d�veloppement d'un module en reprenant les diff�rentes parties de la documentation d�veloppeur. L'exemple trait� est la gestion �lectronique de documents. Le module GED est limit� � un mod�le super simple. +Ce tutoriel montre le développement d'un module en reprenant les différentes parties de la documentation développeur. L'exemple traité est la gestion électronique de documents. Le module GED est limité à un modèle super simple. -Les fonctionnalit�s du module GED sont les suivantes : +Les fonctionnalités du module GED sont les suivantes : - Ajout/Suppression de documents - Visualisation de la liste des documents -Les diff�rents fichiers de notre module seront r�partis dans les r�pertoires suivants : +Les différents fichiers de notre module seront répartis dans les répertoires suivants : -- pour le mod�le : /src/xmi +- pour le modèle : /src/xmi - pour la vue : /src/webapp/WEB-INF/ged -- pour le contr�leur : /src/java/web/mentawai/ged +- pour le contrôleur : /src/java/web/mentawai/ged -Mod�le +Modèle ------ -Etape 1 : Cr�ation du mod�le sur ArgoUML +Etape 1 : Création du modèle sur ArgoUML ++++++++++++++++++++++++++++++++++++++++ -Le mod�le est le plus simple possible, il ne comporte qu'une seule classe, Document. Elle d�finie un document avec son nom et sa description. +Le modèle est le plus simple possible, il ne comporte qu'une seule classe, Document. Elle définie un document avec son nom et sa description. :: +----------------------------------+ - | �entity� | + | «entity» | | Document | +----------------------------------+ | name : String | @@ -47,14 +47,14 @@ | getNameAndDescription() : String | +----------------------------------+ -Le mod�le est � cr�er dans le fichier /src/xmi/chorem.zargo dans le paquetage org.codelutin.chorem.entities.ged. On remarque que la classe porte le st�r�otype Entity, ceci permet d'indiquer que Topia se chargera de la g�n�ration de cette classe ainsi que de sa persistance. +Le modèle est à créer dans le fichier /src/xmi/chorem.zargo dans le paquetage org.codelutin.chorem.entities.ged. On remarque que la classe porte le stéréotype Entity, ceci permet d'indiquer que Topia se chargera de la génération de cette classe ainsi que de sa persistance. -Etape 2 : G�n�ration du code avec ToPIA +Etape 2 : Génération du code avec ToPIA +++++++++++++++++++++++++++++++++++++++ -Le plugin Maven 2 Generator se charge de lancer la g�n�ration de ToPIA. Par la commande "mvn compile", nous lan�ons la compilation du projet ainsi que la g�n�ration ToPIA. Nous obtenons les classes Java et les fichiers de mapping Hibernate dans le r�pertoire /src/gen/java/org/codelutin/chorem/entities/ged. -Le projet ne compile pas car il ne trouve pas l'impl�mentation des m�thodes du mod�le : +Le plugin Maven 2 Generator se charge de lancer la génération de ToPIA. Par la commande "mvn compile", nous lançons la compilation du projet ainsi que la génération ToPIA. Nous obtenons les classes Java et les fichiers de mapping Hibernate dans le répertoire /src/gen/java/org/codelutin/chorem/entities/ged. +Le projet ne compile pas car il ne trouve pas l'implémentation des méthodes du modèle : :: @@ -64,10 +64,10 @@ location: package org.codelutin.chorem.entities.ged -Etape 3 : Impl�mentation des m�thodes +Etape 3 : Implémentation des méthodes +++++++++++++++++++++++++++++++++++++ -Les m�thodes contenues dans le mod�le n'�tant pas impl�ment�es, il est maintenant n�cessaire de les compl�ter. Elles sont a compl�ter dans le r�pertoire /src/java/org/codelutin/chorem/entities/ged et porte comme nom, le nom de classe avec le suffixe "Impl". Elle doivent h�riter de sa classe abstraite et impl�menter son interface. +Les méthodes contenues dans le modèle n'étant pas implémentées, il est maintenant nécessaire de les complèter. Elles sont a compléter dans le répertoire /src/java/org/codelutin/chorem/entities/ged et porte comme nom, le nom de classe avec le suffixe "Impl". Elle doivent hériter de sa classe abstraite et implémenter son interface. :: @@ -83,7 +83,7 @@ Etape 4 : Modification des classes de persistances ++++++++++++++++++++++++++++++++++++++++++++++++++ -La propri�t� topia.persistence.classes dans le fichier /src/ressources/TopiaContextImpl.properties doit contenir la classe Document. +La propriété topia.persistence.classes dans le fichier /src/ressources/TopiaContextImpl.properties doit contenir la classe Document. :: @@ -94,26 +94,26 @@ --- -Etape 5 : D�claration du module au niveau du Layout +Etape 5 : Déclaration du module au niveau du Layout +++++++++++++++++++++++++++++++++++++++++++++++++++ -Il faut d�clarer le nom du module dans les fichiers de langue dans le r�pertoire /src/webapp/WEB-INF/common/lang. +Il faut déclarer le nom du module dans les fichiers de langue dans le répertoire /src/webapp/WEB-INF/common/lang. :: ged = GED -Apr�s, il faut ajouter le module dans l'ent�te, fichier /src/webapp/WEB-INF/common/layout/layout.jsp, pour pouvoir donner l'acc�s � celui-ci. +Après, il faut ajouter le module dans l'entête, fichier /src/webapp/WEB-INF/common/layout/layout.jsp, pour pouvoir donner l'accès à celui-ci. :: | <a class="Link" href="${path}/ged.mtw"><fmt:message key="ged" bundle="${commonBundle}"/></a> -Etape 6 : Cr�ation du menu +Etape 6 : Création du menu ++++++++++++++++++++++++++ -Chaque module a son propre menu. Il faut cr�er le fichier /src/webapp/ged/common/menu.jsp pour ajouter un menu au module GED. +Chaque module a son propre menu. Il faut créer le fichier /src/webapp/ged/common/menu.jsp pour ajouter un menu au module GED. :: @@ -129,15 +129,15 @@ <jsp:include page="${common}/layout/tabSpace.jsp"/> -Etape 7 : Cr�ation des pages +Etape 7 : Création des pages ++++++++++++++++++++++++++++ -Il faut cr�er les pages JSP de visualisation du module. Quelques r�gles sont � respecter : - 1. Il faut toujours regarder et recopier ce qui a �t� fait. - 2. Tous les formulaires doivent �tre cr��s avec le tag chorem:action. - 3. Aucun texte doit �tre fixe dans la page, il faut utiliser fmt:message. +Il faut créer les pages JSP de visualisation du module. Quelques règles sont à respecter : + 1. Il faut toujours regarder et recopier ce qui a été fait. + 2. Tous les formulaires doivent être créés avec le tag chorem:action. + 3. Aucun texte doit être fixe dans la page, il faut utiliser fmt:message. -Les deux fichiers sont stock�s dans le r�pertoire /src/webapp/ged/document. +Les deux fichiers sont stockés dans le répertoire /src/webapp/ged/document. Le fichier list.jsp permet de visualiser la liste des documents : @@ -221,10 +221,10 @@ Etape 8 : Internationalisation ++++++++++++++++++++++++++++++ -Pour finir les pages jsp, il faut cr�er les fichiers de langue dans le r�pertoire /src/webapp/WEB-INF/ged/common/lang. De plus, il faut rajouter ce r�pertoire comme ressource dans le pom.xml de Maven. +Pour finir les pages jsp, il faut créer les fichiers de langue dans le répertoire /src/webapp/WEB-INF/ged/common/lang. De plus, il faut rajouter ce répertoire comme ressource dans le pom.xml de Maven. -Fichier de langue pour le fran�ais est ged_fr.properties, il contient : +Fichier de langue pour le français est ged_fr.properties, il contient : :: @@ -243,23 +243,23 @@ document.form.name = Nom : document.form.description = Description : -G�n�ralement les cl�s sont de la forme suivante : "nom de l'entit�"."nom de la page"."nom de l'�l�ment" = ... +Généralement les clés sont de la forme suivante : "nom de l'entité"."nom de la page"."nom de l'élément" = ... -Le bundle commun (${commonBundle}) contient l'ensemble des traductions transversales � tous les modules. +Le bundle commun (${commonBundle}) contient l'ensemble des traductions transversales à tous les modules. -Contr�leur +Contrôleur ---------- -Etape 9 : Cr�ation des actions +Etape 9 : Création des actions ++++++++++++++++++++++++++++++ -Quatres actions sont toujours cr�er pour chaque entit�s du mod�le, elles permettent les manipulations de base. Elles sont stock�es dans le package actions du module. +Quatres actions sont toujours créer pour chaque entités du modèle, elles permettent les manipulations de base. Elles sont stockées dans le package actions du module. -Ces actions vont �tre n�cessaire pour notre exemple les voici, elle doit �tre dans src/java/org/codelutin/chorem/web/mentawai/ged/action/document : +Ces actions vont être nécessaire pour notre exemple les voici, elle doit être dans src/java/org/codelutin/chorem/web/mentawai/ged/action/document : -DocumentFindId.java, permet de rechercher un document par rapport � son identifiant : +DocumentFindId.java, permet de rechercher un document par rapport à son identifiant : :: @@ -271,7 +271,7 @@ } } -DocumentFindAll.java, permet de r�cup�rer l'ensemble des documents : +DocumentFindAll.java, permet de récupérer l'ensemble des documents : :: @@ -282,7 +282,7 @@ } } -DocumentUpdate.java, permet de cr�er et de modifier un document : +DocumentUpdate.java, permet de créer et de modifier un document : :: @@ -317,10 +317,10 @@ } -Etape 10 : Cr�ation du Manageur +Etape 10 : Création du Manageur +++++++++++++++++++++++++++++++ -Le manageur centralise l'ensemble des urls, des pages et des cas d'utilisation avec les actions associ�es. Pour la GED la classe � cr�er est src/java/org/codelutin/chorem/web/mentawai/ged/Manager.java : +Le manageur centralise l'ensemble des urls, des pages et des cas d'utilisation avec les actions associées. Pour la GED la classe à créer est src/java/org/codelutin/chorem/web/mentawai/ged/Manager.java : :: @@ -340,26 +340,26 @@ createFirstLine(DOCUMENT_MODIFY, SuccessAction.class); createFirstLine(DOCUMENT_STORE, DocumentUpdate.class); createFirstLine(DOCUMENT_CANCEL, SuccessAction.class); - // JSP et actions li�es + // JSP et actions liées createLastLine(DOCUMENT_LIST_JSP, DocumentFindAll.class); createLastLine(DOCUMENT_FORM_JSP, DocumentFindId.class); } } -Etape 11 : Cr�ation des cas d'utilisation +Etape 11 : Création des cas d'utilisation +++++++++++++++++++++++++++++++++++++++++ -Il faut maintenant cr�er les cas d'utilisation. Pour notre module, un seul suffit, aucune page ne pr�sente de comportements diff�rents. La classe � cr�er est src/java/org/codelutin/chorem/web/mentawai/ged/usecase/DocumentUseCase.java : +Il faut maintenant créer les cas d'utilisation. Pour notre module, un seul suffit, aucune page ne présente de comportements différents. La classe à créer est src/java/org/codelutin/chorem/web/mentawai/ged/usecase/DocumentUseCase.java : :: public class DocumentUseCase extends UseCase { public String general() throws Exception { - // En partant de la liste des docs on retourne sur cette liste en supprimant un doc ou on acc�de au formulaire de cr�ation + // En partant de la liste des docs on retourne sur cette liste en supprimant un doc ou on accède au formulaire de création accessPoint(DOCUMENT_LIST_JSP).move(DOCUMENT_DEL, DOCUMENT_LIST_JSP).move(DOCUMENT_NEW, DOCUMENT_FORM_JSP); - // En partant du formulaire de cr�ation on retourne � la liste des docs en validant la cr�ation ou en l'annulant + // En partant du formulaire de création on retourne à la liste des docs en validant la création ou en l'annulant access(DOCUMENT_FORM_JSP, "documentId").move(DOCUMENT_CANCEL, DOCUMENT_LIST_JSP).move(DOCUMENT_STORE, DOCUMENT_LIST_JSP); return super.execute(); @@ -383,10 +383,10 @@ } -Etape 12 : D�claration du module +Etape 12 : Déclaration du module ++++++++++++++++++++++++++++++++ -Il est n�cessaire d'ajouter le chargement du manageur du module GED dans le manageur global de Chorem (src/java/org/codelutin/chorem/web/mentawai/Manager.java) : +Il est nécessaire d'ajouter le chargement du manageur du module GED dans le manageur global de Chorem (src/java/org/codelutin/chorem/web/mentawai/Manager.java) : :: @@ -398,7 +398,7 @@ ---- -Etape 13 : D�marrer Chorem +Etape 13 : Démarrer Chorem ++++++++++++++++++++++++++ Modified: trunk/jrst2/src/test/org/codelutin/jrst/text.rst =================================================================== --- trunk/jrst2/src/test/org/codelutin/jrst/text.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/test/org/codelutin/jrst/text.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -264,12 +264,12 @@ -.. Attention:: Derri�re toi c'est horrible ! +.. Attention:: Derrière toi c'est horrible ! .. admonition:: Ceci est un avertissement. - Je vous demande de vous arr�tez. + Je vous demande de vous arrêtez. BLOCK QUOTE ----------- Modified: trunk/jrst2/src/test/org/codelutin/jrst/textEntier.rst =================================================================== --- trunk/jrst2/src/test/org/codelutin/jrst/textEntier.rst 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/jrst2/src/test/org/codelutin/jrst/textEntier.rst 2008-08-05 08:35:30 UTC (rev 177) @@ -18,7 +18,7 @@ de null part avec meme un para -:copyright: � 2007. JRST - Code Lutin - GPL +:copyright: © 2007. JRST - Code Lutin - GPL ------------------ @@ -274,12 +274,12 @@ -.. Attention:: Derri�re toi c'est horrible ! +.. Attention:: Derrière toi c'est horrible ! .. admonition:: Ceci est un avertissement. - Je vous demande de vous arr�tez. + Je vous demande de vous arrêtez. BLOCK QUOTE ----------- Deleted: trunk/maven-jrst-plugin/.classpath =================================================================== --- trunk/maven-jrst-plugin/.classpath 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/maven-jrst-plugin/.classpath 2008-08-05 08:35:30 UTC (rev 177) @@ -1,32 +0,0 @@ -<classpath> - <classpathentry kind="src" path="src/java"/> - <classpathentry kind="src" path="src/test" output="target/test-classes"/> - <classpathentry kind="output" path="target/classes"/> - <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/> - <classpathentry kind="var" path="M2_REPO/lutinlib/lutinutil/0.23/lutinutil-0.23.jar"/> - <classpathentry kind="var" path="M2_REPO/org/apache/maven/maven-plugin-api/2.0.4/maven-plugin-api-2.0.4.jar"/> - <classpathentry kind="var" path="M2_REPO/lutinlib/jrst/0.7/jrst-0.7.jar"/> - <classpathentry kind="var" path="M2_REPO/xalan/xalan/2.7.0/xalan-2.7.0.jar"/> - <classpathentry kind="var" path="M2_REPO/xml-apis/xml-apis/1.0.b2/xml-apis-1.0.b2.jar"/> - <classpathentry kind="var" path="M2_REPO/lutinlib/lutinxml/0.7/lutinxml-0.7.jar"/> - <classpathentry kind="var" path="M2_REPO/jewelcli/jewelcli/0.41/jewelcli-0.41.jar"/> - <classpathentry kind="var" path="M2_REPO/xom/xom/1.0b3/xom-1.0b3.jar"/> - <classpathentry kind="var" path="M2_REPO/javax/servlet/servlet-api/2.3/servlet-api-2.3.jar"/> - <classpathentry kind="var" path="M2_REPO/nwalsh/docbook-xsl-nwalsh/1.71.1/docbook-xsl-nwalsh-1.71.1.jar"/> - <classpathentry kind="var" path="M2_REPO/xerces/xmlParserAPIs/2.6.2/xmlParserAPIs-2.6.2.jar"/> - <classpathentry kind="var" path="M2_REPO/commons-primitives/commons-primitives/1.0/commons-primitives-1.0.jar"/> - <classpathentry kind="var" path="M2_REPO/commons-lang/commons-lang/2.1/commons-lang-2.1.jar"/> - <classpathentry kind="var" path="M2_REPO/jdom/jdom/1.0/jdom-1.0.jar"/> - <classpathentry kind="var" path="M2_REPO/junit/junit/3.8.1/junit-3.8.1.jar"/> - <classpathentry kind="var" path="M2_REPO/commons-collections/commons-collections/3.1/commons-collections-3.1.jar"/> - <classpathentry kind="var" path="M2_REPO/org/ccil/cowan/tagsoup/tagsoup/0.9.7/tagsoup-0.9.7.jar"/> - <classpathentry kind="var" path="M2_REPO/avalon-framework/avalon-framework/4.1.3/avalon-framework-4.1.3.jar"/> - <classpathentry kind="var" path="M2_REPO/xerces/xercesImpl/2.6.2/xercesImpl-2.6.2.jar"/> - <classpathentry kind="var" path="M2_REPO/log4j/log4j/1.2.12/log4j-1.2.12.jar"/> - <classpathentry kind="var" path="M2_REPO/commons-logging/commons-logging/1.1/commons-logging-1.1.jar"/> - <classpathentry kind="var" path="M2_REPO/ant/ant/1.6.5/ant-1.6.5.jar"/> - <classpathentry kind="var" path="M2_REPO/dom4j/dom4j/1.6.1/dom4j-1.6.1.jar"/> - <classpathentry kind="var" path="M2_REPO/logkit/logkit/1.0.1/logkit-1.0.1.jar"/> - <classpathentry kind="var" path="M2_REPO/jaxen/jaxen/1.1-beta-6/jaxen-1.1-beta-6.jar"/> - <classpathentry kind="var" path="M2_REPO/com/ibm/icu/icu4j/2.6.1/icu4j-2.6.1.jar"/> -</classpath> \ No newline at end of file Deleted: trunk/maven-jrst-plugin/.project =================================================================== --- trunk/maven-jrst-plugin/.project 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/maven-jrst-plugin/.project 2008-08-05 08:35:30 UTC (rev 177) @@ -1,14 +0,0 @@ -<projectDescription> - <name>maven-jrst-plugin</name> - <comment>Plugin pour maven 2 pour la gÃ©nÃ©ration de xdoc Ã partir de fichier Rst.</comment> - <projects/> - <buildSpec> - <buildCommand> - <name>org.eclipse.jdt.core.javabuilder</name> - <arguments/> - </buildCommand> - </buildSpec> - <natures> - <nature>org.eclipse.jdt.core.javanature</nature> - </natures> -</projectDescription> \ No newline at end of file Modified: trunk/maven-jrst-plugin/doc/index.rst =================================================================== (Binary files differ) Modified: trunk/maven-jrst-plugin/pom.xml =================================================================== --- trunk/maven-jrst-plugin/pom.xml 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/maven-jrst-plugin/pom.xml 2008-08-05 08:35:30 UTC (rev 177) @@ -1,128 +1,146 @@ <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" - xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> + xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> -  - <modelVersion>4.0.0</modelVersion> - -   -  +  + <modelVersion>4.0.0</modelVersion> -  - <groupId>lutinplugin</groupId> - <artifactId>maven-jrst-plugin</artifactId> - <name>Plugin maven JRst</name> - -  - <packaging>maven-plugin</packaging> - -  - <version>0.8.1-SNAPSHOT</version> - -  - <description> - Plugin pour maven 2 pour la génération de xdoc à partir de fichier Rst. - </description> - <inceptionYear>2006</inceptionYear> - +   +  - - <build> - <sourceDirectory>${maven.src.dir}/java</sourceDirectory> - <testSourceDirectory>${maven.src.dir}/test</testSourceDirectory> - </build> - <distributionManagement> - <repository> - <id>labs</id> - <url>scp://labs.libre-entreprise.org/home/groups/lutinbuilder/htdocs/maven2</url> - </repository> - - <site> - <id>labs</id> - <url>scp://labs.libre-entreprise.org/home/groups/jrst/htdocs/${pom.artifactId}</url> - </site> - </distributionManagement> - +  + <groupId>lutinplugin</groupId> + <artifactId>maven-jrst-plugin</artifactId> + <name>Plugin maven JRst</name> - -  - <issueManagement> - <url>http://labs.libre-entreprise.org/tracker/?group_id=54</url> - </issueManagement> - -  - <contributors> - <contributor> - <name>Julien Ruchaud</name> - <email>ruchaud(a)codelutin.com</email> - <organization>Code Lutin</organization> - <timezone>+2</timezone> - <roles> - <role>Développeur</role> - </roles> - </contributor> - </contributors> - -  - <dependencies> - <dependency> - <groupId>org.apache.maven</groupId> - <artifactId>maven-plugin-api</artifactId> - <version>2.0.7</version> - <scope>compile</scope> - </dependency> - - <dependency> - <groupId>org.apache.ant</groupId> - <artifactId>ant</artifactId> - <version>1.7.0</version> - <scope>compile</scope> - </dependency> +  + <packaging>maven-plugin</packaging> - <dependency> - <groupId>lutinlib</groupId> - <artifactId>jrst</artifactId> - <version>[0.8,)</version> - <scope>compile</scope> - </dependency> - </dependencies> - - - <mailingLists> - <mailingList> - <name>jrst-cvscomit</name> +  + <version>0.8.1-SNAPSHOT</version> + +  + <description> + Plugin pour maven 2 pour la génération de xdoc à partir de fichier Rst. + </description> + <inceptionYear>2006</inceptionYear> + + <properties> +  + <maven.test.skip>true</maven.test.skip> + +  + <maven.src.dir>${basedir}/src</maven.src.dir> + +  + <maven.compile.source>1.5</maven.compile.source> + <maven.compile.target>1.5</maven.compile.target> + </properties> + +  + <build> + <sourceDirectory>${maven.src.dir}/java</sourceDirectory> + <testSourceDirectory>${maven.src.dir}/test</testSourceDirectory> + </build> + <distributionManagement> + <repository> + <id>labs</id> + <url>scp://labs.libre-entreprise.org/home/groups/lutinbuilder/htdocs/maven2</url> + </repository> + + <site> + <id>labs</id> + <url>scp://labs.libre-entreprise.org/home/groups/jrst/htdocs/${pom.artifactId}</url> + </site> + </distributionManagement> +  + + +  + <issueManagement> + <url>http://labs.libre-entreprise.org/tracker/?group_id=54</url> + </issueManagement> + +  + <contributors> + <contributor> + <name>Julien Ruchaud</name> + <email>ruchaud(a)codelutin.com</email> + <organization>Code Lutin</organization> + <timezone>+2</timezone> + <roles> + <role>Développeur</role> + </roles> + </contributor> + </contributors> + +  + <dependencies> + <dependency> + <groupId>org.apache.maven</groupId> + <artifactId>maven-plugin-api</artifactId> + <version>2.0.7</version> + <scope>compile</scope> + </dependency> + + <dependency> + <groupId>org.apache.maven</groupId> + <artifactId>maven-project</artifactId> + <version>2.0.4</version> + <scope>compile</scope> + </dependency> + + <dependency> + <groupId>org.apache.ant</groupId> + <artifactId>ant</artifactId> + <version>1.7.0</version> + <scope>compile</scope> + </dependency> + + <dependency> + <groupId>lutinlib</groupId> + <artifactId>jrst</artifactId> + <version>[0.8,)</version> + <scope>compile</scope> + </dependency> + </dependencies> + +  + <mailingLists> + <mailingList> + <name>jrst-cvscomit</name> <subscribe>http://lists.labs.libre-entreprise.org/mailman/listinfo/jrst-cvscommit</subscribe> - <unsubscribe>http://lists.labs.libre-entreprise.org/mailman/listinfo/jrst-cvscommit</unsubscribe> - <archive>http://lists.labs.libre-entreprise.org/pipermail/jrst-cvscommit/</archive> - </mailingList> - - <mailingList> - <name>jrst-devel</name> - <subscribe>http://lists.labs.libre-entreprise.org/mailman/listinfo/jrst-devel</subscribe> - <unsubscribe>http://lists.labs.libre-entreprise.org/mailman/listinfo/jrst-devel</unsubscribe> - <archive>http://lists.labs.libre-entreprise.org/pipermail/jrst-devel/</archive> - </mailingList> - - <mailingList> - <name>jrst-user</name> - <subscribe>http://lists.labs.libre-entreprise.org/mailman/listinfo/jrst-user</subscribe> - <unsubscribe>http://lists.labs.libre-entreprise.org/mailman/listinfo/jrst-user</unsubscribe> - <archive>http://lists.labs.libre-entreprise.org/pipermail/jrst-user/</archive> - </mailingList> - </mailingLists> + <unsubscribe>http://lists.labs.libre-entreprise.org/mailman/listinfo/jrst-cvscommit</unsubscribe> + <archive>http://lists.labs.libre-entreprise.org/pipermail/jrst-cvscommit/</archive> + </mailingList> - <scm> - <url>http://cvs.labs.libre-entreprise.org/cgi-bin/cvsweb.cgi/?cvsroot=jrst</url> - <connection>scm:cvs:pserver:anonymous@cvs.labs.libre-entreprise.org:/cvsroot/jrst:${pom.artifactId}</connection> - </scm> - + <mailingList> + <name>jrst-devel</name> + <subscribe>http://lists.labs.libre-entreprise.org/mailman/listinfo/jrst-devel</subscribe> + <unsubscribe>http://lists.labs.libre-entreprise.org/mailman/listinfo/jrst-devel</unsubscribe> + <archive>http://lists.labs.libre-entreprise.org/pipermail/jrst-devel/</archive> + </mailingList> + <mailingList> + <name>jrst-user</name> + <subscribe>http://lists.labs.libre-entreprise.org/mailman/listinfo/jrst-user</subscribe> + <unsubscribe>http://lists.labs.libre-entreprise.org/mailman/listinfo/jrst-user</unsubscribe> + <archive>http://lists.labs.libre-entreprise.org/pipermail/jrst-user/</archive> + </mailingList> + </mailingLists> + + <scm> + <url>http://cvs.labs.libre-entreprise.org/cgi-bin/cvsweb.cgi/?cvsroot=jrst</url> + <connection>scm:cvs:pserver:anonymous@cvs.labs.libre-entreprise.org:/cvsroot/jrst:${pom.artifactId}</connection> + </scm> +  + </project> Deleted: trunk/maven-jrst-plugin/profiles.xml =================================================================== --- trunk/maven-jrst-plugin/profiles.xml 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/maven-jrst-plugin/profiles.xml 2008-08-05 08:35:30 UTC (rev 177) @@ -1,24 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<settings> - <profiles> - <profile> - <id>project</id> - - <activation> - <activeByDefault>true</activeByDefault> - </activation> - - <properties> -  - <maven.test.skip>true</maven.test.skip> - -  - <maven.src.dir>${basedir}/src</maven.src.dir> - -  - <maven.compile.source>1.5</maven.compile.source> - <maven.compile.target>1.5</maven.compile.target> - </properties> - </profile> - </profiles> -</settings> Modified: trunk/maven-jrst-plugin/src/java/org/codelutin/jrst/plugin/JRstPlugin.java =================================================================== --- trunk/maven-jrst-plugin/src/java/org/codelutin/jrst/plugin/JRstPlugin.java 2008-08-04 07:16:33 UTC (rev 176) +++ trunk/maven-jrst-plugin/src/java/org/codelutin/jrst/plugin/JRstPlugin.java 2008-08-05 08:35:30 UTC (rev 177) @@ -1,6 +1,6 @@ /* *##% * Copyright (C) 2006 - * Code Lutin, Cédric Pineau, Benjamin Poussin + * Code Lutin, CÃ©dric Pineau, Benjamin Poussin * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License @@ -31,123 +31,115 @@ package org.codelutin.jrst.plugin; -import java.io.File; -import java.io.IOException; - import org.apache.maven.plugin.AbstractMojo; import org.apache.maven.plugin.MojoExecutionException; import org.apache.maven.project.MavenProject; -import org.apache.tools.ant.BuildLogger; -import org.apache.tools.ant.NoBannerLogger; -import org.apache.tools.ant.Project; -import org.apache.tools.ant.taskdefs.Copy; -import org.apache.tools.ant.types.FileSet; import org.codelutin.jrst.JRST; import org.codelutin.util.FileUtil; import org.codelutin.util.FileUtil.FileAction; +import java.io.File; +import java.io.IOException; + /** - * Génére du xdoc à partir de fichiers Rst - * + * GÃ©nÃ©re du xdoc Ã partir de fichiers Rst + * <p/> * Les fichiers rst sont dans les repertoires: * <li> src/site/fr/rst/ * <li> src/site/en/rst/ * <li> src/site/es/rst/ * <li> ... - * + * <p/> * et ils iront au final dans: * <li> target/site-build/fr/xdoc/ * <li> target/site-build/en/xdoc/ * <li> target/site-build/es/xdoc/ * <li> ... - * + * <p/> * tous les autres fichiers iront dans target/site-build en respectant la * meme hierarchie de repertoire. - * + * * @goal jrst * @phase pre-site */ -public class JRstPlugin extends AbstractMojo implements FileAction { +public class JRstPlugin extends AbstractMojo implements FileAction { /** - * R�pertoire source des fichiers Rst - * + * Répertoire source des fichiers Rst + * * @parameter default-value="src/site" * @required */ private String directoryIn = "src/site"; - + /** - * Encoding en entr�e - * - * @parameter default-value="ISO-8859-15" + * Encoding en entrée + * + * @parameter default-value="UTF-8" */ - private String inputEncoding = "ISO-8859-15"; + private String inputEncoding = "UTF-8"; /** * Encoding en sortie - * - * @parameter default-value="ISO-8859-15" + * + * @parameter default-value="UTF-8" */ - private String outputEncoding = "ISO-8859-15"; - + private String outputEncoding = "UTF-8"; + /** - * Répertoire cible des fichiers xdoc générée - * + * RÃ©pertoire cible des fichiers xdoc gÃ©nÃ©rÃ©e + * * @parameter default-value="target/site-build" * @required */ private String directoryOut = "target/site-build"; /** - * Arr�te la g�n�ration en cas d'erreurs - * + * Arrï¿½te la gï¿½nï¿½ration en cas d'erreurs + * * @parameter default-value="true" */ private boolean ignoreErrors = true; - + /** - * Ecrase les fichiers g�n�r�s - * + * Ecrase les fichiers gï¿½nï¿½rï¿½s + * * @parameter default-value="ifnewer" */ private String overwrite = "ifnewer"; - - /** - * - * @parameter default-value="fr" - */ + + /** @parameter default-value="fr" */ private String defaultLocale = "fr"; - + /** * Permet d'obtenir plus d'information - * + * * @parameter default-value="false" */ private boolean verbose = false; - + /** - * Projet en cours de deploiement. - * @parameter expression="${project}" - */ + * Projet en cours de deploiement. + * + * @parameter expression="${project}" + */ private MavenProject project; - + private int numberFilesGenerates; - + /** - * Retourne la langue par defaut precisé dans le pom.xml + * Retourne la langue par defaut precisÃ© dans le pom.xml + * * @return */ protected String getDefaultLocale() { String result = defaultLocale; return result; } - - /** - * @return the overwrite - */ + + /** @return the overwrite */ public JRST.Overwrite getOverwrite() { - JRST.Overwrite result = JRST.Overwrite.NEVER; + JRST.Overwrite result = JRST.Overwrite.NEVER; if (this.overwrite.contains("new")) { result = JRST.Overwrite.IFNEWER; } else if ("true".equalsIgnoreCase(this.overwrite) || @@ -156,63 +148,63 @@ } return result; } - + public void execute() throws MojoExecutionException { try { actionGenerate(); } catch (GenerationJRstException e) { - System.out.println("Error during generation for :\n" + System.out.println("Error during generation for :\n" + GenerationJRstException.getFilesErrors()); - if(!ignoreErrors) + if (!ignoreErrors) throw new MojoExecutionException("Erreur lors de l'execution"); } actionCopy(); } - - private void actionGenerate(){ - getLog().info("Génération des fichier xdocs à partir des fichiers rst"); + + private void actionGenerate() { + getLog().info("GÃ©nÃ©ration des fichier xdocs Ã partir des fichiers rst"); numberFilesGenerates = 0; FileUtil.walkAfter(new File(directoryIn), this); getLog().info("Generating " + numberFilesGenerates + " files to " + directoryOut); } - + public boolean doAction(File file) { String fileIn = file.getAbsoluteFile().toString(); String fileOut = null; getLog().info("Using " + fileIn); if (fileIn.matches(".*[/\\\\]rst[/\\\\].*\\.rst")) { - fileOut = - fileIn.replace(directoryIn, directoryOut) - .replace(".rst",".xml") - .replaceFirst("([/\\\\])rst([/\\\\])", "$1xdoc$2"); + fileOut = + fileIn.replace(directoryIn, directoryOut) + .replace(".rst", ".xml") + .replaceFirst("([/\\\\])rst([/\\\\])", "$1xdoc$2"); if (defaultLocale != null && !"".equals(defaultLocale)) { fileOut = fileOut.replaceFirst("([/\\\\])" + defaultLocale + "([/\\\\])", "$1"); } - + try { JRST.generate(JRST.TYPE_XDOC, new File(fileIn), inputEncoding, new File(fileOut), outputEncoding, getOverwrite()); - numberFilesGenerates ++; + numberFilesGenerates++; } catch (Exception e) { getLog().error(e); - if(!ignoreErrors) { + if (!ignoreErrors) { throw new GenerationJRstException(fileIn); } } } - - if(fileOut != null && verbose) { + + if (fileOut != null && verbose) { getLog().info("Using " + fileIn); getLog().info("Generating " + fileOut); } return true; } - private void actionCopy(){ + private void actionCopy() { getLog().info("Copie des fichiers images"); - /* Execution de la tâche ant copy */ - + /* Execution de la tÃ¢che ant copy */ + try { if (defaultLocale != null && !"".equals(defaultLocale)) { // copie de tous les fichiers non rst @@ -223,7 +215,7 @@ "([/\\\\])" + defaultLocale + "([/\\\\])", "$1", true, ".*[/\\\\]rst[/\\\\].*"); - + // copie des images du repertoire rst dans le build-site FileUtil.copyAndRenameRecursively( new File(directoryIn), @@ -238,18 +230,18 @@ FileUtil.copyAndRenameRecursively( new File(directoryIn), new File(directoryOut), - false, - "", - "", - true, + false, + "", + "", + true, ".*[/\\\\]rst[/\\\\].*"); - + // copie des images du repertoire rst dans le build-site FileUtil.copyAndRenameRecursively( new File(directoryIn), new File(directoryOut), false, - "([/\\\\])rst([/\\\\])", + "([/\\\\])rst([/\\\\])", "$1resources$2", false, ".*[/\\\\]rst[/\\\\].*(\\.png|\\.jpeg|\\.jpg|\\.gif)$"); @@ -257,11 +249,8 @@ } catch (IOException eee) { getLog().error(eee); } - - - - -// /* Création d'un projet ant */ + +// /* CrÃ©ation d'un projet ant */ // Project project = new Project(); // // BuildLogger logger = new NoBannerLogger(); @@ -273,7 +262,7 @@ // project.getBaseDir(); // project.addBuildListener(logger); // -// /* Création de la tâche ant Copy */ +// /* CrÃ©ation de la tÃ¢che ant Copy */ // Copy copy = new Copy(); // copy.setProject(project); // copy.setTaskName("Copy images");

1 0

r176 - trunk/jrst2
by chatellier＠users.labs.libre-entreprise.org 04 Aug '08

04 Aug '08

Author: chatellier Date: 2008-08-04 07:16:33 +0000 (Mon, 04 Aug 2008) New Revision: 176 Removed: trunk/jrst2/.cvsignore Modified: trunk/jrst2/pom.xml Log: Add missing dep commons-lang Deleted: trunk/jrst2/.cvsignore =================================================================== --- trunk/jrst2/.cvsignore 2008-07-31 14:35:17 UTC (rev 175) +++ trunk/jrst2/.cvsignore 2008-08-04 07:16:33 UTC (rev 176) @@ -1,3 +0,0 @@ -maven.log -target -velocity.log Modified: trunk/jrst2/pom.xml =================================================================== --- trunk/jrst2/pom.xml 2008-07-31 14:35:17 UTC (rev 175) +++ trunk/jrst2/pom.xml 2008-08-04 07:16:33 UTC (rev 176) @@ -89,6 +89,12 @@ <scope>compile</scope> </dependency> <dependency> + <groupId>commons-lang</groupId> + <artifactId>commons-lang</artifactId> + <version>2.4</version> + <scope>compile</scope> + </dependency> + <dependency> <groupId>lutinlib</groupId> <artifactId>lutinutil</artifactId> <version>0.29</version>

1 0