13.2. Utilizar o git-producao-local

Documentação pode ser vista em Seção 10.4.3, “git-producao-local”. Esta seção assume que o alias foi configurado conforme descrito na documentação.

Consultando a documentação. 

git producao-local -h

Consultando a documentação, com o alias configurado. 

git pl -h

Ajuda. 

 git-producao-local options

options:
  -h    This help message
  -c    Run commit --interactive before
  -l    Run local sync instead of git-archive during the build, requires -b
  -r    Run rebase --interactive before
  -b    Build the PDF book
  -t    Use test file instead, must be used wih -b
  -o    Open produced PDF

A ordem dos parâmetros não é importante.

13.2.1. Gera o livro do arquivo de teste sem realizar commit

git pl -bolt

Para os autores avançados, este seria o principal comando.

l (local sync)
Copia os arquivos do diretório local para outro intermediário.
b (build)
Gera o livro a partir do diretório intermediário.
t (test)
Utilize o arquivo de teste livro/test.adoc ao invés de livro/livro.asc.
o (open)
Após geração abre o arquivo pdf para leitura.

Características

  • Rápido
  • Focaliza no que está sendo produzido, o autor atualiza o arquivo de teste para conter apenas os capítulos que está trabalhando.
  • Mascara erro pois podem haver arquivos não comitados, como o livro é gerado por uma sincronização local não há garantias que o livro seja gerado em outro local.

13.2.2. Commita, gera o livro com base no commit

git pl -cbo
c (commit)
Realiza um commit e copia os arquivos do commit para o diretório intermediário.
b (build)
Gera o livro a partir do diretório intermediário.
o (open)
Após geração abre o arquivo pdf para leitura.

Características

  • Produz o livro inteiro
  • Produz o livro com base no que foi commitado localmente
  • Abre o livro após a geração
  • Requer mensagem do commit

Realizando um rebase antes

git pl -cbor

Esta é uma modificação incluindo o rebase.

Características

  • As mesmas da anterior
  • Realizar um rebase para unir os commits e editar uma mensagem significativa de commit.
  • Utilizado ao final de alguma atividade.