–mask-email esconde os e-mails dos robˆosde SPAM. [email protected] CONFIGURAC¸ OES˜ vira <x (a) y z> O txt2tags pode ser personalizado por m´etodos internos e -n, –enum-title numera todos os t´ıtulos como 1, 1.1, 1.1.1, etc externos. Os meios externos podem ser de um arquivo chamado TXT2TAGS - Cart˜aode referˆencia –no-encoding exclui a configura¸c˜aode codifica¸c˜ao .txt2tagsrc ou importado de outro arquivo txt2tags. O jeito –no-enum-title desativa a auto-numera¸c˜ao de t´ıtulos interno ´efeito por comandos inclu´ıdos na ´areade configura¸c˜aodo fonte. Ambas formas usam a mesma sintaxe: –no-infile exclui as defini¸c˜oes anteriores do arquivo fonte –no-mask-email exibe os e-mails, desabilitando a op¸c˜ao %!target: define o formato destino (target) principal Setembro, 2004 –mask-email –no-outfile exclui as defini¸c˜oes anteriores sobre o arquivo de %!options(target): define as op¸c˜oesde cada destino destino %!include: arquivo.txt inclui um arquivo texto no documento O txt2tags ´euma ferramenta GPL de convers˜aode formatos –no-rc n˜ao lˆeo arquivo configura¸c˜ao do usu´arioem ˜/.txt2tagsrc %!include: ’’arquivo.html’’ inclui um arquivo literal no escrita em Python que gera documentos em HTML, XHTML, documento, ipsis literis SGML, LaTeX, Man Page, MoinMoin, Magic Point e Pagemaker –no-style exclui as configura¸c˜oesde estilo a partir de um ´unico arquivo de texto com algumas marca¸c˜oes. –no-toc n˜ao inclui o ´Indice (Table of Contents) no documento %!style: para indicar um arquivo CSS (Cascading Style Sheets) O usu´ario s´oprecisa conhecer algumas marcas usadas pelo de destino para os destinos XHTML e HTML ou carregar um m´odulo txt2tags, e escrever textos normais. O programa faz todo o \usepackage no destino TEX –no-toc-only desativa a op¸c˜ao–toc-only trabalho sujo, adicionando as tags complicadas e lidando com as pegadinhas dos documentos de destino. -o, –outfile=ARQUIVO define ARQUIVO como destino (’-’ %!encoding: para indicar um conjunto de caracteres (como O mesmo arquivo texto pode ser convertido para todos os para STDOUT) iso-8859-1) para usu´arios de l´ıngua n˜ao-inglesa formatos dispon´ıveis, sem a necessidade de qualquer altera¸c˜ao. –rc lˆea configura¸c˜aodo usu´ario em ˜/.txt2tagsrc (padr˜ao %!includeconf: usado para incluir configura¸c˜oes a partir de um Esta ´ea finalidade do txt2tags. LIGADO) arquivo externo Visite a p´agina do programa em –style=ARQUIVO utiliza ARQUIVO como estilo do http://txt2tags.sourceforge.net/. documento (como o CSS do Html) %!guicolors: configura¸c˜oes de cores para a interface gr´afica (tcl/tk) AUTOR -t, –target define o tipo do documento de destino. atualmente suportados: html, xhtml, sgml, tex, man, mgp, moin, pm6, %!preproc: filtros personalizados (macros) que ser˜ao O txt2tags foi criado e ´emantido por Aur´elioMarinho Jargas txt processados ANTES da avalia¸c˜ao do documento <[email protected]> –toc inclui o ´Indice (Table of Contents) no documento de Este Cart˜aode Referˆencia foi escrito por Jos´eIn´acio Coelho %!postproc: filtros personalizados (macros) que ser˜ao destino <[email protected]> como um arquivo texto, e convertido processados APOS´ a avalia¸c˜aodo documento com o txt2tags! O arquivo pdf foi gerado com o HTMLDOC –toc-level=N define o n´ıvel m´aximo(profundidade) do ´Indice 1.8.23. O arquivo ps foi formatado usando LaTeX por Leslie para N REGRAS DAS CONFIGURAC¸ OES˜ Harlley Watter <[email protected]>. –toc-only exibe o ´Indice do documento e sai -v, –verbose exibe mensagens informativas durante a convers˜ao • Se o (target) for omitido, a configura¸c˜aoser´av´alida para SINTAXE todos os destinos. txt2tags [OPC¸ OES˜ ]... [ARQUIVO]... -V, –version exibe a vers˜aodo programa e sai Normalmente a sa´ıdaconvertida ´egravada em arquivo.<tipo>. • A %!keyword deve estar no in´ıcio da linha, sem espa¸cos Op¸c˜oes Utilize --outfile para for¸car um nome para o arquivo de sa´ıda. anteriores. –css-suggar insere tags compat´ıveis com CSS em destinos Se o arquivo de entrada ´e’-’, lˆede STDIN. Se o arquivo de sa´ıda • As configura¸c˜oes s˜aov´alidas somente dentro da Area´ de HTML e XHTML ´e’-’, envia a sa´ıdapara STDOUT. Configura¸c˜ao, e ser˜aoconsideradas coment´ariossimples se –dump-config exibe todas as configura¸c˜oes encontradas e sai ESTRUTURA forem encontradas no Corpo do documento. –encoding informa a codifica¸c˜aode destino (utf-8, iso-8859-1, Um arquivo fonte txt2tags pode ter trˆes ´areas: • Se a mesma palavra-chave aparece mais de uma vez na etc) ´ Cabe¸calho As primeiras trˆes linhas. S˜aousadas para Area de Configura¸c˜ao,apenas a ´ultima ser´ausada. –gui carrega a interface gr´afica escrita em TK identifica¸c˜aodo documento. Se n˜aofor necess´ario, o Exce¸c˜oes: options, preproc e postproc, que s˜ao acumulativas. -h, –help exibe o texto de ajuda e sai cabe¸calho pode ser suprimido pela configura¸c˜ao no-header. Configura¸c˜ao Inicia a partir da quarta linha. Todas as • Uma linha de configura¸c˜ao com uma palavra-chave inv´alida -H, –no-headers suprime os cabe¸calhos, t´ıtulo e rodap´e configura¸c˜oes tˆemo formato %!chave: valor. As ser´aconsiderada um coment´ario. –headers exibe os cabe¸calhos, t´ıtulo e rodap´e(padr˜ao configura¸c˜oes tamb´empodem ser realizadas por arquivos LIGADO) de configura¸c˜aoou linha de comando. • Estas configura¸c˜oestˆemprecedˆencia sobre o arquivo ´ .txt2tagsrc, mas n˜aosobre as op¸c˜oesde linha de -i, –infile=ARQUIVO define ARQUIVO como arquivo fonte Corpo O verdadeiro documento! E a ´unica ´areanecess´ariapara comando. (’-’ para STDIN) que se tenha um documento txt2tags v´alido. 1 MARCAC¸ OES˜ $ txt2tags --gui arquivo.t2t ARQUIVOS Uma sintaxe de marcas bem simples ´eutilizada no arquivo fonte Edi¸c˜ao p´os-convers˜aoutilizando filtro externo Os seguintes arquivos podem (o arquivo de texto puro) para identificar as estruturas e a $ txt2tags -t html -o- arquivo.t2t | sed -f meufiltro.sed ser encontrados abaixo do diret´orio em que o txt2 estiver instalado: formata¸c˜ao. Aqui est´aa lista completa: > arquivo.html txt2tags O programa em si (o ´uniconecess´ario de fato) Teste r´apido de uma linha vindo de STDIN Documenta¸c˜ao B´asico $ echo -e "\n**negrito**"| txt2tags -t html -H - TODO Rela¸c˜aode id´eias melhorar o txt2tags ChangeLog Rela¸c˜aodas mudan¸casem cada vers˜ao Cabe¸calhos As 3 primeiras linhas do arquivo fonte README Breve arquivo de apresenta¸c˜ao T´ıtulo = palavras = EXEMPLOS DE FILTROS FAQ D´uvidas e esclarecimentos frequentes, al´em T´ıtulo numerado + palavras + Os filtros PreProc e PostProc s˜aoferramentas poderosas para de reposit´orio de dicas Par´agrafo palavras realizar ajustes tanto no arquivo fonte como no destino. Mas seja REGRAS Regras de marca¸c˜oespara interpreta¸c˜ao do cuidadoso por que eles usam Express˜oesregulares e podem ser txt2tags Embelezadores guia-usuario Guia do usu´ario em linguagem menos t´ecnica perigosos se mal escritos. Fa¸ca testes antes de consider´a-los abuse-me Exemplo que estressa dos recursos Negrito **palavras** definitivos. COPYING Licen¸caGNU GPL It´alico //palavras// css-reference.txt Atributos CSS e seus parˆametros Sublinhado __palavras__ preproc Facilitadores Monoespa¸cado ‘‘palavras‘‘ S˜ao filtros personalizados (macros) que ser˜aoprocessados txt2tags.vim Arquivo de sintaxe para o Vim txt2tags-compiler.vim Configura o Vim para converter com um sim- ANTES da avalia¸c˜ao do documento. Todavia n˜aoalteram o ples comando :make Blocos de Texto arquivo fonte original. txt2tags-mode.el Arquivo de sintaxe para o Emacs Cita¸c~ao <TAB>palavras Simplifica escrita de links em html nanorc Arquivo de sintaxe para o editor nano Lista - palavras txt2tags-kate.xml Arquivo de sintaxe para o Kate %!preproc(html): TXT2TAGS ’[txt2tags http://txt2tags.sf.net]’ unhtml.vim Usa o Vim para converter arquivos HTML em Lista numerada + palavras arquivo txt2tags Lista de defini¸c~ao : palavras pagemaker.vim Configura¸c˜aode cores para arquivos do Pa- Linha formatada ‘‘‘ palavras Uso de abreviaturas geMaker no Vim Area´ formatada ‘‘‘<Quebra> linhas <Quebra>‘‘‘ Programas auxiliares Linha protegida """ palavras %!preproc: T2T ’**//txt2tags// - UMA fonte VARIOS´ destinos**’ t2tconv Script de convers˜aoda vers˜ao1.x para nova Area´ protegida """<Quebra> linhas <Quebra>""" formata¸c˜aoda vers˜ao 2.0 %!preproc: ABREV ’Abreviaturas, um bom uso de ‘‘preproc‘‘’ t2tmake.rb Script Ruby automatizar a convers˜ao de ar- Tabela | cel1 | cel2 | cel3... quivos txt2tags alterados html-update.sh Script para automatizar a convers˜aode ar- Outros postproc quivos txt2tags alterados ´ Linha de separa¸c~ao -----------------------... S˜ao filtros personalizados (macros) que ser˜aoprocessados APOS txt2tags.php Interface web em PHP para converter arqui- vos txt2tags Linha destacada =======================... a avalia¸c˜ao do documento. Eles alteram o arquivo destino gerado. Links [nome url] Gera CSS no destino html UTILIDADES Imagem [arquivo.XXX] H´aalguns truques que tornam o txt2tags uma excelente Texto protegido ""palavras"" %!postproc(html): <HEAD> ’<HEAD>\n<STYLE TYPE="text/css">\n</STYLE>’ %!postproc(html): (</STYLE>) ’a {text-decoration:none;} \n\1’ ferramenta de documenta¸c˜ao: Data atual %%date(formato) Ancoramento Coment´ario % coment´arios Os T´ıtulos podem ser ligados por ˆancoras (se o formato de destino Voltar em javascript para HTML permitir). Isso permite ir diretamente a alguma parte do Por favor, leia o arquivo REGRAS (no diret´oriode Contribui¸c˜aodo Prof. Sergio de Albuquerque Souza documento. documenta¸c˜aodo programa) para uma descri¸c˜aodetalhada de cada marca. Exemplo: [Clique aqui JAVABACK] para voltar T´ıtulo = palavras =[^ancora] T´ıtulo Numerado + palavras +[^ancora] EXEMPLOS %!postproc(html): ’JAVABACK’ ’javascript:history.back()’ M´ultiplos arquivos Supondo que vocˆecriou um arquivo marcado chamado For¸ca marca¸c˜oes no destino O txt2tags pode manipular mais de um arquivo, como: , vamos nos divertir fazendo algumas convers˜oes.