====== txt2tags ======

===== Présentation =====
txt2tags est un générateur de documents, c'est un outil de conversion et de mise en format.\\
Il lit un simple fichier texte contenant quelques balisages et à partir d'une même source le convertit, au choix dans les formats suivants :

  * HTML
  * XHTML
  * SGML
  * LaTeX
  * Lout
  * Page de manuel (page man)
  * Wikipedia / MediaWiki
  * Google Code Wiki
  * DokuWiki (donc très utile pour écrire des articles pour LinuxPedia ;) )
  * MoinMoin
  * MagicPoint
  * PageMaker
  * texte brut
  * ...


===== Installation =====
==== À partir de votre système ====
Si txt2tags a été packagé pour votre distribution, installez le via :

  * votre gestionnaire de packages

Fedora : 
  yum install txt2tags

Ubuntu, Debian : 
  sudo apt-get install txt2tags

  * ou manuellement (dépendances nécessaires : python, gettext)

Red Hat, CentOS :  [[http://dag.wieers.com/rpm/packages/txt2tags/|package]]
  rpm -ivh txt2tags-*.rpm

Slackware/Salix : [[http://txt2tags.javila.net/|package]]
  installpkg txt2tags-*.tgz


===== Utilisation =====
Des balises très simples sont utilisées, par exemple :

<code>
= Titre niveau 1 =
== Titre niveau 2 ==
=== Titre niveau 3 ===
+ Titre numéroté niveau 1 +
++ Titre numéroté niveau 2 ++
+++ Titre numéroté niveau 3 +++
</code>
<code>
Pour les modificateurs il y a **gras**
et //italique//

Il y a aussi __souligné__ et
``chasse fixe``
</code>

  * Quelques exemples : http://txt2tags.sourceforge.net/fr/markup-fr.html
  * L'essayer en ligne : http://txt2tags.sourceforge.net/online.php

Les documents peuvent être composés de plusieurs parties, le fichier principal se chargera de les regrouper.
L'utilisation d'images et de tableaux est possible.

La documentation en ligne est très riche et souvent traduite en français :
  * [[http://txt2tags.sourceforge.net/fr/manpage-fr.html|la page man]]
  * [[http://txt2tags.sourceforge.net/fr/userguide-fr.pdf|le guide complet de l'utilisateur (PDF)]] avec sa [[http://txt2tags.sourceforge.net/userguide/userguide.t2t|source t2t]] (format txt2tags) pour voir ce qu'il est possible de faire facilement.
  * [[http://txt2tags.sourceforge.net/docs.html|toute la documentation]]