Provided by: txt2tags_2.6-3_all bug

NOM

       txt2tags -  outil de conversion et de formatage de texte

SYNOPSIS

       txt2tags [options] [FICHIER...]

DESCRIPTION

       txt2tags  lit  un  fichier  texte avec des balises minimales et peut le
       convertir en : ASCII Art, AsciiDoc, Creole, DocBook,  DokuWiki,  Google
       Code   Wiki,   HTML,  LaTeX,  Lout,  MagicPoint,  Man  page,  MoinMoin,
       PageMaker, Plain Text, PmWiki, SGML, Wikipedia et XHTML.

       Cette page de man a ete creee grace a txt2tags depuis un simple fichier
       textuel. Le meme fichier texte a ete egalement converti en HTML pour la
       version en ligne de ce manuel.

       UNE source, des sorties MULTIPLES - http://txt2tags.org

BALISES

       Entete               Les 3 premieres lignes du fichier source
       Titre                = mots =
       Titre numerote       + mots +
       Commentaires         % commentaires
       Ligne de separation  -----------------------...
       Ligne plus epaisse   =======================...
       Image                [fichier.jpg]
       Liens                [label url]

       Gras                 **mots**
       Italique             //mots//
       Souligne             __mots__
       Barre                --mots--
       Monospaced           ``mots``
       Raw                  ""mots""
       Tagged               ''mots''

       Paragraphe           mots
       Citation             <TAB>mots
       Liste                - mots
       Liste numerotee      + mots
       Liste de definitions : mots
       Table                | cellule1 | cellule2 | cellule3...

       Ligne verbatim       ``` mots
       Ligne raw            """ mots
       Ligne tagged         ''' mots

       Bloc verbatim        ```
                            lignes
                            ```
       Bloc raw             """
                            lignes
                            """
       Bloc tagged          '''
                            lignes
                            '''

OPTIONS

           --art-chars=MOTIF
              Utilise le MOTIF pour definir les caracteres du mode ASCII  Art,
              respectivement  pour  les  coins,  les  bordures, les cotes, les
              barres 1 et 2, les niveaux 2, niveaux 3, niveaux 4 et niveau  5.
              Le  motif  par defaut est +-|-==-^". Cette option est uniquement
              valable pour la cible ASCII Art.

       -C, --config-file=FICHIER
              Lit la configuration depuis le  fichier  exterieur  FICHIER.  La
              configuration doit etre de la forme %!mot-cl'e:valeur. Se referer
              a la section CONFIGURATIONS pour plus de details.

           --css-sugar
              Ameliore l'utilisation de  feuilles  CSS  par  rapport  au  code
              HTML/XHTML  genere.  Les  attributs  eventuels  des balises sont
              retires, les balises de presentation sont evites,  l'entete  est
              compose  de  balises H1, H2 et H3, de nouveaux DIVs sont crees :
              #header, #body, .toc.

           --css-inside
              Insere le contenu  du  fichier  CSS  dans  l'entete  HTML/XHTML.
              Utilisez --style pour specifier le fichier CSS a inclure.

           --dump-config
              Affiche toute la configuration trouvee et sort.

           --dump-source
              Affiche  la  source  du  document,  avec  toutes  les inclusions
              (%!include) eventuelles.

           --encoding=CODE
              Definit l'encodage de la sortie utilise par le  document  source
              vers CODE. Par exemple UTF-8, iso-8859-1, etc.

           --gui
              Appelle l'interface graphique Tk.

       -h, --help
              Affiche l'aide et sort.

       -H, --no-headers
              Supprime  les  entetes,  les  titres  et les pieds de page de la
              sortie. Seul le contenu (body) sera affiche.

           --headers
              Montre les entetes, les titres et les  pieds  de  page  dans  la
              sortie. ACTIVE par defaut.

           --height=NOMBRE
              Definit  la  hauteur  de sortie a NOMBRE de lignes. Cette option
              est uniquement utilisee par la  cible  ASCI  ART  (-t  art),  en
              utilisant egalement l'option --slides.

       -i, --infile=FICHIER
              Definit  FICHIER comme fichier d'entree pour le document source.
              Utilisez '-' pour lire la source depuis STDIN.

           --mask-email
              Masque les courriels contre les robots spammeurs.  Retire  @  et
              les  points.  Ainsi  l'adresse  foo@bar.com devient <foo (a) bar
              com>.

       -n, --enum-title
              Numerote automatiquement les titres. Ils seront prefixes par  1,
              1.1, 1.1.1, ...

           --no-dump-config
              Annule l'affichage de configuration via --dump-config.

           --no-dump-source
              Annule l'affichage de la source via --dump-source.

           --no-encoding
              Annule la configuration d'encodage.

           --no-enum-title
              Annule la numerotation automatique des titres.

           --no-infile
              Annule toutes les declarations precedentes de fichiers d'entree.

           --no-targets
              Annule l'action --targets.

           --no-mask-email
              Annule l'action de masquer les courriels.

           --no-outfile
              Annule la precedente declaration de fichier de sortie.

           --no-quiet
              Affiche les messages, annule l'option --quiet.

           --no-rc
              Ne   lit   pas   le   fichier   de   configuration   utilisateur
              ~/.txt2tagsrc.

           --no-slides
              N'utilise pas les slides (-t art).

           --no-style
              Supprime la declaration de style.

           --no-toc
              N'ajoute pas de table des matieres au document de sortie.

           --no-toc-only
              Annule l'action de --toc-only.

       -o, --outfile=FICHIER
              Genere le nom FICHIER en tant que fichier  de  sortie.  Utilisez
              '-' pour envoyer le resultat vers STDOUT.

       -q, --quiet
              Mode silencieux, supprime toutes les sorties (sauf les erreurs).

           --rc
              Lit  le  fichier  de  configuration  utilisateur  ~/.txt2tagsrc.
              ACTIVE par defaut.

           --slides
              Formate la sortie en  tant  que  slide  de  presentation.  Cette
              option est uniquement utilisee par la cible ASCII Art.

           --style=FICHIER
              Utilise  FICHIER  en tant que fichier de style pour le document.
              Utilise  pour  definir  les  fichiers  CSS  pour  les  documents
              HTML/XHTML  et  les  paquets  pour LaTeX. Cette option peut etre
              appelee a plusieurs reprises pour inclure de multiples fichiers.

       -t, --target=TYPE
              Choisit la cible document de sortie en la  definissant  a  TYPE.
              Des cibles courantes sont : html, xhtml, tex, man, txt. Utilisez
              l'option --targets pour lister toutes les cibles disponibles.

           --targets
              Affiche une liste de toutes les cibles disponibles, et sort.

           --toc
              Ajoute une table des matieres (Table of Contents ; TOC), generee
              automatiquement,  au document de sortie, entre son entete et son
              contenu. Vous pouvez egalement specifier la place de cette table
              des matieres en utilisant la macro %%TOC.

           --toc-level=NOMBRE
              Assigne  le  niveau  maximum  de la table des matieres a NOMBRE.
              Tous les titres au-dela de NOMBRE ne seront pas inclus  dans  la
              table des matieres.

           --toc-only
              Affiche la table des matieres et sort.

       -v, --verbose
              Affiche  les  messages d'information durant la conversion. Cette
              option peut etre appelee a plusieurs reprises pour augmenter  le
              nombre de messages affiches.

       -V, --version
              Affiche la version du programme et sort.

           --width=NOMBRE
              Assigne  la largeur de sortie a NOMBRE de colonnes. Cette option
              est uniquement utilisee par la cible ASCII Art.

FICHIERS SOURCE

       Les fichiers source sont generalement identifies par  l'extension  .t2t
       (par  exemple  mon_fichier.t2t). Vous pouvez avoir trois zones dans vos
       sources :

       Ent^ete (optionel)
              Les trois premieres lignes du fichier. Laissez la premiere ligne
              vide  si  vous  n'avez  pas  besoin  d'entetes.  Utilise dans le
              document pour le titre, l'auteur, la version, et la date.

       Configuration (optionel)
              Commence juste apres l'entete (4eme ou 2nde ligne) et se termine
              quand   le   corps   du   texte   debute.    Utilise   pour  les
              configurations, dans le format %!mot-cle:valeur.

       Corps  Commence a la premiere ligne de texte valide (pas de commentaire
              ou de configuration), apres la zone d'entete et continue jusqu'a
              la  fin  du  document.  Utilise  pour  le  contenu  du  document
              proprement dit.

CONFIGURATIONS

       Les  configurations  vous  permettent  de personnaliser txt2tags, elles
       sont similaires aux options. Elles peuvent etre  utilisees  :  dans  la
       zone   de   configurations   du   document   source,  dans  un  fichier
       ~/.txt2tagsrc,  dans  un  fichier  exterieur   appele   avec   l'option
       --config-file.

       %!target
              Definit  le  format  de sortie, de la meme maniere que --target.
              Par exemple :
              %!target: html

       %!options(target)
              Definit les options par  defaut  de  chaque  cible.  Vous  devez
              utiliser la meme syntaxe qu'en ligne de commande. Par exemple :
              %!options(html): --toc --toc-level 3 --css-sugar

       %!includeconf
              Inclut  une  configuration  a partir d'un fichier externe, de la
              meme maniere que --config-file. Par exemple :
              %!includeconf: myconfig.t2t

       %!style
              Definit un fichier de style pour le document, de la meme maniere
              que --style. Peut etre appelee a plusieurs reprises. Par exemple
              :
              %!style: colors.css

       %!encoding
              Definit  l'encodage  de  la  cible,  de  la  meme  maniere   que
              --encoding. Par exemple :
              %!encoding: UTF-8

       %!preproc
              Filtre  de  recherche  et  remplacement utilise pour modifier le
              corps  de  la  source  AVANT  les  remplacements  habituels   de
              txt2tags.  La  fonction  de  recherche  utilise  les expressions
              rationnelles (regex) de Python. Par exemple :
              %!preproc:  "JJS"  "John J. Smith"

       %!postproc
              Filtre de recherche et remplacement  utilise  pour  modifier  le
              document  genere  APRES les remplacements habituels de txt2tags.
              La fonction de recherche utilise  les  expressions  rationnelles
              (regex) de Python. Par exemple :
              %!postproc(html):  "<B>"  "<STRONG>"

       Si  le  meme  mot apparait plusieurs fois, le dernier trouve sera celui
       utilise (a l'exception des  options,  preproc  et  postproc,  qui  sont
       cumulatifs).   Les  mots-cles  non-valides  sont  ignores.  L'ordre  de
       priorite  est  :  fichier  ~/.txt2tagsrc,  zone  de  configuration   du
       document, option --config-file passee en ligne de commandes.

COMMANDES

       Les  commandes font diverses taches durant la conversion. Elles doivent
       etre placees dans le corps du document.

       %!csv: fichier.csv
              Inclut un fichier externe CSV file en tant que tableau.

       %!include: fichier.t2t
              Inclut un fichier txt2tags dans le document.

       %!include: ``fichier.txt``
              Inclut un fichier texte (verbatim) dans le document.

       %!include: ''fichier.html''
              Inclut un fichier html dans le document.

MACROS

       Les macros sont  des  raccourcis  pratiques  pour  inserer  du  contenu
       dynamique dans votre document. Elles doivent etre placees dans le corps
       du document source. A l'exception de %%toc, toutes les  macros  peuvent
       etre  personnalisees  avec  des directives specifiques, comme %Y ou %f.
       Voir le guide complet de txt2tags pour plus de details.

       %%date Insere  la   date   actuelle.   Le   format   par   defaut   est
              %%date(%Y%m%d), ce qui donne AAAAMMJJ.

       %%infile
              Insere  le  chemin  du  fichier source. Le format par defaut est
              %%infile(%f). Utile pour inclure des bas de page de type   [Voir
              la source %%infile].

       %%mtime
              Insere  la date de modification du fichier source. Le format par
              defaut est %%date(%Y%m%d), ce qui donne AAAAMMJJ.

       %%outfile
              Insere le chemin du fichier de sortie. Le format par defaut  est
              %%outfile(%f).  Utile  pour  une  description  de type "C'est le
              fichier manpage-fr.man".

       %%toc  Indique ou sera placee la table des matieres. Vous  pouvez  meme
              l'appeler   a  de  multiples  reprises.  Notez  que  vous  devez
              egalement utiliser l'option --toc.

EXEMPLES

       txt2tags -t html fichier.t2t

              Conversion HTML, vers le fichier fichier.html.

       txt2tags -t html -o - fichier.t2t

              Conversion HTML, envoie le resultat vers STDOUT.

       txt2tags -t html --toc fichier.t2t

              Conversion HTML, incluant une table des matieres automatiquement
              generee.

       txt2tags -t html --toc --toc-level 2 -n fichier.t2t

              Conversion  HTML,  avec une table des matieres de niveau deux et
              des titres numerotes.

       txt2tags --toc-only fichier.t2t

              Affiche juste la table des matieres  dans  le  terminal,  aucune
              conversion ne sera faite.

       txt2tags   -t   html   --css-sugar   --style  base.css  --style  ui.css
       fichier.t2t

              Convertion HTML, preparant le code resultant a etre utilise avec
              des CSS, et incluant egalement deux fichiers CSS externes.

       txt2tags -t art --slides --width 80 --height 25 -o - fichier.t2t | more

              Cree une presentation en ASCII Art, prete a etre visualisee dans
              un terminal en 80x25.

       (echo ; echo "**bold**") | txt2tags -t html -H -

              Test rapide en une ligne avec entree depuis la console STDIN.

       txt2tags -t html -o - fichier.t2t | tidy > fichier.html

              Envoie le resultat vers STDOUT, puis  ajuste  le  code  avec  un
              programme  externe  avant  de  sauvegarder  le  resultat dans un
              fichier externe.

FICHIERS

       ~/.txt2tagsrc
              Fichier de configuration par defaut de l'utilisateur.

ENVIRONNEMENT

       T2TCONFIG
              Si cette variable d'environnement n'est pas nulle, elle  definit
              alors  le  chemin  complet  pour  la configuration par defaut de
              l'utilisateur.

AUTEUR

       Aurelio Jargas <verde@aurelio.net>

       Page de man traduite en francais par Eric Forgeot <http://esclinux.tk>,
       en   reutilisant   parfois   le   travail  original  de  Claude  Hiebel
       <chiebel@free.fr>

BOGUES

       http://bugs.txt2tags.org

COPYRIGHT

       Copyright (C) 2001-2010 Aurelio Jargas, GNU GPL v2

                                   Aug, 2010                       TXT2TAGS(1)