Cart˜Ao De Referência

–mask-email esconde os e-mails dos robôsde SPAM. [email protected] CONFIGURAÇ OES˜ vira O txt2tags pode ser personalizado por métodos 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ãode referência –no-encoding exclui a configura¸cãode codifica¸cão .txt2tagsrc ou importado de outro arquivo txt2tags. O jeito –no-enum-title desativa a auto-numera¸cão de t´ıtulos interno éfeito por comandos inclu´ıdos na áreade configura¸cãodo fonte. Ambas formas usam a mesma sintaxe: –no-infile exclui as defini¸cões anteriores do arquivo fonte –no-mask-email exibe os e-mails, desabilitando a op¸cão %!target: define o formato destino (target) principal Setembro, 2004 –mask-email –no-outfile exclui as defini¸cões anteriores sobre o arquivo de %!options(target): define as op¸cõesde cada destino destino %!include: arquivo.txt inclui um arquivo texto no documento O txt2tags éuma ferramenta GPL de conversãode formatos –no-rc não lêo arquivo configura¸cão do usuárioem ˜/.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õesde estilo a partir de um único arquivo de texto com algumas marca¸cões. –no-toc não inclui o Índice (Table of Contents) no documento %!style: para indicar um arquivo CSS (Cascading Style Sheets) O usuário sóprecisa conhecer algumas marcas usadas pelo de destino para os destinos XHTML e HTML ou carregar um módulo txt2tags, e escrever textos normais. O programa faz todo o \usepackage no destino TEX –no-toc-only desativa a op¸cão–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ários de l´ıngua não-inglesa formatos dispon´ıveis, sem a necessidade de qualquer altera¸cão. –rc lêa configura¸cãodo usuário em ˜/.txt2tagsrc (padrão %!includeconf: usado para incluir configura¸cões a partir de um Esta éa finalidade do txt2tags. LIGADO) arquivo externo Visite a página do programa em –style=ARQUIVO utiliza ARQUIVO como estilo do http://txt2tags.sourceforge.net/. documento (como o CSS do Html) %!guicolors: configura¸cões de cores para a interface gráfica (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ão O txt2tags foi criado e émantido por AurélioMarinho Jargas txt processados ANTES da avalia¸cão do documento –toc inclui o Índice (Table of Contents) no documento de Este Cartãode Referência foi escrito por JoséInácio Coelho %!postproc: filtros personalizados (macros) que serão destino como um arquivo texto, e convertido processados APOS´ a avalia¸cãodo documento com o txt2tags! O arquivo pdf foi gerado com o HTMLDOC –toc-level=N define o n´ıvel máximo(profundidade) do Índice 1.8.23. O arquivo ps foi formatado usando LaTeX por Leslie para N REGRAS DAS CONFIGURAÇ OES˜ Harlley Watter . –toc-only exibe o Índice do documento e sai -v, –verbose exibe mensagens informativas durante a conversão • Se o (target) for omitido, a configura¸cãoseráválida para SINTAXE todos os destinos. txt2tags [OPÇ OES˜ ]... [ARQUIVO]... -V, –version exibe a versãodo programa e sai Normalmente a sa´ıdaconvertida égravada em arquivo.. • A %!keyword deve estar no in´ıcio da linha, sem espa¸cos Op¸cões 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 é’-’, lêde STDIN. Se o arquivo de sa´ıda • As configura¸cões sãoválidas somente dentro da Area´ de HTML e XHTML é’-’, envia a sa´ıdapara STDOUT. Configura¸cão, e serãoconsideradas comentáriossimples se –dump-config exibe todas as configura¸cões encontradas e sai ESTRUTURA forem encontradas no Corpo do documento. –encoding informa a codifica¸cãode destino (utf-8, iso-8859-1, Um arquivo fonte txt2tags pode ter três áreas: • Se a mesma palavra-chave aparece mais de uma vez na etc) ´ Cabe¸calho As primeiras três linhas. Sãousadas para Area de Configura¸cão,apenas a última seráusada. –gui carrega a interface gráfica escrita em TK identifica¸cãodo documento. Se nãofor necessário, o Exce¸cões: options, preproc e postproc, que são acumulativas. -h, –help exibe o texto de ajuda e sai cabe¸calho pode ser suprimido pela configura¸cão no-header. Configura¸cão Inicia a partir da quarta linha. Todas as • Uma linha de configura¸cão com uma palavra-chave inválida -H, –no-headers suprime os cabe¸calhos, t´ıtulo e rodapé configura¸cões têmo formato %!chave: valor. As seráconsiderada um comentário. –headers exibe os cabe¸calhos, t´ıtulo e rodapé(padrão configura¸cões tambémpodem ser realizadas por arquivos LIGADO) de configura¸cãoou linha de comando. • Estas configura¸cõestêmprecedência sobre o arquivo ´ .txt2tagsrc, mas nãosobre as op¸cõesde linha de -i, –infile=ARQUIVO define ARQUIVO como arquivo fonte Corpo O verdadeiro documento! E a única áreanecessáriapara comando. (’-’ para STDIN) que se tenha um documento txt2tags válido.

1 MARCAÇ OES˜ $ txt2tags --gui arquivo.t2t ARQUIVOS Uma sintaxe de marcas bem simples éutilizada no arquivo fonte Edi¸cão pós-conversãoutilizando 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ório em que o txt2 estiver instalado: formata¸cão. Aqui estáa lista completa: > arquivo.html txt2tags O programa em si (o úniconecessário de fato) Teste rápido de uma linha vindo de STDIN Documenta¸cão Básico $ echo -e "\n**negrito**"| txt2tags -t html -H - TODO Rela¸cãode idéias melhorar o txt2tags ChangeLog Rela¸cãodas mudan¸casem cada versão Cabe¸calhos As 3 primeiras linhas do arquivo fonte README Breve arquivo de apresenta¸cão T´ıtulo = palavras = EXEMPLOS DE FILTROS FAQ Dúvidas e esclarecimentos frequentes, além T´ıtulo numerado + palavras + Os filtros PreProc e PostProc sãoferramentas poderosas para de repositório de dicas Parágrafo palavras realizar ajustes tanto no arquivo fonte como no destino. Mas seja REGRAS Regras de marca¸cõespara interpreta¸cão do cuidadoso por que eles usam Expressõesregulares e podem ser txt2tags Embelezadores guia-usuario Guia do usuário em linguagem menos técnica perigosos se mal escritos. Fa¸ca testes antes de considerá-los abuse-me Exemplo que estressa dos recursos Negrito **palavras** definitivos. COPYING Licen¸caGNU GPL Itálico //palavras// css-reference.txt Atributos CSS e seus parâmetros Sublinhado __palavras__ preproc Facilitadores Monoespa¸cado ‘‘palavras‘‘ São filtros personalizados (macros) que serãoprocessados txt2tags.vim Arquivo de sintaxe para o Vim txt2tags-compiler.vim Configura o Vim para converter com um sim- ANTES da avalia¸cão do documento. Todavia nãoalteram o ples comando :make Blocos de Texto arquivo fonte original. txt2tags-mode.el Arquivo de sintaxe para o Emacs Cita¸c~ao 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ãode cores para arquivos do Pa- Linha formatada ‘‘‘ palavras Uso de abreviaturas geMaker no Vim Area´ formatada ‘‘‘ linhas ‘‘‘ Programas auxiliares Linha protegida """ palavras %!preproc: T2T ’**//txt2tags// - UMA fonte VARIOS´ destinos**’ t2tconv Script de conversãoda versão1.x para nova Area´ protegida """ linhas """ formata¸cãoda versão 2.0 %!preproc: ABREV ’Abreviaturas, um bom uso de ‘‘preproc‘‘’ t2tmake.rb Script Ruby automatizar a conversão de ar- Tabela | cel1 | cel2 | cel3... quivos txt2tags alterados html-update.sh Script para automatizar a conversãode ar- Outros postproc quivos txt2tags alterados ´ Linha de separa¸c~ao ------... São filtros personalizados (macros) que serãoprocessados APOS txt2tags.php Interface web em PHP para converter arquivos txt2tags Linha destacada ======... a avalia¸cão do documento. Eles alteram o arquivo destino gerado. Links [nome url] Gera CSS no destino html UTILIDADES Imagem [arquivo.XXX] Háalguns truques que tornam o txt2tags uma excelente Texto protegido ""palavras"" %!postproc(html): ’\n’ %!postproc(html): () ’a {text-decoration:none;} \n\1’ ferramenta de documenta¸cão: Data atual %%date(formato) Ancoramento Comentário % comentários Os T´ıtulos podem ser ligados por âncoras (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óriode Contribui¸cãodo Prof. Sergio de Albuquerque Souza documento. documenta¸cãodo programa) para uma descri¸cãodetalhada de cada marca. Exemplo: [Clique aqui JAVABACK] para voltar T´ıtulo = palavras =[âncora] T´ıtulo Numerado + palavras +[âncora] EXEMPLOS %!postproc(html): ’JAVABACK’ ’javascript:history.back()’ Múltiplos arquivos Supondo que vocêcriou um arquivo marcado chamado For¸ca marca¸cões no destino O txt2tags pode manipular mais de um arquivo, como: , vamos nos divertir fazendo algumas conversões. Usa um escape (#) para evitar substitui¸cões indevidas arquivo.t2t txt2tags *.t2t Converte para HTML, gravando em arquivo.html A macro %%date %!postproc(html): (#sim#) ’sim’ $ txt2tags -t html arquivo.t2t Permite incluir a data corrente no formato ISO aaaammdd. Uma Similar ao anterior, usando redirecionamento %!postproc(html): (#n~ao#)’n~ao’ formata¸cão opcional pode ser especificada com a sintaxe > $ txt2tags -t html -o - arquivo.t2t arquivo.html %%date(formato). Incluindo o Índice Truque para inserir tags HTML no documento usando A macro %%date nãoprecisa, obrigatoriamente, ser usada na área chaves $ txt2tags -t html --toc arquivo.t2t de cabe¸calho. Os exemplos abaixo foram gerados em tempo de Incluindo o Índice e t´ıtulos numerados Serãoremovidas nos outros destinos conversão. $ txt2tags -t html --toc --enum-title arquivo.t2t %%date(format) Resultado para: 2004-, Sep28, 19:31 Exibi¸cãorápida do conteúdo Exemplo: {table}{tr}{td align="center"} Ultima´ atualiza¸cão:%c Ultima´ atualiza¸cão:Tue Sep 28 19:31:08 2004 $ txt2tags --toc-only arquivo.t2t %%!postproc(html): ’{(.*?)}’ ’<\1>’ %Y-%m-%d 2004-09-28 Utilizando a interface gráfica %%!postproc: ’{.*?}’ ’’ %I:%M %p 07:31 PM Hoje é%A, em %B. Hoje éTuesday, em September.