TOC

Gerando um livro com o Asciidoctor

Gerando um livro com o Asciidoctor

1. Introdução

Neste artigo rápido, demonstraremos comogenerate a book from an AsciiDoc document e como personalizar seu livro com várias opções de estilo.

Se você não está familiarizado com AsciiDoc em Java, pode ler nossoIntroduction to AsciiDoctor.

2. Tipo de livro de back-end

A maneira mais simples de gerar um livro com o AsciiDoctorj é com o Maven, como no artigo mencionado anteriormente. The only difference is that you have to specify doctype tag and set it to “book”. 

pdf
book

Com doctype definido, o AsciiDoctorj sabe que você deseja criar um livro, portanto, ele cria:

  • Uma página de título

  • Um índice

  • A primeira página do conteúdo do corpo

  • Partes e capítulos

Para obter as partes mencionadas, o documento do Asciidoc deve ter título, seções e outras partes que são normais para um livro.

3. Definindo um estilo personalizado

Ao escrever um livro, é natural que queiramos usar algum estilo personalizado. É possível fazer isso com a linguagem de formatação específica do AsciiDoc definida no arquivo YAML simples.

Por exemplo, esse trecho de código definirá a aparência de cada página de um livro. Queremos estar no modo retrato, margem de 0,75 polegadas na parte superior e inferior e margem de 1 polegada nas laterais no formato de papel A4: 

page:
    layout: portrait
    margin: [0.75in, 1in, 0.75in, 1in]
    size: A4

Além disso, podemos definir um estilo personalizado para o rodapé e o cabeçalho do livro: 

header:
  height: 0.5in
  line_height: 1
  recto_content:
    center: '{document-title}'
  verso_content:
    center: '{document-title}'

footer:
  height: 0.5in
  line_height: 1
  recto_content:
    right: '{chapter-title} | *{page-number}*'
  verso_content:
    left: '*{page-number}* | {chapter-title}

Mais opções de formatação podem ser encontradas emGithub page of AsciiDoctorj.

Para incluir o tema personalizado em um processo de geração de livros, precisamos definir o caminho em que nosso arquivo de estilo está localizado. A localização é especificada na parte dos atributos empom.xml: 

${project.basedir}/src/themes
custom

A primeira linha define o caminho em que nosso estilo é definido e a segunda linha especifica o nome do arquivo sem extensão.

Com essas mudanças, nossopom.xml fica assim: 


    src/docs/asciidoc
    target/docs/asciidoc
    
        ${project.basedir}/src/themes
        custom
    
    pdf
    book

4. Gerando Livro

Para gerar seu livro, basta executar o Maven no diretório do projeto, e o livro gerado pode ser encontrado no diretóriotarget/docs/asciidoctor/.

5. Conclusão

Neste tutorial, mostramos como gerar um livro decorado com estilo simples com o Maven.

Como sempre, o código deste artigo pode ser encontradoover on GitHub.

Related