File: utilisationLDC.html

package info (click to toggle)
natbraille 2.0rc3-14
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 7,080 kB
  • sloc: java: 31,266; xml: 7,747; sh: 165; haskell: 50; makefile: 32
file content (94 lines) | stat: -rwxr-xr-x 5,745 bytes parent folder | download | duplicates (7)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr">
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
		<link title="default" media="screen" rel="stylesheet" href="nat-help.css" type="text/css" />
		<link title="impression" media="screen" href="../nat-print.css" type="text/css" rel="alternate stylesheet" />
		<link title="impression" media="print" href="../nat-print.css" type="text/css" rel="stylesheet" />
		<title>Utiliser NAT en ligne de commande</title>
	</head>

	<body class="doc">
		<div id="corps">
			<h1>Utiliser NAT en ligne de commande</h1>
			<h2>Transcrire un document </h2>
			<p>NAT peut s'excuter en ligne de commande (dans une console linux, msdos, etc.) en mode non-interactif et en se passant compltement de l'interface graphique. La forme de l'appel est la suivante :</p>
			<p><code>nat-launch-no-gui --from mon_fichier_source.odt --to mon_fichier_braille.txt </code></p>
			<p>Cette ligne va transcrire le document openoffice.org <code>mon_fichier_source</code> en un fichier braille nomm <code>mon_fichier_braille.txt</code>. La ligne peut tre abrge ainsi : </p>
			<p><code>nat-launch-no-gui -f mon_fichier_source.odt -t mon_fichier_braille.txt </code></p>
			<h2>Spcifier des paramtres de transcription</h2>
			<p>Tous les paramtres configurables par l'interface graphique peuvent tre dfinis dans la ligne de commande. </p>
			<p><code>nat-launch-no-gui -f document.odt -t sortie.txt --fi-litt-abbreg true --fi-line-length 80</code></p>	
			<p>Dans la ligne prcdente, on lance la mme transcription en activant cette fois le braille abrg et en rglant la longueur de ligne  80 caractres. La liste des paramtres modifiables est dtaille plus bas.</p>
			<h2>Fichier de configuration</h2>
			<p>Il est possible d'utiliser un fichier de configuration regroupant l'ensemble des paramtres de transcription et de sortie (que l'on aura ralis avec l'interface graphique ou directement avec un diteur de texte) en utilisant le paramtre <code>--config</code> ou <code>-c</code>, suivi du nom du fichier de configuration.  </p>
			<p><code>nat-launch-no-gui -c maconfig.cfg -f document.odt -t sortie.txt </code></p>
			<p>La commande prcdente transcrit le <code>document.odt</code> en fichier braille <code>sortie.txt</code>, en utilisant les paramtres de  <code>maconfig.cfg</code>. Notons que l'ordre des paramtres est sans importance.</p>
			<p>Il est enfin possible de spcifier simultanment un fichier de configuration et une option. Dans ce cas, les paramtres sont d'abord lus dans le fichier de configuration; ensuite, ceux qui figurent dans la ligne de commande les remplacent :</p>
			<p><code>nat-launch-no-gui -c embossage_linux.cfg -f document.odt -t sortie.txt --fi-litt-abbreg true </code></p>
			<p>Dans la ligne prcdente, on utilise un fichier de configuration <code>embossage_linux.cfg</code> destin, disons,  l'embossage sous linux, en prcisant que le document sera transcrit en braille abrg.</p>
			<h2>Liste des options</h2>
			<p>NAT accepte les paramtres suivants (Cette liste est galement affiche lorsque nat est lanc sans paramtre):</p>

			<code>
			<pre>

-?, -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       


			</pre>
			</code>

			<p><a href="index.html">Retour au sommaire de l'aide</a></p>
			<div align="center">
				<p id="licence"><a href="http://creativecommons.org/licenses/by-sa/3.0/deed.fr"><img src="images/cc.png" alt="Licence creative commons"/></a> et <a href="http://www.gnu.org/licenses/gpl.html"><img src="images/gnu.png" alt="licence gnu/gpl 2" /></a></p>
				<p id="mentions">
					Tous les contenus (images, textes, vidos...) de cette documentation sont sous <a href="http://creativecommons.org/licenses/by-sa/3.0/deed.fr">licence creative commons</a> de type 
					<img src="images/cc-by.png" alt="paternit" />
					
					<img src="images/cc-sa.png" alt="partage des conditions initiales  l'identique" /><br/>
					NAT est un logiciel libre sous licence GNU/GPL ralis par Bruno MASCRET, Frdric SCHWEBEL et Vivien GUILLET
				</p>
			</div>
		</div>
	</body>
</html>