Asciidoc Playground

Asciidoc Playground
i
Asciidoc Playground
por Eduardo de Santana Medeiros Alexadre
Asciidoc Playground
ii
COLLABORATORS
TITLE :
Asciidoc Playground
ACTION
NAME
DATE
WRITTEN BY
Eduardo de
Santana
Medeiros
Alexadre
2003-12
SIGNATURE
REVISION HISTORY
NUMBER
DATE
1.0
2003-12
DESCRIPTION
Primeira versão do meu livro.
NAME
E
Asciidoc Playground
iii
Sumário
1
Playground1
1
1.1
Alterando o título do livro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1
1.2
Configurando o autor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1
1.2.1
Múltiplos autores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1
Capítulos e Seções . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2
1.3.1
Criando seções . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2
1.3.2
Criando sub-seção . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2
1.3.3
Criando sub-sub-seção . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2
1.3.4
Capítulos e seções não podem ficar vazias . . . . . . . . . . . . . . . . . . .
2
Inserindo texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2
1.4.1
Não utilize espaço de parágrafo. . . . . . . . . . . . . . . . . . . . . . . . .
2
Como fazer Listas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3
1.5.1
Lista não ordenada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3
1.5.2
Lista ordenada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3
1.5.3
Cuidados ao criar uma lista . . . . . . . . . . . . . . . . . . . . . . . . . . .
3
1.5.4
Lista rotulada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3
Referenciando capítulos e seções . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4
1.6.1
Explicação do número próximo à referência . . . . . . . . . . . . . . . . . .
4
1.6.2
Clicável . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4
1.3
1.4
1.5
1.6
Asciidoc Playground
1/4
Capítulo 1
Playground1
Neste playground nós vamos aprender:
• a alterar o título do livro
• a configurar o autor
• a inserir Capítulos e Seções
• a inserir texto
• a referenciar capítulos e seções
• como fazer Listas
1.1
Alterando o título do livro
• A primeira linha do texto determina o título do livro
• A segunda linha do texto deve ser composta por uma sequência de =, com a mesma quantidade de
caracteres que o título possui.
Em caso de dúvidas, consulte:
http://producao.virtual.ufpb.br/books/edusantana/producaocomputacao-ead-ufpb/livro/livro.chunked/ch11s01.html#titulo_livro_alterando
1.2
Configurando o autor
A terceira linha do arquivo especifica o nome do autor do documento. Altere esta linha substituindo
o conteúdo com o seu nome.
1.2.1
Múltiplos autores
Neste curso, iremos aprender apenas como configurar um único autor. Múltiplos autores será visto no
curso avançado.
Asciidoc Playground
1.3
2/4
Capítulos e Seções
Para adicionar um capítulo basta iniciar uma nova linha com 2 iguais seguidos de um espaço e o título
do seu capítulo, Ex: (== Título do capítulo)
Neste arquivo temos apenas um capítulo.
1.3.1
Criando seções
Criar uma seção é similar à criação de capítulo, só que adicionamos mais um igual (=== Título da
seção)
1.3.2
Criando sub-seção
Criar uma sub-seção é similar à criação de seção, só que adicionamos mais um igual (==== Título da
sub-seção)
1.3.3
Criando sub-sub-seção
Criar uma sub-sub-seção é similar à criação de sub-seção, só que adicionamos mais um igual (=====
Título da sub-sub-seção)
OBS: Não existe sub-sub-sub-seção.
1.3.4
Capítulos e seções não podem ficar vazias
Nenhuma seção ou capítulo pode ficar vazia sem nenhum texto.
1.4
Inserindo texto
Os textos podem ser inseridos entre as seções e capítulos.
É muito importante compreender como funcionam os parágrafos. Um parágrafo é iniciando com um
texto e só termina quando encontra uma linha em branco.
Enquanto não existir uma linha em branco, o texto faz parte do mesmo parágrafo.
1.4.1
Não utilize espaço de parágrafo.
Não utilize espaço de parágrafo. Comece o texto no
início da linha sem adicionar nenhum espaço.
Caso você inicie alguma linha com espaço ela
ficará desse jeito.
Asciidoc Playground
1.5
Como fazer Listas
1.5.1
Lista não ordenada
3/4
• Um asterisco (*) seguido de espaço ( ) e texto inicia uma lista.
• Adicione outro ítem da mesma forma.
• Se o texto do ítem for muito grande e ocupar mais de uma linha, não tem problema nenhum.
Simplesmente continue digitando o texto do ítem até ele acabar.
• Adicione tantos ítens quanto forem necessários.
1.5.2
Lista ordenada
1. Uma lista ordenada numericamente é criada de forma similar
2. Só que inicia com 1 ponto (.)
3. Os ítens adicionados são numerados automaticamente
a. Você também pode fazer sub-ítens
b. Basta inicia-los com 2 pontos (..)
4. Você pode incluse misturar as duas listas
1.5.3
Cuidados ao criar uma lista
Lembre-se que após o (*) ou (.) SEMPRE vem um espaço em branco ( ).
1.5.4
Lista rotulada
O Norte
Conhecido também por setentrião, setentrional ou boreal, geográfica ou astronomicamente, é
uma direcção/direção fundamentada no sentido de rotação do planeta e o ponto zero dos quatro
pontos cardeais
O Sul
Um dos quatro pontos cardeais da rosa-dos-ventos, ou meridião, ou meridional ou austral;
meio-dia; para quem está no hemisfério norte, ao meio-dia solar o Sol encontra-se a Sul do
observador.
O Leste
Leste, símbolo L ou E, um dos quatro pontos cardeais da rosa-dos-ventos, também chamado de
oriente, este, nascente ou levante.
O Oeste
Oeste, símbolo O (ou W, do nome em inglês), para a geografia, é um dos quatro pontos cardeais
da rosa-dos-ventos, que fica localizado à esquerda do observador, quando este se volta para o
Norte.
Asciidoc Playground
1.6
4/4
Referenciando capítulos e seções
Para referenciar um capítulo ou seção primeiro precisamos nomeá-los. Exemplo de nomeção:
[[cap_playground1]]
== Playground1
[[criando_secao]]
=== Criando seções
Os nomes atribuídos não podem conter espaços.
Após nomeá-los, podermos referenciá-los da seguinte forma:
<<cap_playground1>> e <<criando_secao>>.
Referenciando capítulo: O Capítulo 1 [1] ensina como referenciar capítulos, entre outras coisas.
Refrenciando seção: A Seção 1.3.1 [2] demonstra a criação de seção.
1.6.1
Explicação do número próximo à referência
O número ao lado da referência corresponde à página onde o item referenciado se encontra.
1.6.2
Clicável
Na versão digital, a referência se torna um link. Se você clicar na referência será redirecionado para
o item referenciado.