4.6. Configurando o livro e os capítulos

Você deve ter percebido que o livro que se encontra no repositório já possui alguns capítulos.

O principal arquivo do livro é o livro/livro.asc. Neste arquivo são configurados:

livro/livro.asc. 

= Nome da disciplina
Autor da disciplina
:doctype: book
:lang: pt-BR
:keywords:    Computação
:description: Livro de Nome-da-disciplina
:ascii-ids:


 include::capitulos/prefacio.asc[]

////
= Nome da Parte =
////

 include::capitulos/novo-capitulo.asc[]
 include::capitulos/asciidoc-cheatsheet.asc[]

// Sempre termine os arquivos com uma linha em branco.

4.6.1. Atualize o nome da disciplina

Onde atualizar o nome da disciplina. 

= Nome da disciplina

Exemplo de nome da disciplina atualizado. 

= Introdução à Computação

4.6.2. Criando um novo capítulo

O arquivo livro/capitulos/novo-capitulo.asc foi criado com o objetivo de você criar uma cópia deste arquivo sempre que desejar criar um novo capitulo.

  1. Abra o arquivo, salve-o como outro nome dentro da pasta capitulos. Não utilize espaço no nome do arquivo.
  2. Edite o arquivo livro.asc e adicione um include com o novo arquivo
  3. Comente os capítulos que não serão utilizados

Exemplo de livro.asc após incluir um novo capítulo chamado História da Computação. 

 include::capitulos/historia-da-computacao.asc[]
 // include::capitulos/novo-capitulo.asc[]
 // include::capitulos/asciidoc-cheatsheet.asc[]

[Dica]

Gere o livro novamente para verificar as alterações (Seção 4.5, “Visualize as alterações”).

4.6.3. Atualizando o conteúdo do novo capítulo

O conteúdo do arquivo novo-capitulo foi elaborado para facilitar a edição de novos capítulos.

[Cuidado]

Lembre-se de que não pode existir nenhuma seção sem texto. Sempre que você criar uma seção, adicione quaquer texto dentro dela, caso contrário o PDF não será gerado.

4.6.4. Planejamento & Acompanhamento

O autor deve fornecer um planejamento de elaboração do livro através das seguintes ações:

Informar quais e quantos capítulos serão realizados

O autor informa quais capítulos serão realizados criando os arquivos de cada capítulo e enviando-os para o github.

Exemplo de planejamento de um livro de Introdução a Programação. 

 capitulos/computador.asc
 capitulos/algoritimos.asc
 capitulos/representacao-de-dados.asc
 capitulos/expressoes.asc
 capitulos/entrada-e-saida.asc
 capitulos/estruturas-de-controle.asc
 capitulos/estruturas-de-repeticao.asc
 capitulos/variaveis-compostas.asc
 capitulos/modularizacao.asc
 capitulos/novo-capitulo.asc
 livro.asc (com os includes dos novos capítulos)

[Nota]

Embora existam muitos arquivos acima, todos eles foram cópias do arquivo novo-capitulo.asc, com apenas o título do capítulo modificado.

Arquivo livro/livro.asc atualizado. 

= Introdução a Programação
Eduardo Santana
:doctype: book
:lang: pt-BR
:description: Livro de Introdução a Programação
:ascii-ids:

 include::capitulos/prefacio.asc[]
 include::capitulos/computador.asc[]
 include::capitulos/algoritimos.asc[]
 include::capitulos/representacao-de-dados.asc[]
 include::capitulos/expressoes.asc[]
 include::capitulos/entrada-e-saida.asc[]
 include::capitulos/estruturas-de-controle.asc[]
 include::capitulos/estruturas-de-repeticao.asc[]
 include::capitulos/variaveis-compostas.asc[]
 include:: capitulos/modularizacao.asc[]

// Sempre termine os arquivos com uma linha em branco.

[Importante]

Não esqueça de atualizar o arquivo livro.asc para incluir o novos capítulos. Consulte Seção 4.6.2, “Criando um novo capítulo” se precisar lembrar como os novos capítulos são criados.

Em seguida, adicione os arquivos ao gitb e realize um push (sincronização) para enviar os arquivos para o github.

Informar um planejamento de conclusão dos capítulos

O autor informa o planejamento de conclusão dos capítulos através da criação de um Issue entitulado "Planejamento de conclusão dos capítulos".

Figura 4.1. Exemplo do Issue de Planejamento de conclusão dos capítulos

images/iniciando-livro/issue-planejamento.png

[Cuidado]

O Issue deve ser criado no projeto original, e não no fork do autor.