Processo Ágil de Produção de Livros

Eduardo de Santana Medeiros Alexandre

Histórico de Revisões
Revisão 1.02013-10E

Índice

I. O Processo de Produção
1. Visão Geral do Processo de Produção
2. Início rápido
2.1. Vídeo demonstrando as instruções deste capítulo
2.2. Acesse o repositório deste manual
2.3. Gerando o PDF através do Servidor da Produção
2.4. Explorando a estrutura de diretórios do projeto
2.5. Realizando um fork no projeto
2.6. Clonando o repositório do projeto
2.6.1. Clonando através da linha de comando
2.6.2. Clonando usando interface gráfico (no windows)
2.7. Realizando alteração no projeto
2.8. Comitando as alterações
2.8.1. No linux
2.9. Realize um push
2.10. Gerando nova versão do livro com as alterações realizadas
2.11. Realizando um pull-request
2.12. Reportando sugestões, erros ou críticas
2.13. Resumo técnico do processo
2.14. Recapitulando
3. Revisão de conteúdo anterior
3.1. Benefícios desta etapa de revisão
3.2. Escolhendo um conteúdo para revisar
3.3. Realize um fork do projeto
3.4. Clone o projeto
3.5. Realize a sua contribuição
3.6. Visualizando sua revisão
3.7. Submetendo sua revisão
3.8. Recapitulando
4. Iniciando um livro
4.1. Repositório do seu livro
4.2. Estrutura inicial dos projetos
4.3. Gere o pdf inicial do livro
4.4. Atualize metadados do livro
4.5. Visualize as alterações
4.6. Configurando o livro e os capítulos
4.6.1. Atualize o nome da disciplina
4.6.2. Criando um novo capítulo
4.6.3. Atualizando o conteúdo do novo capítulo
4.6.4. Planejamento & Acompanhamento
4.7. Configurando webhook
5. Portugues
5.1. Manuais gerais
5.2. Quando usar o ESTA, ESSA ou AQUELA
II. Ferramentas utilizadas no Processo de Produção
6. Instalação das Ferramentas
6.1. Requisitos mínimos
6.1.1. Criando conta de usuário no github
6.1.2. Instalando git no Linux
6.1.3. Instalando git(hub) no Windows
6.1.4. Instalando git no Mac
6.1.5. Configurando sua identidade
6.1.6. Editor de texto no Linux
6.1.7. Editor de texto no Windows
6.2. Instalando ambiente para desenvolvimento off-line
7. AsciiDoc cheatsheet
7.1. Configurando o Cabeçalho do livro
7.1.1. Alterando o título do livro
7.2. Seções
7.3. Estilos de parágrafos
7.4. Blocos
7.5. Text
7.6. Macros: Referencias, images & include
7.7. Código fonte de programas
7.7.1. Trecho de código
7.7.2. TABs, identação e estilos de códigos
7.8. Listas
7.9. Tabelas
7.10. Matemática
7.11. Comentários
8. Desenhando gráficos
8.1. Exemplos do graphviz
8.1.1. Grafos
8.2. Outros gráficos
8.2.1. Diagrama de Sequência
8.2.2. Diagramas usando ditaa
9. Vídeos
9.1. Problema da inserção de vídeos
9.2. Solução adota
9.2.1. Exemplo do vídeo
10. Git
10.1. Configurando o git com chave ssh
10.2. Configurando o git com cor no linux
10.3. Commit rápido
10.4. Scripts
10.4.1. Configuração dos scripts
10.4.2. git-producao
10.4.3. git-producao-local
10.4.4. git-local
10.4.5. git-livro
10.5. Configurações avançadas
10.6. Tags
10.6.1. Listando tags
11. Outras Ferramentas
11.1. Convertendo arquivos do Word para Asciidoc
11.2. Formatando código fonte
III. Utilizando o processo
12. Processo para os autores
12.1. Pense no livro como um software
12.2. Planjenando da produção do livro
12.3. Trabalhando num issue
12.4. Recebendo feedback durante a produção
12.5. Finalizando um capítulo
12.6. Finalizando o livro e obtendo o ISBN
12.7. Fase de Pós-produção
13. Autores avançados
13.1. Instalar o ambiente de produção local
13.2. Utilizar o git-producao-local
13.2.1. Gera o livro do arquivo de teste sem realizar commit
13.2.2. Commita, gera o livro com base no commit
IV. Implementação do processo
14. Criando um novo livro
14.1. Baixando o projeto
14.2. Criando a estrutura inicial do projeto
14.2.1. Gerando um pdf do livro (off-line)
14.2.2. Gerando o pdf do livro (off-line estilizado)
15. Instalando ambiente para desenvolvimento off-line
15.1. Instalando o git
15.2. Instalando o mercurial
15.3. Instalar o latex
15.4. Instalar o asciidoc e dbaltex
15.4.1. Removendo e atualizando o asciidoc e dbaltex
15.4.2. Instala nova versão do dblatex
15.4.3. Instala nova versão do asciidoc
15.5. graphviz
15.6. Instalando estilo do dblatex para geração do pdf estilizado
15.7. Instalação dos scripts cgi
15.7.1. Dependencia dos scripts
15.8. Instalando filtros do asciidoc
15.8.1. diag filter for Asciidoc
15.8.2. ditaa filter for AsciiDoc
15.8.3. ditaa filter for AsciiDoc
15.8.4. Criando link simbólico para o .asciidoc
16. Gerenciando versões dos livros
16.1. Sobre o versionamento dos livros
16.2. Antes de iniciar
16.2.1. Testando a configuração
16.2.2. Configurando caso o resultado não parecido com o esperado
16.3. Número da versão
16.4. Preparando o livro para a gráfica
16.4.1. Verifique pendências de revisão
16.4.2. Verifique pendências no issue track do projeto
16.4.3. Verifique as versões anteriores
16.4.4. Verificar o número da versão
16.4.5. Atualize o histórico de revisão
16.4.6. Atualize a ficha catalográfica
16.4.7. Verificando se há alterações pendentes
16.4.8. Gerando o livro
16.4.9. Aplicando uma tag
16.4.10. Excluindo uma tag
16.4.11. Verificando a tag aplicada
16.4.12. Submetendo tag para o github
16.5. Gerando versão do livro
16.6. Disponibilizando a release do livro
16.6.1. Atualizando livros.txt
16.6.2. Publicando atualização no facebook do curso
16.7. Criando estrutura de CD para enviar para a gráfica
16.7.1. Criando estrutura inicial do cd
16.7.2. Copiando os arquivos para dentro dos diretórios
16.8. Gerando a imagem do cd
V. Outras
17. Capacitação
17.1. Marcando uma capacitação
17.2. Instalar os softwares necessários no laboratório
17.3. Coffee Break
17.4. Auxiliares para o Ministrante
18. Visão técnica
18.1. Ferramentas utilizadas no processo
18.2. Escrevendo o livro
18.2.1. Iniciando um novo livro
18.3. Gerando edição para impressão
18.3.1. Revisando o livro
18.3.2. Fechando versão para impressão
18.4. Erratas dos livros
18.4.1. Onde encontrar a errata
18.4.2. Contribuindo com correções
18.4.3. Contribuindo com indicações de erros
18.5. Licença
19. Escrevendo um livro
19.1. Estrutura inicial do projeto
20. Inserindo caracteres especiais no texto
21. Comunicações
21.1. Capacitação
21.1.1. Convite e Agendamento para a capacitação
VI. Projetos e Pessoas
22. Projetos de produção de livros
22.1. Este manual
22.2. Licenciatura em Computação a Distância - UFPB
22.2.1. Período 1
22.2.2. Período 2
22.2.3. Período 3
22.2.4. Período 4
22.2.5. Período 5
22.2.6. Período 6
22.2.7. Período 7
22.2.8. Período 8
23. Pessoas

Lista de Figuras

1.1. Fluxo de trabalho, visão geral.
2.1. Página do repositório deste livro
2.2. Geração do PDF através do Servidor da Produção
2.3. Tela de geração do PDF
2.4. Commitando com o gitg no linux
2.5. Sistema de gerenciamento de erros do github
2.6. Sequencia das operações
4.1. Exemplo do Issue de Planejamento de conclusão dos capítulos
4.2. Configurando webhook no github
6.1. Highlight do plugin no gedit
6.2. Highlight do plugin no Notepad++
7.1. Exemplo de imagem
8.1. Exemplo de grafo.
8.2. Exemplo de grafo (width="50%")
8.3. Com tamanho menor
8.4. Tipo barramento
8.5. Blocks
8.6. Round corners
8.7. Color
8.8. Color codes
8.9. Dashed lines
8.10. Point markers
8.11. Text handling
8.12. Flowchart
8.13. Shapes
18.1. Fluxo de trabalho, visão técnica.

Lista de Tabelas

7.1. Labeled horizontal
7.2. An example table
7.3. CSV data, 15% each column
7.4. Multiline cells, row/col span

Lista de Exemplos

7.1. Titulo do bloco de exemplo

Lista de Equações

7.1. Uma equação qualquer.