/doc/Catalan/manpage-ca.html

http://txt2tags.googlecode.com/ · HTML · 472 lines · 458 code · 14 blank · 0 comment · 0 complexity · e773d62889a4407cfffe219809b4e92b MD5 · raw file 

    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
    2. 

  2. <HTML>
    3. 

  3. <HEAD>
    4. 

  4. <STYLE>body{margin:3em;} pre{background:#ffc;}</STYLE>
    5. 

  5. <META NAME="generator" CONTENT="http://txt2tags.org">
    6. 

  6. <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8">
    7. 

  7. <TITLE>TXT2TAGS</TITLE>
    8. 

  8. </HEAD><BODY BGCOLOR="white" TEXT="black">
    9. 

  9. <CENTER>
    10. 

  10. <H1>TXT2TAGS</H1>
    11. 

  11. <FONT SIZE="4">Aug, 2010</FONT>
    12. 

  12. </CENTER>
    13. 

  13. 

  14. <P></P>
    15. 

  15. <HR NOSHADE SIZE=1>
    16. 

  16. <P></P>
    17. 

  17. 

  18.   <UL>
    19. 

  19.   <LI><A HREF="#name">NOM</A>
    20. 

  20.   <LI><A HREF="#synopsis">SINOPSI</A>
    21. 

  21.   <LI><A HREF="#description">DESCRIPCIÓ</A>
    22. 

  22.   <LI><A HREF="#markup">MARCAT</A>
    23. 

  23.   <LI><A HREF="#options">OPCIONS</A>
    24. 

  24.   <LI><A HREF="#source">ARXIU FONT</A>
    25. 

  25.   <LI><A HREF="#settings">AJUSTS</A>
    26. 

  26.   <LI><A HREF="#commands">ORDRES</A>
    27. 

  27.   <LI><A HREF="#macros">MACROS</A>
    28. 

  28.   <LI><A HREF="#examples">EXEMPLES</A>
    29. 

  29.   <LI><A HREF="#files">ARXIUS</A>
    30. 

  30.   <LI><A HREF="#environment">ENTORN</A>
    31. 

  31.   <LI><A HREF="#author">AUTOR</A>
    32. 

  32.   <LI><A HREF="#bugs">BUGS</A>
    33. 

  33.   <LI><A HREF="#copyright">COPYRIGHT</A>
    34. 

  34.   </UL>
    35. 

  35. 

  36. <P></P>
    37. 

  37. <HR NOSHADE SIZE=1>
    38. 

  38. <P></P>
    39. 

  39. 

  40. <A NAME="name"></A>
    41. 

  41. <H1>NOM</H1>
    42. 

  42. 

  43. <P>
    44. 

  44. txt2tags - Eina de formatació i conversió de texte.
    45. 

  45. </P>
    46. 

  46. 

  47. <A NAME="synopsis"></A>
    48. 

  48. <H1>SINOPSI</H1>
    49. 

  49. 

  50. <P>
    51. 

  51. <B>txt2tags</B> [<I>opcions</I>] [<I>ARXIU</I>...]
    52. 

  52. </P>
    53. 

  53. 

  54. <A NAME="description"></A>
    55. 

  55. <H1>DESCRIPCIÓ</H1>
    56. 

  56. 

  57. <P>
    58. 

  58. <B>txt2tags</B> llegeig un arxiu de texte que ha estat mínimament marcat i el converteix las siguents formats:
    59. 

  59. <I>ASCII Art</I>,
    60. 

  60. <I>AsciiDoc</I>,
    61. 

  61. <I>Creole</I>,
    62. 

  62. <I>DocBook</I>,
    63. 

  63. <I>DokuWiki</I>,
    64. 

  64. <I>Google Code Wiki</I>,
    65. 

  65. <I>HTML</I>,
    66. 

  66. <I>LaTeX</I>,
    67. 

  67. <I>Lout</I>,
    68. 

  68. <I>MagicPoint</I>,
    69. 

  69. <I>Man page</I>,
    70. 

  70. <I>MoinMoin</I>,
    71. 

  71. <I>PageMaker</I>,
    72. 

  72. <I>Plain Text (Texte Plà)</I>,
    73. 

  73. <I>PmWiki</I>,
    74. 

  74. <I>SGML</I>,
    75. 

  75. <I>Wikipedia</I> 
    76. 

  76. <I>XHTML</I>.
    77. 

  77. </P>
    78. 

  78. <P>
    79. 

  79. Aquesta pàgina de manual (Man page) fou creada amb <B>txt2tags</B> 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.
    80. 

  80. </P>
    81. 

  81. <P>
    82. 

  82. UNA única font, MÚLTIPLES formats de sortida - <A HREF="http://txt2tags.org">http://txt2tags.org</A>
    83. 

  83. </P>
    84. 

  84. 

  85. <A NAME="markup"></A>
    86. 

  86. <H1>MARCAT</H1>
    87. 

  87. 

  88. <PRE>
    89. 

  89.   Encapçalaments            Les primeres tres línies de l'arxiu font.
    90. 

  90.   Títol                     = texte =
    91. 

  91.   Títol numerat             + texte +
    92. 

  92.   Comentari                 % comentaris
    93. 

  93.   Línia de separació        -----------------------...
    94. 

  94.   Línia gruixuda            =======================...
    95. 

  95.   Imàgen                    [nom.jpg]
    96. 

  96.   Enlaç                     [etiqueta url]
    97. 

  97.   
    98. 

  98.   Negreta                   **texte**
    99. 

  99.   Cursiva                   //texte//
    100. 

  100.   ratllat                   __texte__
    101. 

  101.   Tatxat                    --texte--
    102. 

  102.   Monoespai                 ``texte``
    103. 

  103.   Raw                       ""texte""
    104. 

  104.   Etiquetat                 ''texte''
    105. 

  105.   
    106. 

  106.   Paràgraf                  texte
    107. 

  107.   Cita                      &lt;TAB&gt;texte
    108. 

  108.   Llista                    - texte
    109. 

  109.   Llista numerada           + texte
    110. 

  110.   Llista de definició       : texte
    111. 

  111.   Taula                     | cel.la1 | cel.la2 | cel.la3...
    112. 

  112.   
    113. 

  113.   Línia verbatim            ``` texte
    114. 

  114.   Línia Raw                 """ texte
    115. 

  115.   Línia Etiquetada          ''' texte
    116. 

  116.   
    117. 

  117.   Bloc Verbatim             ```
    118. 

  118.                             línies
    119. 

  119.                             ```
    120. 

  120.   Bloc Raw                  """
    121. 

  121.                             línies
    122. 

  122.                             """
    123. 

  123.   Bloc etiquetat            '''
    124. 

  124.                             línies
    125. 

  125.                             '''
    126. 

  126. </PRE>
    127. 

    128. 

  128. <A NAME="options"></A>
    129. 

  129. <H1>OPCIONS</H1>
    130. 

    131. 

  131. <DL>
    132. 

  132. <DT><B>-C</B>, <B>--config-file</B>=<I>ARXIU</I></DT><DD>
    133. 

  133. Llegeig la configuració (ajusts) especificats a l'arxiu extern   <I>ARXIU</I>. La configuració ha d'estar en format   <I>%!keyword:value</I>. Per a més detalls, consultar la secció  <A HREF="#settings">AJUSTS</A>.
    134. 

  134. <P></P>
    135. 

  135. <DT>    <B>--css-sugar</B></DT><DD>
    136. 

  136. 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 :  <I>#header</I>,  <I>#body</I>,  <I>.toc</I>.
    137. 

  137. <P></P>
    138. 

  138. <DT>    <B>--css-inside</B></DT><DD>
    139. 

  139. Insereix el contingut d'un arxiu CSS dins l'encapçalament  HTML/XHTML. Utilitzar  <CODE>--style</CODE>  per especificar l'arxiu CSS que s'ha de llegir.
    140. 

  140. <P></P>
    141. 

  141. <DT>    <B>--dump-config</B></DT><DD>
    142. 

  142. Mostra tota la configuració (ajusts) i surt.
    143. 

  143. <P></P>
    144. 

  144. <DT>    <B>--dump-source</B></DT><DD>
    145. 

  145. Mostra el document font, amb totes les seves les inclusions  (<CODE>%!include</CODE>) expandides.
    146. 

  146. <P></P>
    147. 

  147. <DT>    <B>--encoding</B>=<I>CODI</I></DT><DD>
    148. 

  148. Estableix la configuració de caràcters que s'utilitzarà a l'arxiu de sortida, utilitzant l'establerta a  <I>CODI</I>. Exemples de  <I>CODI</I>: UTF-8 y iso-8859-1.
    149. 

  149. <P></P>
    150. 

  150. <DT>    <B>--gui</B></DT><DD>
    151. 

  151. Activa la Interfície Gráfica Tk.
    152. 

  152. <P></P>
    153. 

  153. <DT><B>-h</B>, <B>--help</B></DT><DD>
    154. 

  154. Mostra la informació d'ajut i surt.
    155. 

  155. <P></P>
    156. 

  156. <DT><B>-H</B>, <B>--no-headers</B></DT><DD>
    157. 

  157. Elimina els encapçalaments i els peus de pàgina de l'arxiu de sortida. Sols es mostraràn els continguts (cos del document).
    158. 

  158. <P></P>
    159. 

  159. <DT>    <B>--headers</B></DT><DD>
    160. 

  160. Mostra els encapçalaments i els peus de pàgina de l'arxiu de sortida. Per defecte: ON.
    161. 

  161. <P></P>
    162. 

  162. <DT>    <B>--height</B>=<I>NUM</I></DT><DD>
    163. 

  163. Fixa el nombre de línies de l'arxiu de sortida a l'establert a  <I>NUM</I>. Aquesta opció s'utilitza sols amb formats de sortida  ASCII Art, quan també s'estigui utilitzant l'opció <CODE>--slides</CODE>.
    164. 

  164. <P></P>
    165. 

  165. <DT><B>-i</B>, <B>--infile</B>=<I>ARXIU</I></DT><DD>
    166. 

  166. Pren  <I>ARXIU</I>  com l'arxiu font. Utilitzar '-' per a llegir la font des de STDIN.
    167. 

  167. <P></P>
    168. 

  168. <DT>    <B>--mask-email</B></DT><DD>
    169. 

  169. Oculta els emails als robots de spam. Elimina @ i punts. L'adreça foo@bar.com esdevé &lt;foo (a) bar com&gt;.
    170. 

  170. <P></P>
    171. 

  171. <DT><B>-n</B>, <B>--enum-title</B></DT><DD>
    172. 

  172. Activa la numeració automàtica dels títols. Està prefixada a: 1, 1.1, 1.1.1, ...
    173. 

  173. <P></P>
    174. 

  174. <DT>    <B>--no-dump-config</B></DT><DD>
    175. 

  175. Anul.la  l'acció  <CODE>--dump-config</CODE>.
    176. 

  176. <P></P>
    177. 

  177. <DT>    <B>--no-dump-source</B></DT><DD>
    178. 

  178. Anul.la  l'acció  <CODE>--dump-source</CODE>.
    179. 

  179. <P></P>
    180. 

  180. <DT>    <B>--no-encoding</B></DT><DD>
    181. 

  181. Anul.la la configuració de caràcters.
    182. 

  182. <P></P>
    183. 

  183. <DT>    <B>--no-enum-title</B></DT><DD>
    184. 

  184. Desactiva la numeració automàtica dels títols.
    185. 

  185. <P></P>
    186. 

  186. <DT>    <B>--no-infile</B></DT><DD>
    187. 

  187. Anul.la tota anterior declaració   <CODE>--infile</CODE>.
    188. 

  188. <P></P>
    189. 

  189. <DT>    <B>--no-targets</B></DT><DD>
    190. 

  190. Anul.la l'acció   <CODE>--targets</CODE>.
    191. 

  191. <P></P>
    192. 

  192. <DT>    <B>--no-mask-email</B></DT><DD>
    193. 

  193. Desactiva l'ocultació dels emails.
    194. 

  194. <P></P>
    195. 

  195. <DT>    <B>--no-outfile</B></DT><DD>
    196. 

  196. Anul.la tota anterior declaració  <CODE>--outfile</CODE>.
    197. 

  197. <P></P>
    198. 

  198. <DT>    <B>--no-quiet</B></DT><DD>
    199. 

  199. Mostra els missatges del sistema, desactiva l'opció  <CODE>--quiet</CODE>.
    200. 

  200. <P></P>
    201. 

  201. <DT>    <B>--no-rc</B></DT><DD>
    202. 

  202. No llegir a l'arxiu de configuració (ajusts) de l'usuari   ~/.txt2tagsrc.
    203. 

  203. <P></P>
    204. 

  204. <DT>    <B>--no-slides</B></DT><DD>
    205. 

  205. Desactiva  <CODE>--slides</CODE>.
    206. 

  206. <P></P>
    207. 

  207. <DT>    <B>--no-style</B></DT><DD>
    208. 

  208. Desactiva tots els ajusts d'estil.
    209. 

  209. <P></P>
    210. 

  210. <DT>    <B>--no-toc</B></DT><DD>
    211. 

  211. Elimina la Taula de Continguts (TOC) a l'arxiu de sortida.
    212. 

  212. <P></P>
    213. 

  213. <DT>    <B>--no-toc-only</B></DT><DD>
    214. 

  214. Desactiva l'acció  <CODE>--toc-only</CODE>.
    215. 

  215. <P></P>
    216. 

  216. <DT><B>-o</B>, <B>--outfile</B>=<I>ARXIU</I></DT><DD>
    217. 

  217. Pren  <I>ARXIU</I>  com a nom per a l'arxiu de sortida. Utilitzar '-' per a dirigir els resultats a STDOUT.
    218. 

  218. <P></P>
    219. 

  219. <DT><B>-q</B>, <B>--quiet</B></DT><DD>
    220. 

  220. Mode silenciós. Suprimeix tots els missatges del sistema, excepte els dels errors.
    221. 

  221. <P></P>
    222. 

  222. <DT>    <B>--rc</B></DT><DD>
    223. 

  223. Llegeig a l'arxiu de configuració de l'usuari  ~/.txt2tagsrc. Per defecte: ON.
    224. 

  224. <P></P>
    225. 

  225. <DT>    <B>--slides</B></DT><DD>
    226. 

  226. Formata l'arxiu de sortida com una presentació de diapositives. Aquesta opció s'utilitza sols amb formats de sortida ASCII Art.
    227. 

  227. <P></P>
    228. 

  228. <DT>    <B>--style</B>=<I>ARXIU</I></DT><DD>
    229. 

  229. Utilitza  <I>ARXIU</I>  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.
    230. 

  230. <P></P>
    231. 

  231. <DT><B>-t</B>, <B>--target</B>=<I>TIPUS</I></DT><DD>
    232. 

  232. Fixa el format del document de sortida a l'establert a  <I>TIPUS</I>. Els formats de document mes corrents son: <I>html</I>, <I>xhtml</I>, <I>tex</I>, <I>man</I>, <I>txt</I>. Utilitzar l'opció  <CODE>--targets</CODE> per a consultar els formats disponibles.
    233. 

  233. <P></P>
    234. 

  234. <DT>    <B>--targets</B></DT><DD>
    235. 

  235. Mostra els formats de document disponibles per als arxius de sortida i surt.
    236. 

  236. <P></P>
    237. 

  237. <DT>    <B>--toc</B></DT><DD>
    238. 

  238. 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 <CODE>%%TOC</CODE>.
    239. 

  239. <P></P>
    240. 

  240. <DT>    <B>--toc-level</B>=<I>NUM</I></DT><DD>
    241. 

  241. Fixa el nivell màxim de la Taula de Continguts (TOC) al número especificat a  <I>NUM</I>. Tots els títols inferiors a  <I>NUM</I> no serán inclosos a la Taula de Continguts.
    242. 

  242. <P></P>
    243. 

  243. <DT>    <B>--toc-only</B></DT><DD>
    244. 

  244. Mostra la Taula de Continguts (TOC) i surt.
    245. 

  245. <P></P>
    246. 

  246. <DT><B>-v</B>, <B>--verbose</B></DT><DD>
    247. 

  247. 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.
    248. 

  248. <P></P>
    249. 

  249. <DT><B>-V</B>, <B>--version</B></DT><DD>
    250. 

  250. Mostra l'actual versió del programa i surt.
    251. 

  251. <P></P>
    252. 

  252. <DT>    <B>--width</B>=<I>NUM</I> </DT><DD>
    253. 

  253. Fixa al número especificat a  <I>NUM</I>  l'amplada de les columnes de l'arxiu de sortida. Aquesta opció s'utilitza sols amb formats de sortida del tipus ASCII Art.
    254. 

  254. </DL>
    255. 

    256. 

  256. <A NAME="source"></A>
    257. 

  257. <H1>ARXIU FONT</H1>
    258. 

    259. 

  259. <P>
    260. 

  260. Els arxius font acostumen a especificar-se mitjançant l'extensió  <I>.t2t</I>  (per exemple, <CODE>arxiu.t2t</CODE>). Dins d'un arxiu font hi podem considerar tres àrees :
    261. 

  261. </P>
    262. 

    263. 

  263. <DL>
    264. 

  264. <DT><B>Encapçalament</B> (opcional)</DT><DD>
    265. 

  265. 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.
    266. 

  266. <P></P>
    267. 

  267. <DT><B>Ajusts</B> (opcional)</DT><DD>
    268. 

  268. 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.
    269. 

  269. Utilitzats per a implementar ajusts (configuracions) en format  <CODE>%!keyword:value</CODE>.
    270. 

  270. <P></P>
    271. 

  271. <DT><B>Cos del Document</B></DT><DD>
    272. 

  272. 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.
    273. 

  273. </DL>
    274. 

    275. 

  275. <A NAME="settings"></A>
    276. 

  276. <H1>AJUSTS</H1>
    277. 

    278. 

  278. <P>
    279. 

  279. Els ajusts ens permeten personalitzar  <B>txt2tags</B>; son similars a les opcions. Poden emplaçar-se a: l'área d'Ajusts del document font, a l'arxiu  <CODE>~/.txt2tagsrc</CODE> o a un arxiu extern que s'invocarà mitjançant l'opció  <CODE>--config-file</CODE>.
    280. 

  280. </P>
    281. 

    282. 

  282. <DL>
    283. 

  283. <DT><B>%!target</B></DT><DD>
    284. 

  284. Defineix el format de l'arxiu de sortida, tal com ho faria l'opció  <CODE>--target</CODE>. Exemple:
    285. 

    286. 

  286. <PRE>
    287. 

  287.   %!target: html
    288. 

  288. </PRE>
    289. 

    290. 

  290. <P></P>
    291. 

  291. <DT><B>%!options(tipo)</B></DT><DD>
    292. 

  292. 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:
    293. 

    294. 

  294. <PRE>
    295. 

  295.   %!options(html): --toc --toc-level 3 --css-sugar
    296. 

  296. </PRE>
    297. 

    298. 

  298. <P></P>
    299. 

  299. <DT><B>%!includeconf</B></DT><DD>
    300. 

  300. Inclou, a l'arxiu corrent, els ajusts definits a un arxiu extern, tal com ho faria l'opció  <CODE>--config-file</CODE>. Exemple:
    301. 

    302. 

  302. <PRE>
    303. 

  303.   %!includeconf: miconfig.t2t
    304. 

  304. </PRE>
    305. 

    306. 

  306. <P></P>
    307. 

  307. <DT><B>%!style</B> </DT><DD>
    308. 

  308. Utilitza un arxiu d'estil extern, tal com ho faria l'opció  <CODE>--style</CODE>. Es pot utilitzar repetides vegades. Exemple:
    309. 

    310. 

  310. <PRE>
    311. 

  311.   %!style: colores.css
    312. 

  312. </PRE>
    313. 

    314. 

  314. <P></P>
    315. 

  315. <DT><B>%!encoding</B></DT><DD>
    316. 

  316. Defineix la codificació de caràcters que s'utilitzarà al document convertit, tal com ho faria l'opció  <CODE>--encoding</CODE>. Exemple :
    317. 

    318. 

  318. <PRE>
    319. 

  319.   %!encoding: UTF-8
    320. 

  320. </PRE>
    321. 

    322. 

  322. <P></P>
    323. 

  323. <DT><B>%!preproc</B></DT><DD>
    324. 

  324. 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:
    325. 

    326. 

  326. <PRE>
    327. 

  327.   %!preproc:  "JJS"  "John J. Smith"
    328. 

  328. </PRE>
    329. 

    330. 

  330. <P></P>
    331. 

  331. <DT><B>%!postproc</B></DT><DD>
    332. 

  332. 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:
    333. 

    334. 

  334. <PRE>
    335. 

  335.   %!postproc(html):  "&lt;B&gt;"  "&lt;STRONG&gt;"
    336. 

  336. </PRE>
    337. 

    338. 

  338. </DL>
    339. 

    340. 

  340. <P>
    341. 

  341. 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:  <CODE>~/.txt2tagsrc</CODE>, àrea de Ajusts del document font, opció  <CODE>--config-file</CODE>.
    342. 

  342. </P>
    343. 

    344. 

  344. <A NAME="commands"></A>
    345. 

  345. <H1>ORDRES</H1>
    346. 

    347. 

  347. <P>
    348. 

  348. Les Ordres executen tasques durant el procés de conversió. S'han d'emplaçar en el cos del document font.
    349. 

  349. </P>
    350. 

    351. 

  351. <DL>
    352. 

  352. <DT><B>%!csv: arxiu.csv</B></DT><DD>
    353. 

  353. Incorpora un arxiu CSV com una tabla.
    354. 

  354. <P></P>
    355. 

  355. <DT><B>%!include: arxiu.t2t</B></DT><DD>
    356. 

  356. Incorpora al document un arxiu txt2tags.
    357. 

  357. <P></P>
    358. 

  358. <DT><B>%!include: ``arxiu.txt``</B></DT><DD>
    359. 

  359. Incorpora al document un arxiu de text (verbatim).
    360. 

  360. <P></P>
    361. 

  361. <DT><B>%!include: ''arxiu.html''</B></DT><DD>
    362. 

  362. Incorpora al document un arxiu marcat.
    363. 

  363. </DL>
    364. 

    365. 

  365. <A NAME="macros"></A>
    366. 

  366. <H1>MACROS</H1>
    367. 

    368. 

  368. <P>
    369. 

  369. 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  <CODE>%%toc</CODE> , totes les macros poden ser personalitzades amb directives especials, como  <CODE>%Y</CODE> i  <CODE>%f</CODE>. Per més detalls, consulteu la <B>Guia del Usuario de txt2tags</B>.
    370. 

  370. </P>
    371. 

    372. 

  372. <DL>
    373. 

  373. <DT><B>%%date</B></DT><DD>
    374. 

  374. Insereix la data actual. El seu format per defecte es:  <CODE>%%date(%Y%m%d)</CODE>,  que ens mostrará la data com: AAAAMMDD.
    375. 

  375. <P></P>
    376. 

  376. <DT><B>%%infile</B></DT><DD>
    377. 

  377. Insereix el path de l'arxiu font. El seu format per defecte es:  <CODE>%%infile(%f)</CODE>.  Útil per a enllaços del tipus: <CODE>[Veure font %%infile]</CODE>.
    378. 

  378. <P></P>
    379. 

  379. <DT><B>%%mtime</B></DT><DD>
    380. 

  380. Insereix la data de l'última modificació de l'arxiu font. El seu format per defecte es:  <CODE>%%date(%Y%m%d)</CODE>, que ens mostrarà la data com: AAAAMMDD.
    381. 

  381. <P></P>
    382. 

  382. <DT><B>%%outfile</B></DT><DD>
    383. 

  383. Insereix el path de l'arxiu final. El seu format per defecte es:  <CODE>%%outfile(%f)</CODE>. Útil en mencions del tipus: "Aquest es l'arxiu manpage-ca.html".
    384. 

  384. <P></P>
    385. 

  385. <DT><B>%%toc</B></DT><DD>
    386. 

  386. 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ó  <CODE>--toc</CODE>.
    387. 

  387. </DL>
    388. 

    389. 

  389. <A NAME="examples"></A>
    390. 

  390. <H1>EXEMPLES</H1>
    391. 

    392. 

  392. <DL>
    393. 

  393. <DT><CODE>txt2tags -t html arxiu.t2t</CODE></DT><DD>
    394. 

  394. <P></P>
    395. 

  395. Converteix a HTML, guardant el resultat com arxiu.html.
    396. 

  396. <P></P>
    397. 

  397. <DT><CODE>txt2tags -t html -o - arxiu.t2t</CODE></DT><DD>
    398. 

  398. <P></P>
    399. 

  399. Converteix a HTML, mostrant el resultat a STDOUT.
    400. 

  400. <P></P>
    401. 

  401. <DT><CODE>txt2tags -t html --toc arxiu.t2t</CODE></DT><DD>
    402. 

  402. <P></P>
    403. 

  403. Converteix a HTML, generant una Taula de Continguts (TOC) de forma automàtica.
    404. 

  404. <P></P>
    405. 

  405. <DT><CODE>txt2tags -t html --toc --toc-level 2 -n archivo.t2t</CODE></DT><DD>
    406. 

  406. <P></P>
    407. 

  407. Converteix a HTML, amb una Taula de Continguts (TOC) a dos nivells i títols numerats.
    408. 

  408. <P></P>
    409. 

  409. <DT><CODE>txt2tags --toc-only arxiu.t2t</CODE></DT><DD>
    410. 

  410. <P></P>
    411. 

  411. Ens mostra sols la Taula de Continguts (TOC), sense realitzar cap mena de conversió en el document font.
    412. 

  412. <P></P>
    413. 

  413. <DT><CODE>txt2tags -t html --css-sugar --style base.css --style ui.css arxiu.t2t</CODE></DT><DD>
    414. 

  414. <P></P>
    415. 

  415. 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).
    416. 

  416. <P></P>
    417. 

  417. <DT><CODE>txt2tags -t art --slides --width 80 --height 25 -o - arxiu.t2t | more</CODE></DT><DD>
    418. 

  418. <P></P>
    419. 

  419. Crea una presentació de diapositives tipus ASCII Art, apta para a ser visionada amb un terminal pantalla/finestra 80x25.
    420. 

  420. <P></P>
    421. 

  421. <DT><CODE>(echo ; echo "**bold**") | txt2tags -t html -H -</CODE></DT><DD>
    422. 

  422. <P></P>
    423. 

  423. Pràctica forma de realitzar comprovacions ràpides utilitzant STDIN.
    424. 

  424. <P></P>
    425. 

  425. <DT><CODE>txt2tags -t html -o - arxiu.t2t | tidy &gt; arxiu.html</CODE></DT><DD>
    426. 

  426. <P></P>
    427. 

  427. Envia el resultat a STDOUT, desde on se'l redirigeix a un programa extern (tidy) abans de ser guardat.
    428. 

  428. </DL>
    429. 

    430. 

  430. <A NAME="files"></A>
    431. 

  431. <H1>ARXIUS</H1>
    432. 

    433. 

  433. <DL>
    434. 

  434. <DT>~/.txt2tagsrc</DT><DD>
    435. 

  435. Arxiu de configuració de l'usuari, per defecte.
    436. 

  436. </DL>
    437. 

    438. 

  438. <A NAME="environment"></A>
    439. 

  439. <H1>ENTORN</H1>
    440. 

    441. 

  441. <DL>
    442. 

  442. <DT>T2TCONFIG</DT><DD>
    443. 

  443. Si no es nul, defineix el pathname de l'arxiu de configuració de l'usuari per defecte.
    444. 

  444. </DL>
    445. 

    446. 

  446. <A NAME="author"></A>
    447. 

  447. <H1>AUTOR</H1>
    448. 

    449. 

  449. <P>
    450. 

  450. Aurelio Jargas &lt;&lt;verde (a) aurelio net&gt;&gt;
    451. 

  451. </P>
    452. 

  452. <P>
    453. 

  453. Traducció al català realitzada per Antoni Serra Devecchi &lt;&lt;antoni serra (a) gmail com&gt;&gt;
    454. 

  454. </P>
    455. 

    456. 

  456. <A NAME="bugs"></A>
    457. 

  457. <H1>BUGS</H1>
    458. 

    459. 

  459. <P>
    460. 

  460. <A HREF="http://bugs.txt2tags.org">http://bugs.txt2tags.org</A>
    461. 

  461. </P>
    462. 

    463. 

  463. <A NAME="copyright"></A>
    464. 

  464. <H1>COPYRIGHT</H1>
    465. 

    466. 

  466. <P>
    467. 

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

  468. </P>
    469. 

    470. 

  470. <!-- html code generated by txt2tags 2.6 (http://txt2tags.org) -->
    471. 

  471. <!-- cmdline: txt2tags -t html doc/Catalan/manpage-ca.t2t -->
    472. 

  472. </BODY></HTML>
    473.