# TXT2TAGS - ARQUIVO DE EXEMPLO

Aurélio Jargas
18/11/2010

# Introdução

Bem-vindo(a) ao arquivo de exemplo do txt2tags.

Aqui você encontra exemplos e uma rápida explicação de todas as marcas. Use-o como esqueleto do seu primeiro documento escrito no txt2tags.

As primeiras 3 linhas deste arquivo são usadas como cabeçalho, no seguinte formato:

      linha 1: título do documento
      linha 2: nome do autor, email
      linha 3: data, versão

As linhas que possuem sinais de igual = balanceados no início e final são títulos.

# Fontes e Embelezadores

Há dois tipos de fontes disponíveis:

O tipo NORMAL, que pode ser destacado com embelezadores.

O tipo MONOESPAÇADO, usa letras monoespaçadas (tipo Courier) para textos já formatados.

Agora vamos entrar num subtítulo...

## Embelezadores

As marcações para embelezar o texto são simples, iguais as usadas numa mensagem de e-mail.

Basta duplicar *, /, - e _ para representar negrito, itálico, riscado e sublinhado.

Também é possível fazer negrito itálico combinando as marcas.

## Texto Pré-Formatado

É possível inserir um trecho de código ou outro texto já formatado:

        aqui    é      pré-formatado
      //marcas// **não**  são ``interpretadas``

Se for apenas uma linha, há uma marca especial:

      prompt$ ls /etc

Ou então use `as crases` para incluir texto monoespaçado dentro de parágrafos.

## Mais Perfumaria

Entidades especiais como e-mail (abc@algumlugar.com) e URL (http://www.abc.com) são reconhecidas automagicamente. A linha horizontal também:

^ fina ou grossa v

Você também pode especificar um link com nome.

E lembre-se:

> Um TAB no início da linha indica uma citação.

> > Mais TABs, mais profundidade (se permitido).

Legal.

# Listas

A lista de itens é natural, basta colocar um hífen ou sinal de mais no início da linha.

## Lista Normal

O hífen é o marcador de listas. Para fazer sublistas (aninhadas), basta adicionar espaços em branco no início da linha. Mais espaços, mais sublistas.

- Terra
  - América
    - América do sul
      - Brasil
        - Posso aprofundar ainda mais?
  - Europa
    - Muitos países
- Marte
  - Quem sabe?

A lista acaba com duas linhas em branco consecutivas.

## Lista Numerada

As mesmas regras as lista normal são válidas para a numerada, mudando apenas o marcador (sinal de mais).

1. um
2. dois
3. três
   - misturando listas!
   - que bagunça...
     1. contando de novo
     2. ...
4. quatro

## Lista de Termos

O marcador da lista é o dois-pontos, seguido do termo. O conteúdo do termo é colocado na linha seguinte.

laranja
  uma fruta amarela
maçã
  uma fruta verde ou vermelha
outras frutas
  - êpa!
  - misturando listas
    1. de novo!
    2. e de novo!

# Tabelas

Utilize barras verticais para separar os campos. Duas barras no início indicam uma linha de título. Espaços em branco indicam o alinhamento do campo.

título 1 | título 2 | título 3
--- | --- | ---
campo 1.1 | campo 1.2 | campo 1.3
campo 2.1 | campo 2.2 | campo 2.3

Tire a última barra para a tabela ficar sem borda:

título 1 | título 2 | título 3
--- | --- | ---
campo 1.1 | campo 1.2 | campo 1.3
campo 2.1 | campo 2.2 | campo 2.3

# Entidades Especiais

Está tudo muito simples, vamos complicar um pouco...

## Imagens

A marca da imagem é simplérrima: `[nome-do-arquivo]`.

- O nome do arquivo deve terminar em PNG, JPG, GIF, ...
- Não é permitido espaços em branco!

## Outros

A macro `%%date` informa a data atual.

Hoje é 20101118 no formato ISO (`AAAAMMDD`).

O formato da data pode ser mudado usando os formatadores %?, como em `%%date(%d-%m-%Y)`, que fica: 18-11-2010.

É isso.

(sample-pt.t2t)