/doc/Portuguese/userguide-pt.html

http://txt2tags.googlecode.com/ · HTML · 2503 lines · 2348 code · 155 blank · 0 comment · 0 complexity · 10c3d69f49fe24423985d57058a5a0ea MD5 · raw file

Large files are truncated click here to view the full file

    

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

  2. <HTML>
    3. 

  3. <HEAD>
    4. 

  4. <STYLE TYPE="text/css">
    5. 

  5. body {background-color:#ddeeff; color:black;   
    6. 

  6.       margin:2em; text-align:justify;}         
    7. 

  7. a {text-decoration:none;}
    8. 

  8. a:hover {color:red;}
    9. 

  9. a:visited {color:purple;}
    10. 

  10. dl {margin:1em;}    
    11. 

  11. h1 {text-align:center; background-color:blue;  
    12. 

  12.     color:white; padding:8px;}                 
    13. 

  13. h2 {padding-top:20px;}
    14. 

  14. hr {border-style:none;}
    15. 

  15. code {background-color:lightblue;}             
    16. 

  16. table {border-style:solid; border-color:black;}
    17. 

  17. th {background-color:lightblue; padding:1em;}  
    18. 

  18. td {border-style:none; background-color:white;}
    19. 

  19. pre {border-style:solid; border-width:1px 1px; 
    20. 

  20.      background-color:lightblue; padding:8px;  
    21. 

  21.      border-color:black;}                      
    22. 

  22. </STYLE>
    23. 

  23. <META NAME="generator" CONTENT="http://txt2tags.org">
    24. 

  24. <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8">
    25. 

  25. <TITLE>Guia do Usuário Txt2tags</TITLE>
    26. 

  26. </HEAD><BODY BGCOLOR="white" TEXT="black">
    27. 

  27. <CENTER>
    28. 

  28. <H1>Guia do Usuário Txt2tags</H1>
    29. 

  29. <FONT SIZE="4"><I>Aurelio, Wed Jan 11 20:53:37 2012</I></FONT><BR>
    30. 

  30. <FONT SIZE="4">Tradução para o português: César A. K. Grossman</FONT>
    31. 

  31. </CENTER>
    32. 

  32. 

  33. <P></P>
    34. 

  34. <HR NOSHADE SIZE=1>
    35. 

  35. <P></P>
    36. 

  36. 

  37.   <UL>
    38. 

  38.   <LI><A HREF="#toc1">Sobre este documento</A>
    39. 

  39.   <LI><A HREF="#toc2">Parte I - Introdução ao Txt2tags</A>
    40. 

  40.     <UL>
    41. 

  41.     <LI><A HREF="#toc3">Suas Primeiras Questões</A>
    42. 

  42.     <LI><A HREF="#toc4">Estruturas de Formatação Suportadas</A>
    43. 

  43.     <LI><A HREF="#toc5">Formatos Suportados</A>
    44. 

  44.     <LI><A HREF="#estruturas">Situação dos Formatos-Destino para as Estruturas Suportadas</A>
    45. 

  45.     <LI><A HREF="#toc7">As Três Interfaces ao Usuário: GUI, Web e Linha de Comando</A>
    46. 

  46.     </UL>
    47. 

  47.   <LI><A HREF="#instalacao">Parte II - OK, eu quero um. E agora?</A>
    48. 

  48.     <UL>
    49. 

  49.     <LI><A HREF="#toc9">Download e Instalação do Python</A>
    50. 

  50.     <LI><A HREF="#toc10">Copiando o txt2tags</A>
    51. 

  51.     <LI><A HREF="#toc11">Instalação do txt2tags</A>
    52. 

  52.     <LI><A HREF="#sintaxe">Instalar os Arquivos de Sintaxe dos Editores de Texto</A> <b>[NOVO!]</b>
    53. 

  53.     </UL>
    54. 

  54.   <LI><A HREF="#toc13">Parte III - Escrevendo e Convertendo Seu Primeiro Documento</A>
    55. 

  55.     <UL>
    56. 

  56.     <LI><A HREF="#toc14">As Áreas do documento .t2t</A>
    57. 

  57.     </UL>
    58. 

  58.   <LI><A HREF="#toc15">Parte IV - Dominando o Txt2tags</A>
    59. 

  59.     <UL>
    60. 

  60.     <LI><A HREF="#toc16">A Área de Cabeçalho</A>
    61. 

  61.     <LI><A HREF="#toc17">A Área de Configuração</A>
    62. 

  62.     <LI><A HREF="#toc18">O Corpo do Texto</A>
    63. 

  63.     <LI><A HREF="#regras">Marcações (REGRAS)</A>
    64. 

  64.     <LI><A HREF="#data">A macro %%date</A>
    65. 

  65.     <LI><A HREF="#include">O comando %!include</A>
    66. 

  66.     </UL>
    67. 

  67.   <LI><A HREF="#settings">Parte V - Dominando as Diretivas de Configuração</A>
    68. 

  68.     <UL>
    69. 

  69.     <LI><A HREF="#toc23">%!Target</A> <b>[NOVO!]</b>
    70. 

  70.     <LI><A HREF="#toc24">%!Options</A> <b>[NOVO!]</b>
    71. 

  71.     <LI><A HREF="#toc25">%!Encoding</A>
    72. 

  72.     <LI><A HREF="#toc26">%!PreProc</A>
    73. 

  73.     <LI><A HREF="#toc27">%!PostProc</A>
    74. 

  74.     <LI><A HREF="#toc28">%!Style</A>
    75. 

  75.     <LI><A HREF="#toc29">Detalhes dos Filtros PreProc e PostProc</A>
    76. 

  76.     <LI><A HREF="#toc30">Definindo uma Configuração para um Tipo-Destino Específico</A>
    77. 

  77.     <LI><A HREF="#toc31">RC, CONF e a precedência de linha de comando</A> <b>[NOVO!]</b>
    78. 

  78.     </UL>
    79. 

  79.   <LI><A HREF="#toc32">Parte VI - Magia Negra</A>
    80. 

  80.     <UL>
    81. 

  81.     <LI><A HREF="#toc33">Inserindo Múltiplas Linhas com %!PostProc (como regras CSS)</A>
    82. 

  82.     <LI><A HREF="#toc34">Criando Conteúdo "Específico ao Tipo Destino", com %!PreProc</A>
    83. 

  83.     <LI><A HREF="#toc35">Mudando Marcas txt2tags com %!PreProc</A>
    84. 

  84.     </UL>
    85. 

  85.   <LI><A HREF="#historia">Parte VII - História do txt2tags</A>
    86. 

  86.     <UL>
    87. 

  87.     <LI><A HREF="#toc37">Janeiro de 1999: Pré História</A>
    88. 

  88.     <LI><A HREF="#toc38">Junho 1999: Ainda Pré-História</A>
    89. 

  89.     <LI><A HREF="#toc39">Agosto de 2000: Não Mais Pré-História</A>
    90. 

  90.     <LI><A HREF="#toc40">Julho de 2001: Debute das séries 0.x (Lançamento Mundial)</A>
    91. 

  91.     <LI><A HREF="#toc41">Setembro de 2002: Debute das séries 1.x</A>
    92. 

  92.     <LI><A HREF="#toc42">2002, 2003... e as História não pára</A>
    93. 

  93.     </UL>
    94. 

  94.   </UL>
    95. 

  95. 

  96. <P></P>
    97. 

  97. <HR NOSHADE SIZE=1>
    98. 

  98. <P></P>
    99. 

  99. 

  100. <H1 ID="toc1">Sobre este documento</H1>
    101. 

  101. 

  102. 	<BLOCKQUOTE>
    103. 

  103. 	Olá, eu sou o guia do usuário do txt2tags!
    104. 

  104. 	</BLOCKQUOTE>
    105. 

  105. 	<BLOCKQUOTE>
    106. 

  106. 	Aqui você encontra toda a informação disponível sobre a
    107. 

  107. 	ferramenta de conversão de textos txt2tags.
    108. 

  108. 	</BLOCKQUOTE>
    109. 

  109. 	<BLOCKQUOTE>
    110. 

  110. 	Minha versão atualizada pode ser encontrada em
    111. 

  111. 	<A HREF="http://txt2tags.org/userguide/">http://txt2tags.org/userguide/</A>
    112. 

  112. 	</BLOCKQUOTE>
    113. 

  113. 	<BLOCKQUOTE>
    114. 

  114. 	Para mais informações e versões recentes, visite
    115. 

  115. 	<A HREF="http://txt2tags.org/">o website do txt2tags</A>.
    116. 

  116. 	</BLOCKQUOTE>
    117. 

  117. 	<BLOCKQUOTE>
    118. 

  118. 	Bom proveito!
    119. 

  119. 	</BLOCKQUOTE>
    120. 

  120. 

  121. <HR NOSHADE SIZE=5>
    122. 

  122. 

  123. <H1 ID="toc2">Parte I - Introdução ao Txt2tags</H1>
    124. 

  124. 

  125. <H2 ID="toc3">Suas Primeiras Questões</H2>
    126. 

  126. 

  127. <P>
    128. 

  128. Este capítulo apresenta o txt2tags, introduzindo as funcionalidades e
    129. 

  129. objetivo do programa.
    130. 

  130. </P>
    131. 

  131. 

  132. <HR NOSHADE SIZE=1>
    133. 

  133. 

  134. <H3>O Que É?</H3>
    135. 

  135. 

  136. <P>
    137. 

  137. O txt2tags é uma ferramenta de formatação e conversão de texto.
    138. 

  138. </P>
    139. 

  139. <P>
    140. 

  140. O txt2tags converte um arquivo texto com algumas marcas para qualquer um
    141. 

  141. dos tipos de arquivos suportados:
    142. 

  142. </P>
    143. 

  143. 

  144. <UL>
    145. 

  145. <LI>Documento HTML
    146. 

  146. <LI>Documento XHTML
    147. 

  147. <LI>Documento SGML
    148. 

  148. <LI>Documento LaTeX
    149. 

  149. <LI>Página man UNIX
    150. 

  150. <LI>Apresentação Magic Point
    151. 

  151. <LI>Página MoinMoin
    152. 

  152. <LI>Documento PageMaker 6.0
    153. 

  153. <LI>Texto Plano (sem marcações)
    154. 

  154. </UL>
    155. 

  155. 

  156. <HR NOSHADE SIZE=1>
    157. 

  157. 

  158. <H3>Por Quê Eu Devo Usá-lo?</H3>
    159. 

  159. 

  160. <P>
    161. 

  161. Você achará o txt2tags bastante útil se você:
    162. 

  162. </P>
    163. 

  163. 

  164. <UL>
    165. 

  165. <LI>precisa publicar documentos em diferentes formatos
    166. 

  166. <LI>precisa manter documentos atualizados em diferentes formatos
    167. 

  167. <LI>escreve manuais ou documentos técnicos
    168. 

  168. <LI>não sabe como escrever um documento em um formato específico
    169. 

  169. <LI>não tem um editor específico para um certo formato.
    170. 

  170. <LI>quer usar um editor de texto simples para atualizar seus documentos
    171. 

  171. </UL>
    172. 

  172. 

  173. <P>
    174. 

  174. E a motivação principal é:
    175. 

  175. </P>
    176. 

  176. 

  177. <UL>
    178. 

  178. <LI>economizar tempo, escrevendo <B>conteúdo</B>, sem se preocupar com
    179. 

  179.   <B>formatação</B>
    180. 

  180. </UL>
    181. 

  181. 

  182. <HR NOSHADE SIZE=1>
    183. 

  183. 

  184. <H3>Quais vantagens oferece em relação a outras ferramentas?</H3>
    185. 

  185. 

  186. <P>
    187. 

  187. O txt2tags possui uma forma bem direta de crescimento, seguindo alguns
    188. 

  188. conceitos básicos. Os conceitos a seguir se destacam:
    189. 

  189. </P>
    190. 

  190. 

  191. <TABLE CELLPADDING="4">
    192. 

  192. <TR>
    193. 

  193. <TD><I>Arquivo fonte legível</I></TD>
    194. 

  194. <TD>As marcações do txt2tags são bastante simples, quase naturais.</TD>
    195. 

  195. </TR>
    196. 

  196. <TR>
    197. 

  197. <TD><I>Documento destino legível</I></TD>
    198. 

  198. <TD>Da mesma forma que o arquivo fonte, o código do documento gerado também é legível, alinhado e possui linhas curtas.</TD>
    199. 

  199. </TR>
    200. 

  200. <TR>
    201. 

  201. <TD><I>Consistência na Marcação</I></TD>
    202. 

  202. <TD>As marcações txt2tags são únicas, atendendo todos os tipos de documentos e não sendo confundidas com o conteúdo.</TD>
    203. 

  203. </TR>
    204. 

  204. <TR>
    205. 

  205. <TD><I>Regras Consistentes</I></TD>
    206. 

  206. <TD>Da mesma forma que as marcas, as regras aplicadas a elas são uniformes, não há "exceções" ou "casos especiais".</TD>
    207. 

  207. </TR>
    208. 

  208. <TR>
    209. 

  209. <TD><I>Estruturas Simples</I></TD>
    210. 

  210. <TD>Toda a formatação suportada é <B>simples</B>, sem opções extras ou modificadores complexos de comportamento. Uma marcação é só uma marcação, sem opções adicionais.</TD>
    211. 

  211. </TR>
    212. 

  212. <TR>
    213. 

  213. <TD><I>Fácil de aprender</I></TD>
    214. 

  214. <TD>Com marcações simples e o código fonte legível, a curva de aprendizado é bem amigável.</TD>
    215. 

  215. </TR>
    216. 

  216. <TR>
    217. 

  217. <TD><I>Bons Exemplos</I></TD>
    218. 

  218. <TD>Os <B>arquivos de exemplo</B> incluídos com o pacote dão mostras reais de documentos simples e super-estruturados, escritos no formato txt2tags.</TD>
    219. 

  219. </TR>
    220. 

  220. <TR>
    221. 

  221. <TD><I>Ferramentas Valiosas</I></TD>
    222. 

  222. <TD>Os <B>arquivos de sintaxe</B> incluídos com o pacote (para os editores vim, emacs, nano e kate) ajudam a escrever documentos sem erros sintáticos.</TD>
    223. 

  223. </TR>
    224. 

  224. <TR>
    225. 

  225. <TD><I>Três interfaces ao usuários</I></TD>
    226. 

  226. <TD>Há uma <B>interface Gráfica Tk</B> que é bastante amigável, uma <B>inteface Web</B> para usar remotamente ou na intranet, e uma <B>interface de Linha de Comando</B>, para usuários avançados e scripts.</TD>
    227. 

  227. </TR>
    228. 

  228. <TR>
    229. 

  229. <TD><I>Suporte a Scripts</I></TD>
    230. 

  230. <TD>Com o modo completo de linha de comando, um usuário experiente pode <B>automatizar</B> tarefas e efetuar <B>pós-edições</B> nos arquivos convertidos.</TD>
    231. 

  231. </TR>
    232. 

  232. <TR>
    233. 

  233. <TD><I>Baixe e Execute / Multiplataforma</I></TD>
    234. 

  234. <TD>O txt2tags é apenas um <B>script Python</B>. Não há necessidade de compilá-lo ou carregar módulos extras. Assim, ele pode ser executado sem problemas em máquinas *NIX, Linux, Windows e Macintosh.</TD>
    235. 

  235. </TR>
    236. 

  236. <TR>
    237. 

  237. <TD><I>Atualizações Freqüentes</I></TD>
    238. 

  238. <TD>O programa possui uma lista de discussões com usuários ativos que sugerem correções e melhorias. O próprio autor é um usuário intenso em casa e no trabalho, por isto o desenvolvimento não irá parar tão cedo.</TD>
    239. 

  239. </TR>
    240. 

  240. </TABLE>
    241. 

  241. 

  242. <HR NOSHADE SIZE=1>
    243. 

  243. 

  244. <H3>Tenho que pagar por ele?</H3>
    245. 

  245. 

  246. <TABLE ALIGN="center" BORDER="1" CELLPADDING="4">
    247. 

  247. <TR>
    248. 

  248. <TH>Absolutamente NÃO!</TH>
    249. 

  249. </TR>
    250. 

  250. </TABLE>
    251. 

  251. 

  252. <P>
    253. 

  253. O txt2tags é um programa gratuito, GPL, open source, domínio público,
    254. 

  254. etc...
    255. 

  255. </P>
    256. 

  256. <P>
    257. 

  257. Você pode copiar, usar, modificar, vender, liberar como seu. As
    258. 

  258. políticas de software e copyright não são uma das maiores preocupações
    259. 

  259. do autor.
    260. 

  260. </P>
    261. 

  261. 

  262. <HR NOSHADE SIZE=1>
    263. 

  263. 

  264. <H2 ID="toc4">Estruturas de Formatação Suportadas</H2>
    265. 

  265. 

  266. <P>
    267. 

  267. Segue uma lista de todas as estruturas suportadas pelo txt2tags.
    268. 

  268. </P>
    269. 

  269. 

  270. <UL>
    271. 

  271. <LI>cabeçalho (título, nome do autor, data)
    272. 

  272. <LI>títulos de seções (numeradas ou não)
    273. 

  273. <LI>parágrafos
    274. 

  274. <LI>modificadores de fontes
    275. 

  275.   <UL>
    276. 

  276.   <LI>negrito
    277. 

  277.   <LI>itálico
    278. 

  278.   <LI>sublinhado
    279. 

  279.   </UL>
    280. 

  280. <LI>fonte monoespaço (verbatim)
    281. 

  281.   <UL>
    282. 

  282.   <LI>monoespaço no meio de um parágrafo
    283. 

  283.   <LI>linha monoespaçada
    284. 

  284.   <LI>trecho em monoespaçado
    285. 

  285.   </UL>
    286. 

  286. <LI>citações
    287. 

  287. <LI>links
    288. 

  288.   <UL>
    289. 

  289.   <LI>Links de Internet (URL)
    290. 

  290.   <LI>links de email
    291. 

  291.   <LI>links locais
    292. 

  292.   <LI>links nomeados
    293. 

  293.   </UL>
    294. 

  294. <LI>listas
    295. 

  295.   <UL>
    296. 

  296.   <LI>listas com marcadores
    297. 

  297.   <LI>listas numeradas
    298. 

  298.   <LI>listas de definição
    299. 

  299.   </UL>
    300. 

  300. <LI>linha horizontal de separação
    301. 

  301. <LI>imagems (com alinhamento inteligente)
    302. 

  302. <LI>tabela (com ou sem borda, com alinhamento inteligente)
    303. 

  303. <LI>marcação especial para texto que não deve ser formatado
    304. 

  304. <LI>macro especial para a data atual (com formatação flexível)
    305. 

  305. <LI>comentários (para notas, A FAZER, CORREÇÕES, etc.)
    306. 

  306. </UL>
    307. 

  307. 

  308. <HR NOSHADE SIZE=1>
    309. 

  309. 

  310. <H2 ID="toc5">Formatos Suportados</H2>
    311. 

  311. 

  312. <DL>
    313. 

  313. <DT><B>HTML</B>                                                                </DT><DD>
    314. 

  314. Todo mundo sabe o que o HTML é (dica: Internet).
    315. 

  315. <P></P>
    316. 

  316. O txt2tags gera documentos HTML limpos, que tem boa apresentação e cujo
    317. 

  317. código fonte é legível. Ele NÃO USA javascript, frames ou outras
    318. 

  318. técnicas de formatação fúteis, que não são necessárias para documentos
    319. 

  319. técnicos simples. Mas um arquivo CSS separado pode ser utilizado, se for
    320. 

  320. desejado. O Txt2tags gera código "<I>HTML 4.0 Transitional</I>".
    321. 

  321. <P></P>
    322. 

  322. Desde a versão 2.0, o código HTML gerado pelo txt2tags é 100% aprovado
    323. 

  323. pelo <A HREF="vhttp://validator.w3.org/">validador w3c</A>.
    324. 

  324. </DL>
    325. 

  325. 

  326. <DL>
    327. 

  327. <DT><B>XHTML</B></DT><DD>
    328. 

  328. Esta é a nova generação do HTML, com regras mais restritas, como fechar
    329. 

  329. todas as marcas que forem abertas. Isto torna o código mas fácil de ser
    330. 

  330. avaliado e entendido. Para propósitos gerais, considere como HTML. O
    331. 

  331. txt2tags gera código "<I>HTML 4.0 Transitional</I>".
    332. 

  332. <P></P>
    333. 

  333. Desde a versão 2.0, o código XHTML gerado pelo txt2tags é 100% aprovado
    334. 

  334. pelo <A HREF="vhttp://validator.w3.org/">validador w3c</A>.
    335. 

  335. <P></P>
    336. 

  336. <DT><B>SGML</B></DT><DD>
    337. 

  337. O SGML é um formato de documento comum que possui aplicações de
    338. 

  338. conversão, como <A HREF="http://www.sgmltools.org/">sgmltools</A>. De um arquivo
    339. 

  339. sgml pode-se gerar documentos html, pdf, ps, info, latex, lyx, rtf e
    340. 

  340. xml. As ferramentas sgml2* também criam índices (TOC) e quebra de seções
    341. 

  341. em subpáginas (sgml2html).
    342. 

  342. <P></P>
    343. 

  343. O txt2tags gera arquivos SGML válidos para a DTD linuxdoc, prontos para
    344. 

  344. serem convertidos com uma ferramenta sgml2* sem qualquer arquivo de
    345. 

  345. catálogo extra ou outras exigências incômodas do SGML.
    346. 

  346. <P></P>
    347. 

  347. <DT><B>LATEX</B></DT><DD>
    348. 

  348. O formato de documentação preferido nos meios acadêmicos, é mais potente
    349. 

  349. do que normalmente se considera. Livros completos, fórmulas complicadas
    350. 

  350. e qualquer texto complexo pode ser escrito em LaTeX. Mas se prepare para
    351. 

  351. perder os cabelos se tentar escever as marcações à mão...
    352. 

  352. <P></P>
    353. 

  353. O txt2tags gera arquivos LaTeX prontos para usar, realizando todos os
    354. 

  354. complexos truques de escape e exceções. O escritor deve se preocupar
    355. 

  355. exclusivamente com o texto.
    356. 

  356. <P></P>
    357. 

  357. <DT><B>MAN</B></DT><DD>
    358. 

  358. As páginas man do UNIX resistiram pelos anos. Formatos de documento vem
    359. 

  359. e vão, e elas estão aí, imbatíveis.
    360. 

  360. <P></P>
    361. 

  361. Existem outras ferramentas para gerar documentos man, mas o txt2tags tem
    362. 

  362. uma vantagem: uma fonte, múltiplos formatos destino. Assim, o conteúdo
    363. 

  363. da mesma página man pode ser convertido para uma página HTML, uma
    364. 

  364. apresentação Magic Point, etc.
    365. 

  365. <P></P>
    366. 

  366. <DT><B>MGP</B></DT><DD>
    367. 

  367. O <A HREF="http://www.mew.org/mgp/">Magic Point</A> é uma ferramenta de apresentação
    368. 

  368. bastante útil (dica: Microsoft PowerPoint), que usa uma linguagem de
    369. 

  369. marcação para definir todas as telas. Desta forma, você pode criar
    370. 

  370. apresentações complexas no vi/emacs/notepad.
    371. 

  371. <P></P>
    372. 

  372. O txt2tags gera um arquivo .mgp pronto para ser usado, definindo todos
    373. 

  373. os cabeçalhos necessários para as definições de fontes e aparência, bem
    374. 

  374. como o suporte aos caracteres acentuados da página de código ISO-8859.
    375. 

  375. <P></P>
    376. 

  376. <B>Observação 1:</B> os arquivos .mgp criados pelo txt2tags usam as fontes
    377. 

  377. Type1 do XFree86! Desta forma, não é necessário incluir fontes TrueType
    378. 

  378. com sua apresentação.
    379. 

  379. <P></P>
    380. 

  380. <B>Observação 2:</B> as definições de cor para as fontes são limpas, de
    381. 

  381. forma que mesmo com uma paleta de cores de sistema pobre (como em
    382. 

  382. <CODE>startx -- -bpp 8</CODE>) a apresentação vai ter boa aparência.
    383. 

  383. <P></P>
    384. 

  384. A chave é: converta e use. Não há necessidade de remendos ou de outros
    385. 

  385. requisitos.
    386. 

  386. <P></P>
    387. 

  387. <DT><B>MOIN</B></DT><DD>
    388. 

  388. Você não sabe o que é o <A HREF="http://moin.sourceforge.net">MoinMoin</A>? Ele é
    389. 

  389. um <A HREF="http://www.c2.com/cgi/wiki">WikiWiki</A>!
    390. 

  390. <P></P>
    391. 

  391. A sintaxe do Moin é um pouco chata, quando você tem que ficar
    392. 

  392. <CODE>{{{'''''acrescentando chaves e plicas'''''}}}</CODE>, mas o txt2tags vem
    393. 

  393. com as marcações simplificadas e uma solução unificada: uma fonte,
    394. 

  394. múltiplos formatos destino.
    395. 

  395. <P></P>
    396. 

  396. <DT><B>PM6</B></DT><DD>
    397. 

  397. Aposto que você não sabia, mas o Adobe PageMaker 6.0 tem sua própria
    398. 

  398. linguagem de marcação! Estilos, tabelas de cores, embelezadores, e a
    399. 

  399. maior parte das funcionalidades acessíveis via cliques de mouse também
    400. 

  400. estão disponíveis em sua linguagem de marcação. Você só precisa acessar
    401. 

  401. o item de menu "Import tagged text". Apenas para registro, é um formato
    402. 

  402. de marcação semelhante ao HTML.
    403. 

  403. <P></P>
    404. 

  404. O txt2tags gera todas as tags e já define um cabeçalho extenso e
    405. 

  405. funcional, configurando os estilos de parágrafo e formatações. Esta é a
    406. 

  406. parte difícil. <B>EPA:</B> Sem quebras de linha! Um parágrafo deve ser uma
    407. 

  407. única linha.
    408. 

  408. <P></P>
    409. 

  409. Nota do Autor:
    410. 

  410. <I>Todo meu livro em português sobre <A HREF="http://guia-er.sf.net/">expressões regulares</A></I>
    411. 

  411. <I>foi escrito no vi, convertido para o formato do PageMaker com o</I>
    412. 

  412. <I>txt2tags e então mandado para o prelo.</I>
    413. 

  413. <P></P>
    414. 

  414. <DT><B>TXT</B></DT><DD>
    415. 

  415. TXT é texto. O único tipo de formatação verdadeiro.
    416. 

  416. <P></P>
    417. 

  417. Apesar das marcações do txt2tags serem bem intuitivas e discretas,
    418. 

  418. pode-se removê-las ao converter o arquivo para TXT puro.
    419. 

  419. <P></P>
    420. 

  420. Os títulos são sublinhados, e o texto é basicamente deixado como está no
    421. 

  421. código fonte.
    422. 

  422. </DL>
    423. 

  423. 

  424. <HR NOSHADE SIZE=1>
    425. 

  425. 

  426. <H2 ID="estruturas">Situação dos Formatos-Destino para as Estruturas Suportadas</H2>
    427. 

  427. 

  428. <TABLE ALIGN="center" BORDER="1" CELLPADDING="4">
    429. 

  429. <TR>
    430. 

  430. <TH>Estrutura</TH>
    431. 

  431. <TH>html</TH>
    432. 

  432. <TH>xhtml</TH>
    433. 

  433. <TH>sgml</TH>
    434. 

  434. <TH>tex</TH>
    435. 

  435. <TH>man</TH>
    436. 

  436. <TH>mgp</TH>
    437. 

  437. <TH>moin</TH>
    438. 

  438. <TH>pm6</TH>
    439. 

  439. <TH>txt</TH>
    440. 

  440. </TR>
    441. 

  441. <TR>
    442. 

  442. <TD>cabeçalhos</TD>
    443. 

  443. <TD ALIGN="center">S</TD>
    444. 

  444. <TD ALIGN="center">S</TD>
    445. 

  445. <TD ALIGN="center">S</TD>
    446. 

  446. <TD ALIGN="center">S</TD>
    447. 

  447. <TD ALIGN="center">S</TD>
    448. 

  448. <TD ALIGN="center">S</TD>
    449. 

  449. <TD ALIGN="center">N</TD>
    450. 

  450. <TD ALIGN="center">N</TD>
    451. 

  451. <TD ALIGN="center">S</TD>
    452. 

  452. </TR>
    453. 

  453. <TR>
    454. 

  454. <TD>título de seções</TD>
    455. 

  455. <TD ALIGN="center">S</TD>
    456. 

  456. <TD ALIGN="center">S</TD>
    457. 

  457. <TD ALIGN="center">S</TD>
    458. 

  458. <TD ALIGN="center">S</TD>
    459. 

  459. <TD ALIGN="center">S</TD>
    460. 

  460. <TD ALIGN="center">S</TD>
    461. 

  461. <TD ALIGN="center">S</TD>
    462. 

  462. <TD ALIGN="center">S</TD>
    463. 

  463. <TD ALIGN="center">S</TD>
    464. 

  464. </TR>
    465. 

  465. <TR>
    466. 

  466. <TD>parágrafos</TD>
    467. 

  467. <TD ALIGN="center">S</TD>
    468. 

  468. <TD ALIGN="center">S</TD>
    469. 

  469. <TD ALIGN="center">S</TD>
    470. 

  470. <TD ALIGN="center">S</TD>
    471. 

  471. <TD ALIGN="center">S</TD>
    472. 

  472. <TD ALIGN="center">S</TD>
    473. 

  473. <TD ALIGN="center">S</TD>
    474. 

  474. <TD ALIGN="center">S</TD>
    475. 

  475. <TD ALIGN="center">S</TD>
    476. 

  476. </TR>
    477. 

  477. <TR>
    478. 

  478. <TD>negrito</TD>
    479. 

  479. <TD ALIGN="center">S</TD>
    480. 

  480. <TD ALIGN="center">S</TD>
    481. 

  481. <TD ALIGN="center">S</TD>
    482. 

  482. <TD ALIGN="center">S</TD>
    483. 

  483. <TD ALIGN="center">S</TD>
    484. 

  484. <TD ALIGN="center">S</TD>
    485. 

  485. <TD ALIGN="center">S</TD>
    486. 

  486. <TD ALIGN="center">S</TD>
    487. 

  487. <TD ALIGN="center">-</TD>
    488. 

  488. </TR>
    489. 

  489. <TR>
    490. 

  490. <TD>itálico</TD>
    491. 

  491. <TD ALIGN="center">S</TD>
    492. 

  492. <TD ALIGN="center">S</TD>
    493. 

  493. <TD ALIGN="center">S</TD>
    494. 

  494. <TD ALIGN="center">S</TD>
    495. 

  495. <TD ALIGN="center">S</TD>
    496. 

  496. <TD ALIGN="center">S</TD>
    497. 

  497. <TD ALIGN="center">S</TD>
    498. 

  498. <TD ALIGN="center">S</TD>
    499. 

  499. <TD ALIGN="center">-</TD>
    500. 

  500. </TR>
    501. 

  501. <TR>
    502. 

  502. <TD>sublinhado</TD>
    503. 

  503. <TD ALIGN="center">S</TD>
    504. 

  504. <TD ALIGN="center">S</TD>
    505. 

  505. <TD ALIGN="center">-</TD>
    506. 

  506. <TD ALIGN="center">S</TD>
    507. 

  507. <TD ALIGN="center">-</TD>
    508. 

  508. <TD ALIGN="center">S</TD>
    509. 

  509. <TD ALIGN="center">S</TD>
    510. 

  510. <TD ALIGN="center">S</TD>
    511. 

  511. <TD ALIGN="center">-</TD>
    512. 

  512. </TR>
    513. 

  513. <TR>
    514. 

  514. <TD>pré-formatado</TD>
    515. 

  515. <TD ALIGN="center">S</TD>
    516. 

  516. <TD ALIGN="center">S</TD>
    517. 

  517. <TD ALIGN="center">S</TD>
    518. 

  518. <TD ALIGN="center">S</TD>
    519. 

  519. <TD ALIGN="center">-</TD>
    520. 

  520. <TD ALIGN="center">S</TD>
    521. 

  521. <TD ALIGN="center">S</TD>
    522. 

  522. <TD ALIGN="center">S</TD>
    523. 

  523. <TD ALIGN="center">-</TD>
    524. 

  524. </TR>
    525. 

  525. <TR>
    526. 

  526. <TD>linha pré-formatada</TD>
    527. 

  527. <TD ALIGN="center">S</TD>
    528. 

  528. <TD ALIGN="center">S</TD>
    529. 

  529. <TD ALIGN="center">S</TD>
    530. 

  530. <TD ALIGN="center">S</TD>
    531. 

  531. <TD ALIGN="center">S</TD>
    532. 

  532. <TD ALIGN="center">S</TD>
    533. 

  533. <TD ALIGN="center">S</TD>
    534. 

  534. <TD ALIGN="center">S</TD>
    535. 

  535. <TD ALIGN="center">-</TD>
    536. 

  536. </TR>
    537. 

  537. <TR>
    538. 

  538. <TD>área pré-formatada</TD>
    539. 

  539. <TD ALIGN="center">S</TD>
    540. 

  540. <TD ALIGN="center">S</TD>
    541. 

  541. <TD ALIGN="center">S</TD>
    542. 

  542. <TD ALIGN="center">S</TD>
    543. 

  543. <TD ALIGN="center">S</TD>
    544. 

  544. <TD ALIGN="center">S</TD>
    545. 

  545. <TD ALIGN="center">S</TD>
    546. 

  546. <TD ALIGN="center">S</TD>
    547. 

  547. <TD ALIGN="center">-</TD>
    548. 

  548. </TR>
    549. 

  549. <TR>
    550. 

  550. <TD>área cotada</TD>
    551. 

  551. <TD ALIGN="center">S</TD>
    552. 

  552. <TD ALIGN="center">S</TD>
    553. 

  553. <TD ALIGN="center">S</TD>
    554. 

  554. <TD ALIGN="center">S</TD>
    555. 

  555. <TD ALIGN="center">S</TD>
    556. 

  556. <TD ALIGN="center">S</TD>
    557. 

  557. <TD ALIGN="center">S</TD>
    558. 

  558. <TD ALIGN="center">S</TD>
    559. 

  559. <TD ALIGN="center">S</TD>
    560. 

  560. </TR>
    561. 

  561. <TR>
    562. 

  562. <TD>links internet</TD>
    563. 

  563. <TD ALIGN="center">S</TD>
    564. 

  564. <TD ALIGN="center">S</TD>
    565. 

  565. <TD ALIGN="center">S</TD>
    566. 

  566. <TD ALIGN="center">-</TD>
    567. 

  567. <TD ALIGN="center">-</TD>
    568. 

  568. <TD ALIGN="center">-</TD>
    569. 

  569. <TD ALIGN="center">S</TD>
    570. 

  570. <TD ALIGN="center">-</TD>
    571. 

  571. <TD ALIGN="center">-</TD>
    572. 

  572. </TR>
    573. 

  573. <TR>
    574. 

  574. <TD>links e-mail</TD>
    575. 

  575. <TD ALIGN="center">S</TD>
    576. 

  576. <TD ALIGN="center">S</TD>
    577. 

  577. <TD ALIGN="center">S</TD>
    578. 

  578. <TD ALIGN="center">-</TD>
    579. 

  579. <TD ALIGN="center">-</TD>
    580. 

  580. <TD ALIGN="center">-</TD>
    581. 

  581. <TD ALIGN="center">S</TD>
    582. 

  582. <TD ALIGN="center">-</TD>
    583. 

  583. <TD ALIGN="center">-</TD>
    584. 

  584. </TR>
    585. 

  585. <TR>
    586. 

  586. <TD>links locais</TD>
    587. 

  587. <TD ALIGN="center">S</TD>
    588. 

  588. <TD ALIGN="center">S</TD>
    589. 

  589. <TD ALIGN="center">S</TD>
    590. 

  590. <TD ALIGN="center">N</TD>
    591. 

  591. <TD ALIGN="center">-</TD>
    592. 

  592. <TD ALIGN="center">-</TD>
    593. 

  593. <TD ALIGN="center">S</TD>
    594. 

  594. <TD ALIGN="center">-</TD>
    595. 

  595. <TD ALIGN="center">-</TD>
    596. 

  596. </TR>
    597. 

  597. <TR>
    598. 

  598. <TD>links nomeados</TD>
    599. 

  599. <TD ALIGN="center">S</TD>
    600. 

  600. <TD ALIGN="center">S</TD>
    601. 

  601. <TD ALIGN="center">S</TD>
    602. 

  602. <TD ALIGN="center">-</TD>
    603. 

  603. <TD ALIGN="center">-</TD>
    604. 

  604. <TD ALIGN="center">-</TD>
    605. 

  605. <TD ALIGN="center">S</TD>
    606. 

  606. <TD ALIGN="center">-</TD>
    607. 

  607. <TD ALIGN="center">-</TD>
    608. 

  608. </TR>
    609. 

  609. <TR>
    610. 

  610. <TD>lista não-numerada</TD>
    611. 

  611. <TD ALIGN="center">S</TD>
    612. 

  612. <TD ALIGN="center">S</TD>
    613. 

  613. <TD ALIGN="center">S</TD>
    614. 

  614. <TD ALIGN="center">S</TD>
    615. 

  615. <TD ALIGN="center">S</TD>
    616. 

  616. <TD ALIGN="center">S</TD>
    617. 

  617. <TD ALIGN="center">S</TD>
    618. 

  618. <TD ALIGN="center">S</TD>
    619. 

  619. <TD ALIGN="center">S</TD>
    620. 

  620. </TR>
    621. 

  621. <TR>
    622. 

  622. <TD>lista numerada</TD>
    623. 

  623. <TD ALIGN="center">S</TD>
    624. 

  624. <TD ALIGN="center">S</TD>
    625. 

  625. <TD ALIGN="center">S</TD>
    626. 

  626. <TD ALIGN="center">S</TD>
    627. 

  627. <TD ALIGN="center">S</TD>
    628. 

  628. <TD ALIGN="center">S</TD>
    629. 

  629. <TD ALIGN="center">S</TD>
    630. 

  630. <TD ALIGN="center">S</TD>
    631. 

  631. <TD ALIGN="center">S</TD>
    632. 

  632. </TR>
    633. 

  633. <TR>
    634. 

  634. <TD>lista de definições</TD>
    635. 

  635. <TD ALIGN="center">S</TD>
    636. 

  636. <TD ALIGN="center">S</TD>
    637. 

  637. <TD ALIGN="center">S</TD>
    638. 

  638. <TD ALIGN="center">S</TD>
    639. 

  639. <TD ALIGN="center">S</TD>
    640. 

  640. <TD ALIGN="center">N</TD>
    641. 

  641. <TD ALIGN="center">N</TD>
    642. 

  642. <TD ALIGN="center">N</TD>
    643. 

  643. <TD ALIGN="center">S</TD>
    644. 

  644. </TR>
    645. 

  645. <TR>
    646. 

  646. <TD>linha horizontal</TD>
    647. 

  647. <TD ALIGN="center">S</TD>
    648. 

  648. <TD ALIGN="center">S</TD>
    649. 

  649. <TD ALIGN="center">-</TD>
    650. 

  650. <TD ALIGN="center">S</TD>
    651. 

  651. <TD ALIGN="center">-</TD>
    652. 

  652. <TD ALIGN="center">S</TD>
    653. 

  653. <TD ALIGN="center">S</TD>
    654. 

  654. <TD ALIGN="center">N</TD>
    655. 

  655. <TD ALIGN="center">S</TD>
    656. 

  656. </TR>
    657. 

  657. <TR>
    658. 

  658. <TD>imagem</TD>
    659. 

  659. <TD ALIGN="center">S</TD>
    660. 

  660. <TD ALIGN="center">S</TD>
    661. 

  661. <TD ALIGN="center">S</TD>
    662. 

  662. <TD ALIGN="center">S</TD>
    663. 

  663. <TD ALIGN="center">-</TD>
    664. 

  664. <TD ALIGN="center">S</TD>
    665. 

  665. <TD ALIGN="center">S</TD>
    666. 

  666. <TD ALIGN="center">N</TD>
    667. 

  667. <TD ALIGN="center">-</TD>
    668. 

  668. </TR>
    669. 

  669. <TR>
    670. 

  670. <TD>tabela</TD>
    671. 

  671. <TD ALIGN="center">S</TD>
    672. 

  672. <TD ALIGN="center">S</TD>
    673. 

  673. <TD ALIGN="center">S</TD>
    674. 

  674. <TD ALIGN="center">S</TD>
    675. 

  675. <TD ALIGN="center">S</TD>
    676. 

  676. <TD ALIGN="center">N</TD>
    677. 

  677. <TD ALIGN="center">S</TD>
    678. 

  678. <TD ALIGN="center">N</TD>
    679. 

  679. <TD ALIGN="center">N</TD>
    680. 

  680. </TR>
    681. 

  681. <TR>
    682. 

  682. <TH>Extras</TH>
    683. 

  683. <TH>html</TH>
    684. 

  684. <TH>xhtml</TH>
    685. 

  685. <TH>sgml</TH>
    686. 

  686. <TH>tex</TH>
    687. 

  687. <TH>man</TH>
    688. 

  688. <TH>mgp</TH>
    689. 

  689. <TH>moin</TH>
    690. 

  690. <TH>pm6</TH>
    691. 

  691. <TH>txt</TH>
    692. 

  692. </TR>
    693. 

  693. <TR>
    694. 

  694. <TD>image align</TD>
    695. 

  695. <TD ALIGN="center">S</TD>
    696. 

  696. <TD ALIGN="center">S</TD>
    697. 

  697. <TD ALIGN="center">N</TD>
    698. 

  698. <TD ALIGN="center">N</TD>
    699. 

  699. <TD ALIGN="center">-</TD>
    700. 

  700. <TD ALIGN="center">S</TD>
    701. 

  701. <TD ALIGN="center">N</TD>
    702. 

  702. <TD ALIGN="center">N</TD>
    703. 

  703. <TD ALIGN="center">-</TD>
    704. 

  704. </TR>
    705. 

  705. <TR>
    706. 

  706. <TD>table cell align</TD>
    707. 

  707. <TD ALIGN="center">S</TD>
    708. 

  708. <TD ALIGN="center">S</TD>
    709. 

  709. <TD ALIGN="center">S</TD>
    710. 

  710. <TD ALIGN="center">S</TD>
    711. 

  711. <TD ALIGN="center">S</TD>
    712. 

  712. <TD ALIGN="center">N</TD>
    713. 

  713. <TD ALIGN="center">S</TD>
    714. 

  714. <TD ALIGN="center">N</TD>
    715. 

  715. <TD ALIGN="center">N</TD>
    716. 

  716. </TR>
    717. 

  717. </TABLE>
    718. 

  718. 

  719. <TABLE ALIGN="center" CELLPADDING="4">
    720. 

  720. <TR>
    721. 

  721. <TH></TH>
    722. 

  722. <TH>Legenda</TH>
    723. 

  723. </TR>
    724. 

  724. <TR>
    725. 

  725. <TD><B>S</B></TD>
    726. 

  726. <TD><I>suportada</I></TD>
    727. 

  727. </TR>
    728. 

  728. <TR>
    729. 

  729. <TD><B>N</B></TD>
    730. 

  730. <TD><I>não suportada (talvez em uma versão futura)</I></TD>
    731. 

  731. </TR>
    732. 

  732. <TR>
    733. 

  733. <TD><B>-</B></TD>
    734. 

  734. <TD><I>não suportada (não pode ser feita neste formato)</I></TD>
    735. 

  735. </TR>
    736. 

  736. </TABLE>
    737. 

  737. 

  738. <HR NOSHADE SIZE=1>
    739. 

  739. 

  740. <H2 ID="toc7">As Três Interfaces ao Usuário: GUI, Web e Linha de Comando</H2>
    741. 

  741. 

  742. <P>
    743. 

  743. Assim como diferentes usuários possuem diferentes necessidades e
    744. 

  744. ambientes, o txt2tags é bastante flexivel na forma de ser usado.
    745. 

  745. </P>
    746. 

  746. <P>
    747. 

  747. Existem três Interfaces de Usuário para o programa, cada uma atendendo a
    748. 

  748. um objetivo definido e com funcionalidades próprias.
    749. 

  749. </P>
    750. 

  750. 

  751. <UL>
    752. 

  752. <LI><B>GUI</B>: Escrita em Tk, traz as janelas e os cliques para o txt2tags.
    753. 

  753. <LI><B>Web</B>: Escrita em PHP, permite que o usuário execute o txt2tags no
    754. 

  754.            navegador, não exigindo instalação do lado do cliente.
    755. 

  755. <LI><B>Linha de Comando</B>: Escrita em Python, é o núcleo do programa.
    756. 

  756.            Todas as funcionalidades estão disponíveis como opções de
    757. 

  757.            linha de comando.
    758. 

  758. </UL>
    759. 

  759. 

  760. <HR NOSHADE SIZE=1>
    761. 

  761. 

  762. <H3 ID="gui">Interface Gráfica Tk</H3>
    763. 

  763. 

  764. <P>
    765. 

  765. Desde a versão 1.0, há uma bela Interface Gráfica, que funciona do
    766. 

  766. Linux, Windows, Mac e outros.
    767. 

  767. </P>
    768. 

  768. <P>
    769. 

  769. O programa automaticamente detecta se seu sistema pode apresentar a
    770. 

  770. interface e a lança quando é chamado sem argumentos. Pode-se forçar a
    771. 

  771. apresentação da Interfaca Gráfica com a opção <CODE>--gui</CODE>. Se estiver
    772. 

  772. faltando algum recurso o programa irá alertar.
    773. 

  773. </P>
    774. 

  774. 	<BLOCKQUOTE>
    775. 

  775. 	<B>Nota:</B> O módulo Tkinter é necessário. Como ele vem com a
    776. 

  776. 	distribição padrão do Python você já deve tê-lo.
    777. 

  777. 	</BLOCKQUOTE>
    778. 

  778. <P>
    779. 

  779. Ela é bastante simples e fácil de usar:
    780. 

  780. </P>
    781. 

  781.           <center><IMG ALIGN="middle" SRC="../userguide/gui.png" BORDER="0" ALT=""></center>          
    782. 

  782. 

  783. <OL>
    784. 

  784. <LI>Você localiza o arquivo fonte .t2t no disco e suas opções são
    785. 

  785.   carregadas.
    786. 

  786. <P></P>
    787. 

  787. <LI>Se o destino ainda estiver vazio, você deve escolher um.
    788. 

  788. <P></P>
    789. 

  789. <LI>Há algumas opões que podem ser escolhidas, mas nenhuma delas é
    790. 

  790.   essencial.
    791. 

  791. <P></P>
    792. 

  792. <LI>Finalmente, pressione o botão "Converter!".
    793. 

  793. </OL>
    794. 

  794. 

  795. <P>
    796. 

  796. Uma boa opção a selecionar é "<I>Dump to screen</I>", assim se pode
    797. 

  797. verificar o código resultante em uma janela separada, sem que o arquivo
    798. 

  798. seja salvo. Quando o código estiver correto, basta desmarcá-la e o
    799. 

  799. arquivo será gravado.
    800. 

  800. </P>
    801. 

  801. <P>
    802. 

  802. As cores padrão podem ser mudadas no arquivo <CODE>~/.txt2tagsrc</CODE>,
    803. 

  803. configurando em <CODE>%!guicolors</CODE>. Por exemplo:
    804. 

  804. </P>
    805. 

  805. 

  806. <PRE>
    807. 

  807.    % minhas cores para a interface (fundo1, texto1, fundo2, texto2)
    808. 

  808.    %!guicolors: blue white brown yellow
    809. 

  809. </PRE>
    810. 

  810. 

  811. <HR NOSHADE SIZE=1>
    812. 

  812. 

  813. <H3 ID="web">Interface Web</H3>
    814. 

  814. 

  815. <P>
    816. 

  816. A Interface Web está em funcionamento na Internet no endereço
    817. 

  817. <A HREF="http://txt2tags.org/online.php">http://txt2tags.org/online.php</A>, permitindo que o programa possa ser
    818. 

  818. usado e testado antes de ser copiado.
    819. 

  819. </P>
    820. 

  820.           <center><IMG ALIGN="middle" SRC="../userguide/web.png" BORDER="0" ALT=""></center>          
    821. 

  821. <P>
    822. 

  822. Esta interface também pode ser colocada na intrant para uso local,
    823. 

  823. evitando a instalação do txt2tags em todas as máquinas.
    824. 

  824. </P>
    825. 

  825. 

  826. <HR NOSHADE SIZE=1>
    827. 

  827. 

  828. <H3 ID="linhadecomando">Interface de Linha de Comando</H3>
    829. 

  829. 

  830. <P>
    831. 

  831. Para usuários de linha de comando acostumados, o parâmetro --help deve
    832. 

  832. ser suficiente:
    833. 

  833. </P>
    834. 

  834. 

  835. <PRE>
    836. 

  836.   Uso: txt2tags [OPÇÕES] [arquivo.t2t ...]
    837. 

  837.   
    838. 

  838.     -t, --target        define o formato do destino. tipos suportados:
    839. 

  839.                         html, xhtml, sgml, tex, man, mgp, moin, pm6, txt
    840. 

  840.     -i, --infile=ARQ    define ARQ como o arquivo fonte ('-' para STDIN)
    841. 

  841.     -0, --outfile=ARQ   define ARQ como o arquivo destino ('-' para STDOUT)
    842. 

  842.     -n, --enum-title    numera todos os títulos como 1, 1.1, 1.1.1, etc
    843. 

  843.     -H, --no-headers    suprime os cabeçalhos, título e rodapé
    844. 

  844.         --headers       exibe os cabeçalhos, título e rodapé (padrão LIGADO)
    845. 

  845.         --encoding      informa a codificação de destino (utf-8, iso-8859-1, etc)
    846. 

  846.         --style=ARQ     utiliza ARQ como estilo do documento (CSS no Html)
    847. 

  847.         --css-sugar     insere tags compatíveis com CSS em destinos HTML e XHTML
    848. 

  848.         --mask-email    esconde e-mails dos robôs de SPAM. x@y.z vira &lt;x (a) y z&gt;
    849. 

  849.         --toc           inclui o Índice (Table of Contents) no documento destino
    850. 

  850.         --toc-only      exibe o Índice do documento e sai
    851. 

  851.         --toc-level=N   define o nível máximo do Índice para N
    852. 

  852.         --rc            lê a config do usuário em ~/.txt2tagsrc (padrão LIGADO)
    853. 

  853.         --gui           carrega a interface gráfica escrita em TK
    854. 

  854.     -v, --verbose       exibe mensagens informativas durante a conversão
    855. 

  855.     -h, --help          exibe este texto de ajuda e sai
    856. 

  856.     -V, --version       exibe a versão do programa e sai
    857. 

  857.         --dump-config   exibe todas as configurações encontradas e sai
    858. 

  858.   
    859. 

  859.   Opções para DESLIGAR funcionalidades:
    860. 

  860.        --no-outfile, --no-infile, --no-style, --no-encoding, --no-headers
    861. 

  861.        --no-toc, --no-toc-only, --no-mask-email, --no-enum-title, --no-rc
    862. 

  862.        --no-css-sugar
    863. 

  863.   
    864. 

  864.   Exemplo:
    865. 

  865.        txt2tags -t html --toc meuarquivo.t2t
    866. 

  866.   
    867. 

  867.   Normalmente a saída convertida é gravada em 'arquivo.&lt;tipo&gt;'.
    868. 

  868.   Utilize --outfile para forçar um nome para o arquivo de saída.
    869. 

  869.   Se o arquivo de entrada é '-', lê de STDIN.
    870. 

  870.   Se o arquivo de saída é '-', envia a saída para STDOUT.
    871. 

  871. </PRE>
    872. 

  872. 

  873. <H4>Exemplos</H4>
    874. 

  874. 

  875. <P>
    876. 

  876. Supondo que exista um arquivo de marcação chamado <CODE>file.t2t</CODE>, vamos nos
    877. 

  877. divertir um pouco.
    878. 

  878. </P>
    879. 

  879. 

  880. <TABLE CELLPADDING="4">
    881. 

  881. <TR>
    882. 

  882. <TD><B>Convertendo para HTML</B></TD>
    883. 

  883. <TD><CODE>$ txt2tags -t html file.t2t</CODE></TD>
    884. 

  884. </TR>
    885. 

  885. <TR>
    886. 

  886. <TD><B>O mesmo, usando redirecionamento</B></TD>
    887. 

  887. <TD><CODE>$ txt2tags -t html -o - file.t2t &gt; file.html</CODE></TD>
    888. 

  888. </TR>
    889. 

  889. <TR>
    890. 

  890. <TD></TD>
    891. 

  891. <TD>.</TD>
    892. 

  892. </TR>
    893. 

  893. <TR>
    894. 

  894. <TD><B>Incluindo uma Tabela de Conteúdo</B></TD>
    895. 

  895. <TD><CODE>$ txt2tags -t html --toc file.t2t</CODE></TD>
    896. 

  896. </TR>
    897. 

  897. <TR>
    898. 

  898. <TD><B>Idem, numerando os títulos</B></TD>
    899. 

  899. <TD><CODE>$ txt2tags -t html --toc --enum-title file.t2t</CODE></TD>
    900. 

  900. </TR>
    901. 

  901. <TR>
    902. 

  902. <TD></TD>
    903. 

  903. <TD>.</TD>
    904. 

  904. </TR>
    905. 

  905. <TR>
    906. 

  906. <TD><B>Visualização Rápida do Conteúdo</B></TD>
    907. 

  907. <TD><CODE>$ txt2tags --toc-only file.t2t</CODE></TD>
    908. 

  908. </TR>
    909. 

  909. <TR>
    910. 

  910. <TD><B>Quem sabe com números?</B></TD>
    911. 

  911. <TD><CODE>$ txt2tags --toc-only --enum-title file.t2t</CODE></TD>
    912. 

  912. </TR>
    913. 

  913. <TR>
    914. 

  914. <TD></TD>
    915. 

  915. <TD>.</TD>
    916. 

  916. </TR>
    917. 

  917. <TR>
    918. 

  918. <TD><B>Linha simples de STDIN</B></TD>
    919. 

  919. <TD><CODE>$ echo -e "\n**bold**" | txt2tags -t html --no-headers -</CODE></TD>
    920. 

  920. </TR>
    921. 

  921. <TR>
    922. 

  922. <TD><B>Testando o Mascaramento de Email</B></TD>
    923. 

  923. <TD><CODE>$ echo -e "\njohn.wayne@farwest.com" | txt2tags -t txt --mask-email --no-headers -</CODE></TD>
    924. 

  924. </TR>
    925. 

  925. <TR>
    926. 

  926. <TD><B>Edição pós-conversão</B></TD>
    927. 

  927. <TD><CODE>$ txt2tags -t html -o- file.t2t | sed "s/&lt;BODY .*/&lt;BODY BGCOLOR=green&gt;/" &gt; file.html</CODE></TD>
    928. 

  928. </TR>
    929. 

  929. </TABLE>
    930. 

  930. 

  931. <DL>
    932. 

  932. <DT><I>Nota</I></DT><DD>
    933. 

  933. Desde a versão 1.6 você pode fazer pre e pós processamento usando as
    934. 

  934. macros de configuração <CODE>%!preproc</CODE> e <CODE>%!postproc</CODE>.
    935. 

  935. </DL>
    936. 

  936. 

  937. <HR NOSHADE SIZE=5>
    938. 

  938. 

  939. <H1 ID="instalacao">Parte II - OK, eu quero um. E agora?</H1>
    940. 

  940. 

  941. <P>
    942. 

  942. Basta baixar o programa e executar o mesmo no seu computador.
    943. 

  943. </P>
    944. 

  944. 

  945. <H2 ID="toc9">Download e Instalação do Python</H2>
    946. 

  946. 

  947. <P>
    948. 

  948. Antes de mais nada, deve-se baixar e instalar o interpretador Python
    949. 

  949. para o seu sistema. Se você já o tem, então pule eset passo.
    950. 

  950. </P>
    951. 

  951. <P>
    952. 

  952. O Python é uma das melhores linguagens de programação que existem, ela
    953. 

  953. pode ser utilizada no Windows, Linux, UNIX, Macintosh, e outras
    954. 

  954. plataformas, e pode ser baixada do
    955. 

  955. <A HREF="http://www.python.org">web site do Python</A>. As dicas de instalação podem
    956. 

  956. ser encontradas no mesmo site. O txt2tags funciona com o Python 1.5 ou
    957. 

  957. posterior.
    958. 

  958. </P>
    959. 

  959. <P>
    960. 

  960. Se você não tem certeza de ter o Python ou não, abra um console (tty,
    961. 

  961. xterm, MSDOS) e escreva <CODE>python</CODE>. Se ele não estiver instalado, o
    962. 

  962. sistema vai lhe informar.
    963. 

  963. </P>
    964. 

  964. 

  965. <H2 ID="toc10">Copiando o txt2tags</H2>
    966. 

  966. 

  967. <P>
    968. 

  968. O local oficial de distribuição do txt2tags é na homepage do programa,
    969. 

  969. em <A HREF="http://txt2tags.org/src">http://txt2tags.org/src</A>.
    970. 

  970. </P>
    971. 

  971. <P>
    972. 

  972. Todos os arquivos do programa estão em um tarball (arquivo .tgz), que
    973. 

  973. pode ser expandido pela maioria dos utilitários de compressão (incluindo
    974. 

  974. o Winzip).
    975. 

  975. </P>
    976. 

  976. <P>
    977. 

  977. Simplesmente pegue a <B>última</B> versão (data mais recente, número de
    978. 

  978. versão maior). As versões anteriores estão lá apenas por razões
    979. 

  979. históricas.
    980. 

  980. </P>
    981. 

  981. 

  982. <H2 ID="toc11">Instalação do txt2tags</H2>
    983. 

  983. 

  984. <P>
    985. 

  985. Como é apenas um script Python, o txt2tags não precisa ser instalado.
    986. 

  986. </P>
    987. 

  987. <P>
    988. 

  988. O único arquivo necessário para usar o programa é o script txt2tags. Os
    989. 

  989. outros arquivos do tarball compreendem a documentação, ferramentas e
    990. 

  990. arquivos de exemplo.
    991. 

  991. </P>
    992. 

  992. <P>
    993. 

  993. O modo mais seguro de usar o txt2tags é chamar o Python com ele:
    994. 

  994. </P>
    995. 

  995. 

  996. <PRE>
    997. 

  997.   prompt$ python txt2tags 
    998. 

  998. </PRE>
    999. 

  999. 

  1000. <P>
    1001. 

  1001. Se você quiser "instalar" o txt2tags no sistema como um programa
    1002. 

  1002. independente, basta copiar (ou criar um link) o script txt2tags para um
    1003. 

  1003. diretório que esteja no PATH do sistema e certificar-se que o sistema
    1004. 

  1004. saiba como executar o mesmo.
    1005. 

  1005. </P>
    1006. 

  1006. 

  1007. <DL>
    1008. 

  1008. <DT><B>UNIX/Linux</B></DT><DD>
    1009. 

  1009.   Torne o script executável (<CODE>chmod +x txt2tags</CODE>) e copie o mesmo para
    1010. 

  1010.   um diretório no $PATH (<CODE>cp txt2tags /usr/local/bin</CODE>)
    1011. 

  1011. <P></P>
    1012. 

  1012. <DT><B>Windows</B></DT><DD>
    1013. 

  1013.   Renomeie o script, acrescentando a extensão .py
    1014. 

  1014.   (<CODE>ren txt2tags txt2tags.py</CODE>) e o copie para um diretório que esteja
    1015. 

  1015.   no PATH do sistema (<CODE>copy txt2tags.py C:\WINNT</CODE>)
    1016. 

  1016. </DL>
    1017. 

  1017. 

  1018. <P>
    1019. 

  1019. Depois disto, pode-se criar um ícone no desktop para o programa, se
    1020. 

  1020. quiser usar a Interface Gráfica do programa.
    1021. 

  1021. </P>
    1022. 

  1022. 

  1023. <H3>Pacotes Especiais para Usuários Windows</H3>
    1024. 

  1024. 

  1025. <P>
    1026. 

  1026. Existem dois arquivos de distribuição .EXE para o txt2tags, que instalam
    1027. 

  1027. o programa em máquinas Windows com apenas alguns cliques:
    1028. 

  1028. </P>
    1029. 

  1029. 

  1030. <UL>
    1031. 

  1031. <LI>O script txt2tags para aqueles que tem o interpretador Python
    1032. 

  1032.   instalado
    1033. 

  1033. <LI>A versão stand-alone, que não requer a instalação do interpretador
    1034. 

  1034.   Pyton para ser executada (já tem uma versão pequena incluída).
    1035. 

  1035. </UL>
    1036. 

  1036. 

  1037. <P>
    1038. 

  1038. Visite o site <I>Txt2tags-Win</I> para baixar estes pacotes:
    1039. 

  1039. <A HREF="http://txt2tags-win.sf.net/">http://txt2tags-win.sf.net/</A>
    1040. 

  1040. </P>
    1041. 

  1041. 

  1042. <H2 ID="sintaxe">Instalar os Arquivos de Sintaxe dos Editores de Texto</H2>
    1043. 

  1043. 

  1044. <P>
    1045. 

  1045. O txt2tags possui arquivos de sintaxe práticos que podem ser usados com
    1046. 

  1046. os seguintes editores de texto:
    1047. 

  1047. </P>
    1048. 

  1048. 

  1049. <UL>
    1050. 

  1050. <LI>Vim (<A HREF="http://www.vim.org">www.vim.org</A>)
    1051. 

  1051. <LI>Emacs (<A HREF="http://www.emacs.org">www.emacs.org</A>)
    1052. 

  1052. <LI>Nano (<A HREF="http://www.nano-editor.org">www.nano-editor.org</A>)
    1053. 

  1053. <LI>Kate (<A HREF="http://kate.kde.org">http://kate.kde.org</A>)
    1054. 

  1054. </UL>
    1055. 

  1055. 

  1056. <P>
    1057. 

  1057. Os arquivos de sintaxe têm registro de todas as regras e marcações do
    1058. 

  1058. txt2tags, ajudando ao usuário a escrever documentos sem erros. As marcas
    1059. 

  1059. são mostradas coloridas, assim se pode ver se tudo foi escrito
    1060. 

  1060. corretamente.
    1061. 

  1061. </P>
    1062. 

  1062. 

  1063. <TABLE ALIGN="center" BORDER="1" CELLPADDING="4">
    1064. 

  1064. <TR>
    1065. 

  1065. <TD ALIGN="center"><center><IMG ALIGN="middle" SRC="../userguide/vim.png" BORDER="0" ALT=""></center></TD>
    1066. 

  1066. </TR>
    1067. 

  1067. <TR>
    1068. 

  1068. <TD ALIGN="center">O arquivo de exemplo aberto no Editor Vim</TD>
    1069. 

  1069. </TR>
    1070. 

  1070. </TABLE>
    1071. 

  1071. 

  1072. <P>
    1073. 

  1073. Cada editor tem um procedimento diferente para usar seu arquivo de
    1074. 

  1074. sintaxe. Por favor verifique no cabeçalho de cada arquivo e na
    1075. 

  1075. documentação do editor.
    1076. 

  1076. </P>
    1077. 

  1077. 

  1078. <HR NOSHADE SIZE=5>
    1079. 

  1079. 

  1080. <H1 ID="toc13">Parte III - Escrevendo e Convertendo Seu Primeiro Documento</H1>
    1081. 

  1081. 

  1082. <P>
    1083. 

  1083. Desculpe, este capítulo ainda está em desenvolvimento.
    1084. 

  1084. </P>
    1085. 

  1085. 

  1086. <H2 ID="toc14">As Áreas do documento .t2t</H2>
    1087. 

  1087. 

  1088. <P>
    1089. 

  1089. Os arquivos de marcação txt2tags são divididos em 3 áreas. Cada área tem
    1090. 

  1090. suas próprias regras e finalidade. São elas:
    1091. 

  1091. </P>
    1092. 

  1092. 

  1093. <DL>
    1094. 

  1094. <DT><I>Área de Cabeçalho</I></DT><DD>
    1095. 

  1095. É o lugar para informações sobre o Título do Documento, Autor, Versão e
    1096. 

  1096. Data. (opcional)
    1097. 

  1097. <P></P>
    1098. 

  1098. <DT><I>Área de Configuração</I></DT><DD>
    1099. 

  1099. É o local para colocar as configurações Gerais do documento e
    1100. 

  1100. modificadores do funcionamento do analisador. (opcional)
    1101. 

  1101. <P></P>
    1102. 

  1102. <DT><I>Corpo do Texto</I></DT><DD>
    1103. 

  1103. É o local para o Conteúdo do Documento (requerida)
    1104. 

  1104. </DL>
    1105. 

  1105. 

  1106. <P>
    1107. 

  1107. Como vemos acima, as duas primeiras áreas são opcionais, sendo que o
    1108. 

  1108. <I>Corpo do Texto</I> é a única área indispensável.
    1109. 

  1109. (<I>Nota: A <B>Área de Configuração</B> foi introduzida no txt2tags na versão 1.3</I>)
    1110. 

  1110. </P>
    1111. 

  1111. <P>
    1112. 

  1112. As áreas são delimitadas por regras especiais, que serão vistas em
    1113. 

  1113. detalhe no próximo capítulo. Por enquanto, esta é uma representação
    1114. 

  1114. gráfica das áreas de um documento:
    1115. 

  1115. </P>
    1116. 

  1116. 

  1117. <PRE>
    1118. 

  1118.                ____________
    1119. 

  1119.               |            |
    1120. 

  1120.               |  CABEÇALHO |       1. Primeiro, o cabeçalho
    1121. 

  1121.               |            |
    1122. 

  1122.               |   CONFIG   |       2. Então a configuração
    1123. 

  1123.               |            |
    1124. 

  1124.               |   CORPO    |       3. E, finalmente, o corpo do documento
    1125. 

  1125.               |            |
    1126. 

  1126.               |    ...     |          que segue até o final do arquivo.
    1127. 

  1127.               |    ...     |
    1128. 

  1128.               |____________|
    1129. 

  1129.   
    1130. 

  1130. </PRE>
    1131. 

  1131. 

  1132. <P>
    1133. 

  1133. Em resumo, é assim que as áreas são definidas:
    1134. 

  1134. </P>
    1135. 

  1135. 

  1136. <TABLE ALIGN="center" CELLPADDING="4">
    1137. 

  1137. <TR>
    1138. 

  1138. <TD><B>Cabeçalhos</B></TD>
    1139. 

  1139. <TD>As primeiras 3 linhas do arquivo, ou a primeira linha é deixada em branco se não são usados cabeçalhos</TD>
    1140. 

  1140. </TR>
    1141. 

  1141. <TR>
    1142. 

  1142. <TD><B>Configuração</B></TD>
    1143. 

  1143. <TD>Começam logo depois do cabeçalho (4a. ou 2a. linha)  e termina quando a <I>Área de Conteúdo</I> começa.</TD>
    1144. 

  1144. </TR>
    1145. 

  1145. <TR>
    1146. 

  1146. <TD><B>Corpo</B></TD>
    1147. 

  1147. <TD>A primeira linha de texto válida (que não é comentário ou configuração) após a <I>Área de Cabeçalho</I>.</TD>
    1148. 

  1148. </TR>
    1149. 

  1149. </TABLE>
    1150. 

  1150. 

  1151. <H3>Exemplo Completo</H3>
    1152. 

  1152. 

  1153. <PRE>
    1154. 

  1154.   Título do meu belo documento
    1155. 

  1155.   Sr. Fulano da Silva
    1156. 

  1156.   Última atualização: %%date(%c)
    1157. 

  1157.   
    1158. 

  1158.   %! Target  : html
    1159. 

  1159.   %! Style   : fancy.css
    1160. 

  1160.   %! Encoding: UTF-8
    1161. 

  1161.   %! Options : --toc --enum--title
    1162. 

  1162.   
    1163. 

  1163.   Oi! Este é o meu documento de teste.
    1164. 

  1164.   E o seu conteúdo termina aqui.
    1165. 

  1165. </PRE>
    1166. 

  1166. 

  1167. <HR NOSHADE SIZE=5>
    1168. 

  1168. 

  1169. <H1 ID="toc15">Parte IV - Dominando o Txt2tags</H1>
    1170. 

  1170. 

  1171. <H2 ID="toc16">A Área de Cabeçalho</H2>
    1172. 

  1172. 

  1173. <P>
    1174. 

  1174. Localização:
    1175. 

  1175. </P>
    1176. 

  1176. 

  1177. <UL>
    1178. 

  1178. <LI>Posição fixa: <B>Primeiras 3 linhas</B> do arquivo. Ponto.
    1179. 

  1179. <LI>Posição fixa: <B>A Primeira Linha</B> do arquivo está em branco. Isto
    1180. 

  1180.   significa que o cabeçalho está vazio.
    1181. 

  1181. </UL>
    1182. 

  1182. 

  1183. <P>
    1184. 

  1184. A Área de Cabeçalho é a única que tem uma posição fixa, orientada a
    1185. 

  1185. linhas. Ela está localizada nas três primeiras linhas do código fonte.
    1186. 

  1186. </P>
    1187. 

  1187. <P>
    1188. 

  1188. O conteúdo destas linhas é livre, sem necessidade de nenhuma informação
    1189. 

  1189. estática de nenhum tipo. Mas recomenda-se o seguinte para a maioria dos
    1190. 

  1190. documentos:
    1191. 

  1191. </P>
    1192. 

  1192. 

  1193.    <UL>
    1194. 

  1194.    <LI><I>linha 1</I>: título do documento
    1195. 

  1195.    <LI><I>linha 2</I>: nome e/ou email do autor
    1196. 

  1196.    <LI><I>linha 3</I>: data e/ou versão do documento
    1197. 

  1197.                  (um bom lugar para colocar <CODE>%%date</CODE>)
    1198. 

  1198.    </UL>
    1199. 

  1199. 

  1200. <P>
    1201. 

  1201. Tenha em mente que as 3 primeiras linhas do arquivo fonte serão as 3
    1202. 

  1202. primeiras linhas no documento gerado, separadas e com um grande
    1203. 

  1203. contraste em relação ao corpo do texto (ou seja, letras grandes,
    1204. 

  1204. negrito). Se a paginação for permitida, os cabeçalhos estarão separados
    1205. 

  1205. e centralizados na primeira página.
    1206. 

  1206. </P>
    1207. 

  1207. 

  1208. <H4>Menos (ou Nenhuma) Linhas de Cabeçalho</H4>
    1209. 

  1209. 

  1210. <P>
    1211. 

  1211. Às vezes os usuários querem especificar menos de três linhas nos
    1212. 

  1212. cabeçalhos, dando apenas o título do documento e/ou informação de data.
    1213. 

  1213. </P>
    1214. 

  1214. <P>
    1215. 

  1215. Basta deixar a 2a. e/ou a 3a. linhas em branco e estas linhas não serão
    1216. 

  1216. incluídas no documento gerado. Mas tenha em mente que, mesmo em branco,
    1217. 

  1217. estas linhas ainda são parte dos cabeçalho, e o corpo do documento deve
    1218. 

  1218. começar <B>após</B> a 3a. linha.
    1219. 

  1219. </P>
    1220. 

  1220. <P>
    1221. 

  1221. O título é o único cabeçalho requerido (a primeira linha), mas se você
    1222. 

  1222. deixar ela em branco, está dizendo que seu documento
    1223. 

  1223. <B>não tem cabeçalho</B>. Desta forma, a <I>Área de Texto</I> irá começar em
    1224. 

  1224. seguida, na 2a. linha.
    1225. 

  1225. </P>
    1226. 

  1226. <P>
    1227. 

  1227. Não usar cabeçalhos no documento é útil se você quiser especificar seus
    1228. 

  1228. próprios cabeçalhos customizados após a conversão. A opção de linha de
    1229. 

  1229. comando <CODE>--no-headers</CODE> é geralmente necessária para este tipo de coisa.
    1230. 

  1230. </P>
    1231. 

  1231. 

  1232. <H4>Direto ao ponto</H4>
    1233. 

  1233. 

  1234. <TABLE ALIGN="center" BORDER="1" CELLPADDING="4">
    1235. 

  1235. <TR>
    1236. 

  1236. <TH>Em resumo: "Cabeçalhos são apenas <U>posições</U>, não conteúdo "</TH>
    1237. 

  1237. </TR>
    1238. 

  1238. </TABLE>
    1239. 

  1239. 

  1240. <P>
    1241. 

  1241. Coloque um texto na primeira linha, ele irá aparecer na primeira linha
    1242. 

  1242. do arquivo gerado. O mesmo para a 2a. e 3a. linhas de cabeçalho.
    1243. 

  1243. </P>
    1244. 

  1244. 

  1245. <HR NOSHADE SIZE=1>
    1246. 

  1246. 

  1247. <H2 ID="toc17">A Área de Configuração</H2>
    1248. 

  1248. 

  1249. <P>
    1250. 

  1250. Localização:
    1251. 

  1251. </P>
    1252. 

  1252. 

  1253. <UL>
    1254. 

  1254. <LI>Começa logo após a Área de Cabeçalhos
    1255. 

  1255.   <UL>
    1256. 

  1256.   <LI>Começa na <B>4a. linha</B> do arquivo se forem especificados <B>Cabeçalhos</B>
    1257. 

  1257.   <LI>Começa na <B>2a. linha</B> se <B>não</B> forem especificados <B>Cabeçalhos</B>
    1258. 

  1258.   </UL>
    1259. 

  1259. <LI>Termina quando a Área de Conteúdo começa
    1260. 

  1260.   <UL>
    1261. 

  1261.   <LI>Termina com uma linha que não seja de Configuração, ou de
    1262. 

  1262.     Comentário, ou que seja uma linha em Branco.
    1263. 

  1263.   </UL>
    1264. 

  1264. </UL>
    1265. 

  1265. 

  1266. <P>
    1267. 

  1267. A Área de Configuração é opcional. A maioria dos usuários pode escrever
    1268. 

  1268. carradas de arquivos txt2tags mesmo sem saber que ela existe, mas os
    1269. 

  1269. usuários experientes irão gostar do poder e controle que ela oferece.
    1270. 

  1270. </P>
    1271. 

  1271. <P>
    1272. 

  1272. O uso primário desta área é para definir configurações que afetam o
    1273. 

  1273. comportamento do programa.
    1274. 

  1274. </P>
    1275. 

  1275. 

  1276. <H4>Então, como configurar algo? Qual a sintaxe?</H4>
    1277. 

  1277. 

  1278. <P>
    1279. 

  1279. As linhas de configuração são <I>linhas de comentário especiais</I>,
    1280. 

  1280. marcadas com um identificador no início ("<CODE>!</CODE>") que torna estes
    1281. 

  1281. comentários diferentes dos comentários normais. A sintaxe é tão simples
    1282. 

  1282. quanto uma atribuição de valor a uma variável, composta por uma
    1283. 

  1283. palavra-chave e um valor, separados um do outro pelo separador canônico
    1284. 

  1284. dois-pontos ("<CODE>:</CODE>").
    1285. 

  1285. </P>
    1286. 

  1286. 

  1287. <TABLE ALIGN="center" BORDER="1" CELLPADDING="4">
    1288. 

  1288. <TR>
    1289. 

  1289. <TH>%! palavra-chave : valor</TH>
    1290. 

  1290. </TR>
    1291. 

  1291. </TABLE>
    1292. 

  1292. 

  1293. <P>
    1294. 

  1294. <B><CODE>Detalhes da Sintaxe:</CODE></B> O ponto de exclamação deve ser colocado
    1295. 

  1295. junto com o caractere de comentário, sem espaço entre eles ("<CODE>%!</CODE>").
    1296. 

  1296. Os espaços em torno da <I>palavra-chave</I> e o separador são opcionais, e
    1297. 

  1297. tanto a <I>palavra-chave</I> quanto o <I>valor</I> podem estar
    1298. 

  1298. indiferentemente em maiúsculas ou minúsculas.
    1299. 

  1299. </P>
    1300. 

  1300. 

  1301. <H4>O que eu posso configurar? Quais são as palavra-chave válidas?</H4>
    1302. 

  1302. 

  1303. <P>
    1304. 

  1304. As configurações que podem ser feitas são <I>Target</I>, <I>Options</I>, <I>Style</I>,
    1305. 

  1305. <I>Encoding</I>, <I>PreProc</I> e <I>PostProc</I>.
    1306. 

  1306. </P>
    1307. 

  1307. <P>
    1308. 

  1308. A configuração <B><I>Target</I></B> define o destino padrão na qual o
    1309. 

  1309. documento deve ser convertido.
    1310. 

  1310. </P>
    1311. 

  1311. <P>
    1312. 

  1312. A configuração <B><I>Options</I></B> é útil para especificar as opções de
    1313. 

  1313. linha de comando padrão para o arquivo fonte. Estas opções podem ser
    1314. 

  1314. sobrescritas pela linha de comando real. Usar esta opção juntamente com
    1315. 

  1315. <CODE>%!target</CODE> permite converter o documento simplesmente comandando:
    1316. 

  1316. <CODE>txt2tags file.t2t</CODE>
    1317. 

  1317. </P>
    1318. 

  1318. <P>
    1319. 

  1319. A configuração <B><I>Style</I></B> só é suportada pelo tipo de documento
    1320. 

  1320. destino HTML, para definir uma folha de estilo
    1321. 

  1321. (<I>Cascading Style Sheets - CSS</I>).
    1322. 

  1322. </P>
    1323. 

  1323. <P>
    1324. 

  1324. A configuração <B><I>Encoding</I></B> é necessária para escritores não
    1325. 

  1325. ingleses, que usem letras acentuadas e outros detalhes específicos de
    1326. 

  1326. localização, de forma que o <I>Conjunto de Caracteres</I> do documento seja
    1327. 

  1327. personalizado (se permitido).
    1328. 

  1328. </P>
    1329. 

  1329. <P>
    1330. 

  1330. A configuração <B><I>PreProc</I></B> é um filtro. Ela define regras do tipo
    1331. 

  1331. "busca e troca" que serão aplicadas ao arquivo original <U>antes</U> que
    1332. 

  1332. qualquer análise por parte do txt2tags ocorra.
    1333. 

  1333. </P>
    1334. 

  1334. <P>
    1335. 

  1335. A configuração <B><I>PostProc</I></B> é um filtro. Ela define regras do tipo
    1336. 

  1336. "busca e troca" que serão aplicadas ao arquivo destino <U>depois</U> de
    1337. 

  1337. todo o processamento por parte do txt2tags.
    1338. 

  1338. </P>
    1339. 

  1339. <P>
    1340. 

  1340. Exemplo:
    1341. 

  1341. </P>
    1342. 

  1342. 

  1343. <PRE>
    1344. 

  1344.   %! Target  : html
    1345. 

  1345.   %! Options : --toc --toc-level 3
    1346. 

  1346.   %! Style   : fancy.css
    1347. 

  1347.   %! Encoding: UTF-8
    1348. 

  1348.   %! PreProc : "amj"       "Aurelio Marinho Jargas"
    1349. 

  1349.   %! PostProc: '&lt;BODY.*?&gt;' '&lt;BODY bgcolor="yellow"&gt;'
    1350. 

  1350. </PRE>
    1351. 

  1351. 

  1352. <H4>Algumas regras sobre as Configurações</H4>
    1353. 

  1353. 

  1354.  <UL>
    1355. 

  1355.  <LI>As configurações são válidas somente dentro da Área de Configuração,
    1356. 

  1356.    e serão consideradas comentários simples se forem encontradas no
    1357. 

  1357.    Corpo do documento.
    1358. 

  1358.  <P></P>
    1359. 

  1359.  <LI>Se a mesma palavra-chave aparece mais de uma vez na Área de
    1360. 

  1360.    Configuração, apenas a última será usada. Exceção: options, preproc e
    1361. 

  1361.    postproc, que são acumulativas.
    1362. 

  1362.  <P></P>
    1363. 

  1363.  <LI>Uma linha de configuração com uma palavra-chave inválida será
    1364. 

  1364.    considerada um comentário.
    1365. 

  1365.  <P></P>
    1366. 

  1366.  <LI>Estas configurações têm precedência sobre o arquivo <CODE>txt2tagsrc</CODE>,
    1367. 

  1367.    as não sobre as opções de linha de comando.
    1368. 

  1368.  </UL>
    1369. 

  1369. 

  1370. <HR NOSHADE SIZE=1>
    1371. 

  1371. 

  1372. <H2 ID="toc18">O Corpo do Texto</H2>
    1373. 

  1373. 

  1374. <P>
    1375. 

  1375. Localização:
    1376. 

  1376. </P>
    1377. 

  1377. 

  1378. <UL>
    1379. 

  1379. <LI>Começa na primeira linha válida de texto do arquivo
    1380. 

  1380.   <UL>
    1381. 

  1381.   <LI>Cabeçalhos, Configurações e Comentários <B>não</B> são linhas de texto
    1382. 

  1382.     válidas
    1383. 

  1383.   </UL>
    1384. 

  1384. <LI>Termina no fim do arquivo (EOF)
    1385. 

  1385. </UL>
    1386. 

  1386. 

  1387. <P>
    1388. 

  1388. Bem, o corpo do texto é tudo que estiver fora das Áreas de Cabeçalho e
    1389. 

  1389. de Configuração.
    1390. 

  1390. </P>
    1391. 

  1391. <P>
    1392. 

  1392. O corpo do texto é onde está o conteúdo do documento e todas as
    1393. 

  1393. estruturas e formatações que o txt2tags reconhece. Dentro do corpo podem
    1394. 

  1394. ser também colocados comentários para <I>A FAZER</I> e anotações
    1395. 

  1395. particulares.
    1396. 

  1396. </P>
    1397. 

  1397. <P>
    1398. 

  1398. Pode-se utilizar a opção de linha de comando <CODE>--no-headers</CODE> para
    1399. 

  1399. converter somente o corpo do documento, suprimindo os cabeçalhos. Esta
    1400. 

  1400. opção é útil quando os cabeçalhos estão em um arquivo separado, que será
    1401. 

  1401. unido ao corpo depois da conversão.
    1402. 

  1402. </P>
    1403. 

  1403. 

  1404. <HR NOSHADE SIZE=1>
    1405. 

  1405. 

  1406. <H2 ID="regras">Marcações (REGRAS)</H2>
    1407. 

  1407. 

  1408. <P>
    1409. 

  1409. Todas as marcações e sintaxe usadas pelo txt2tags estão detalhadas em
    1410. 

  1410. um <A HREF="REGRAS">arquivo REGRAS a parte</A>.
    1411. 

  1411. </P>
    1412. 

  1412. 

  1413. <HR NOSHADE SIZE=1>
    1414. 

  1414. 

  1415. <H2 ID="data">A macro %%date</H2>
    1416. 

  1416. 

  1417. <P>
    1418. 

  1418. A macro <CODE>%%date</CODE> chamada sem nenhum parâmetro adicional retorna a data
    1419. 

  1419. atual no formato ISO <I>yyyymmdd</I>. Uma formatação opcional pode ser
    1420. 

  1420. especificada usando a sintaxe <CODE>%%date(formato)</CODE>.
    1421. 

  1421. </P>
    1422. 

  1422. <P>
    1423. 

  1423. O <I>formato</I> contém texto de diretivas de formatação, que são compostas
    1424. 

  1424. por um sinal de porcentagem (<CODE>%</CODE>) seguido por um caractere de
    1425. 

  1425. identificação.
    1426. 

  1426. </P>
    1427. 

  1427. <P>
    1428. 

  1428. Segue uma lista de algumas diretivas comuns. A lista completa pode ser
    1429. 

  1429. encontrada em <A HREF="http://www.python.org/doc/current/lib/module-time.html">http://www.python.org/doc/current/lib/module-time.html</A>.
    1430. 

  1430. </P>
    1431. 

  1431. 

  1432. <TABLE ALIGN="center" BORDER="1" CELLPADDING="4">
    1433. 

  1433. <TR>
    1434. 

  1434. <TH>Diretiva</TH>
    1435. 

  1435. <TH>Descrição</TH>
    1436. 

  1436. </TR>
    1437. 

  1437. <TR>
    1438. 

  1438. <TD ALIGN="center">%a</TD>
    1439. 

  1439. <TD>Dia da semana local abreviado.</TD>
    1440. 

  1440. </TR>
    1441. 

  1441. <TR>
    1442. 

  1442. <TD ALIGN="center">%A</TD>
    1443. 

  1443. <TD>Dia da semana completo.</TD>
    1444. 

  1444. </TR>
    1445. 

  1445. <TR>
    1446. 

  1446. <TD ALIGN="center">%b</TD>
    1447. 

  1447. <TD>Nome do mês abreviado.</TD>
    1448. 

  1448. </TR>
    1449. 

  1449. <TR>
    1450. 

  1450. <TD ALIGN="center">%B</TD>
    1451. 

  1451. <TD>Nome do mês.</TD>
    1452. 

  1452. </TR>
    1453. 

  1453. <TR>
    1454. 

  1454. <TD ALIGN="center">%c</TD>
    1455. 

  1455. <TD>Dia e hora formatados apropriadamente.</TD>
    1456. 

  1456. </TR>
    1457. 

  1457. <TR>
    1458. 

  1458. <TD ALIGN="center">%d</TD>
    1459. 

  1459. <TD>Dia do mês como um número decimal [01,31].</TD>
    1460. 

  1460. </TR>
    1461. 

  1461. <TR>
    1462. 

  1462. <TD ALIGN="center">%H</TD>
    1463. 

  1463. <TD>Hora (24 horas) como um número decimal [00,23].</TD>
    1464. 

  1464. </TR>
    1465. 

  1465. <TR>
    1466. 

  1466. <TD ALIGN="center">%I</TD>
    1467. 

  1467. <TD>Hora (12 horas) como um número decimal [01,12].</TD>
    1468. 

  1468. </TR>
    1469. 

  1469. <TR>
    1470. 

  1470. <TD ALIGN="center">%m</TD>
    1471. 

  1471. <TD>O mês como um número decimal [01,12].</TD>
    1472. 

  1472. </TR>
    1473. 

  1473. <TR>
    1474. 

  1474. <TD ALIGN="center">%M</TD>
    1475. 

  1475. <TD>O minuto como um número decimal [00,59].</TD>
    1476. 

  1476. </TR>
    1477. 

  1477. <TR>
    1478. 

  1478. <TD ALIGN="center">%p</TD>
    1479. 

  1479. <TD>O equivalente local a AM e PM.</TD>
    1480. 

  1480. </TR>
    1481. 

  1481. <TR>
    1482. 

  1482. <TD ALIGN="center">%S</TD>
    1483. 

  1483. <TD>Os segundos como um número decimal [00,61].  (1)</TD>
    1484. 

  1484. </TR>
    1485. 

  1485. <TR>
    1486. 

  1486. <TD ALIGN="center">%x</TD>
    1487. 

  1487. <TD>Representação local da data.</TD>
    1488. 

  1488. </TR>
    1489. 

  1489. <TR>
    1490. 

  1490. <TD ALIGN="center">%X</TD>
    1491. 

  1491. <TD>Representação local da hora.</TD>
    1492. 

  1492. </TR>
    1493. 

  1493. <TR>
    1494. 

  1494. <TD ALIGN="center">%y</TD>
    1495. 

  1495. <TD>O ano sem o século como um número decimal [00,99].</TD>
    1496. 

  1496. </TR>
    1497. 

  1497. <TR>
    1498. 

  1498. <TD ALIGN="center">%Y</TD>
    1499. 

  1499. <TD>O ano com o século como um número decimal.</TD>
    1500. 

  1500. </TR>
    1501. 

  1501. <TR>
    1502. 

  1502. <TD ALIGN="center">%%</TD>
    1503. 

  1503. <TD>Um caractere "%".</TD>
    1504. 

  1504. </TR>
    1505. 

  1505. </TABLE>
    1506. 

  1506. 

  1507. <H4>Exemplos</H4>
    1508. 

  1508. 

  1509. <TABLE ALIGN="center" BORDER="1" CELLPADDING="4">
    1510. 

  1510. <TR>
    1511. 

  1511. <TH><CODE>%%date(format)</CODE></TH>
    1512. 

  1512. <TH>Resultado para: 2004, Jul13, 18:49</TH>
    1513. 

  1513. </TR>
    1514. 

  1514. <TR>
    1515. 

  1515. <TD>Last Update: %c</TD>
    1516. 

  1516. <TD>Last Update: Tue Jan 13 18:49:32 2004</TD>
    1517. 

  1517. </TR>
    1518. 

  1518. <TR>
    1519. 

  1519. <TD>%Y-%m-%d</TD>
    1520. 

  1520. <TD>2004-07-13</TD>
    1521. 

  1521. </TR>
    1522. 

  1522. <TR>
    1523. 

  1523. <TD>%I:%M %p</TD>
    1524. 

  1524. <TD>18:49 PM</TD>
    1525. 

  1525. </TR>
    1526. 

  1526. <TR>
    1527. 

  1527. <TD>Hoje e %A, em %B.</TD>
    1528. 

  1528. <TD>Hoje e Tuesday, em July.</TD>
    1529. 

  1529. </TR>
    1530. 

  1530. </TABLE>
    1531. 

  1531. 

  1532. <HR NOSHADE SIZE=1>
    1533. 

  1533. 

  1534. <H2 ID="include">O comando %!include</H2>
    1535. 

  1535. 

  1536. <P>
    1537. 

  1537. A partir da versão 1.7, é possível usar o comando <CODE>include</CODE> para
    1538. 

  1538. inserir o conteúdo de um arquivo externo dentro do corpo do documento
    1539. 

  1539. original.
    1540. 

  1540. </P>
    1541. 

  1541. <P>
    1542. 

  1542. O <CODE>%!include</CODE> não é uma configuração, mas um comando, sendo somente
    1543. 

  1543. válido na área de CORPO do texto.
    1544. 

  1544. </P>
    1545. 

  1545. <P>
    1546. 

  1546. O comando <CODE>include</CODE> é útil para dividir um documento grande em vários
    1547. 

  1547. arquivos menores (como capítulos de um livro) ou para incluir todo o
    1548. 

  1548. conteúdo de um arquivo qualquer no documento. Por exemplo:
    1549. 

  1549. </P>
    1550. 

  1550. 

  1551. <PRE>
    1552. 

  1552.   Meu Primeiro Livro
    1553. 

  1553.   Dr. Fulano da Silva
    1554. 

  1554.   1ª Edição
    1555. 

  1555.   
    1556. 

  1556.   %!include: introducao.t2t
    1557. 

  1557.   %!include: capitulo1.t2t
    1558. 

  1558.   %!include: capitulo2.t2t
    1559. 

  1559.   ...
    1560. 

  1560.   %!include: capitulo9.t2t
    1561. 

  1561.   %!include: conclusao.t2t
    1562. 

  1562. </PRE>
    1563. 

  1563. 

  1564. <P>
    1565. 

  1565. Como se pode ver, basta informar o nome do arquivo logo após o comando
    1566. 

  1566. <CODE>%!include</CODE>. Também é possível atrelar o comando a um destino
    1567. 

  1567. específico, como em:
    1568. 

  1568. </P>
    1569. 

  1569. 

  1570. <PRE>
    1571. 

  1571.   %!include(html): arquivo.t2t
    1572. 

  1572. </PRE>
    1573. 

  1573. 

  1574. <P>
    1575. 

  1575. Note que o <CODE>include</CODE> vai inserir o CORPO do documento .t2t, ignorando
    1576. 

  1576. seu CABEÇALHO e suas CONFIGURAÇÕES. Assim é possível converter o arquivo
    1577. 

  1577. incluído de maneira isolada ou como parte do documento mãe.
    1578. 

  1578. </P>
    1579. 

  1579. <P>
    1580. 

  1580. Além de incluir arquivos .t2t, há mais três tipos de inclusão:
    1581. 

  1581. </P>
    1582. 

  1582. 

  1583. <UL>
    1584. 

  1584. <LI>Inclusão de texto pré-formatado (Verbatim)
    1585. 

  1585. <LI>Inclusão de texto protegido (Raw)
    1586. 

  1586. <LI>Inclusão de texto já convertido (Tagged)
    1587. 

  1587. </UL>
    1588. 

  1588. 

  1589. <P>
    1590. 

  1590. No tipo <B>Verbatim</B> o texto é incluído preservado seus espaços e
    1591. 

  1591. formatação originais. É como se esse texto estivesse entre as marcações
    1592. 

  1592. (```) da área VERB do txt2tags. Para incluir um arquivo dessa maneira,
    1593. 

  1593. basta colocar seu nome entre crases:
    1594. 

  1594. </P>
    1595. 

    1596. 

  1596. <PRE>
    1597. 

  1597.   %!include: ``/etc/fstab``
    1598. 

  1598. </PRE>
    1599. 

    1600. 

  1600. <P>
    1601. 

  1601. No tipo <B>Raw</B> o texto é incluído "como está", sem tentar encontrar e
    1602. 

  1602. avaliar as marcas do txt2tags dele. É como se esse texto estivesse entre
    1603. 

  1603. as marcações (""") da área protegida. Para incluir um arquivo dessa
    1604. 

  1604. maneira, basta colocar seu nome entre aspas
    1605. 

  1605. </P>
    1606. 

    1607. 

  1607. <PRE>
    1608. 

  1608.   %!include: ""bom_texto.txt""
    1609. 

  1609. </PRE>
    1610. 

    1611. 

  1611. <P>
    1612. 

  1612. Já no tipo <B>Tagged</B>, o texto é passado diretamente para o documento
    1613. 

  1613. resultante, sem NENHUM tratamento pelo txt2tags. Assim é possível
    1614. 

  1614. incluir tags adicionais, trechos já prontos ou estruturas mais
    1615. 

  1615. complicadas que não são suportadas pelo programa. Outra aplicação é
    1616. 

  1616. incluir um cabeçalho ou rodapé padrão em todos os documentos:
    1617. 

  1617. </P>
    1618. 

    1619. 

  1619. <PRE>
    1620. 

  1620.   %!include(html): ''rodape.html''
    1621. 

  1621. </PRE>
    1622. 

    1623. 

  1623. <P>
    1624. 

  1624. Note que o nome do arquivo está entre aspas simples (e não crases como o
    1625. 

  1625. anterior). São estas aspas que indicam que o conteúdo deve ser passado
    1626. 

  1626. diretamente. Como este conteúdo já contém tags, é primordial especificar
    1627. 

  1627. o destino também, para evitar problemas.
    1628. 

  1628. </P>
    1629. 

    1630. 

  1630. <HR NOSHADE SIZE=5>
    1631. 

    1632. 

  1632. <H1 ID="settings">Parte V - Dominando as Diretivas de Configuração</H1>
    1633. 

    1634. 

  1634. <P>
    1635. 

  1635. As Diretivas de Configuração são todas opcionais. A maioria dos usuários
    1636. 

  1636. pode muito bem passar sem elas. Mas elas são viciantes, se você começa a
    1637. 

  1637. usá-las, não consegue parar :)
    1638. 

  1638. </P>
    1639. 

    1640. 

  1640. <HR NOSHADE SIZE=1>
    1641. 

    1642. 

  1642. <H2 ID="toc23">%!Target</H2>
    1643. 

    1644. 

  1644. <P>
    1645. 

  1645. Usando a configuração Target define o destino padrão definido no
    1646. 

  1646. documento:
    1647. 

  1647. </P>
    1648. 

    1649. 

  1649. <PRE>
    1650. 

  1650.   %!target: html
    1651. 

  1651. </PRE>
    1652. 

    1653. 

  1653. <P>
    1654. 

  1654. Assim o usuário pode simplesmente comandar
    1655. 

  1655. </P>
    1656. 

    1657. 

  1657. <PRE>
    1658. 

  1658.   $ txt2tags file.t2t
    1659. 

  1659. </PRE>
    1660. 

    1661. 

  1661. <P>
    1662. 

  1662. E a conversão será efetuada para o destino especificado.
    1663. 

  1663. </P>
    1664. 

  1664. <P>
    1665. 

  1665. A configuração Target não permite a especificação opcional de destino.
    1666. 

  1666. Afinal, não faz sentido algo como <CODE>%!target(tex): html</CODE>.
    1667. 

  1667. </P>
    1668. 

    1669. 

  1669. <HR NOSHADE SIZE=1>
    1670. 

    1671. 

  1671. <H2 ID="toc24">%!Options</H2>
    1672. 

    1673. 

  1673. <P>
    1674. 

  1674. Escrever longas lin…
    1675.