<p>
	Doctutils est une suite d&#39;outils permettant la transformation d&#39;un texte int&eacute;ligible, gr&acirc;ce &agrave; une syntaxe qui lui est propre, en plusieurs formats tels que le HTML ou le LaTeX.</p>
<p>
	La syntaxe utilis&eacute;e est le reStructuredText que l&#39;on &eacute;crit aussi reST.</p>
<h2>
	Installation</h2>
<p>
	Le nom du paquet &agrave; installer est python-docutils &agrave; adapter en fonction de votre distribution GNU/Linux.</p>
<pre>
# urpmi python-docutils</pre>
<h2>
	Edition</h2>
<pre>
$ mkdir doc
$ cd doc
</pre>
<p>
	Prenez votre &eacute;diteur de pr&eacute;dilection :</p>
<pre>
$ vim essai.txt

</pre>
<hr />
<pre>
essai de titre
==============


sous-titre
----------

bla bla

- liste 1
- item 2
- item 3

deuxi&egrave;me sous-titre
-------------------

bla bla


::

   ls /tmp
   cd /usr/bin

</pre>
<hr />
<p>
	Pour cr&eacute;er un titre, souligner le avec le caract&egrave;re de votre choix.</p>
<p>
	Pour faire un sous-titre, souligner le avec un autre caract&egrave;re de votre choix.</p>
<p>
	Pour faire une liste utiliser simplement des tirets.</p>
<p>
	Pour cr&eacute;er un bloc, utiliser :: suivit du contenu avec un retrait.</p>
<p>
	<br />
	Il est possible d&#39;exporter votre travail vers html, man, odt, pseudoxml, xml, latex et s5.</p>
<p>
	Vim est en mesure d&#39;apporter la coloration syntaxique, pour l&#39;y aider vous pouvez donner l&#39;extension .rst plut&ocirc;t que .txt.</p>
<h2>
	Exporter</h2>
<p>
	Nous pouvons maintenant exporter notre document dans le format HTML :</p>
<pre>
$ rst2html essai.txt &gt; essai.html</pre>
<p>
	Vous pouvez maintenant visualiser le r&eacute;sultat dans votre navigateur :</p>
<pre>
$ firefox essai.html</pre>
<p>
	Voici d&#39;autres balises pour docutils :</p>
<p>
	<a>http://docutils.sourceforge.net/sandbox/wilk/french/quickstart-fr.html</a><a href="http://docutils.sourceforge.net/sandbox/wilk/french/quickstart-fr.html"><br />
	</a></p>
<p>
	Essayons maintenant avec sphinx. C&#39;est un outil de g&eacute;n&eacute;ration de documentation pour les projet Python.</p>
<h2>
	Installation</h2>
<pre>
# urpmi python-sphinx
</pre>
<h2>
	Liens</h2>
<p>
	Site de docutils :</p>
<p>
	<a href="http://docutils.sourceforge.net/">http://docutils.sourceforge.net/<br />
	</a></p>
<p>
	Le guide de d&eacute;marrage rapide de rST :</p>
<p>
	<a href="http://docutils.sourceforge.net/docs/user/rst/quickref.html">http://docutils.sourceforge.net/docs/user/rst/quickref.html</a></p>
