/doc/Portuguese/sample-pt.t2t

  1TXT2TAGS - ARQUIVO DE EXEMPLO
  2Aurélio Jargas
  3%%mtime(%d/%m/%Y)
  4
  5%!target: html
  6%!encoding: UTF-8
  7
  8                   =  Introdução  =
  9
 10Bem-vindo(a) ao arquivo de exemplo do txt2tags.
 11
 12Aqui você encontra exemplos e uma rápida explicação
 13de todas as marcas. Use-o como esqueleto do seu
 14primeiro documento escrito no txt2tags.
 15
 16As primeiras 3 linhas deste arquivo são usadas como
 17cabeçalho, no seguinte formato:
 18```
 19linha 1: título do documento
 20linha 2: nome do autor, email
 21linha 3: data, versão
 22```
 23
 24As linhas que possuem sinais de igual = balanceados no
 25início e final são títulos.
 26
 27% aqui um comentário secreto!
 28%TODO fazer um link para a página do programa http://txt2tags.org
 29
 30
 31             =  Fontes e Embelezadores  =
 32
 33Há dois tipos de fontes disponíveis:
 34
 35O tipo NORMAL, que pode ser destacado com
 36embelezadores.
 37
 38O tipo MONOESPAÇADO, usa letras monoespaçadas
 39(tipo Courier) para textos já formatados.
 40
 41Agora vamos entrar num subtítulo...
 42
 43
 44                 ==  Embelezadores  ==
 45
 46As marcações para embelezar o texto são simples,
 47iguais as usadas numa mensagem de e-mail.
 48
 49Basta duplicar *, /, - e _ para representar **negrito**,
 50//itálico//, --riscado-- e __sublinhado__.
 51
 52Também é possível fazer **//negrito itálico//**
 53combinando as marcas.
 54
 55
 56              ==  Texto Pré-Formatado  ==
 57
 58É possível inserir um trecho de código ou outro texto
 59já formatado:
 60```
 61  aqui    é      pré-formatado
 62//marcas// **não**  são ``interpretadas``
 63```
 64
 65Se for apenas uma linha, há uma marca especial:
 66``` prompt$ ls /etc
 67
 68Ou então use ``as crases`` para incluir texto
 69monoespaçado dentro de parágrafos.
 70
 71
 72                ==  Mais Perfumaria  ==
 73
 74Entidades especiais como e-mail (abc@algumlugar.com)
 75e URL (http://www.abc.com) são reconhecidas
 76automagicamente. A linha horizontal também:
 77
 78--------------------------------------------------------
 79^ fina ou grossa v
 80========================================================
 81
 82Você também pode especificar um
 83[link com nome http://abc.org].
 84
 85E lembre-se:
 86	Um TAB no início da linha indica uma citação.
 87		Mais TABs, mais profundidade (se permitido).
 88Legal.
 89
 90
 91                     =  Listas  =
 92
 93A lista de itens é natural, basta colocar um **hífen**
 94ou **sinal de mais** no início da linha.
 95
 96
 97                 ==  Lista Normal  ==
 98
 99O hífen é o marcador de listas. Para fazer sublistas
100(aninhadas), basta adicionar **espaços em branco** no
101início da linha. Mais espaços, mais sublistas.
102
103- Terra
104  - América
105    - América do sul
106      - Brasil
107        - Posso aprofundar ainda mais?
108  - Europa
109    - Muitos países
110- Marte
111  - Quem sabe?
112
113
114A lista acaba com **duas** linhas em branco
115consecutivas.
116
117
118                ==  Lista Numerada  ==
119
120As mesmas regras as lista normal são válidas para a
121numerada, mudando apenas o marcador (sinal de mais).
122
123+ um
124+ dois
125+ três
126  - misturando listas!
127  - que bagunça...
128    + contando de novo
129    + ...
130+ quatro
131
132
133                ==  Lista de Termos  ==
134
135O marcador da lista é o dois-pontos, seguido do termo.
136O conteúdo do termo é colocado na linha seguinte.
137
138: laranja
139  uma fruta amarela
140: maçã
141  uma fruta verde ou vermelha
142: outras frutas
143  - êpa!
144  - misturando listas
145    + de novo!
146    + e de novo!
147
148
149                     =  Tabelas  =
150
151Utilize barras verticais para separar os campos.
152Duas barras no início indicam uma linha de título.
153Espaços em branco indicam o alinhamento do campo.
154
155 || título 1  |  título 2   |   título 3 |
156  | campo 1.1 |  campo 1.2  |  campo 1.3 |
157  | campo 2.1 |  campo 2.2  |  campo 2.3 |
158
159Tire a última barra para a tabela ficar sem borda:
160
161 || título 1  |  título 2   |   título 3
162  | campo 1.1 |  campo 1.2  |  campo 1.3
163  | campo 2.1 |  campo 2.2  |  campo 2.3
164
165
166               =  Entidades Especiais  =
167
168Está tudo muito simples, vamos complicar um pouco...
169
170                    == Imagens  ==
171
172A marca da imagem é simplérrima: ``[nome-do-arquivo]``.
173
174               [../img/photo.jpg]  
175
176- O nome do arquivo deve terminar em PNG, JPG, GIF, ...
177- Não é permitido espaços em branco!
178
179
180                    ==  Outros  ==
181
182A macro ``%%date`` informa a data atual.
183
184Hoje é %%date no formato ISO (``AAAAMMDD``).
185
186O formato da data pode ser mudado usando os
187formatadores %?, como em ``%%date(%d-%m-%Y)``,
188que fica: %%date(%d-%m-%Y).
189
190É isso.
191
192-------------------------------------------------------
193[../img/t2tpowered.png] ([%%infile %%infile])