/doc/Catalan/manpage-ca.t2t

http://txt2tags.googlecode.com/ · Unknown · 370 lines · 248 code · 122 blank · 0 comment · 0 complexity · 771fe4458910429e7e4f5c6814ed6ada MD5 · raw file

  1. TXT2TAGS
  2. Aug, 2010
  3. %!target: man
  4. %!encoding: UTF-8
  5. %!postproc(man): ' \(#\w+\)' ''
  6. %!options(html): --mask-email --toc
  7. %!postproc(html): <HEAD> '<HEAD>\n<STYLE>body{margin:3em;} pre{background:#ffc;}</STYLE>'
  8. = NOM =[name]
  9. txt2tags - Eina de formatació i conversió de texte.
  10. = SINOPSI =[synopsis]
  11. **txt2tags** [//opcions//] [//ARXIU//...]
  12. = DESCRIPCIÓ =[description]
  13. **txt2tags** llegeig un arxiu de texte que ha estat mínimament marcat i el converteix las siguents formats:
  14. //ASCII Art//,
  15. //AsciiDoc//,
  16. //Creole//,
  17. //DocBook//,
  18. //DokuWiki//,
  19. //Google Code Wiki//,
  20. //HTML//,
  21. //LaTeX//,
  22. //Lout//,
  23. //MagicPoint//,
  24. //Man page//,
  25. //MoinMoin//,
  26. //PageMaker//,
  27. //Plain Text (Texte Plà)//,
  28. //PmWiki//,
  29. //SGML//,
  30. //Wikipedia//
  31. //XHTML//.
  32. % TRANSLATOR: please keep the alphabetical order of this list.
  33. Aquesta pàgina de manual (Man page) fou creada amb **txt2tags** a partir d'un arxiu de texte plà. El mateix arxiu de texte plà fou tambè convertit a HTML per a la versió online d'aquest manual.
  34. UNA única font, MÚLTIPLES formats de sortida - http://txt2tags.org
  35. = MARCAT =[markup]
  36. ```
  37. Encapçalaments Les primeres tres línies de l'arxiu font.
  38. Títol = texte =
  39. Títol numerat + texte +
  40. Comentari % comentaris
  41. Línia de separació -----------------------...
  42. Línia gruixuda =======================...
  43. Imàgen [nom.jpg]
  44. Enlaç [etiqueta url]
  45. Negreta **texte**
  46. Cursiva //texte//
  47. ratllat __texte__
  48. Tatxat --texte--
  49. Monoespai ``texte``
  50. Raw ""texte""
  51. Etiquetat ''texte''
  52. Paràgraf texte
  53. Cita <TAB>texte
  54. Llista - texte
  55. Llista numerada + texte
  56. Llista de definició : texte
  57. Taula | cel.la1 | cel.la2 | cel.la3...
  58. Línia verbatim ``` texte
  59. Línia Raw """ texte
  60. Línia Etiquetada ''' texte
  61. Bloc Verbatim ```
  62. línies
  63. ```
  64. Bloc Raw """
  65. línies
  66. """
  67. Bloc etiquetat '''
  68. línies
  69. '''
  70. ```
  71. = OPCIONS =[options]
  72. : **-C**, **--config-file**=//ARXIU//
  73. Llegeig la configuració (ajusts) especificats a l'arxiu extern //ARXIU//. La configuració ha d'estar en format //%!keyword:value//. Per a més detalls, consultar la secció [AJUSTS #settings].
  74. : **--css-sugar**
  75. Millora el codi HTML/XHTML generat per a fi de poder utilitzar CSS. S'eliminen els atributs de les etiquetes, s'ignòren les etiquetes de presentació, les capçaleres es generen amb etiquetes H1, H2 i H3 i es creen noves DIVs : //#header//, //#body//, //.toc//.
  76. : **--css-inside**
  77. Insereix el contingut d'un arxiu CSS dins l'encapçalament HTML/XHTML. Utilitzar ``--style`` per especificar l'arxiu CSS que s'ha de llegir.
  78. : **--dump-config**
  79. Mostra tota la configuració (ajusts) i surt.
  80. : **--dump-source**
  81. Mostra el document font, amb totes les seves les inclusions (``%!include``) expandides.
  82. : **--encoding**=//CODI//
  83. Estableix la configuració de caràcters que s'utilitzarà a l'arxiu de sortida, utilitzant l'establerta a //CODI//. Exemples de //CODI//: UTF-8 y iso-8859-1.
  84. : **--gui**
  85. Activa la Interfície Gráfica Tk.
  86. : **-h**, **--help**
  87. Mostra la informació d'ajut i surt.
  88. : **-H**, **--no-headers**
  89. Elimina els encapçalaments i els peus de pàgina de l'arxiu de sortida. Sols es mostraràn els continguts (cos del document).
  90. : **--headers**
  91. Mostra els encapçalaments i els peus de pàgina de l'arxiu de sortida. Per defecte: ON.
  92. : **--height**=//NUM//
  93. Fixa el nombre de línies de l'arxiu de sortida a l'establert a //NUM//. Aquesta opció s'utilitza sols amb formats de sortida ASCII Art, quan també s'estigui utilitzant l'opció ``--slides``.
  94. : **-i**, **--infile**=//ARXIU//
  95. Pren //ARXIU// com l'arxiu font. Utilitzar '-' per a llegir la font des de STDIN.
  96. : **--mask-email**
  97. Oculta els emails als robots de spam. Elimina @ i punts. L'adreça ""foo@bar.com"" esdevé <foo (a) bar com>.
  98. : **-n**, **--enum-title**
  99. Activa la numeració automàtica dels títols. Està prefixada a: 1, 1.1, 1.1.1, ...
  100. : **--no-dump-config**
  101. Anul.la l'acció ``--dump-config``.
  102. : **--no-dump-source**
  103. Anul.la l'acció ``--dump-source``.
  104. : **--no-encoding**
  105. Anul.la la configuració de caràcters.
  106. : **--no-enum-title**
  107. Desactiva la numeració automàtica dels títols.
  108. : **--no-infile**
  109. Anul.la tota anterior declaració ``--infile``.
  110. : **--no-targets**
  111. Anul.la l'acció ``--targets``.
  112. : **--no-mask-email**
  113. Desactiva l'ocultació dels emails.
  114. : **--no-outfile**
  115. Anul.la tota anterior declaració ``--outfile``.
  116. : **--no-quiet**
  117. Mostra els missatges del sistema, desactiva l'opció ``--quiet``.
  118. : **--no-rc**
  119. No llegir a l'arxiu de configuració (ajusts) de l'usuari ~/.txt2tagsrc.
  120. : **--no-slides**
  121. Desactiva ``--slides``.
  122. : **--no-style**
  123. Desactiva tots els ajusts d'estil.
  124. : **--no-toc**
  125. Elimina la Taula de Continguts (TOC) a l'arxiu de sortida.
  126. : **--no-toc-only**
  127. Desactiva l'acció ``--toc-only``.
  128. : **-o**, **--outfile**=//ARXIU//
  129. Pren //ARXIU// com a nom per a l'arxiu de sortida. Utilitzar '-' per a dirigir els resultats a STDOUT.
  130. : **-q**, **--quiet**
  131. Mode silenciós. Suprimeix tots els missatges del sistema, excepte els dels errors.
  132. : **--rc**
  133. Llegeig a l'arxiu de configuració de l'usuari ~/.txt2tagsrc. Per defecte: ON.
  134. : **--slides**
  135. Formata l'arxiu de sortida com una presentació de diapositives. Aquesta opció s'utilitza sols amb formats de sortida ASCII Art.
  136. : **--style**=//ARXIU//
  137. Utilitza //ARXIU// como l'arxiu que conté l'estil del document. Utilitzat per a definir arxius CSS en documents HTML/XHTML i ´´mòduls´´ LaTeX. Aquesta opció es pot utilitzar repetides vegades amb la finalitat d'incloure múltiples arxius d'estil.
  138. : **-t**, **--target**=//TIPUS//
  139. Fixa el format del document de sortida a l'establert a //TIPUS//. Els formats de document mes corrents son: //html//, //xhtml//, //tex//, //man//, //txt//. Utilitzar l'opció ``--targets`` per a consultar els formats disponibles.
  140. : **--targets**
  141. Mostra els formats de document disponibles per als arxius de sortida i surt.
  142. : **--toc**
  143. Inclou, automaticament, una Taula de Continguts (TOC) a l'arxiu de sortida, entre la capçalera (HEADER) i el cos del document (BODY). Es possible especificar la posició de la TOC utilitzant la macro ``%%TOC``.
  144. : **--toc-level**=//NUM//
  145. Fixa el nivell màxim de la Taula de Continguts (TOC) al número especificat a //NUM//. Tots els títols inferiors a //NUM// no serán inclosos a la Taula de Continguts.
  146. : **--toc-only**
  147. Mostra la Taula de Continguts (TOC) i surt.
  148. : **-v**, **--verbose**
  149. Mostra els missatges del sistema durant el procés de conversió. Aquesta opció es pot utilitzar repetides vegades per a incrementar el nombre de missatges a mostrar.
  150. : **-V**, **--version**
  151. Mostra l'actual versió del programa i surt.
  152. : **--width**=//NUM//
  153. Fixa al número especificat a //NUM// l'amplada de les columnes de l'arxiu de sortida. Aquesta opció s'utilitza sols amb formats de sortida del tipus ASCII Art.
  154. :
  155. = ARXIU FONT =[source]
  156. Els arxius font acostumen a especificar-se mitjançant l'extensió //.t2t// (per exemple, ``arxiu.t2t``). Dins d'un arxiu font hi podem considerar tres àrees :
  157. : **Encapçalament** (opcional)
  158. Les tres primeres línies de l'arxiu. Si no es necessita encapçalament, deixar en blanc la primera línia. S'acostuma a utilitzar aquesta àrea per a posar-hi el títol del document i la informació sobre el autor, la versió, la data etc.
  159. : **Ajusts** (opcional)
  160. Comença tot just després de l'Encapçalament (4ª línia, o 2ª línia en el càs d'ometre l'encapçalament) i finalitza al començament de l'àrea del Cos del Document.
  161. Utilitzats per a implementar ajusts (configuracions) en format ``%!keyword:value``.
  162. : **Cos del Document**
  163. Comença amb la primera línia de text vàlid (que no sigui comentari o ajust) després de l'Encapçalament i s'estén fins al final del document. A aquesta àrea es a on hi trobarém el contingut del document.
  164. :
  165. = AJUSTS =[settings]
  166. Els ajusts ens permeten personalitzar **txt2tags**; son similars a les opcions. Poden emplaçar-se a: l'área d'Ajusts del document font, a l'arxiu ``~/.txt2tagsrc`` o a un arxiu extern que s'invocarà mitjançant l'opció ``--config-file``.
  167. : **%!target**
  168. Defineix el format de l'arxiu de sortida, tal com ho faria l'opció ``--target``. Exemple:
  169. ``` %!target: html
  170. : **%!options(tipo)**
  171. Defineix les opcions per defecte per a cada tipus d'arxiu de sortida. S'han d'utilitzar les opcions amb versió línia d'ordres (la que comença amb '--'). Exemple:
  172. ``` %!options(html): --toc --toc-level 3 --css-sugar
  173. : **%!includeconf**
  174. Inclou, a l'arxiu corrent, els ajusts definits a un arxiu extern, tal com ho faria l'opció ``--config-file``. Exemple:
  175. ``` %!includeconf: miconfig.t2t
  176. : **%!style**
  177. Utilitza un arxiu d'estil extern, tal com ho faria l'opció ``--style``. Es pot utilitzar repetides vegades. Exemple:
  178. ``` %!style: colores.css
  179. : **%!encoding**
  180. Defineix la codificació de caràcters que s'utilitzarà al document convertit, tal com ho faria l'opció ``--encoding``. Exemple :
  181. ``` %!encoding: UTF-8
  182. : **%!preproc**
  183. Filtre input de cercar/reemplaçar utilitzat per a realitzar canvis en el cos del document font ABANS que txt2tags realitzi qualsevol acció. La cerca utilitza expresions regulars de Python. Exemple:
  184. ``` %!preproc: "JJS" "John J. Smith"
  185. : **%!postproc**
  186. Filtre output de cercar/reemplaçar utilitzat per a realitzar canvis en el document generat DESPRÉS del complet processament per txt2tags de l'arxiu font. La cerca utilitza exresions regulars de Python. Exemple:
  187. ``` %!postproc(html): "<B>" "<STRONG>"
  188. :
  189. Si la mateixa paraula clau apareix més d'una vegada, l'ùltima trobada será que s'utilitzarà (excepcions: opcions, preproc i postproc, que son acumulatives). Les paraules claus invàlides seràn ignorades. L'odre de processament es: ``~/.txt2tagsrc``, àrea de Ajusts del document font, opció ``--config-file``.
  190. = ORDRES =[commands]
  191. Les Ordres executen tasques durant el procés de conversió. S'han d'emplaçar en el cos del document font.
  192. : **%!csv: arxiu.csv**
  193. Incorpora un arxiu CSV com una tabla.
  194. : **%!include: arxiu.t2t**
  195. Incorpora al document un arxiu txt2tags.
  196. : **%!include: ""``arxiu.txt``""**
  197. Incorpora al document un arxiu de text (verbatim).
  198. : **%!include: ""''arxiu.html''""**
  199. Incorpora al document un arxiu marcat.
  200. :
  201. = MACROS =[macros]
  202. Mitjançant les Macros podrem inserir, d'una forma fàcil, continguts dinàmics en el document convertit. S'han de definir en el cos del document font. Amb l'excepció de ``%%toc`` , totes les macros poden ser personalitzades amb directives especials, como ``%Y`` i ``%f``. Per més detalls, consulteu la **Guia del Usuario de txt2tags**.
  203. : **""%%date""**
  204. Insereix la data actual. El seu format per defecte es: ``%%date(%Y%m%d)``, que ens mostrará la data com: AAAAMMDD.
  205. : **""%%infile""**
  206. Insereix el path de l'arxiu font. El seu format per defecte es: ``%%infile(%f)``. Útil per a enllaços del tipus: ``[Veure font %%infile]``.
  207. : **""%%mtime""**
  208. Insereix la data de l'última modificació de l'arxiu font. El seu format per defecte es: ``%%date(%Y%m%d)``, que ens mostrarà la data com: AAAAMMDD.
  209. : **""%%outfile""**
  210. Insereix el path de l'arxiu final. El seu format per defecte es: ``%%outfile(%f)``. Útil en mencions del tipus: "Aquest es l'arxiu %%outfile".
  211. : **""%%toc""**
  212. Amb aquesta macro l'usuari pot fixar l'emplaçament de la Taula de Continguts (TOC). Es pot utilitzar repetides vegades. S'ha d'utilitzar conjuntament amb l'opció ``--toc``.
  213. :
  214. = EXEMPLES =[examples]
  215. : ``txt2tags -t html arxiu.t2t``
  216. Converteix a HTML, guardant el resultat com arxiu.html.
  217. : ``txt2tags -t html -o - arxiu.t2t``
  218. Converteix a HTML, mostrant el resultat a STDOUT.
  219. : ``txt2tags -t html --toc arxiu.t2t``
  220. Converteix a HTML, generant una Taula de Continguts (TOC) de forma automàtica.
  221. : ``txt2tags -t html --toc --toc-level 2 -n archivo.t2t``
  222. Converteix a HTML, amb una Taula de Continguts (TOC) a dos nivells i títols numerats.
  223. : ``txt2tags --toc-only arxiu.t2t``
  224. Ens mostra sols la Taula de Continguts (TOC), sense realitzar cap mena de conversió en el document font.
  225. : ``txt2tags -t html --css-sugar --style base.css --style ui.css arxiu.t2t``
  226. Converteix a HTML, preparant el codi resultat per a poder utilitzar CSS, incloent-hi també una crida a dos arxius CSS externs (base.css y ui.css).
  227. : ``txt2tags -t art --slides --width 80 --height 25 -o - arxiu.t2t | more``
  228. Crea una presentació de diapositives tipus ASCII Art, apta para a ser visionada amb un terminal pantalla/finestra 80x25.
  229. : ``(echo ; echo "**bold**") | txt2tags -t html -H -``
  230. Pràctica forma de realitzar comprovacions ràpides utilitzant STDIN.
  231. : ``txt2tags -t html -o - arxiu.t2t | tidy > arxiu.html``
  232. Envia el resultat a STDOUT, desde on se'l redirigeix a un programa extern (tidy) abans de ser guardat.
  233. :
  234. = ARXIUS =[files]
  235. : ~/.txt2tagsrc
  236. Arxiu de configuració de l'usuari, per defecte.
  237. :
  238. = ENTORN =[environment]
  239. : T2TCONFIG
  240. Si no es nul, defineix el pathname de l'arxiu de configuració de l'usuari per defecte.
  241. :
  242. = AUTOR =[author]
  243. Aurelio Jargas <verde@aurelio.net>
  244. Traducció al català realitzada per Antoni Serra Devecchi <antoni.serra@gmail.com>
  245. = BUGS =[bugs]
  246. http://bugs.txt2tags.org
  247. = COPYRIGHT =[copyright]
  248. Copyright (C) 2001-%%date(%Y) Aurelio Jargas, GNU GPL v2