PageRenderTime 17ms CodeModel.GetById 12ms app.highlight 1ms RepoModel.GetById 2ms app.codeStats 0ms

/doc/French/writing-book-fr.t2t

http://txt2tags.googlecode.com/
Unknown | 341 lines | 239 code | 102 blank | 0 comment | 0 complexity | 0549df833101748ad5d2c2bee6f3726c MD5 | raw file
  1Écrire des livres avec txt2tags
  2
  3par Aurelio Jargas
  4
  5%!target : xhtml
  6%!encoding: UTF-8
  7%!style  : ../English/writing-book.css
  8%!options: -n --toc --css-sugar --css-inside -o writing-book-fr.html
  9
 10%!preproc: URL_RE_BOOK  http://guia-er.sourceforge.net/
 11%!preproc: URL_HTMLDOC	http://www.easysw.com/htmldoc/
 12%!preproc: SORRY        txt2tags ne peut pas vous aider
 13%!postproc: URL_PC_BOOK  http://www.picocontainer.org/Contructor+Dependency+Injection+...+Book+Announcement
 14
 15
 16
 17	Ce document est un guide rapide montrant l'intérêt d'utiliser
 18	txt2tags pour écrire un livre. C'est aussi applicable pour
 19	d'autres gros documents tels des guides ou des thèses.
 20
 21
 22= Préface =
 23
 24Je suis l'auteur  de txt2tags ``[1]`` et a écrit deux documents
 25publiés en l'utilisant :
 26[Regular Expressions book URL_RE_BOOK] (96 pages) et Shell Programming
 27Course (108 pages). La procédure d'écriture était régulière et sans
 28douleur, donc je veux faire partager cette expérience.
 29
 30Un livre est un vrai gros travail, mais cela n'a pas à être compliqué.
 31Ecrire est organiser des idées dans des structures de texte comme des
 32paragraphes, des sections et des listes. Txt2tags est un outil qui
 33rend cette tâche simple et aisée.
 34
 35Écrire seul ou dans une équipe, avec ou sans gestion de version, un
 36contenu technique ou non, du texte seul ou avec des graphiques, dans
 37tous les cas txt2tags peut être utilisé comme outil principal pour la
 38création de livre.
 39
 40	``[1]`` Txt2tags lit un fichier texte avec un minimum de
 41	marques comme ""**gras**"" et ""//italique//"" et convertir en
 42	documents HTML, LaTeX et Adobe PageMaker. plus d'infos sur :
 43	http://txt2tags.org.
 44
 45
 46
 47= Éditeurs graphiques contre langage à balise =
 48
 49Les deux facons communes d'écrire un livre sont d'utiliser un éditeur
 50visuel (//Microsoft Word//, //Adobe Pagemaker//) ou un langage à
 51balises (//LaTeX//, //docbook//).
 52
 53Avec les éditeurs visuels, vous écrivez et mettez en forme le contenu
 54en même temps. Cette approche est bonne pour de courts documents mais
 55pour des livres de 300 pages, la mise en forme consomme du temps et
 56distrait l'auteur.
 57
 58Dans les  langages à balises, vous écrivez le contenu et insérez les
 59marques, un programme externe le convertit dans sa forme finale.
 60L'auteur ne s'occupe pas de la mise en forme mais insérer des
 61``<tags></tags>`` et ``\encore{des marques}``. Cela est source
 62d'erreur et très ``intrusive``, rendant le contenu très difficile à
 63lire dans les fichiers source.
 64
 65Txt2tags utilise aussi les balises, mais la grosse différence est que
 66les marques sont minimales, et aussi naturelles que d'utiliser des
 67tirets pour les listes d'items. Ainsi l'auteur ne se concentre que sur
 68le contenu et les fichiers source restent lisibles.
 69
 70
 71= L'approche Txt2tags =
 72
 73En utilisant txt2tags, le processus d'écriture du livre suit les
 74étapes suivantes :
 75
 76+ L'auteur(s) apprend quelques règles de marques très simples.
 77
 78+ L'auteur écrit le contenu du livre, sans s'occuper des détails tels
 79  que les marges, les fontes les couleurs et les tailles.
 80
 81+ L'auteur (ou l'éditeur) ouvre le contenu sur un processeur de texte
 82  graphique qui lit le HTML (ou le LaTeX ou ...) et termine la mise en
 83  forme.
 84
 85
 86L'étape 1 dure quelques minutes. L'étape 2 peut prendre des mois, et
 87l'étape 3 prend quelques jours ou semaines.
 88
 89Vous écrivez le contenu quand vous voulez y passer du temps, il est
 90donc important que cela soit simple, productif et plaisant.
 91
 92Nous allons montrer les arguments qui font que txt2tags peut être
 93utilisé pour cette tâche.
 94
 95
 96= Rapide et acharné =
 97
 98Le temps est le plus important. En utilisant txt2tags vous allez avoir
 99une grande productivité parce que vous écrivez le contenu, pas la mise
100en forme.
101
102- **Première révision rapide**
103
104  Il est très difficile de démarrer quelque chose, mais txt2tags a une
105  approche agréable pour régler ce problème. Installez vous et écrivez
106  du texte brut. Au bout de quelques minutes, vous ajoutez les marques
107  txt2tags sur le texte et il est prêt à être converti et publié.
108
109- **Prévisualisation rapide**
110
111  Le format final n'a pas d'importance, HTML est le format préféré au
112  moment de l'écriture. Une image de ce qui a été réalisé peut être
113  faite à tout moment, en convertissant les sources en pages HTML,
114  ainsi on peut le lire avec n'importe quel butineur. Si vous avez
115  besoin d'une version imprimable, convertissez le en PDF avec
116  l'excellent outil [htmldoc URL_HTMLDOC].
117
118- **Vue du contenu**
119
120  Pour avoir rapidement une vue globale du contenu du livre utilisez
121  l'option txt2tags //TOC Only//. Le programme montre la table des
122  matières avec la liste des chapitres et section, numérotés ou non,
123  avec n'importe quelle profondeur.
124
125- **Écriture rapide**
126
127  Les marques de txt2tags sont simples et minimales, très faciles à
128  apprendre. Pas de noms, d'option ou de paramètres. Vous ne devez pas
129  arrêter d'écrire pour insérer des marques, elles se coulent dans le
130  texte. Si vous ne vous rappelez pas d'une marque spécifique oubliez
131  la et continuez à écrire. A la fin faites une relecture globale et
132  insérez rapidement les marques manquantes.
133
134- **Conversion Rapide**
135
136  Même si vous faites un livre de 500 pages, la conversion est rapide.
137  C'est parce que txt2tags agit comme un filtre, convertissant d'un
138  format à l'autre. Il ne fait pas d'index, de compilation, de
139  compression, de tracé ou de traitement important sur les sources.
140  Plus de librairies, de catalogues, de schémas ou de cauchemars DTD.
141
142
143= Organiser les sources en dossiers =
144
145Txt2tags a un commande interne pour inclure des fichiers externes
146n'importe où dans le document. On peut découper le source en de
147multiples fichiers.
148
149- **Chaque chapitre dans un dossier**
150
151  Vous pouvez faire un dossier pour chaque chapitre, enregistrant les
152  sources dans une arborescence structurée. Dans chaque  dossier
153  (chapitre) vous pouvez créer des sous-dossiers pour enregistrer des
154  images, des configurations ou des fichiers inclus.
155
156- **Plus de conflits**
157
158  En séparant les chapitres, des personnes différentes peuvent
159  travailler sur des chapitres différents sans interférence. Chaque
160  équipe travaille sur son propre dossier, éliminant les conflits dus
161  à des changements intempestifs.
162
163- **Contrôle d'accès flexible**
164
165  Avec l'organisation des dossiers et des fichiers, on peut
166  implémenter des règles de contrôle d'accès, positionnant les
167  propriétés et les permissions pour chacun des fichiers ou chapitres.
168  On peut utiliser des outils systèmes standard pour configurer les
169  autorisations de lecture-écriture, comme dans le schéma
170  "utilisateurs et groupes".
171
172- **Vue globale des source**
173
174  Structurer les sources aide aussi à avoir une vue globale du livre,
175  en utilisant une butineur pour voir rapidement la quantité du texte
176  et des images de chaque chapitre. (Astuce : sur UNIX, commandes
177  ``tree`` et ``du``).
178
179- **Travaillez sur votre chapitre, oubliez les autres**
180
181  En séparant les sources en fichiers, vous pouvez convertir un seul
182  chapitre , pas besoin d'attendre que le livre soit terminé. En plus
183  de la rapidité de conversion, un chapitre seul peut être envoyé aux
184  relecteurs ou publié seul, comme échantillon du livre complet.
185
186- **Vous découpez, txt2tags regroupe**
187
188  À la conversion, txt2tags va automatiquement concaténer tous les
189  chapitres dans le livre final, quelle que soit la taille et la
190  grandeur des dossiers.
191
192
193= Le contrôle de version rendu facile =
194
195Txt2tags aide le contrôle de version avec des outils ligne (tels que
196//CVS// and //Subversion//). Les sources sont du texte brut, pas des
197//données compilées.
198
199- **Travaillez avec des lignes courtes**
200
201  Vous pouvez faire des lignes courtes en les coupant à 72 caractères.
202  Cela va aider au contrôle de version, puisque c'est un outil ligne.
203  Si le format final nécessite une longue ligne (comme PageMaker),
204  txt2tags va les concaténer automatiquement.
205
206- **Sources lisibles**
207
208  Avec des marques minimales, les sources sont lisibles. On peut voir
209  aisément ce qui a changé d'une version à l'autre. Les marques ne
210  polluent pas le texte.
211
212- **Gros contenus, petits sources**
213
214  Avec du texte brut, vous pouvez avoir un gros contenu, avec peu
215  d'occupation du disque. Les gens peuvent faire des ``checkout`` (des
216  sorties du contrôle d'accès) et des ``commits`` même avec des
217  connexions lentes.
218
219- **Versionnage de chapitre**
220
221  Comme vu auparavant, les sources sont organisés en dossiers. Cela
222  rend le contrôle de version séparé possible par chapitre ou par
223  section, cela dépendant de la granularité désirée.
224
225
226= La qualité en premier =
227
228Vous pouvez écrire un livre ou écrire LE livre. Txt2tags a des
229possiblités intégrées pour augmenter la qualité du travail.
230
231- **Correction orthographique**
232
233  Comme les marques de txt2tags sont des symboles et pas des mots,
234  vous pouvez utiliser un correcteur orthographique sur les sources.
235  Il ne s'occupera que du texte et n'essayera pas de corriger les
236  marques.
237
238- **Base d'alias**
239
240  Txt2tags a un //Pre Processing Filters// (filtre avant conversion),
241  où vous pouvez définir des couples clé/valeur. Partout où la clé est
242  trouvée dans le source, elle est remplacée par la valeur au moment
243  de la conversion. Par exemple si vous utilisez la chaine
244  ``URL_GOOGLE`` dans votre texte, elle va apparaître comme
245  ``http://www.google.com`` dans votre livre. Si l'URL de Google
246  change, il n'y a qu'à changer la définition du filtre et toutes les
247  occurences seront remises à jour. Vous pouvez définir autant de clés
248  que vous voulez, et cela sans limite.
249
250- **Contenu dynamique**
251
252  Txt2tags a une commande pour inclure à la conversion du texte
253  pré-formatté dans le document, par exemple un échantillon de code
254  source. Vous pouvez séparer le code source du document et le
255  remettre à jour soit manuellement soit automatiquement. Une bonne
256  idée est de marquer le code source du programme avec des
257  commentaires spécifiques, et un petit programme extrait les parties
258  marquées dans des fichiers séparés.
259
260- **Contrôle sur le résultat**
261
262  Txt2tags a //Post Processing Filters//(filtre après conversion), où
263  vous pouvez définir des règles qui ajustent le document généré.
264  Ainsi si la conversion standard de txt2tags ne vous satisfait pas,
265  vous pouvez ``improve`` avec vos propres filtres. Vous pouvez
266  utiliser les expressions régulières pour faire vos filtres.
267
268
269= Autres avantages =
270
271Et il y a plus !
272
273- **Séparer la mise en forme de l'écriture**
274
275  En utilisant le HTML comme format de sortie, vous pouvez utiliser
276  les fichiers CSS pour voir plusieurs rendus du livre. CSS définit la
277  mise en forme pour les pages HTML, et il y a des éditeurs graphiques
278  pour créer des fichiers CSS. Une équipe peut travailler sur les
279  fichers CSS pendant que l'autre écrit le contenu.
280
281- **Inclure des structures complexes**
282
283  Txt2tags n'a pas le support de toutes les structures utilisées dans
284  les textes : listes, définitions, ``quotation``, ``verbatim area``
285  et tables. Mais si votre livre a besoin d'une structure plus
286  complexe vous pouvez utiliser la possibilité des "inclusions
287  marquées" (``Pass-Thru Include``) où vous insérez le texte déjà
288  marqué comme une jolie table HTML. Avec txt2tags, les exceptions ne
289  sont pas un problème !
290
291- **Utiliser n'importe quel éditeur**
292
293  Comme les sources sont du texte brut, même le plus modeste éditeur
294  du monde peut être utilisé pour écrire un livre. Il n'a pas besoin
295  d'autres capacités que d'écrire et sauver du texte. Si vous utilisez
296  un éditeur avec le support txt2tags vous aurez la
297  //coloration syntaxique//, qui aide à identifier les marques
298  txt2tags. Ce sont les éditeurs : Vim, Emacs, Kat et Nano.
299
300- **Support technique**
301
302  Txt2tags a différents canaux de support technique : deux mailing
303  lists (anglais et portugais), un canal IRC et une communauté
304  ``ORKUT``. Pour des projets de livre, vous pouvez envoyer
305  directement des emails à l'auteur du programme, qui vous répondra
306  prioritairement.
307
308
309= Aucun outil ne couvre tous les besoins =
310
311Il y a des cas spécifiques où txt2tags n'est pas un bon outil pour
312écrire un livre.
313
314- **Livres très complexes**
315
316  Les livres qui utilisent des tables compliquées, des formules ou des
317  structures spécifiques, ont besoin d'un éditeur graphique ou un
318  langage de balises plus complexe comme LaTeX. Si votre livre
319  correspond à cela, SORRY.
320
321- **Notes de bas de page**
322
323  Txt2tags n'a pas de support pour les notes de bas de page. Si vous
324  en utlisez peu vous pouvez les ajouter après. Si vous voulez en
325  faire un usage intensif, SORRY. (NdT : Malgré tout avec le système de 
326  preproc et postproc propre à txt2tags, il est relativement aisé de 
327  rajouter des notes en LaTeX et de les simuler en html).
328
329- **Réferences pour des pages, des tables et des images**
330
331  On peut utiliser un éditeur graphique au moment de la publication
332  pour inclure les index pour les pages, les tables et les images, pas
333  de problème. Mais si vous voulez y référer dans le texte comme
334  "//voir table 4.11 page 35//", SORRY.
335
336
337----------------------------------------------------------------------
338//Writing Books with Txt2tags - Oct/2004//
339([voir le source %%infile])
340
341Traduit par Claude Hiebel.