# Utiliser NAT en ligne de commande

## Transcrire un document

NAT peut s'exécuter en ligne de commande (dans une console linux, msdos, etc.) en mode non-interactif et en se passant complètement de l'interface graphique. La forme de l'appel est la suivante :

`nat-launch --from mon_fichier_source.odt --to mon_fichier_braille.txt`

Cette ligne va transcrire le document openoffice.org `mon_fichier_source` en un fichier braille nommé `mon_fichier_braille.txt`. La ligne peut être abrégée ainsi :

`nat-launch -f mon_fichier_source.odt -t mon_fichier_braille.txt`

## Spécifier des paramètres de transcription

Tous les paramètres configurables par l'interface graphique peuvent être définis dans la ligne de commande.

`nat-launch -f document.odt -t sortie.txt --fi-litt-abbreg true --fi-line-length 80`

Dans la ligne précédente, on lance la même transcription en activant cette fois le braille abrégé et en réglant la longueur de ligne à 80 caractères. La liste des paramètres modifiables est détaillée plus bas.

## Fichier de configuration

Il est possible d'utiliser un fichier de configuration regroupant l'ensemble des paramètres de transcription et de sortie (que l'on aura réalisé avec l'interface graphique ou directement avec un éditeur de texte) en utilisant le paramètre `--config` ou `-c`, suivi du nom du fichier de configuration.

`nat-launch -c maconfig.cfg -f document.odt -t sortie.txt`

La commande précédente transcrit le `document.odt` en fichier braille `sortie.txt`, en utilisant les paramètres de `maconfig.cfg`. Notons que l'ordre des paramètres est sans importance.

Il est enfin possible de spécifier simultanément un fichier de configuration et une option. Dans ce cas, les paramètres sont d'abord lus dans le fichier de configuration; ensuite, ceux qui figurent dans la ligne de commande les remplacent :

`nat-launch -c embossage_linux.cfg -f document.odt -t sortie.txt --fi-litt-abbreg true`

Dans la ligne précédente, on utilise un fichier de configuration `embossage_linux.cfg` destiné, disons, à l'embossage sous linux, en précisant que le document sera transcrit en braille abrégé.

## Liste des options

NAT accepte les paramètres suivants (Cette liste est également affichée lorsque nat est lancé sans paramètre):

`

    -?, -h, --help
       displays help message

    -g, --gui
       loads graphical interface

    -c, --config [sourcefile]
       sets configuration file
    -f, --from [sourcefile]
       sets source file
    -t, --to [destfile]
       sets destination file

    --in-encoding [encoding name]
       input file encoding
    --out-encoding [encoding name]
       output file encoding
    --fi-braille-table
       sets braille table

    --fi-line-length [Integer: char number]
       sets line length
    --fi-hyphenation [Boolean: true/false]
       use hyphenation
    --fi-hyphenation-dirty [Boolean: true/false]
       use dirty hyphenation

    --fi-litt-transcribe [Boolean: true/false]
       transcribe litterary contents
    --fi-litt-abbreg [Boolean: true/false]
       transcribe as abbreged
    --fi-math-transcribe [Boolean: true/false]
       transcribe math contents
    --fi-math-use-trigo-notation [Boolean: true/false]
       use special trigonmetric notation
    --fi-music-transcribe [Boolean: true/false]
       transcribe musical contents

    --ge-log-level [Integer: verbosity level 1|2|3]
       debug verbosity

`

Retour au sommaire de l'aide

et

Tous les contenus (images, textes, vidéos...) de cette documentation sont sous licence creative commons de type
NAT est un logiciel libre sous licence GNU/GPL réalisé par Bruno MASCRET, Frédéric SCHWEBEL et Vivien GUILLET