PageRenderTime 47ms CodeModel.GetById 17ms RepoModel.GetById 1ms app.codeStats 0ms

/doc/Portuguese/userguide-pt.t2t

http://txt2tags.googlecode.com/
Unknown | 1736 lines | 1235 code | 501 blank | 0 comment | 0 complexity | ff6cc7b6181103b19ee14898de320836 MD5 | raw file
Possible License(s): GPL-2.0, GPL-3.0, WTFPL

Large files files are truncated, but you can click here to view the full file

    

  1. Guia do Usuário Txt2tags
    2. 

  2. Aurelio, %%date(%c)
    3. 

  3. Tradução para o português: César A. K. Grossman
    4. 

  4. 

  5. %!target: html
    6. 

  6. %!encoding: UTF-8
    7. 

  7. %!options: --toc --toc-level 2
    8. 

  8. 

  9. %!preproc: IMGPATH ../userguide
    10. 

  10. 

  11. %!postproc(html): '(<LI>.*include </A>)$'          '\1 <b>[NOVO!]</b>'
    12. 

  12. %!postproc(html): '(<LI>.*%!Target</A>)$'          '\1 <b>[NOVO!]</b>'
    13. 

  13. %!postproc(html): '(<LI>.*%!Options</A>)$'         '\1 <b>[NOVO!]</b>'
    14. 

  14. %!postproc(html): '(<LI>.*linha de comando</A>)$'  '\1 <b>[NOVO!]</b>'
    15. 

  15. %!postproc(html): '(<LI>.*Editores de Texto</A>)$' '\1 <b>[NOVO!]</b>'
    16. 

  16. 

  17. %%% Embedded CSS code
    18. 

  18. %
    19. 

  19. %!postproc(html): ^<HEAD>$ '<HEAD>\n<STYLE TYPE="text/css">\n@#@'
    20. 

  20. %!postproc(html): (@#@)$ 'body {background-color:#ddeeff; color:black;   \n\1'
    21. 

  21. %!postproc(html): (@#@)$ '      margin:2em; text-align:justify;}         \n\1'
    22. 

  22. %!postproc(html): (@#@)$ 'a {text-decoration:none;}\na:hover {color:red;}\n\1'
    23. 

  23. %!postproc(html): (@#@)$ 'a:visited {color:purple;}\ndl {margin:1em;}    \n\1'
    24. 

  24. %!postproc(html): (@#@)$ 'h1 {text-align:center; background-color:blue;  \n\1'
    25. 

  25. %!postproc(html): (@#@)$ '    color:white; padding:8px;}                 \n\1'
    26. 

  26. %!postproc(html): (@#@)$ 'h2 {padding-top:20px;}\nhr {border-style:none;}\n\1'
    27. 

  27. %!postproc(html): (@#@)$ 'code {background-color:lightblue;}             \n\1'
    28. 

  28. %!postproc(html): (@#@)$ 'table {border-style:solid; border-color:black;}\n\1'
    29. 

  29. %!postproc(html): (@#@)$ 'th {background-color:lightblue; padding:1em;}  \n\1'
    30. 

  30. %!postproc(html): (@#@)$ 'td {border-style:none; background-color:white;}\n\1'
    31. 

  31. %!postproc(html): (@#@)$ 'pre {border-style:solid; border-width:1px 1px; \n\1'
    32. 

  32. %!postproc(html): (@#@)$ '     background-color:lightblue; padding:8px;  \n\1'
    33. 

  33. %!postproc(html): (@#@)$ '     border-color:black;}                      \n\1'
    34. 

  34. %!postproc(html):  @#@$  </STYLE>
    35. 

  35. 

  36. % 23/08/2003 grossman: traduzido para o português
    37. 

  37. % 13/07/2004 jic     : revisado e atualizado por jic conforme V2.0 beta 4
    38. 

  38. % 22/07/2004 aurelio : revisado para a v2.0
    39. 

  39. 

  40. 

  41. = Sobre este documento =
    42. 

  42. 

  43. 	Olá, eu sou o guia do usuário do txt2tags!
    44. 

  44. 	
    45. 

  45. 	Aqui você encontra toda a informação disponível sobre a
    46. 

  46. 	ferramenta de conversão de textos txt2tags.
    47. 

  47. 	
    48. 

  48. 	Minha versão atualizada pode ser encontrada em
    49. 

  49. 	http://txt2tags.org/userguide/
    50. 

  50. 	
    51. 

  51. 	Para mais informações e versões recentes, visite
    52. 

  52. 	[o website do txt2tags http://txt2tags.org/].
    53. 

  53. 	
    54. 

  54. 	Bom proveito!
    55. 

  55. 

  56. ========================================================================
    57. 

  57. 

  58. 

  59. 

  60. = Parte I - Introdução ao Txt2tags =
    61. 

  61. 

  62. == Suas Primeiras Questões ==
    63. 

  63. 

  64. Este capítulo apresenta o txt2tags, introduzindo as funcionalidades e
    65. 

  65. objetivo do programa.
    66. 

  66. 

  67. ------------------------------------------------------------------------
    68. 

  68. 

  69. 

  70. === O Que É? ===
    71. 

  71. 

  72. O txt2tags é uma ferramenta de formatação e conversão de texto.
    73. 

  73. 

  74. O txt2tags converte um arquivo texto com algumas marcas para qualquer um
    75. 

  75. dos tipos de arquivos suportados:
    76. 

  76. 

  77. - Documento HTML
    78. 

  78. - Documento XHTML
    79. 

  79. - Documento SGML
    80. 

  80. - Documento LaTeX
    81. 

  81. - Página man UNIX
    82. 

  82. - Apresentação Magic Point
    83. 

  83. - Página MoinMoin
    84. 

  84. - Documento PageMaker 6.0
    85. 

  85. - Texto Plano (sem marcações)
    86. 

  86. 

  87. 

  88. ------------------------------------------------------------------------
    89. 

  89. 

  90. 

  91. === Por Quê Eu Devo Usá-lo? ===
    92. 

  92. 

  93. Você achará o txt2tags bastante útil se você:
    94. 

  94. - precisa publicar documentos em diferentes formatos
    95. 

  95. - precisa manter documentos atualizados em diferentes formatos
    96. 

  96. - escreve manuais ou documentos técnicos
    97. 

  97. - não sabe como escrever um documento em um formato específico
    98. 

  98. - não tem um editor específico para um certo formato.
    99. 

  99. - quer usar um editor de texto simples para atualizar seus documentos
    100. 

  100. 

  101. 

  102. E a motivação principal é:
    103. 

  103. - economizar tempo, escrevendo **conteúdo**, sem se preocupar com
    104. 

  104.   **formatação**
    105. 

  105. 

  106. 

  107. ------------------------------------------------------------------------
    108. 

  108. 

  109. 

  110. === Quais vantagens oferece em relação a outras ferramentas? ===
    111. 

  111. 

  112. O txt2tags possui uma forma bem direta de crescimento, seguindo alguns
    113. 

  113. conceitos básicos. Os conceitos a seguir se destacam:
    114. 

  114. 

  115. | //Arquivo fonte legível//       | As marcações do txt2tags são bastante simples, quase naturais.
    116. 

  116. | //Documento destino legível//   | Da mesma forma que o arquivo fonte, o código do documento gerado também é legível, alinhado e possui linhas curtas.
    117. 

  117. | //Consistência na Marcação// 	  | As marcações txt2tags são únicas, atendendo todos os tipos de documentos e não sendo confundidas com o conteúdo.
    118. 

  118. | //Regras Consistentes//         | Da mesma forma que as marcas, as regras aplicadas a elas são uniformes, não há "exceções" ou "casos especiais".
    119. 

  119. | //Estruturas Simples//          | Toda a formatação suportada é **simples**, sem opções extras ou modificadores complexos de comportamento. Uma marcação é só uma marcação, sem opções adicionais.
    120. 

  120. | //Fácil de aprender//           | Com marcações simples e o código fonte legível, a curva de aprendizado é bem amigável.
    121. 

  121. | //Bons Exemplos//               | Os **arquivos de exemplo** incluídos com o pacote dão mostras reais de documentos simples e super-estruturados, escritos no formato txt2tags.
    122. 

  122. | //Ferramentas Valiosas//        | Os **arquivos de sintaxe** incluídos com o pacote (para os editores vim, emacs, nano e kate) ajudam a escrever documentos sem erros sintáticos.
    123. 

  123. | //Três interfaces ao usuários// | Há uma **interface Gráfica Tk** que é bastante amigável, uma **inteface Web** para usar remotamente ou na intranet, e uma **interface de Linha de Comando**, para usuários avançados e scripts.
    124. 

  124. | //Suporte a Scripts//           | Com o modo completo de linha de comando, um usuário experiente pode **automatizar** tarefas e efetuar **pós-edições** nos arquivos convertidos.
    125. 

  125. | //Baixe e Execute / Multiplataforma// | O txt2tags é apenas um **script Python**. 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.
    126. 

  126. | //Atualizações Freqüentes//     | 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.
    127. 

  127. 

  128. 

  129. ------------------------------------------------------------------------
    130. 

  130. 

  131. 

  132. === Tenho que pagar por ele? ===
    133. 

  133. 

  134.   ||  Absolutamente NÃO!  |
    135. 

  135. 

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

  137. etc...
    138. 

  138. 

  139. Você pode copiar, usar, modificar, vender, liberar como seu. As
    140. 

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

  141. do autor.
    142. 

  142. 

  143. 

  144. ------------------------------------------------------------------------
    145. 

  145. 

  146. 

  147. == Estruturas de Formatação Suportadas ==
    148. 

  148. 

  149. Segue uma lista de todas as estruturas suportadas pelo txt2tags.
    150. 

  150. 

  151. - cabeçalho (título, nome do autor, data)
    152. 

  152. - títulos de seções (numeradas ou não)
    153. 

  153. - parágrafos
    154. 

  154. - modificadores de fontes
    155. 

  155.   - negrito
    156. 

  156.   - itálico
    157. 

  157.   - sublinhado
    158. 

  158. - fonte monoespaço (verbatim)
    159. 

  159.   - monoespaço no meio de um parágrafo
    160. 

  160.   - linha monoespaçada
    161. 

  161.   - trecho em monoespaçado
    162. 

  162. - citações
    163. 

  163. - links
    164. 

  164.   - Links de Internet (URL)
    165. 

  165.   - links de email
    166. 

  166.   - links locais
    167. 

  167.   - links nomeados
    168. 

  168. - listas
    169. 

  169.   - listas com marcadores
    170. 

  170.   - listas numeradas
    171. 

  171.   - listas de definição
    172. 

  172. - linha horizontal de separação
    173. 

  173. - imagems (com alinhamento inteligente)
    174. 

  174. - tabela (com ou sem borda, com alinhamento inteligente)
    175. 

  175. - marcação especial para texto que não deve ser formatado
    176. 

  176. - macro especial para a data atual (com formatação flexível)
    177. 

  177. - comentários (para notas, A FAZER, CORREÇÕES, etc.)
    178. 

  178. 

  179. 

  180. ------------------------------------------------------------------------
    181. 

  181. 

  182. 

  183. == Formatos Suportados ==
    184. 

  184. 

  185. : **HTML**                                                                
    186. 

  186. Todo mundo sabe o que o HTML é (dica: Internet).
    187. 

  187. 

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

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

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

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

  192. desejado. O Txt2tags gera código "//HTML 4.0 Transitional//".
    193. 

  193. 

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

  195. pelo [validador w3c vhttp://validator.w3.org/].
    196. 

  196. 

  197. 

  198. : **XHTML**
    199. 

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

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

  201. avaliado e entendido. Para propósitos gerais, considere como HTML. O
    202. 

  202. txt2tags gera código "//HTML 4.0 Transitional//".
    203. 

  203. 

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

  205. pelo [validador w3c vhttp://validator.w3.org/].
    206. 

  206. 

  207. : **SGML**
    208. 

  208. O SGML é um formato de documento comum que possui aplicações de
    209. 

  209. conversão, como [sgmltools http://www.sgmltools.org/]. De um arquivo
    210. 

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

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

  212. em subpáginas (sgml2html).
    213. 

  213. 

  214. O txt2tags gera arquivos SGML válidos para a DTD linuxdoc, prontos para
    215. 

  215. serem convertidos com uma ferramenta sgml2* sem qualquer arquivo de
    216. 

  216. catálogo extra ou outras exigências incômodas do SGML.
    217. 

  217. 

  218. : **LATEX**
    219. 

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

  220. do que normalmente se considera. Livros completos, fórmulas complicadas
    221. 

  221. e qualquer texto complexo pode ser escrito em LaTeX. Mas se prepare para
    222. 

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

  223. 

  224. O txt2tags gera arquivos LaTeX prontos para usar, realizando todos os
    225. 

  225. complexos truques de escape e exceções. O escritor deve se preocupar
    226. 

  226. exclusivamente com o texto.
    227. 

  227. 

  228. : **MAN**
    229. 

  229. As páginas man do UNIX resistiram pelos anos. Formatos de documento vem
    230. 

  230. e vão, e elas estão aí, imbatíveis.
    231. 

  231. 

  232. Existem outras ferramentas para gerar documentos man, mas o txt2tags tem
    233. 

  233. uma vantagem: uma fonte, múltiplos formatos destino. Assim, o conteúdo
    234. 

  234. da mesma página man pode ser convertido para uma página HTML, uma
    235. 

  235. apresentação Magic Point, etc.
    236. 

  236. 

  237. : **MGP**
    238. 

  238. O [Magic Point http://www.mew.org/mgp/] é uma ferramenta de apresentação
    239. 

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

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

  241. apresentações complexas no vi/emacs/notepad.
    242. 

  242. 

  243. O txt2tags gera um arquivo .mgp pronto para ser usado, definindo todos
    244. 

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

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

  246. 

  247. **Observação 1:** os arquivos .mgp criados pelo txt2tags usam as fontes
    248. 

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

  249. com sua apresentação.
    250. 

  250. 

  251. **Observação 2:** as definições de cor para as fontes são limpas, de
    252. 

  252. forma que mesmo com uma paleta de cores de sistema pobre (como em
    253. 

  253. ``startx -- -bpp 8``) a apresentação vai ter boa aparência.
    254. 

  254. 

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

  256. requisitos.
    257. 

  257. 

  258. : **MOIN**
    259. 

  259. Você não sabe o que é o [MoinMoin http://moin.sourceforge.net]? Ele é
    260. 

  260. um [WikiWiki http://www.c2.com/cgi/wiki]!
    261. 

  261. 

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

  263. ``{{{'''''acrescentando chaves e plicas'''''}}}``, mas o txt2tags vem
    264. 

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

  265. múltiplos formatos destino.
    266. 

  266. 

  267. : **PM6**
    268. 

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

  269. linguagem de marcação! Estilos, tabelas de cores, embelezadores, e a
    270. 

  270. maior parte das funcionalidades acessíveis via cliques de mouse também
    271. 

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

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

  273. de marcação semelhante ao HTML.
    274. 

  274. 

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

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

  277. parte difícil. **EPA:** Sem quebras de linha! Um parágrafo deve ser uma
    278. 

  278. única linha.
    279. 

  279. 

  280. Nota do Autor:
    281. 

  281. //Todo meu livro em português sobre [expressões regulares http://guia-er.sf.net/]//
    282. 

  282. //foi escrito no vi, convertido para o formato do PageMaker com o//
    283. 

  283. //txt2tags e então mandado para o prelo.//
    284. 

  284. 

  285. : **TXT**
    286. 

  286. TXT é texto. O único tipo de formatação verdadeiro.
    287. 

  287. 

  288. Apesar das marcações do txt2tags serem bem intuitivas e discretas,
    289. 

  289. pode-se removê-las ao converter o arquivo para TXT puro.
    290. 

  290. 

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

  292. código fonte.
    293. 

  293. 

  294. 

  295. ------------------------------------------------------------------------
    296. 

  296. 

  297. 

  298. == Situação dos Formatos-Destino para as Estruturas Suportadas ==[estruturas]
    299. 

  299. 

  300.   || Estrutura          | html | xhtml | sgml | tex | man | mgp | moin | pm6 | txt |
    301. 

  301.   | cabeçalhos          |  S   |   S   |  S   |  S  |  S  |  S  |  N   |  N  |  S  |
    302. 

  302.   | título de seções    |  S   |   S   |  S   |  S  |  S  |  S  |  S   |  S  |  S  |
    303. 

  303.   | parágrafos          |  S   |   S   |  S   |  S  |  S  |  S  |  S   |  S  |  S  |
    304. 

  304.   | negrito             |  S   |   S   |  S   |  S  |  S  |  S  |  S   |  S  |  -  |
    305. 

  305.   | itálico             |  S   |   S   |  S   |  S  |  S  |  S  |  S   |  S  |  -  |
    306. 

  306.   | sublinhado          |  S   |   S   |  -   |  S  |  -  |  S  |  S   |  S  |  -  |
    307. 

  307.   | pré-formatado       |  S   |   S   |  S   |  S  |  -  |  S  |  S   |  S  |  -  |
    308. 

  308.   | linha pré-formatada |  S   |   S   |  S   |  S  |  S  |  S  |  S   |  S  |  -  |
    309. 

  309.   | área pré-formatada  |  S   |   S   |  S   |  S  |  S  |  S  |  S   |  S  |  -  |
    310. 

  310.   | área cotada         |  S   |   S   |  S   |  S  |  S  |  S  |  S   |  S  |  S  |
    311. 

  311.   | links internet      |  S   |   S   |  S   |  -  |  -  |  -  |  S   |  -  |  -  |
    312. 

  312.   | links e-mail        |  S   |   S   |  S   |  -  |  -  |  -  |  S   |  -  |  -  |
    313. 

  313.   | links locais        |  S   |   S   |  S   |  N  |  -  |  -  |  S   |  -  |  -  |
    314. 

  314.   | links nomeados      |  S   |   S   |  S   |  -  |  -  |  -  |  S   |  -  |  -  |
    315. 

  315.   | lista não-numerada  |  S   |   S   |  S   |  S  |  S  |  S  |  S   |  S  |  S  |
    316. 

  316.   | lista numerada      |  S   |   S   |  S   |  S  |  S  |  S  |  S   |  S  |  S  |
    317. 

  317.   | lista de definições |  S   |   S   |  S   |  S  |  S  |  N  |  N   |  N  |  S  |
    318. 

  318.   | linha horizontal    |  S   |   S   |  -   |  S  |  -  |  S  |  S   |  N  |  S  |
    319. 

  319.   | imagem              |  S   |   S   |  S   |  S  |  -  |  S  |  S   |  N  |  -  |
    320. 

  320.   | tabela              |  S   |   S   |  S   |  S  |  S  |  N  |  S   |  N  |  N  |
    321. 

  321.   || Extras             | html | xhtml | sgml | tex | man | mgp | moin | pm6 | txt |
    322. 

  322.   | image align         |  S   |   S   |  N   |  N  |  -  |  S  |  N   |  N  |  -  |
    323. 

  323.   | table cell align    |  S   |   S   |  S   |  S  |  S  |  N  |  S   |  N  |  N  |
    324. 

  324. 

  325.   ||      | Legenda
    326. 

  326.   | **S** | //suportada//
    327. 

  327.   | **N** | //não suportada (talvez em uma versão futura)//
    328. 

  328.   | **-** | //não suportada (não pode ser feita neste formato)//
    329. 

  329. % | **?** | //não suportada (não estou bem certo se pode ou não ser feito)//
    330. 

  330. 

  331. 

  332. ------------------------------------------------------------------------
    333. 

  333. 

  334. 

  335. == As Três Interfaces ao Usuário: GUI, Web e Linha de Comando ==
    336. 

  336. 

  337. Assim como diferentes usuários possuem diferentes necessidades e
    338. 

  338. ambientes, o txt2tags é bastante flexivel na forma de ser usado.
    339. 

  339. 

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

  341. um objetivo definido e com funcionalidades próprias.
    342. 

  342. 

  343. - **GUI**: Escrita em Tk, traz as janelas e os cliques para o txt2tags.
    344. 

  344. - **Web**: Escrita em PHP, permite que o usuário execute o txt2tags no
    345. 

  345.            navegador, não exigindo instalação do lado do cliente.
    346. 

  346. - **Linha de Comando**: Escrita em Python, é o núcleo do programa.
    347. 

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

  348.            linha de comando.
    349. 

  349. 

  350. 

  351. ------------------------------------------------------------------------
    352. 

  352. 

  353. 

  354. === Interface Gráfica Tk ===[gui]
    355. 

  355. 

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

  357. Linux, Windows, Mac e outros.
    358. 

  358. 

  359. O programa automaticamente detecta se seu sistema pode apresentar a
    360. 

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

  361. apresentação da Interfaca Gráfica com a opção ``--gui``. Se estiver
    362. 

  362. faltando algum recurso o programa irá alertar.
    363. 

  363. 

  364. 	**Nota:** O módulo Tkinter é necessário. Como ele vem com a
    365. 

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

  366. 

  367. Ela é bastante simples e fácil de usar:
    368. 

  368. 

  369.           [IMGPATH/gui.png]          
    370. 

  370. 

  371. + Você localiza o arquivo fonte .t2t no disco e suas opções são
    372. 

  372.   carregadas.
    373. 

  373. 

  374. + Se o destino ainda estiver vazio, você deve escolher um.
    375. 

  375. 

  376. + Há algumas opões que podem ser escolhidas, mas nenhuma delas é
    377. 

  377.   essencial.
    378. 

  378. 

  379. + Finalmente, pressione o botão "Converter!".
    380. 

  380. 

  381. 

  382. Uma boa opção a selecionar é "//Dump to screen//", assim se pode
    383. 

  383. verificar o código resultante em uma janela separada, sem que o arquivo
    384. 

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

  385. arquivo será gravado.
    386. 

  386. 

  387. As cores padrão podem ser mudadas no arquivo ``~/.txt2tagsrc``,
    388. 

  388. configurando em ``%!guicolors``. Por exemplo:
    389. 

  389. 

  390. 

  391. ``` 
    392. 

  392.  % minhas cores para a interface (fundo1, texto1, fundo2, texto2)
    393. 

  393.  %!guicolors: blue white brown yellow
    394. 

  394. ```
    395. 

  395. 

  396. ------------------------------------------------------------------------
    397. 

  397. 

  398. === Interface Web ===[web]
    399. 

  399. 

  400. A Interface Web está em funcionamento na Internet no endereço
    401. 

  401. http://txt2tags.org/online.php, permitindo que o programa possa ser
    402. 

  402. usado e testado antes de ser copiado.
    403. 

  403. 

  404.           [IMGPATH/web.png]          
    405. 

  405. 

  406. Esta interface também pode ser colocada na intrant para uso local,
    407. 

  407. evitando a instalação do txt2tags em todas as máquinas.
    408. 

  408. 

  409. ------------------------------------------------------------------------
    410. 

  410. 

  411. === Interface de Linha de Comando ===[linhadecomando]
    412. 

  412. 

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

  414. ser suficiente:
    415. 

  415. 

  416. ```
    417. 

  417. Uso: txt2tags [OPÇÕES] [arquivo.t2t ...]
    418. 

    419. 

  419.   -t, --target        define o formato do destino. tipos suportados:
    420. 

  420.                       html, xhtml, sgml, tex, man, mgp, moin, pm6, txt
    421. 

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

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

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

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

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

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

  427.       --style=ARQ     utiliza ARQ como estilo do documento (CSS no Html)
    428. 

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

  429.       --mask-email    esconde e-mails dos robôs de SPAM. x@y.z vira <x (a) y z>
    430. 

  430.       --toc           inclui o Índice (Table of Contents) no documento destino
    431. 

  431.       --toc-only      exibe o Índice do documento e sai
    432. 

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

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

  434.       --gui           carrega a interface gráfica escrita em TK
    435. 

  435.   -v, --verbose       exibe mensagens informativas durante a conversão
    436. 

  436.   -h, --help          exibe este texto de ajuda e sai
    437. 

  437.   -V, --version       exibe a versão do programa e sai
    438. 

  438.       --dump-config   exibe todas as configurações encontradas e sai
    439. 

    440. 

  440. Opções para DESLIGAR funcionalidades:
    441. 

  441.      --no-outfile, --no-infile, --no-style, --no-encoding, --no-headers
    442. 

  442.      --no-toc, --no-toc-only, --no-mask-email, --no-enum-title, --no-rc
    443. 

  443.      --no-css-sugar
    444. 

    445. 

  445. Exemplo:
    446. 

  446.      txt2tags -t html --toc meuarquivo.t2t
    447. 

    448. 

  448. Normalmente a saída convertida é gravada em 'arquivo.<tipo>'.
    449. 

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

  450. Se o arquivo de entrada é '-', lê de STDIN.
    451. 

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

  452. ```
    453. 

  453. 

  454. ==== Exemplos ====
    455. 

  455. 

  456. Supondo que exista um arquivo de marcação chamado ``file.t2t``, vamos nos
    457. 

  457. divertir um pouco.
    458. 

  458. 

  459. | **Convertendo para HTML**            | ``$ txt2tags -t html file.t2t``
    460. 

  460. | **O mesmo, usando redirecionamento** | ``$ txt2tags -t html -o - file.t2t > file.html``
    461. 

  461. |  | .
    462. 

  462. | **Incluindo uma Tabela de Conteúdo** | ``$ txt2tags -t html --toc file.t2t``
    463. 

  463. | **Idem, numerando os títulos**       | ``$ txt2tags -t html --toc --enum-title file.t2t``
    464. 

  464. |  | .
    465. 

  465. | **Visualização Rápida do Conteúdo**  | ``$ txt2tags --toc-only file.t2t``
    466. 

  466. | **Quem sabe com números?**           | ``$ txt2tags --toc-only --enum-title file.t2t``
    467. 

  467. |  | .
    468. 

  468. | **Linha simples de STDIN**           | ``$ echo -e "\n**bold**" | txt2tags -t html --no-headers -``
    469. 

  469. | **Testando o Mascaramento de Email** | ``$ echo -e "\njohn.wayne@farwest.com" | txt2tags -t txt --mask-email --no-headers -``
    470. 

  470. | **Edição pós-conversão**             | ``$ txt2tags -t html -o- file.t2t | sed "s/<BODY .*/<BODY BGCOLOR=green>/" > file.html``
    471. 

  471. 

  472. : //Nota//
    473. 

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

  474. macros de configuração ``%!preproc`` e ``%!postproc``.
    475. 

  475. 

  476. 

  477. ========================================================================
    478. 

  478. 

  479. 

  480. 

  481. = Parte II - OK, eu quero um. E agora? =[instalacao]
    482. 

  482. 

  483. Basta baixar o programa e executar o mesmo no seu computador.
    484. 

  484. 

  485. == Download e Instalação do Python ==
    486. 

  486. 

  487. Antes de mais nada, deve-se baixar e instalar o interpretador Python
    488. 

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

  489. 

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

  491. pode ser utilizada no Windows, Linux, UNIX, Macintosh, e outras
    492. 

  492. plataformas, e pode ser baixada do
    493. 

  493. [web site do Python http://www.python.org]. As dicas de instalação podem
    494. 

  494. ser encontradas no mesmo site. O txt2tags funciona com o Python 1.5 ou
    495. 

  495. posterior.
    496. 

  496. 

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

  498. xterm, MSDOS) e escreva ``python``. Se ele não estiver instalado, o
    499. 

  499. sistema vai lhe informar.
    500. 

  500. 

  501. == Copiando o txt2tags ==
    502. 

  502. 

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

  504. em http://txt2tags.org/src.
    505. 

  505. 

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

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

  508. o Winzip).
    509. 

  509. 

  510. Simplesmente pegue a **última** versão (data mais recente, número de
    511. 

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

  512. históricas.
    513. 

  513. 

  514. == Instalação do txt2tags ==
    515. 

  515. 

  516. Como é apenas um script Python, o txt2tags não precisa ser instalado.
    517. 

  517. 

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

  519. outros arquivos do tarball compreendem a documentação, ferramentas e
    520. 

  520. arquivos de exemplo.
    521. 

  521. 

  522. O modo mais seguro de usar o txt2tags é chamar o Python com ele:
    523. 

  523. 

  524. ``` prompt$ python txt2tags 
    525. 

    526. 

  526. Se você quiser "instalar" o txt2tags no sistema como um programa
    527. 

  527. independente, basta copiar (ou criar um link) o script txt2tags para um
    528. 

  528. diretório que esteja no PATH do sistema e certificar-se que o sistema
    529. 

  529. saiba como executar o mesmo.
    530. 

    531. 

  531. : **UNIX/Linux**
    532. 

  532.   Torne o script executável (``chmod +x txt2tags``) e copie o mesmo para
    533. 

  533.   um diretório no $PATH (``cp txt2tags /usr/local/bin``)
    534. 

    535. 

  535. : **Windows**
    536. 

  536.   Renomeie o script, acrescentando a extensão .py
    537. 

  537.   (``ren txt2tags txt2tags.py``) e o copie para um diretório que esteja
    538. 

  538.   no PATH do sistema (``copy txt2tags.py C:\WINNT``)
    539. 

    540. 

    541. 

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

  542. quiser usar a Interface Gráfica do programa.
    543. 

    544. 

  544. === Pacotes Especiais para Usuários Windows ===
    545. 

    546. 

  546. Existem dois arquivos de distribuição .EXE para o txt2tags, que instalam
    547. 

  547. o programa em máquinas Windows com apenas alguns cliques:
    548. 

    549. 

  549. - O script txt2tags para aqueles que tem o interpretador Python
    550. 

  550.   instalado
    551. 

  551. - A versão stand-alone, que não requer a instalação do interpretador
    552. 

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

    554. 

    555. 

  555. Visite o site //Txt2tags-Win// para baixar estes pacotes:
    556. 

  556. http://txt2tags-win.sf.net/
    557. 

    558. 

  558. == Instalar os Arquivos de Sintaxe dos Editores de Texto ==[sintaxe]
    559. 

    560. 

  560. O txt2tags possui arquivos de sintaxe práticos que podem ser usados com
    561. 

  561. os seguintes editores de texto:
    562. 

    563. 

  563. - Vim (www.vim.org)
    564. 

  564. - Emacs (www.emacs.org)
    565. 

  565. - Nano (www.nano-editor.org)
    566. 

  566. - Kate (http://kate.kde.org)
    567. 

    568. 

    569. 

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

  570. txt2tags, ajudando ao usuário a escrever documentos sem erros. As marcas
    571. 

  571. são mostradas coloridas, assim se pode ver se tudo foi escrito
    572. 

  572. corretamente.
    573. 

    574. 

  574.            |  [IMGPATH/vim.png]  |
    575. 

  575.            |  O arquivo de exemplo aberto no Editor Vim 
    576. 

    577. 

  577. Cada editor tem um procedimento diferente para usar seu arquivo de
    578. 

  578. sintaxe. Por favor verifique no cabeçalho de cada arquivo e na
    579. 

  579. documentação do editor.
    580. 

    581. 

  581. ========================================================================
    582. 

    583. 

    584. 

    585. 

  585. = Parte III - Escrevendo e Convertendo Seu Primeiro Documento =
    586. 

    587. 

  587. Desculpe, este capítulo ainda está em desenvolvimento.
    588. 

    589. 

  589. == As Áreas do documento .t2t ==
    590. 

    591. 

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

  592. suas próprias regras e finalidade. São elas:
    593. 

    594. 

  594. : //Área de Cabeçalho//
    595. 

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

  596. Data. (opcional)
    597. 

    598. 

  598. : //Área de Configuração//
    599. 

  599. É o local para colocar as configurações Gerais do documento e
    600. 

  600. modificadores do funcionamento do analisador. (opcional)
    601. 

    602. 

  602. : //Corpo do Texto//
    603. 

  603. É o local para o Conteúdo do Documento (requerida)
    604. 

    605. 

    606. 

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

  607. //Corpo do Texto// é a única área indispensável.
    608. 

  608. (//Nota: A **Área de Configuração** foi introduzida no txt2tags na versão 1.3//)
    609. 

    610. 

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

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

  612. gráfica das áreas de um documento:
    613. 

    614. 

  614. ```
    615. 

  615.              ____________
    616. 

  616.             |            |
    617. 

  617.             |  CABEÇALHO |       1. Primeiro, o cabeçalho
    618. 

  618.             |            |
    619. 

  619.             |   CONFIG   |       2. Então a configuração
    620. 

  620.             |            |
    621. 

  621.             |   CORPO    |       3. E, finalmente, o corpo do documento
    622. 

  622.             |            |
    623. 

  623.             |    ...     |          que segue até o final do arquivo.
    624. 

  624.             |    ...     |
    625. 

  625.             |____________|
    626. 

  626. 

  627. ```
    628. 

    629. 

  629. Em resumo, é assim que as áreas são definidas:
    630. 

    631. 

  631.   | **Cabeçalhos**   | As primeiras 3 linhas do arquivo, ou a primeira linha é deixada em branco se não são usados cabeçalhos
    632. 

  632.   | **Configuração** | Começam logo depois do cabeçalho (4a. ou 2a. linha)  e termina quando a //Área de Conteúdo// começa.
    633. 

  633.   | **Corpo**        | A primeira linha de texto válida (que não é comentário ou configuração) após a //Área de Cabeçalho//.
    634. 

    635. 

  635. === Exemplo Completo ===
    636. 

    637. 

  637. ```
    638. 

  638. Título do meu belo documento
    639. 

  639. Sr. Fulano da Silva
    640. 

  640. Última atualização: %%date(%c)
    641. 

  641. 

  642. %! Target  : html
    643. 

  643. %! Style   : fancy.css
    644. 

  644. %! Encoding: UTF-8
    645. 

  645. %! Options : --toc --enum--title
    646. 

  646. 

  647. Oi! Este é o meu documento de teste.
    648. 

  648. E o seu conteúdo termina aqui.
    649. 

  649. ```
    650. 

    651. 

  651. =======================================================================
    652. 

    653. 

    654. 

    655. 

  655. = Parte IV - Dominando o Txt2tags =
    656. 

    657. 

    658. 

  658. == A Área de Cabeçalho ==
    659. 

    660. 

  660. Localização:
    661. 

  661. - Posição fixa: **Primeiras 3 linhas** do arquivo. Ponto.
    662. 

  662. - Posição fixa: **A Primeira Linha** do arquivo está em branco. Isto
    663. 

  663.   significa que o cabeçalho está vazio.
    664. 

    665. 

    666. 

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

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

    669. 

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

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

  671. documentos:
    672. 

    673. 

  673.    - //linha 1//: título do documento
    674. 

  674.    - //linha 2//: nome e/ou email do autor
    675. 

  675.    - //linha 3//: data e/ou versão do documento
    676. 

  676.                  (um bom lugar para colocar ``%%date``)
    677. 

    678. 

    679. 

  679. Tenha em mente que as 3 primeiras linhas do arquivo fonte serão as 3
    680. 

  680. primeiras linhas no documento gerado, separadas e com um grande
    681. 

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

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

  683. e centralizados na primeira página.
    684. 

    685. 

  685. ==== Menos (ou Nenhuma) Linhas de Cabeçalho ====
    686. 

    687. 

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

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

    690. 

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

  691. incluídas no documento gerado. Mas tenha em mente que, mesmo em branco,
    692. 

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

  693. começar **após** a 3a. linha.
    694. 

    695. 

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

  696. deixar ela em branco, está dizendo que seu documento
    697. 

  697. **não tem cabeçalho**. Desta forma, a //Área de Texto// irá começar em
    698. 

  698. seguida, na 2a. linha.
    699. 

    700. 

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

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

  702. comando ``--no-headers`` é geralmente necessária para este tipo de coisa.
    703. 

    704. 

  704. ==== Direto ao ponto ====
    705. 

    706. 

  706.  || Em resumo: "Cabeçalhos são apenas __posições__, não conteúdo " |
    707. 

    708. 

  708. Coloque um texto na primeira linha, ele irá aparecer na primeira linha
    709. 

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

    711. 

  711. ------------------------------------------------------------------------
    712. 

    713. 

  713. == A Área de Configuração ==
    714. 

    715. 

  715. Localização:
    716. 

  716. - Começa logo após a Área de Cabeçalhos
    717. 

  717.   - Começa na **4a. linha** do arquivo se forem especificados **Cabeçalhos**
    718. 

  718.   - Começa na **2a. linha** se **não** forem especificados **Cabeçalhos**
    719. 

  719. - Termina quando a Área de Conteúdo começa
    720. 

  720.   - Termina com uma linha que não seja de Configuração, ou de
    721. 

  721.     Comentário, ou que seja uma linha em Branco.
    722. 

    723. 

    724. 

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

  725. carradas de arquivos txt2tags mesmo sem saber que ela existe, mas os
    726. 

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

    728. 

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

  729. comportamento do programa.
    730. 

    731. 

  731. ==== Então, como configurar algo? Qual a sintaxe? ====
    732. 

    733. 

  733. As linhas de configuração são //linhas de comentário especiais//,
    734. 

  734. marcadas com um identificador no início ("``!``") que torna estes
    735. 

  735. comentários diferentes dos comentários normais. A sintaxe é tão simples
    736. 

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

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

  738. dois-pontos ("``:``").
    739. 

    740. 

  740.  || %! palavra-chave : valor |
    741. 

    742. 

  742. **``Detalhes da Sintaxe:``** O ponto de exclamação deve ser colocado
    743. 

  743. junto com o caractere de comentário, sem espaço entre eles ("``%!``").
    744. 

  744. Os espaços em torno da //palavra-chave// e o separador são opcionais, e
    745. 

  745. tanto a //palavra-chave// quanto o //valor// podem estar
    746. 

  746. indiferentemente em maiúsculas ou minúsculas.
    747. 

    748. 

  748. ==== O que eu posso configurar? Quais são as palavra-chave válidas? ====
    749. 

    750. 

  750. As configurações que podem ser feitas são //Target//, //Options//, //Style//,
    751. 

  751. //Encoding//, //PreProc// e //PostProc//.
    752. 

    753. 

  753. A configuração **//Target//** define o destino padrão na qual o
    754. 

  754. documento deve ser convertido.
    755. 

    756. 

  756. A configuração **//Options//** é útil para especificar as opções de
    757. 

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

  758. sobrescritas pela linha de comando real. Usar esta opção juntamente com
    759. 

  759. ``%!target`` permite converter o documento simplesmente comandando:
    760. 

  760. ``txt2tags file.t2t``
    761. 

    762. 

  762. A configuração **//Style//** só é suportada pelo tipo de documento
    763. 

  763. destino HTML, para definir uma folha de estilo
    764. 

  764. (//Cascading Style Sheets - CSS//).
    765. 

    766. 

  766. A configuração **//Encoding//** é necessária para escritores não
    767. 

  767. ingleses, que usem letras acentuadas e outros detalhes específicos de
    768. 

  768. localização, de forma que o //Conjunto de Caracteres// do documento seja
    769. 

  769. personalizado (se permitido).
    770. 

    771. 

  771. A configuração **//PreProc//** é um filtro. Ela define regras do tipo
    772. 

  772. "busca e troca" que serão aplicadas ao arquivo original __antes__ que
    773. 

  773. qualquer análise por parte do txt2tags ocorra.
    774. 

    775. 

  775. A configuração **//PostProc//** é um filtro. Ela define regras do tipo
    776. 

  776. "busca e troca" que serão aplicadas ao arquivo destino __depois__ de
    777. 

  777. todo o processamento por parte do txt2tags.
    778. 

    779. 

  779. Exemplo:
    780. 

    781. 

  781. ```
    782. 

  782. %! Target  : html
    783. 

  783. %! Options : --toc --toc-level 3
    784. 

  784. %! Style   : fancy.css
    785. 

  785. %! Encoding: UTF-8
    786. 

  786. %! PreProc : "amj"       "Aurelio Marinho Jargas"
    787. 

  787. %! PostProc: '<BODY.*?>' '<BODY bgcolor="yellow">'
    788. 

  788. ```
    789. 

    790. 

    791. 

  791. ==== Algumas regras sobre as Configurações ====
    792. 

    793. 

  793.  - As configurações são válidas somente dentro da Área de Configuração,
    794. 

  794.    e serão consideradas comentários simples se forem encontradas no
    795. 

  795.    Corpo do documento.
    796. 

    797. 

  797.  - Se a mesma palavra-chave aparece mais de uma vez na Área de
    798. 

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

  799.    postproc, que são acumulativas.
    800. 

    801. 

  801.  - Uma linha de configuração com uma palavra-chave inválida será
    802. 

  802.    considerada um comentário.
    803. 

    804. 

  804.  - Estas configurações têm precedência sobre o arquivo ``txt2tagsrc``,
    805. 

  805.    as não sobre as opções de linha de comando.
    806. 

    807. 

    808. 

  808. ----------------------------------------------------------------
    809. 

    810. 

  810. == O Corpo do Texto == 
    811. 

    812. 

  812. Localização:
    813. 

  813. - Começa na primeira linha válida de texto do arquivo
    814. 

  814.   - Cabeçalhos, Configurações e Comentários **não** são linhas de texto
    815. 

  815.     válidas
    816. 

  816. - Termina no fim do arquivo (EOF)
    817. 

    818. 

    819. 

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

  820. de Configuração.
    821. 

    822. 

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

  823. estruturas e formatações que o txt2tags reconhece. Dentro do corpo podem
    824. 

  824. ser também colocados comentários para //A FAZER// e anotações
    825. 

  825. particulares.
    826. 

    827. 

  827. Pode-se utilizar a opção de linha de comando ``--no-headers`` para
    828. 

  828. converter somente o corpo do documento, suprimindo os cabeçalhos. Esta
    829. 

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

  830. unido ao corpo depois da conversão.
    831. 

    832. 

  832. -----------------------------------------------------------------------
    833. 

    834. 

  834. == Marcações (REGRAS) ==[regras]
    835. 

    836. 

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

  837. um [arquivo REGRAS a parte REGRAS].
    838. 

    839. 

  839. -----------------------------------------------------------------------
    840. 

    841. 

  841. == A macro %%date ==[data]
    842. 

    843. 

  843. A macro ``%%date`` chamada sem nenhum parâmetro adicional retorna a data
    844. 

  844. atual no formato ISO //yyyymmdd//. Uma formatação opcional pode ser
    845. 

  845. especificada usando a sintaxe ``%%date(formato)``.
    846. 

    847. 

  847. O //formato// contém texto de diretivas de formatação, que são compostas
    848. 

  848. por um sinal de porcentagem (``%``) seguido por um caractere de
    849. 

  849. identificação.
    850. 

    851. 

  851. Segue uma lista de algumas diretivas comuns. A lista completa pode ser
    852. 

  852. encontrada em http://www.python.org/doc/current/lib/module-time.html.
    853. 

    854. 

  854.  || Diretiva | Descrição |
    855. 

  855.   |  %a  | Dia da semana local abreviado.
    856. 

  856.   |  %A  | Dia da semana completo.
    857. 

  857.   |  %b  | Nome do mês abreviado.
    858. 

  858.   |  %B  | Nome do mês.
    859. 

  859.   |  %c  | Dia e hora formatados apropriadamente.
    860. 

  860.   |  %d  | Dia do mês como um número decimal [01,31].
    861. 

  861.   |  %H  | Hora (24 horas) como um número decimal [00,23].
    862. 

  862.   |  %I  | Hora (12 horas) como um número decimal [01,12].
    863. 

  863.   |  %m  | O mês como um número decimal [01,12].
    864. 

  864.   |  %M  | O minuto como um número decimal [00,59].
    865. 

  865.   |  %p  | O equivalente local a AM e PM.
    866. 

  866.   |  %S  | Os segundos como um número decimal [00,61].  (1)
    867. 

  867.   |  %x  | Representação local da data.
    868. 

  868.   |  %X  | Representação local da hora.
    869. 

  869.   |  %y  | O ano sem o século como um número decimal [00,99].
    870. 

  870.   |  %Y  | O ano com o século como um número decimal.
    871. 

  871.   |  %%  | Um caractere "%".
    872. 

    873. 

    874. 

  874. ==== Exemplos ====
    875. 

    876. 

  876.  || ``%%date(format)``  | Resultado para: 2004, Jul13, 18:49 |
    877. 

  877.   | Last Update: %c     | Last Update: Tue Jan 13 18:49:32 2004
    878. 

  878.   | %Y-%m-%d            | 2004-07-13
    879. 

  879.   | %I:%M %p            | 18:49 PM
    880. 

  880.   | Hoje e %A, em %B.   | Hoje e Tuesday, em July.
    881. 

    882. 

  882. -----------------------------------------------------------------------
    883. 

    884. 

  884. == O comando %!include ==[include]
    885. 

    886. 

  886. A partir da versão 1.7, é possível usar o comando ``include`` para
    887. 

  887. inserir o conteúdo de um arquivo externo dentro do corpo do documento
    888. 

  888. original.
    889. 

    890. 

  890. O ``%!include`` não é uma configuração, mas um comando, sendo somente
    891. 

  891. válido na área de CORPO do texto.
    892. 

    893. 

  893. O comando ``include`` é útil para dividir um documento grande em vários
    894. 

  894. arquivos menores (como capítulos de um livro) ou para incluir todo o
    895. 

  895. conteúdo de um arquivo qualquer no documento. Por exemplo:
    896. 

    897. 

  897. ```
    898. 

  898. Meu Primeiro Livro
    899. 

  899. Dr. Fulano da Silva
    900. 

  900. 1ª Edição
    901. 

  901. 

  902. %!include: introducao.t2t
    903. 

  903. %!include: capitulo1.t2t
    904. 

  904. %!include: capitulo2.t2t
    905. 

  905. ...
    906. 

  906. %!include: capitulo9.t2t
    907. 

  907. %!include: conclusao.t2t
    908. 

  908. ```
    909. 

    910. 

  910. Como se pode ver, basta informar o nome do arquivo logo após o comando
    911. 

  911. ``%!include``. Também é possível atrelar o comando a um destino
    912. 

  912. específico, como em:
    913. 

    914. 

  914. ``` %!include(html): arquivo.t2t
    915. 

  915. 

  916. Note que o ``include`` vai inserir o CORPO do documento .t2t, ignorando
    917. 

  917. seu CABEÇALHO e suas CONFIGURAÇÕES. Assim é possível converter o arquivo
    918. 

  918. incluído de maneira isolada ou como parte do documento mãe.
    919. 

  919. 

  920. Além de incluir arquivos .t2t, há mais três tipos de inclusão:
    921. 

  921. 

  922. - Inclusão de texto pré-formatado (Verbatim)
    923. 

  923. - Inclusão de texto protegido (Raw)
    924. 

  924. - Inclusão de texto já convertido (Tagged)
    925. 

  925. 

  926. 

  927. No tipo **Verbatim** o texto é incluído preservado seus espaços e
    928. 

  928. formatação originais. É como se esse texto estivesse entre as marcações
    929. 

  929. (```) da área VERB do txt2tags. Para incluir um arquivo dessa maneira,
    930. 

  930. basta colocar seu nome entre crases:
    931. 

    932. 

  932. ``` %!include: ``/etc/fstab``
    933. 

  933. 

  934. No tipo **Raw** o texto é incluído "como está", sem tentar encontrar e
    935. 

  935. avaliar as marcas do txt2tags dele. É como se esse texto estivesse entre
    936. 

  936. as marcações (""") da área protegida. Para incluir um arquivo dessa
    937. 

  937. maneira, basta colocar seu nome entre aspas
    938. 

  938. 

  939. ``` %!include: ""bom_texto.txt""
    940. 

    941. 

  941. Já no tipo **Tagged**, o texto é passado diretamente para o documento
    942. 

  942. resultante, sem NENHUM tratamento pelo txt2tags. Assim é possível
    943. 

  943. incluir tags adicionais, trechos já prontos ou estruturas mais
    944. 

  944. complicadas que não são suportadas pelo programa. Outra aplicação é
    945. 

  945. incluir um cabeçalho ou rodapé padrão em todos os documentos:
    946. 

    947. 

  947. ``` %!include(html): ''rodape.html''
    948. 

  948. 

  949. Note que o nome do arquivo está entre aspas simples (e não crases como o
    950. 

  950. anterior). São estas aspas que indicam que o conteúdo deve ser passado
    951. 

  951. diretamente. Como este conteúdo já contém tags, é primordial especificar
    952. 

  952. o destino também, para evitar problemas.
    953. 

  953. 

  954. =======================================================================
    955. 

  955. 

  956. 

  957. 

  958. = Parte V - Dominando as Diretivas de Configuração =[settings]
    959. 

  959. 

  960. As Diretivas de Configuração são todas opcionais. A maioria dos usuários
    961. 

  961. pode muito bem passar sem elas. Mas elas são viciantes, se você começa a
    962. 

  962. usá-las, não consegue parar :)
    963. 

  963. 

  964. -----------------------------------------------------------------------
    965. 

  965. 

  966. == %!Target ==
    967. 

  967. 

  968. Usando a configuração Target define o destino padrão definido no
    969. 

  969. documento:
    970. 

  970. 

  971. ``` %!target: html
    972. 

    973. 

  973. Assim o usuário pode simplesmente comandar
    974. 

    975. 

  975. ``` $ txt2tags file.t2t
    976. 

  976. 

  977. E a conversão será efetuada para o destino especificado.
    978. 

  978. 

  979. A configuração Target não permite a especificação opcional de destino.
    980. 

  980. Afinal, não faz sentido algo como ``%!target(tex): html``.
    981. 

  981. 

  982. 

  983. -----------------------------------------------------------------------
    984. 

  984. 

  985. == %!Options ==
    986. 

  986. 

  987. Escrever longas linhas de comando toda vez que for necessário converter
    988. 

  988. um documento é maçante e sujeito a erros. A configuração Options permite
    989. 

  989. que o usuário salve todas as opções de conversão juntas, no próprio
    990. 

  990. documento. Desta forma também se garante que o documento sempre será
    991. 

  991. convertido da mesma forma, com as mesmas opções.
    992. 

  992. 

  993. Só é necessário escrevê-la sem erros de sintaxe, como se estivesse na
    994. 

  994. linha de comando. Mas omita a chamada ao programa "txt2tags" no início e
    995. 

  995. o nome do arquivo origem no fim da linha.
    996. 

  996. 

  997. Por exemplo, se você usa esta linha de comando para converter seu
    998. 

  998. documento:
    999. 

  999. 

  1000. ``` $ txt2tags -t html --toc --toc-level 2 --enum-title file.t2t
    1001. 

    1002. 

  1002. Pode-se economizar um bocado de digitação usando esta configuração de
    1003. 

  1003. Options dentro do documento origem:
    1004. 

    1005. 

  1005. ```
    1006. 

  1006. %!target: html
    1007. 

  1007. %!options(html): --toc --toc-level 2 --enum-title
    1008. 

  1008. ```
    1009. 

    1010. 

  1010. A linha de comando real passa agora a ser apenas "``txt2tags file.t2t``",
    1011. 

  1011. e a conversão pode ser executada dentro do seu editor de textos
    1012. 

  1012. favorito, enquanto o conteúdo está sendo editado. No Vi, o comando é:
    1013. 

    1014. 

  1014. ``` :!txt2tags %
    1015. 

  1015. 

  1016. -----------------------------------------------------------------------
    1017. 

  1017. 

  1018. == %!Encoding ==
    1019. 

  1019. 

  1020. A configuração de Encoding é necessária para autores não ingleses, que
    1021. 

  1021. usam letras acentuadas e outros detalhes específicos, de forma que o
    1022. 

  1022. //Conjunto de Caracteres// do documento gerado possa ser personalizado
    1023. 

  1023. (se possível).
    1024. 

  1024. 

  1025. Os valores válidos para a configuração de Encoding são os mesmos que são
    1026. 

  1026. válidos para documentos, HTML, como //UTF-8// e //koi8-r//. Se você
    1027. 

  1027. não está certo de qual codificação quer usar,
    1028. 

  1028. [esta lista completa (e longa!) http://www.iana.org/assignments/character-sets]
    1029. 

  1029. poderá ser de ajuda.
    1030. 

  1030. 

  1031. Quando for gerado documentos LaTeX, utiliza aliases para a codificação.
    1032. 

  1032. Isto não deve ser problema para o usuário, já que o txt2tags faz a
    1033. 

  1033. tradução internamente. Alguns exemplos:
    1034. 

  1034. 

  1035.       || txt2tags/HTML   |  >  | LaTeX  |
    1036. 

  1036.        | windows-1250    | >>> | cp1250 |
    1037. 

  1037.        | windows-1252    | >>> | cp1252 |
    1038. 

  1038.        | ibm850          | >>> | cp850  |
    1039. 

  1039.        | ibm852          | >>> | cp852  |
    1040. 

  1040.        | iso-8859-1      | >>> | latin1 |
    1041. 

  1041.        | iso-8859-2      | >>> | latin2 |
    1042. 

  1042.        | koi8-r          | >>> | koi8-r |
    1043. 

  1043. 

  1044. Se o valor é desconhecido do txt2tags, ele será passado sem tradução,
    1045. 

  1045. permitindo que o usuário especifique codificações personalizadas.
    1046. 

  1046. 

  1047. -----------------------------------------------------------------------
    1048. 

  1048. 

  1049. == %!PreProc ==
    1050. 

  1050. 

  1051. O filtro de usuário PreProc é uma função "busca e troca" que é aplicada
    1052. 

  1052. logo após a linha ter sido lida do arquivo original, antes de qualquer
    1053. 

  1053. tratamento pelo txt2tags.
    1054. 

  1054. 

  1055. Ela é útil para definir algumas abreviações para texto que seja usado
    1056. 

  1056. comumente, como:
    1057. 

  1057. 

  1058. ```
    1059. 

  1059. %!preproc amj          "Aurelio Marinho Jargas"
    1060. 

  1060. %!preproc RELEASE_DATE "2004-07-13"
    1061. 

  1061. %!preproc BOLOTA       "[images/tiny/bullet_blue.png]"
    1062. 

  1062. ```
    1063. 

  1063. 

  1064. Desta forma, o usuário pode escrever uma linha como:
    1065. 

  1065. 

  1066. ``` Oi, eu sou amj. Hoje é RELEASE_DATE.
    1067. 

    1068. 

  1068. E o txt2tags irá ver esta linha como:
    1069. 

    1070. 

  1070. ``` Oi, eu sou Aurelio Marinho Jargas. Hoje é 2004-07-13.
    1071. 

  1071. 

  1072. Este filtro é um componente que trabalha entre o autor do documento e a
    1073. 

  1073. conversão do txt2tags. É como uma primeira conversão antes da conversão
    1074. 

  1074. "real". Este comportamento funciona exatamente como um filtro Sed/Perl
    1075. 

  1075. externo, chamado assim:
    1076. 

  1076. 

  1077. ``` $ cat arquivo.t2t | preproc-script.sh | txt2tags -
    1078. 

    1079. 

  1079. Assim, o tratamento executado pelo txt2tags irá começar após todas as
    1080. 

  1080. substituições PreProc terem sido feitas.
    1081. 

    1082. 

  1082. -----------------------------------------------------------------------
    1083. 

    1084. 

  1084. == %!PostProc ==
    1085. 

    1086. 

  1086. O filtro de usuário PostProc é uma função do tipo "busca e troca" que é
    1087. 

  1087. aplicada no arquivo resultante, após todos as conversões do txt2tags
    1088. 

  1088. terem sido feitas.
    1089. 

    1090. 

  1090. É útil para defintir alguns refinamentos no documento gerado, mudar
    1091. 

  1091. algumas marcações e acrescentar algumas marcações ou texto extra.
    1092. 

  1092. Alguns exemplos breves:
    1093. 

    1094. 

  1094. ```
    1095. 

  1095. %!postproc(html): '<BODY.*?>' '<BODY BGCOLOR="green">'
    1096. 

  1096. %!postproc(tex) : "\\clearpage" ""
    1097. 

  1097. ```
    1098. 

    1099. 

  1099. Estes filtros mudam a cor de fundo da página HTML e removem as quebras
    1100. 

  1100. de página em arquivos LaTeX gerados.
    1101. 

    1102. 

  1102. As regras do PostProc são iguais a filtros externos Sed/Perl, chamados
    1103. 

  1103. desta forma:
    1104. 

    1105. 

  1105. ``` $ txt2tags -t html -o- arquivo.t2t | postproc-script.sh > arquivo.html
    1106. 

  1106. 

  1107. Antes desta funcionalidade ter sido introduzida, era bastante comum ter
    1108. 

  1108. pequenos scripts para "ajustar" os resultados gerados pelo txt2tags.
    1109. 

  1109. Estes scripts eram, de fato, vários comandos sed (ou assemelhados), para
    1110. 

  1110. fazer algo do tipo "substitua isto por aquilo". Agora estas trocas podem
    1111. 

  1111. ser salvas junto com o texto do documento, e também aproveitar-se da
    1112. 

  1112. poderosa máquina de Expressões Regulares do Python para encontrar os
    1113. 

  1113. padrões.
    1114. 

  1114. 

  1115. -----------------------------------------------------------------------
    1116. 

  1116. 

  1117. == %!Style ==
    1118. 

  1118. 

  1119. - Esta opção é útil na geração de arquivos HTML e XHTML, definindo o
    1120. 

  1120.   nome do arquivo CSS que será usado no documento gerado.
    1121. 

  1121. 

  1122. - No formato LaTeX, essa opção é usada para carregar módulos com o
    1123. 

  1123.   ``\usepackage``.
    1124. 

  1124. 

  1125. - O mesmo efeito pode ser obtido com a opção de linha de comando
    1126. 

  1126.   ``--style``.
    1127. 

  1127. 

  1128. - A opção de linha de comando --style tem precedência sobre a
    1129. 

  1129.   configuração de %!style
    1130. 

  1130. 

  1131. 

  1132. -----------------------------------------------------------------------
    1133. 

  1133. 

  1134. == Detalhes dos Filtros PreProc e PostProc ==
    1135. 

  1135. 

  1136. - Estes filtros foram acrescentados ao txt2tags na versão 1.6.
    1137. 

  1137. 

  1138. - Filtros são uma função do tipo "buscar e trocar" (pense no sed)
    1139. 

  1139. 

  1140. - O PREproc é aplicado logo após a linha ser lida, e o POSTproc é
    1141. 

  1141.   aplicado após todo o tratamento ter sido feito. Funcionam exatamente
    1142. 

  1142.   como em (UUOC à frente):
    1143. 

  1143. 

  1144. ``` $ cat file.t2t | preproc.sh | txt2tags | postproc.sh
    1145. 

    1146. 

  1146. - Escapes especiais como ``\n`` e ``\t`` são interpretados
    1147. 

    1148. 

  1148. - Os filtros são cumulativos e são aplicados na mesma ordem em que são
    1149. 

  1149.   definidos
    1150. 

    1151. 

  1151. - Os filtros devem receber exatamente DOIS argumentos
    1152. 

    1153. 

  1153. - Para apagar uma string, troque ela por uma string vazia
    1154. 

  1154. ``` %!postproc: "undesired string" ""
    1155. 

  1155. 

  1156. - Para evitar problemas, sempre use informar explicitamente para que
    1157. 

  1157.   destino se aplica o filtro quando estiver usando o PostProc para mudar
    1158. 

  1158.   marcações: ``%!PostProc(destino): <isto> <aquilo>``
    1159. 

  1159. 

  1160. - As Expressões Regulares do Python podem ser utilizadas! Elas são
    1161. 

  1161.   similares às Regex do Perl. Por exemplo: troque todas as marcações "B"
    1162. 

  1162.   para "STRONG" no HTML:
    1163. 

  1163. 

  1164. ``` %!postproc(html):   '(</?)B>'   '\1STRONG>'
    1165. 

    1166. 

  1166. - Os argumentos dos filtros podem ser passados de 3 formas:
    1167. 

  1167.    + Uma palavra simples, sem aspas ou plicas, como FOO (sem espaços)
    1168. 

  1168.    + Uma string com aspas duplas, como em "FOO"
    1169. 

  1169.    + Uma string com plicas ou apóstrofos, como em 'FOO'
    1170. 

    1171. 

  1171. - Se seu padrão tem aspas, proteja as mesmas com plicas, e vice-versa.
    1172. 

  1172.   Alguns exemplos válidos:
    1173. 

  1173. ```
    1174. 

  1174. %!postproc:   PADRÃO    TROCA
    1175. 

  1175. %!postproc:  "PADRÃO"  "TROCA"
    1176. 

  1176. %!postproc:  'PADRÃO'  'TROCA'
    1177. 

  1177. %!postproc:   PADRÃO   "TROCA"
    1178. 

  1178. %!postproc:  "PADRÃO"  'TROCA'
    1179. 

  1179. ```
    1180. 

    1181. 

    1182. 

  1182. -----------------------------------------------------------------------
    1183. 

    1184. 

  1184. == Definindo uma Configuração para um Tipo-Destino Específico ==
    1185. 

    1186. 

  1186. Desde a versão 1.6 do txt2tags, todas as Diretivas de Configuração podem
    1187. 

  1187. ser especificadas para um destino específico, usando a sintaxe
    1188. 

  1188. ``%!key(target): value``. Desta forma, o usuário pode definir diferentes
    1189. 

  1189. configurações para diverentes tipos de arquivos gerados.
    1190. 

    1191. 

  1191. Este aspecto é especialmente útil nos filtros pre/postproc, mas pode ser
    1192. 

  1192. utilizado em todas as diretrizes. Por exemplo, configurar diferentes
    1193. 

  1193. valores de Encoding para HTML e LaTeX:
    1194. 

    1195. 

  1195. ```
    1196. 

  1196. %!encoding(html): UTF-8
    1197. 

  1197. %!encoding(tex): latin1
    1198. 

  1198. ```
    1199. 

    1200. 

  1200. 	**Nota:** O mapeamento de codificações para os nomes especiais
    1201. 

  1201. 	LaTeX já é parte do txt2tags, o trecho acima é apenas um
    1202. 

  1202. 	exemplo.
    1203. 

    1204. 

  1204. Para o ``%!options``, pode ser interessante:
    1205. 

    1206. 

  1206. ```
    1207. 

  1207. %!target: sgml
    1208. 

  1208. %!options(sgml): --toc
    1209. 

  1209. %!options(html): --style foo.css
    1210. 

  1210. %!options(txt ): --toc-only --toc-level 2
    1211. 

  1211. ```
    1212. 

    1213. 

  1213. Desta forma, o tipo de destino padrão é o SGML, com TOC. Se o usuário
    1214. 

  1214. executar:
    1215. 

    1216. 

  1216. ``` $ txt2tags -t html file.t2t
    1217. 

  1217. 

  1218. O tipo de destino HTML será feito, e **somente** as opções de
    1219. 

  1219. ``%!options(html)`` serão usadas. Desta forma, a opçõa --style será
    1220. 

  1220. usada e o arquivo HTML não terá TOC.
    1221. 

  1221. 

  1222. === A Precedência é Diferente ===
    1223. 

  1223. 

  1224. Em geral, para as diretivas de configuração, a última encontrada é a
    1225. 

  1225. usada, mas quando usar diretivas explícitas de tipo-destino, elas tem
    1226. 

  1226. precedência sobre as genéricas, não importando qual vem antes. Assim:
    1227. 

  1227. 

  1228. ```
    1229. 

  1229. %!encoding(html): UTF-8
    1230. 

  1230. %!encoding: latin1
    1231. 

  1231. ```
    1232. 

  1232. 

  1233. Irá expandir para 'UTF-8' quando chamado com ``-t html`` mesmo que
    1234. 

  1234. 'latin1' seja definido logo após.
    1235. 

  1235. 

  1236. === Filtros são Cumulativos ===
    1237. 

  1237. 

  1238. Os filtros pre/postproc não tem precedência e não se encaixam no esquema
    1239. 

  1239. "último encontrado", eles são cumulativos. O usuário pode configurar
    1240. 

  1240. múltiplos filtros, e eles serão aplicados na ordem em que são definidos.
    1241. 

  1241. 

  1242. Por exemplo:
    1243. 

  1243. 

  1244. ```
    1245. 

  1245. %!postproc     : ^ \t
    1246. 

  1246. %!postproc(txt): ^ '> '
    1247. 

  1247. ```
    1248. 

  1248. 

  1249. Com estes filtros, todos os tipos-destino serão indentados por uma TAB.
    1250. 

  1250. Se o tipo-destino é TXT, ele também receberá citações, como mensagens
    1251. 

  1251. de email.
    1252. 

  1252. 

  1253. ```
    1254. 

  1254. Desta forma        Minha bela linha.
    1255. 

  1255. se tornará         \t> Minha bela linha.
    1256. 

  1256. ```
    1257. 

  1257. 

  1258. === Em Resumo ===
    1259. 

  1259. 

  1260. - Para filtros, a ordem faz diferença e as regras genéricas __e__
    1261. 

  1261.   específicas ao tipo-destino serão usadas
    1262. 

  1262. 

  1263. - Para outras configurações, __somente__ o tipo-destino especificado é
    1264. 

  1264.   usado (se definido, é claro), não importando a ordem
    1265. 

  1265. 

  1266. 

  1267. == RC, CONF e a precedência de linha de comando ==
    1268. 

  1268. 

  1269. Há três maneiras de dizer ao txt2tags quais opções e configurações usar:
    1270. 

  1270. 

  1271. + O arquivo de usuário RC  (``.txt2tagsrc``)
    1272. 

  1272. + A Área de Configurações CONF do documento
    1273. 

  1273. + As opções de linha de comando
    1274. 

  1274. 

  1275. 

  1276. E esta é a ordem exata de como as configurações são lidas e aplicadas.
    1277. 

  1277. Logo, as configuraçõe dp arquivo RC são lidas primeiro, daí as
    1278. 

  1278. configurações do fonte do documento vêm a seguir, sobreescrevendo as do
    1279. 

  1279. RC e finalmente as opções da linha de comando, mais fortes do que as
    1280. 

  1280. outras duas.
    1281. 

  1281. 

  1282. Então se o "encoding" do documento foi definido nas três opções, a da
    1283. 

  1283. linha de comando será a utilizada.
    1284. 

  1284. 

  1285. 

  1286. =======================================================================
    1287. 

  1287. 

  1288. 

  1289. 

  1290. = Parte VI - Magia Negra =
    1291. 

  1291. 

  1292. Este capítulo não é recomendado para novatos. Ele demonstra como fazer
    1293. 

  1293. coisas estranhas com os filtros txt2tags, abusando de padrões complexos
    1294. 

  1294. e Expressões Regulares.
    1295. 

  1295. 

  1296. 	**CUIDADO!** Os procedimentos detalhados a seguir NÃO são
    1297. 

  1297. 	encorajados e podem acarretar danos. Até mesmo algum texto do
    1298. 

  1298. 	arquivo fonte pode ser perdido no processo de conversão, não
    1299. 

  1299. 	aparecendo no arquivo gerado. Use estas táticas se você
    1300. 

  1300. 	realmente precisa delas e sabe o que está fazendo.
    1301. 

  1301. 

  1302.  || Filtros são um recurso poderoso, mas podem ser perigosos! |
    1303. 

  1303. 

  1304.  ||…
    1305.

Large files files are truncated, but you can click here to view the full file