Asciidoc Playground =================== Eduardo de Santana Medeiros Alexadre v1.0, 2003-12: Primeira versão do meu livro. :doctype: book :icons: :lang: pt-BR :ascii-ids: [[cap_playground1]] == 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 === 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/producao-computacao-ead-ufpb/livro/livro.chunked/ch11s01.html#titulo_livro_alterando [[configurando_autor]] === 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. ==== Múltiplos autores Neste curso, iremos aprender apenas como configurar um único autor. Múltiplos autores será visto no curso avançado. === 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. [[criando_secao]] ==== Criando seções Criar uma seção é similar à criação de capítulo, só que adicionamos mais um igual (=== Título da seção) ==== 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) ==== 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. ==== Capítulos e seções não podem ficar vazias Nenhuma seção ou capítulo pode ficar vazia sem nenhum texto. === 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. ==== 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. === Como fazer Listas ==== Lista não ordenada * 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. ==== Lista ordenada . Uma lista ordenada numericamente é criada de forma similar . Só que inicia com 1 ponto (.) . Os ítens adicionados são numerados automaticamente .. Você também pode fazer sub-ítens .. Basta inicia-los com 2 pontos (..) . Você pode incluse misturar as duas listas ==== Cuidados ao criar uma lista Lembre-se que após o (*) ou (.) SEMPRE vem um espaço em branco ( ). ==== 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. === 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: <> e <>. Referenciando capítulo: O <> ensina como referenciar capítulos, entre outras coisas. Refrenciando seção: A <> demonstra a criação de seção. ==== 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. ==== 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.