Embed Size (px)
Citation preview
Processo de Produção i
Processo de Produção
Ed. v1.0
Processo de Produção ii
Copyright © 2013 UAB
Você tem a liberdade de:
Compartilhar — copiar, distribuir e transmitir a obra.
Remixar — criar obras derivadas.
Sob as seguintes condições:
Atribuição — Você deve creditar a obra da forma especificada pelo autor ou licenciante (mas nãode maneira que sugira que estes concedem qualquer aval a você ou ao seu uso da obra).
Uso não comercial — Você não pode usar esta obra para fins comerciais.
Compartilhamento pela mesma licença — Se você alterar, transformar ou criar em cima destaobra, você poderá distribuir a obra resultante apenas sob a mesma licença, ou sob uma licençasimilar à presente.
Para maiores informações consulte: http://creativecommons.org/licenses/by-nc-sa/3.0/br/ .
Processo de Produção iii
REVISION HISTORY
NUMBER DATE DESCRIPTION NAME
v1.0 Março 2013 Primeira versão do livro Eduardo deSantanaMedeirosAlexandre
Processo de Produção iv
Sumário
I O Processo de Produção 1
1 Visão Geral do Processo de Produção 3
2 Início rápido 5
2.1 Vídeo demonstrando as instruções deste capítulo . . . . . . . . . . . . . . . . . . . 5
2.2 Acesse o repositório deste manual . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.3 Gerando o PDF através do Servidor da Produção . . . . . . . . . . . . . . . . . . . 6
2.4 Explorando a estrutura de diretórios do projeto . . . . . . . . . . . . . . . . . . . . 9
2.5 Realizando um fork no projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.6 Clonando o repositório do projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.6.1 Clonando através da linha de comando . . . . . . . . . . . . . . . . . . . . 10
2.6.2 Clonando usando interface gráfico (no windows) . . . . . . . . . . . . . . . 10
2.7 Realizando alteração no projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.8 Comitando as alterações . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.8.1 No linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.9 Realize um push . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.10 Gerando nova versão do livro com as alterações realizadas . . . . . . . . . . . . . . 12
2.11 Realizando um pull-request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.12 Reportando sugestões, erros ou críticas . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.13 Resumo técnico do processo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.14 Recapitulando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3 Capacitação 15
3.1 Marcando uma capacitação . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.2 Instalar os softwares necessários no laboratório . . . . . . . . . . . . . . . . . . . . 15
3.3 Coffee Break . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.4 Auxiliares para o Ministrante . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3.5 Slides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Processo de Produção v
4 Revisão de conteúdo anterior 17
4.1 Benefícios desta etapa de revisão . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.2 Escolhendo um conteúdo para revisar . . . . . . . . . . . . . . . . . . . . . . . . . 17
4.3 Realize um fork do projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.4 Clone o projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.5 Realize a sua contribuição . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.6 Visualizando sua revisão . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.7 Submetendo sua revisão . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.8 Recapitulando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
5 Iniciando um livro 20
5.1 Repositório do seu livro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
5.2 Estrutura inicial dos projetos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
5.3 Gere o pdf inicial do livro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
5.4 Atualize metadados do livro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
5.5 Visualize as alterações . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
5.6 Configurando o livro e os capítulos . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
5.6.1 Atualize o nome da disciplina . . . . . . . . . . . . . . . . . . . . . . . . . 34
5.6.2 Criando um novo capítulo . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
5.6.3 Atualizando o conteúdo do novo capítulo . . . . . . . . . . . . . . . . . . . 35
6 Visão técnica 37
6.1 Ferramentas utilizadas no processo . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
6.2 Escrevendo o livro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
6.2.1 Iniciando um novo livro . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
6.3 Gerando edição para impressão . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
6.3.1 Revisando o livro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
6.3.2 Fechando versão para impressão . . . . . . . . . . . . . . . . . . . . . . . . 38
6.4 Erratas dos livros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
6.4.1 Onde encontrar a errata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
6.4.2 Contribuindo com correções . . . . . . . . . . . . . . . . . . . . . . . . . . 38
6.4.3 Contribuindo com indicações de erros . . . . . . . . . . . . . . . . . . . . . 38
6.5 Licença . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
7 Escrevendo um livro 39
7.1 Estrutura inicial do projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
8 Inserindo caracteres especiais no texto 40
Processo de Produção vi
9 Comunicações 419.1 Capacitação . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
9.1.1 Convite e Agendamento para a capacitação . . . . . . . . . . . . . . . . . . 41
II Ferramentas utilizadas no Processo de Produção 43
10 Instalação das Ferramentas 4410.1 Requisitos mínimos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
10.1.1 Criando conta de usuário no github . . . . . . . . . . . . . . . . . . . . . . 44
10.1.2 Instalando git no Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
10.1.3 Instalando git(hub) no Windows . . . . . . . . . . . . . . . . . . . . . . . . 45
10.1.4 Instalando git no Mac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
10.1.5 Configurando sua identidade . . . . . . . . . . . . . . . . . . . . . . . . . . 45
10.1.6 Editor de texto no Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
10.1.7 Editor de texto no Windows . . . . . . . . . . . . . . . . . . . . . . . . . . 46
10.2 Instalando ambiente para desenvolvimento off-line . . . . . . . . . . . . . . . . . . 47
11 AsciiDoc cheatsheet 4811.1 Seções . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
11.2 Parágrafos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
11.3 Blocos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
11.4 Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
11.5 Macros: Referencias, images & include . . . . . . . . . . . . . . . . . . . . . . . . 51
11.6 Código fonte de programas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
11.6.1 Trecho de código . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
11.7 Listas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
11.8 Tabelas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
11.9 Matemática . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
11.10Comentários . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
12 Desenhando gráficos 5912.1 Exemplos do graphviz . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
12.1.1 Grafos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
13 Git 6413.1 Configurando o git com chave ssh . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
13.2 Configurando o git com cor no linux . . . . . . . . . . . . . . . . . . . . . . . . . . 65
13.3 Commit rápido . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
13.4 Configurações avançadas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Processo de Produção vii
14 Outras Ferramentas 66
14.1 Convertendo arquivos do Word para Asciidoc . . . . . . . . . . . . . . . . . . . . . 66
III Implementação do processo 67
15 Criando um novo livro 69
15.1 Baixando o projeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
15.2 Criando a estrutura inicial do projeto . . . . . . . . . . . . . . . . . . . . . . . . . . 69
15.2.1 Gerando um pdf do livro (off-line) . . . . . . . . . . . . . . . . . . . . . . . 70
15.2.2 Gerando o pdf do livro (off-line estilizado) . . . . . . . . . . . . . . . . . . 70
16 Instalando ambiente para desenvolvimento off-line 71
16.1 Instalando o git . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
16.2 Instalando o mercurial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
16.3 Instalar o latex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
16.4 Instalar o asciidoc e dbaltex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
16.4.1 Removendo e atualizando o asciidoc e dbaltex . . . . . . . . . . . . . . . . 72
16.4.2 Instala nova versão do dblatex . . . . . . . . . . . . . . . . . . . . . . . . . 72
16.4.3 Instala nova versão do asciidoc . . . . . . . . . . . . . . . . . . . . . . . . . 72
16.5 graphviz . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
16.6 Instalando estilo do dblatex para geração do pdf estilizado . . . . . . . . . . . . . . 73
16.7 Instalação dos scripts cgi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
IV Projetos e Pessoas 74
17 Projetos de produção de livros 76
17.1 Este manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
17.2 Licenciatura em Computação a Distância - UFPB . . . . . . . . . . . . . . . . . . . 76
17.2.1 Período 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
17.2.2 Período 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
17.2.3 Período 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
17.2.4 Período 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
17.2.5 Período 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
17.2.6 Período 6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
17.2.7 Período 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
17.2.8 Período 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Processo de Produção viii
18 Pessoas 80
19 Índice Remissivo 81
Processo de Produção 1 / 81
Parte I
O Processo de Produção
Processo de Produção 2 / 81
Nesta parte apresentamos o processo de produção de livros adotado pelo nosso curso.
O primeiro capítulo apresenta rapidamente o processo geração dos livros a partir dos arquivos envia-dos para o Servidor de Produção.
Em seguida, apresentamos uma visão geral do fluxo de trabalho da produção dos livros.
Os capítulos seguintes apresentam detalhes sobre sobre o fluxo e as ferramentas utilizadas na produ-ção.
Processo de Produção 3 / 81
Capítulo 1
Visão Geral do Processo de Produção
Este capítulo demonstra uma visão geral de um Processo de Produção de materiais didáticos propostoe adotado no Curso de Licenciatura em Computação a distância na Universidade Federal da Paraíba.
A figura abaixo ilustra nosso processo de produção.
Figura 1.1: Fluxo de trabalho, visão geral.
A lista abaixo resume as etapas do processo:
Processo seletivo de autoresNesta etapa a coordenação divulga um processo seletivo e os autores são selecionados conformeo edital.
CapacitaçãoA capacitação é iniciada com apresentação do processo, e as ferramentas necessárias. Emseguida, uma revisão inicia o autor no processo de produção. Ao final da capacitação, cadaautor terá iniciado a produção de seu livro.
Capacitação dos autoresOs autores selecionados receberão capacitação sobre o processo e as ferramentas utiliza-das na produção (ver Seção 6.1 [37]).
Processo de Produção 4 / 81
Revisão de conteúdoDurante a capacitação, antes de iniciar a escrita, o novo autor é convidado a revisar umcapítulo das disciplinas relacionadas, já escritas anteriormente. Esta revisão é uma etapaeducativa e que possibilita:
1. Aprimorar os conteúdos já elaborados, contribuindo com sua qualidade;2. Tornar o autor ciente de como os conteúdos foram apresentados para os alunos;3. Integração entre os autores da mesma area.4. Introduzir, para o autor, as ferramentas necessárias para a produção;5. Conscientizar o autor sobre os direitos autorais dos livros;
Iniciando o livroNesta etapa o autor irá baixar o projeto do seu livro, configurar o título, autor, e outrospassos inicias.
EscritaNeste etapa o autor escreve os capítulos, elabora gráficos e está frequente enviando seu pro-gresso.
Envia conteúdoEste envio frequente possui várias utilizades:
1. Permite que os outros autores conheçam a estrutura do seu conteúdo e possam referenciarseu material;
2. Permite o editor intervenha na elaboração, seja realizando nova capacitação ou infor-mando sobre conteúdos semelhantes já abordados nos outros livros.
3. Acompanhamento do progresso para verificar necessidade de ajuda na escrita (co-autores).
4. Possibilitar antecipar o trabalho do revisor. Quando os capítulos vão sendo finalizados, orevisor pode iniciar a revisão neles.
5. Garantir backup dos conteúdos escritos.
Revisão do textoQuando um autor termina um capítulo, os revisores são acionados para realizarem as revisõesno texto referido.
Gerar ediçãoQuando os autores e o revisor finalizam seus trabalhos, o editor gera versão para impressão.
Contribuições para a ErrataDepois do livro impresso, tanto os autores como os leitores podem contribuir para a construçãoda errata. Os leitores devem ser incentivados a enviarem correções dos erros encontrados noslivros.
Manutenção da ErrataCom base nas correções enviadas, o editor mantém uma errata do livro atualizada.
O processo que propomos é assistido por diversas ferramentas. No próximo capítulo apresentaremoscomo utilizar as ferramentas necessárias para a produção dos livros.
Processo de Produção 5 / 81
Capítulo 2
Início rápido
OBJETIVOS DO CAPÍTULO
Ao final deste capítulo você deverá ser capaz de:
• Gerar PDFs dos livros a partir de seus repositórios• Realizar forks em projetos no github• Clonar repositórios, baixando seus conteúdos para seu computador• Realizar alterações nos capítulos dos livros• Enviar alterações para o github• Verificar as alterações realizadas no PDF gerado• Submeter as alterações ao repositório pai, através de um Pull Request• Submeter críticas e sugestões sobre um livro.
Esta seção contém é um guia rápido para iniciar os autores/contribuidores no Processo de Produção.
Nós iremos baixar o projeto deste manual, e editar o capítulo Capítulo 18 [80] incluindo nosso nomeà lista de nomes contida no capítulo referido.
As seções a seguir, ensinarão como realizar esta tarefa.
Instalação do ambiente mínimo de produçãoPara você poder prosseguir com as instruções deste capítulo você deve primeiro instalar oambiente mínimo de produção. Consulte as instruções de instalação em Seção 10.1 [44].Não prossiga enquanto não possuir o ambiente instalado e configurado.
2.1 Vídeo demonstrando as instruções deste capítulo
Para facilitar o entendimento deste capítulo, nós produzimos um vídeo demonstrando como realizaras instruções deste capítulo.
O vídeo está disponível em: http://youtu.be/uDMs-TyjSek.
DicaEmbora o livro demonstre como realizar o processo é importante ler este capítulo prestandobastante atenção em todas as informações.
Processo de Produção 6 / 81
2.2 Acesse o repositório deste manual
NotaUm repositório é um local onde são armazenados os arquivos de um projeto, neste caso,todos os textos e imagens necessários para produzir este manual.
Nossa primeira atividade será acessar o repositório deste manual que você está lendo:
REPOSITÓRIO DESTE MANUAL NO GITHUB
https://github.com/edusantana/producao-computacao-ead-ufpb.
Figura 2.1: Página do repositório deste livro
DicaNeste momento não é necessário explorar o repositório, basta saber que ele existe e que otexto que gera este manual está lá. Você utilizará o endereço deste repositório na próximaseção para gerar o pdf.
2.3 Gerando o PDF através do Servidor da Produção
Nesta seção nós iremos aprender como gerar o PDF deste manual. A geração do PDF é através deuma operação no Servidor da Produção.
Para gerar o PDF precisamos informar qual o repositório que contém o livro que desejamos gerar,neste caso, portanto, precisamos informar o endereço do repositório acessado na seção anterior.
Processo de Produção 7 / 81
Importante
Servidor da ProduçãoEndereço da operação de geração de pdfs no servidor: http://150.165.237.17/-github.html.
Repositório deste manualÉ o mesmo endereço utilizado na seção anterior: https://github.com/edusantana/-producao-computacao-ead-ufpb
Acesse o servidor da produção, informe o repositório deste manual e gere o pdf do livro (ver Figura 2.2[7]).
Figura 2.2: Geração do PDF através do Servidor da Produção
Aguarde alguns instantes enquanto o PDF é gerado.
Processo de Produção 8 / 81
Figura 2.3: Tela de geração do PDF
DicaMatenha o hábito de verificar os logs gerados para certifica-se que não houve erros ou WAR-NINGs.
Depois da geração do pdf:
1. Clique no último link, producao-computacao-ead-ufpb (no topo da página).
2. Clique no diretório livro
3. Clique em livro.pdf para baixar o livro gerado.
ImportanteCaso não compreendeu como encontrar o PDf, consulte o vídeo (Seção 2.1 [5]) no iníciodeste capítulo.
NotaPronto! Você conseguiu gerar o PDF através dos arquivos que estavam no servidor. O nossotrabalho consistirá em enviar nossas alterações para o servidor e verificar o resultado final apartir da geração do PDF.
Na próxima seção iremos aprender a estrutura de diretórios dos projetos e o papel de alguns arquivos.
Processo de Produção 9 / 81
2.4 Explorando a estrutura de diretórios do projeto
No github ou no servidor da produção, explore a estrutura do projeto.
Estrura deste projeto
|-- cgi/|-- dblatex-computacao-ufpb/|-- estrutura-inicial/ x1|-- livro/| |-- capitulos/ x2| | ‘-- code/ x3| | ‘-- editoracao.asc| | ‘-- graficos.asc| | ‘-- inicio-rapido.asc x4| | ‘-- pessoas.asc x5| | ‘-- projetos.asc| | ‘-- usuario.asc| |-- images/ x6| |-- slides/ x7| |-- livro.asc x8| |-- docinfo.xml x9| ‘-- slides.asc x10
|-- livro/‘-- README.asciidoc
x1 Estrutura padrão de novos projetos.x2 Todos os capítulos são criados neste diretório.x3 Os imagens códigos fontes dos exemplos são organizadas em subdiretórios deste diretório.x4 Arquivo fonte deste capítulo.x5 Capítulo que iremos editar mais adiante (Seção 2.7 [11]).x6 As imagens do livro são organizadas em subdiretórios deste diretório.x7 , x10 Necessários para criação dos slides.x8 Ponto de partida do livro. Onde todos os capítulos são incluídos.x9 Arquivo contendo alguns metadados, como os nomes dos autores.
2.5 Realizando um fork no projeto
NotaCertifique-se que esteja logado no github com seu usuário antes de realizar o fork.
Processo de Produção 10 / 81
Na página inicial do projeto, no github, clique em Fork para gerar um fork do projeto para você. Ofork é necessário quando desejamos realizar alterações nos repositórios alheios.
DicaA ajuda do github pode conter informações para auxiliar na realização do fork:https://help.github.com/articles/fork-a-repo.
Quando você realiza um fork do repositório, o github irá criar um outro repositório onde somentevocê possui permissão de escrita.
Diferença dos repositórios após o forkhttp://github.com/edusantana/producao-computacao-ead-ufpb (read only)http://github.com/camyle/producao-computacao-ead-ufpb (depois do fork)
2.6 Clonando o repositório do projeto
A operação de clone baixa todos os arquivos do projeto para o seu disco local.
Como iremos realizar uma alteração no manual, precisaremos baixar os arquivos do projeto, clonandoo fork.
2.6.1 Clonando através da linha de comando
Em um diretório onde você deseja baixa o projeto, execute o seguinte comando:
git clone https://github.com/seu-usuario/producao-computacao-ead-ufpb ←↩.git
CuidadoNa operação de clone, o endereço clonado termina com .git.
2.6.2 Clonando usando interface gráfico (no windows)
ImportanteO vídeo no início do capítulo (Seção 2.1 [5]) demonstra todas as etapas necessária no win-dows.
Clique e arraste o endereço do repositório no github para o programa do github para o windows.
DicaO ajuda do github pode lhe auxiliar nesta tarefa: http://windows.github.com/help.html
Processo de Produção 11 / 81
2.7 Realizando alteração no projeto
NotaNeste momento, assumimos que você possui um editor de texto com highlight reconhecendoa linguagem asciidoc. Caso contrário, consulte Seção 10.1 [44] para efetuar a instalação.
Após realizar o clone do projeto, encontre o arquivo livro/capitulos/pessoas.asc em seucomputador. Abra-o para edição.
DicaNo windows, clique com o botão direito no repositório e escolha "Open with Explorer"para irpara o diretório onde o github salva os arquivos: Documentos\Github.
Com o arquivo aberto, adicione o seu nome à lista. Por exemplo, adicionando Camyle:
. Camyle de Araújo Silva -- *Revisora Ortográfica*, ‘2013.1‘.
2.8 Comitando as alterações
O git funciona com múltimos repositórios. Quando nós clonamos um projeto, nós envolvemos doisrepositórios nesta operação:
O repositórioremoto
É o github. Onde os arquivos são salvos e disponibilizados para qualquerusuário com conexão a internet pode acessa-lo.
O repositóriolocal
Localizado em nosso computador. Mantém os arquivos orginais e todas asalterações que realizamos.
Antes de submeter nossas alterações para o repositório remoto, precisamos primeiro submete-las parao repositório local. Esta operação é conhecida por Commit.
Agora devemos submeter nossa alteração primeiro para o repositório local, realizando um commit.
2.8.1 No linux
Execute o comando dentro de qualquer diretório do projeto:
Ferramenta para realizar o commit
gitg
Marque os arquivos modificados (pessoas.asc) para stage, e adicione um comentário do commit, ex:"Inclusão do nome Camyle".
Processo de Produção 12 / 81
Figura 2.4: Commitando com o gitg no linux
O próximo passo será submeter os nossos commits para o servidor remoto, através de uma operaçãochamada de push.
2.9 Realize um push
Um push envia as alterações comitadas em seu repositório local para o servidor remoto (o github).
Comando para realizar push no linux
git push
No github do windows, esta operação é conhecida por Sync.
2.10 Gerando nova versão do livro com as alterações realizadas
ImportantePercebam que qualquer alteração realizada foi feita no seu fork. Portanto, a geração do livrodeverá ocorrer com o novo endereço.
https://github.com/camyle/producao-computacao-ead-ufpb (seu fork ←↩)
https://github.com/edusantana/producao-computacao-ead-ufpb ( ←↩original)
Re-execute a geração do livro (Seção 2.3 [6]) com o novo endereço do repositório forkado. Se vocênão lembra onde encontrar livro.pdf consulte Seção 2.3 [6].
Processo de Produção 13 / 81
DicaCaso sua alteração não apareça reveja suas ações:
1. Você realizou o commit com o arquivo modificado?
2. Você esqueceu de realizar o git push?
3. Você lembrou de informar o novo endereço contendo o nome do seu usuário?
4. Os logs da geração informou algum erro?
5. Seu navegador está retornando uma versão antiga do cache? Clique em atualizar!
2.11 Realizando um pull-request
Agora que verificou que sua alteração foi inserida com sucesso, é o momento de enviar as alteraçõespara o projeto original.
Clique em Pull Request, no github, para enviar as alterações para o projeto original.
As alterações enviadas não são incorporadas imediatamante, elas ficam em suspenso até que o res-ponsável pelo repositório (o Editor) aceite o Pull Request.
2.12 Reportando sugestões, erros ou críticas
Em qualquer momento da produção do livro, qualquer usuário pode submeter sugestões, erros oucríticas. O github possui um sistema de gerenciamento de erros/tarefas (issue tracking) onde osusuários podem submetê-los.
ImportanteAdicione uma crítica no issue tracking deste manual! Acesse https://github.com/edusantana/-producao-computacao-ead-ufpb. Clique em Issues, em seguida em New Issue (Figura 2.5[13]). Escreva a sua crítica e clique em Submit new Issue.
Figura 2.5: Sistema de gerenciamento de erros do github
Processo de Produção 14 / 81
DicaÉ importante isentivar os leitores a submeter críticas para que os livros estejam sempresendo aprimorados.
2.13 Resumo técnico do processo
O processo técnico está ilustrado em Figura 2.6 [14] e pode ser resumido em:
1. Realiza fork
2. Gera PDF
3. Realiza alterações
4. Commita e Sincroniza (push)
5. Gera PDF com as alterações
6. Realiza um Pull Request
Figura 2.6: Resumo técnico do fluxo de trabalho
2.14 Recapitulando
Este capitulo apresentou, de forma rápida, como funciona o processo de produção descrito nestemanual.
Nos próximos capítulos iremos descrever com mais detalhes cada uma das partes do Processo deProdução.
Processo de Produção 15 / 81
Capítulo 3
Capacitação
Na seção anterior (Capítulo 2 [5]) foi informado que os autores dos livro iriam receber uma capacita-ção antes de iniciar a produzir os livros.
Este capítulo matém informações sobre esta etapa.
3.1 Marcando uma capacitação
Antes de marcar uma capacitação talvez será necessário consultar os autores (também chamados deprofessores conteudistas) para agendar um dia em que a maioria possa participar.
Com a data marcada, reserve um laboratório que comporte o público esperado.
Estenda o convite aos professores que não são conteudistas, a tutores que também possam estar in-teressados. Pois embora o público álvo seja os conteudistas, as outras pessoas podem aprender oProcesso de Produção e contribuir com melhorias nos materiais produzidos.
Preparamos uma recomendação de texto (Seção 9.1.1 [41]) que pode ser enviada por e-mail aosparticipantes da capacitação. O texto tem o propósito de agendar a reunião, e conter intruções que osprofessores podem realizar para se preparar para a reunião.
3.2 Instalar os softwares necessários no laboratório
Certifique-se de que os computadores possuem as ferramentas mínimas necessárias (Seção 10.1 [44])para a produção dos materiais.
Lembre-se que as vezes os computadores não possuem permissão para instalar aplicativos, sendonecessário contactar os responsáveis antecipadamente.
3.3 Coffee Break
A capacitação terá Coffee Break?
Caso a reunião tenha Coffee Break, organize-se para providenciar a compra e a entrega no horário elocal da capacitação.
Lista de perguntas a se fazer:
Processo de Produção 16 / 81
• O ambiente possui mesa para servir?
• Quem irá levar os copos descartáveis?
3.4 Auxiliares para o Ministrante
Durante uma capacitação é muito importante contar com a presença de outras pessoas, que tenhamconhecimentos técnicos de informática, para auxiliar o ministrante da capacitação. O ideal é que sejaalguém que também conheça o Processo de Produção.
Estas pessoas irão auxiliar os participantes nas realizações das atividades durante a capacitação, porexemplo:
• Como iniciar a máquina no Windows/Linux
• Como inserir um comando
• Como realizar as instruções apresentadas na capacitação
• Mostrar os erros cometidos pelos participantes ao seguir as instruções
Durante a capacitação o ministrante costuma ser bastante solicitado, portanto esta pessoa irá dividiras demandas.
3.5 Slides
Os slides deste livro foram feitos com o propósito de ser utilizados na capacitação.
Os slides contém as propostas de atividades para serem realizadas durante a capacitação.
DicaOs slides podem ser consultados em http://150.165.237.17/books/edusantana/producao-computacao-ead-ufpb/livro/slides.html
Processo de Produção 17 / 81
Capítulo 4
Revisão de conteúdo anterior
OBJETIVOS DO CAPÍTULO
Ao final deste capítulo você deverá ser capaz de:
• Realizar contribuições em livros previamente escritos
• Realizar uma revisão num capítulo
Nesta etapa do processo ocorre durante a capacitação. O novo autor é convidado a revisar um capítulode um livro produzido anteriormente.
4.1 Benefícios desta etapa de revisão
1. Tornar o autor ciente de como os conteúdos foram escritos;
2. Aprimorar os conteúdos já elaborados, contribuindo com sua qualidade;
3. Integração entre os autores da mesma area.
4. Introduzir, para o autor, as ferramentas necessárias para a produção;
5. Conscientizar o autor sobre os direitos autorais dos livros;
4.2 Escolhendo um conteúdo para revisar
Escolha um repositório de uma disciplina que você tem afinidade em Seção 17.2 [76].
NotaVocê não precisará revisar todo o livro, basta escolher um capítulo como amostra.
Processo de Produção 18 / 81
4.3 Realize um fork do projeto
Para poder obter um repositório com permissão de escrita (modificar), é necessário realizar um forkno projeto desejado.
NotaVocê já realizou um fork antes (Seção 2.5 [9]), mas agora precisa fazer no livro que escolheupara revisar.
4.4 Clone o projeto
Após realizar o fork, você poderá baixar o projeto realizando a operação de clone (Seção 2.6 [10]) doprojeto.
4.5 Realize a sua contribuição
Nós temos as seguintes sugestões de como você pode contribuir:
Correção de textoBasta atualizar o texto.
Incluindo comentáriosVocê pode inserir diversos comentários (Seção 11.10 [58]) no texto que está sendo revisado.
4.6 Visualizando sua revisão
Para visualizar suas alterações é necessário:
1. Comitar as alterações (Seção 2.8 [11])
2. Enviar os commits para o seu fork (Seção 2.9 [12])
3. Utilizar o Servidor da Produção para gerar o pdf (Seção 2.10 [12])
DicaMesmo que você tenha contribuido somente com comentários, é um bom hábito sempreverificar o resultado final.
4.7 Submetendo sua revisão
Após terminar suas contribuições, você deve realizar um Pull Request (Seção 2.11 [13]) para dispo-nibilizar suas alterações no repositório de origem.
Processo de Produção 19 / 81
4.8 Recapitulando
Neste capítulo você teve a oportunidade de conhecer o trabalho de outro autor e contribuir com otrabalho realizado.
Processo de Produção 20 / 81
Capítulo 5
Iniciando um livro
OBJETIVOS DO CAPÍTULO
Ao final deste capítulo você deverá ser capaz de:
• Configurar um novo livro
• Alterar conteúdo inicial do livro
• Adicionar novos capítulos ao livro
• Consultar manuais
• Como solicitar ajuda
Após a revisão de um capítulo de outro autor, você agora já teve experiência em participar na produçãode um livro em produção utilizando o nosso processo.
Esta etapa do processo ocorre durante a capacitação. Nela você irá aprender como configurar umnovo livro e iniciar sua escrita.
5.1 Repositório do seu livro
Todo livro possui um repositório único, um local para armazenar os arquivos diferente de todos osoutros livros.
Durante a capacitação os autores devem conhecer o endereço do seu repositório. Consulte Seção 17.2[76] para saber o seu. Caso você tenha dúvidas em saber qual é o seu, consulte o editor durante acapacitação.
ImportanteO autor deve receber um repositório não vazio, com um conjunto de arquivos e diretórios quechamandos de estrutura-inicial. O processo de replicar uma estrutura inicial nos repositó-rios está descrito em Seção 15.2 [69]. No entanto, o autor não deve se preocupar com isto,pois é esperado que este passo já tenha sido executado para ele.
Processo de Produção 21 / 81
5.2 Estrutura inicial dos projetos
Todo novo projeto possui uma estrutura inicial criada para o autor.
1. Realize um fork do seu repositório (Seção 2.5 [9])
2. Baixe o seu projeto realizando um clone do seu repositório forkado (Seção 2.6 [10]).
3. Abra o diretório onde o projeto foi baixado e perceba a estrutura inicial do projeto.
Estrutura inicial dos projetos|-- livro/| |-- capitulos/| | |-- code/| | | ‘-- helloworld.c| | |-- asciidoc-cheatsheet.asc| | |-- novo-capitulo.asc| | ‘-- prefacio.asc| |-- images/| | ‘-- novo-capitulo| | ‘-- bug.png| |-- slides/| | ‘-- gerando-slides.asc| |-- livro.asc| |-- docinfo.xml| ‘-- slides.asc‘-- README.asciidoc
5.3 Gere o pdf inicial do livro
Sem realizar nenhuma alteração, gere o pdf do livro (Seção 2.10 [12]) para verificar a versão inicial.
DicaLembre-se de que o PDF gerado é do repositório do seu fork.
5.4 Atualize metadados do livro
Abra o arquivo livro/docinfo.xml e atualize o seu nome na lista de autores.
Conteúdo do arquivo livro/docinfo.xml<!--rudder-doc-docinfo.xmlDocBook document information file for rudder-doc.txt.
--><edition>v1.0</edition>
Processo de Produção 22 / 81
<revhistory><revision>
<revnumber>v1.0</revnumber><date>Março 2013</date><authorinitials>Autor 1, Autor 2</authorinitials><revremark>Primeira versão do livro
</revremark></revision>
</revhistory>
<authorgroup><author>
<firstname>Nome</firstname><surname>Sobrenome</surname><affiliation><jobtitle>Professor</jobtitle><orgname>Universidade Federal da Paraíba</orgname>
</affiliation><authorblurb><para>
Principal contribuidor do livro.</para>
</authorblurb></author>
</authorgroup>
<othercredit><firstname>Eduardo</firstname><surname>Medeiros</surname><othername>Santana</othername>
<contrib>Editor</contrib></othercredit>
<copyright><year>2013</year><holder>UAB</holder>
</copyright>
<legalnotice><simpara>
Você tem a liberdade de:</simpara><simpara>
Compartilhar -- copiar, distribuir e transmitir a obra.</simpara><simpara>
Remixar -- criar obras derivadas.</simpara><simpara>
Sob as seguintes condições:
Processo de Produção 23 / 81
</simpara><simpara>Atribuição -- Você deve creditar a obra da forma especificada pelo ←↩
autor ou licenciante (mas não de maneira que sugira que estes ←↩concedem qualquer aval a você ou ao seu uso da obra).
</simpara><simpara>
Uso não comercial -- Você não pode usar esta obra para fins ←↩comerciais.
</simpara><simpara>
Compartilhamento pela mesma licença -- Se você alterar, ←↩transformar ou criar em cima desta obra, você poderá ←↩distribuir a obra resultante apenas sob a mesma licença, ou ←↩sob uma licença similar à presente.
</simpara><simpara>
Para maiores informações consulte: http://creativecommons.org/ ←↩licenses/by-nc-sa/3.0/br/ .
</simpara></legalnotice>
Não se deixe intimidar pelo tamanho do arquivo, apenas atualize o seus dados:
Seção do arquivo onde configurar os autores<authorgroup><author>
<firstname>Nome</firstname><surname>Sobrenome</surname><affiliation>
<jobtitle>Professor</jobtitle><orgname>Universidade Federal da Paraíba</orgname>
</affiliation><authorblurb>
<para>Principal contribuidor do livro.
</para></authorblurb>
</author></authorgroup>
5.5 Visualize as alterações
Realize as seguintes instruções para gerar e visualizar o pdf com suas alterações.
1. Commite e sincronize (push) as alterações (Seção 2.8 [11] e Seção 2.9 [12]). Para agilizar oenvio consulte Seção 13.3 [65].
2. Gere uma versão do PDF através do Servidor da Produção (Seção 2.10 [12]).
3. Abra o PDF gerado e verifique a alteração.
Processo de Produção 24 / 81
5.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:
• Nome da disciplina do livro
• Capítulos do livro
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:
[[prefacio]][preface]== Prefácio
texto
=== Público alvo
estudantes
=== Método de Elaboração
Financiamento da capes.
=== Contribuição
Erros e etc.
// Sempre termine os arquivos com uma linha em branco.
////= Nome da Parte =////
== Novo capítulo
.Objetivos do capítulo____________________Ao final deste capítulo você deverá ser capaz de:
Processo de Produção 25 / 81
* objetivo 1
* objetivo 2
* objetivo N____________________
Neste lugar você deve apresentar o conteúdo em forma de diálogo.
NOTE: Para começar a escrever um novo capítulo, copie este arquivo esalve com outro nome (não utilize espaço no nome do arquivo). Em ←↩
seguida,atualize o arquivo *livro.asc* para incluir o novo arquivo criado.Consulte o manual.
=== Minha primeira seção
Texto da sua seção.
==== Exemplo de subseçãoTexto da subseção.
=== Minha segunda seção
Texto da sua seção.
=== Recapitulando
Revisão do que foi aprendido.
Reserve o último parágrafo para realizar uma *ponte* para o próximo ←↩capítulo.
=== Atividades
. Texto da atividade.
. Texto da atividade.
. Texto da atividade.
CAUTION: *Sempre termine os arquivos com uma linha em branco*, casocontrário você poderá encontrar erros inesperados.
// Sempre terminar o arquivo com uma nova linha.
== AsciiDoc cheatsheet
A melhor forma de aprender o asciidoc é consultando o site oficial.
Sumário das funcionalidades::http://xpt.sourceforge.net/techdocs/nix/tool/asciidoc-syn/ascs01- ←↩
Processo de Produção 26 / 81
AsciiDocMarkupSyntaxQuickSummary/single/AsciiDoc cheatsheet:: http://powerman.name/doc/asciidocSite oficial:: http://www.methods.co.nz/asciidoc/Exemplo de livro:: https://asciidoc.googlecode.com/hg/doc/book.txtGuida do usuário:: http://www.methods.co.nz/asciidoc/userguide.htmlMatemática:: http://www.methods.co.nz/asciidoc/latexmath.pdfFAQ:: http://www.methods.co.nz/asciidoc/faq.html
=== Seções
----== Nível de capítulo (section) 1Texto.
=== Nível de subseção 2Texto.
==== Level 3Texto.
===== Level 4Texto.----
CAUTION: Não pode existir seções sem texto. Sempre coloque algum texto ←↩,
caso contrário o arquivo não será gerado.
=== Parágrafos
.Título do parágrafo opcional
Texto do parágrafoaqui.
.Título do parágrafo opcional
Texto do parágrafo aqui.Precisa começar com espaço em branco.
.Optional Title
[source,perl]die ’connect: ’.$dbh->errstr;
Este parágrafo não faz parte do código.
.Optional TitleNOTE: This is an example
single-paragraph note.
.Optional Title
Processo de Produção 27 / 81
[NOTE]This is an examplesingle-paragraph note.
TIP: Texto.
IMPORTANT: Texto.
WARNING: Texto.
CAUTION: Texto.
=== Blocos
.Optional Title----
*Listing* Block
Use: code or file listings----
.Optional Title[source,perl]----# *Source* block# Use: highlight code listings# (require ‘source-highlight‘ or ‘pygmentize‘)use DBI;my $dbh = DBI->connect(’...’,$u,$p)
or die "connect: $dbh->errstr";----
.Optional Title
*****Sidebar* Block
Use: sidebar notes :)
****
.Optional Title==========================
*Example* Block
Use: examples :)
Default caption "Example:"can be changed using
[caption="Custom: "]
before example block.==========================
Processo de Produção 28 / 81
.Optional Title[NOTE]===============================
*NOTE* Block
Use: multi-paragraph notes.===============================
////
*Comment* block
Use: hide comments////
.Optional Title
....
*Literal* Block
Use: workaround when literalparagraph (indented) like1. First.2. Second.
incorrectly processed as list.....
.Optional Title[quote, cite author, cite source]____
*Quote* Block
Use: cite somebody____
[[texto-secao]]=== Text
forçando +quebra de linha.
normal, _italic_, *bold*, +mono+.
‘‘double quoted’’, ‘single quoted’.
normal, ^super^, ~sub~.
Command: ‘ls -al‘
Path: ’/some/filez.txt’, ’.b’
Processo de Produção 29 / 81
// Comentário de linha.
////Comentários aqui dentro,com várias linhas.////
(C) (R) (TM) -- ... -> <- => <= ¶
’’’’
[[macro-secao]]=== Macros: Referencias, images & include
Exemplo de referências.
anchor:anchor-2[]Paragraph or block 2.
Exemplo de referencias: <<texto-secao>>,<<texto-secao,Capitulo sobre texto>>.
.Block imageimage::images/novo-capitulo/bug.png[scaledwidth="60%"]
=== Código fonte de programasExemplo de código fonte.
-------------------------------------------/* Hello World program */
#include<stdio.h> // x1main(){
printf("Hello World"); // x2 imprime "Hello Word" na tela.}
-------------------------------------------
x3 Incluindo biblioteca de entrada/saída.x4 Chamada à função printf, que envia para a saída padrão (o console) o ←↩texto recebido.
==== Trecho de código
Exemplo de trecho de código.
#include<stdio.h>
Processo de Produção 30 / 81
main() { printf("Hello World"); }
=== Listas
.Bulleted
* bullet
* bullet- bullet- bullet
* bullet
** bullet
** bullet
*** bullet
*** bullet
**** bullet
**** bullet
***** bullet
***** bullet
**** bullet
*** bullet
** bullet
* bullet
.Bulleted 2- bullet
* bullet
.Ordered
. number
. number.. letter.. letter
. number
.. loweralpha
.. loweralpha
... lowerroman
... lowerroman
.... upperalpha
.... upperalpha
..... upperroman
..... upperroman
.... upperalpha
... lowerroman
.. loweralpha
. number
.Ordered 2a. letterb. letter
.. letter2
.. letter2. number
Processo de Produção 31 / 81
. number1. number22. number23. number24. number2
. number.. letter2
c. letter
.LabeledTermo 1::
Definição 1Termo 2::
Definição 2Termo 2.1;;
Definição 2.1Termo 2.2;;
Definição 2.2Termo 3::
Definição 3Termo 4:: Definição 4Termo 4.1::: Definição 4.1Termo 4.2::: Definição 4.2Termo 4.3::: Definição 4.3Termo 5:: Definição 5
.Labeled 2Termo 1;;
Definição 1Termo 1.1::
Definição 1.1
[horizontal].Labeled horizontalTermo 1:: Definição 1. ashkjahgsjhagkjshgkjhag jhasgjh ←↩
agfsjhgafsjhgafhsgfjasjhaj shgkjahsg khagskjhagskjhsak.Termo 2:: Definição 2 kajshkljahskjah lskjha ←↩
lkjshlaksjlkagsksjahgskjhgk ahsgkala shlkajhsl kjahlskjahls.
[qanda].Q&AQuestão 1::
Resposta da pergunta 1 aqui.Questão 2:: Resposta da pergunta 2 aqui.
.Indent is optional- bullet
* another bullet1. number. again number
Processo de Produção 32 / 81
a. letter.. again letter
.. letter
. number
* bullet- bullet
.Break two lists
. number
. number
Independent paragraph break list.
. number
.Header break list too
. number
--. List block define list boundary too. number. number--
--. number. number--
.Continuation- bulletcontinuation. numbercontinuation
* bullet
literal continuation
.. letter+Non-literal continuation.+----any block can be
included in list----+Last continuation.
.List block allow sublist inclusion
Processo de Produção 33 / 81
- bullet
* bullet+--
- bullet
* bullet--
* bullet- bullet. number
.. letter+--
. number.. letter
--.. letter
. number
=== Tabelas
You can fill table from CSV file using +include::+ macros inside table ←↩.
.An example table[options="header,footer"]|=======================|Col 1|Col 2 |Col 3|1 |Item 1 |a|2 |Item 2 |b|3 |Item 3 |c|6 |Three items|d|=======================
.CSV data, 15% each column[format="csv",width="60%",cols="4"][frame="topbot",grid="none"]|======1,2,3,4a,b,c,dA,B,C,D|======
[grid="rows",format="csv"][options="header",cols="^,<,<s,<,>m"]|===========================ID,FName,LName,Address,Phone1,Vasya,Pupkin,London,+1232,X,Y,"A,B",45678|===========================
.Multiline cells, row/col span
Processo de Produção 34 / 81
|====|Date |Duration |Avg HR |Notes
|22-Aug-08 .2+^.^|10:24 | 157 |Worked out MSHR (max sustainableheart rate) by going hardfor this interval.
|22-Aug-08 | 152 |Back-to-back with previous interval.
|24-Aug-08 3+^|none
|====
=== Matemática
WARNING: Esta solução só funciona com o PDF. As páginas html não geramconforme o esperado.
Ver https://asciidoc.googlecode.com/hg/doc/latexmath.txt e comparar ←↩com
http://www.methods.co.nz/asciidoc/latexmath.pdf
[[equacao-qualquer]].Uma equação qualquer.[latexmath]++++++++++++++++++++++++++++++++++++++++++++\[C = \alpha + \beta Y^{\gamma} + \epsilon\]++++++++++++++++++++++++++++++++++++++++++++
Colocar equação no meio do texto,latexmath:[$C = \alpha + \beta Y^{\gamma} + \epsilon$], também épossível. Mas o mais legal é referencia-la (ver <<equacao-qualquer>>).
// Sempre termine os arquivos com uma linha em branco.
// Sempre termine os arquivos com uma linha em branco.
5.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
Processo de Produção 35 / 81
=======================
CuidadoA quantidade dos sinais de igual (=) deve ser a mesma da quantidade de caracteres do nomeda disciplina.
5.6.2 Criando um novo capítulo
O arquivo livro/capitulos/novo-capitulo.asc foi criado com o objetivo de você criaruma 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 nonome 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[]
DicaGere o livro novamente para verificar as alterações (Seção 5.5 [23]).
5.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.
Conteúdo do arquivo livro/capitulos/novo-capitulo.asc== Novo capítulo
.Objetivos do capítulo____________________Ao final deste capítulo você deverá ser capaz de:
* objetivo 1
* objetivo 2
* objetivo N____________________
Neste lugar você deve apresentar o conteúdo em forma de diálogo.
Processo de Produção 36 / 81
NOTE: Para começar a escrever um novo capítulo, copie este arquivo esalve com outro nome (não utilize espaço no nome do arquivo). Em ←↩
seguida,atualize o arquivo *livro.asc* para incluir o novo arquivo criado.Consulte o manual.
=== Minha primeira seção
Texto da sua seção.
==== Exemplo de subseçãoTexto da subseção.
=== Minha segunda seção
Texto da sua seção.
=== Recapitulando
Revisão do que foi aprendido.
Reserve o último parágrafo para realizar uma *ponte* para o próximo ←↩capítulo.
=== Atividades
. Texto da atividade.
. Texto da atividade.
. Texto da atividade.
CAUTION: *Sempre termine os arquivos com uma linha em branco*, casocontrário você poderá encontrar erros inesperados.
// Sempre terminar o arquivo com uma nova linha.
CuidadoLembre-se de que não pode existir nenhuma seção sem texto. Sempre que você criar umaseção, adicione quaquer texto dentro dela, caso contrário o PDF não será gerado.
Processo de Produção 37 / 81
Capítulo 6
Visão técnica
Figura 6.1: Fluxo de trabalho, visão técnica.
6.1 Ferramentas utilizadas no processo
texto.
6.2 Escrevendo o livro
texto.
6.2.1 Iniciando um novo livro
texto.
6.3 Gerando edição para impressão
texto.
Processo de Produção 38 / 81
6.3.1 Revisando o livro
texto.
6.3.2 Fechando versão para impressão
texto.
6.4 Erratas dos livros
texto.
6.4.1 Onde encontrar a errata
texto.
6.4.2 Contribuindo com correções
texto.
6.4.3 Contribuindo com indicações de erros
texto.
6.5 Licença
texto.
Processo de Produção 39 / 81
Capítulo 7
Escrevendo um livro
texto.
7.1 Estrutura inicial do projeto
texto.
Processo de Produção 40 / 81
Capítulo 8
Inserindo caracteres especiais no texto
Para inserir um caracter especial, basta copia-lo da internet e colar diretamente no arquivo. Os arqui-vos fontes devem está na codificação uft-8.
Ex: πρϕϷ
DicaVocê pode consultar vários simbolos em: http://www.utf8-chartable.de/unicode-utf8-table.pl?number=1024&names=-&view=2. Lembre de avançar a página para encontrar novossimbolos.
Processo de Produção 41 / 81
Capítulo 9
Comunicações
Nesta seção juntamos várias recomendações de comunicações que podem ser utilizadas durante oProcesso de Produção.
9.1 Capacitação
9.1.1 Convite e Agendamento para a capacitação
Capacitação dos professores conteudistasHoje tivemos uma reunião com os professores conteudistas.
- Apresentamos o formato de arquivo que iremos trabalhar (asciidoc)- Apresentamos o fluxo de trabalho- As ferramentas utilizadas
** Git(hub)
** Editor de texto (gedit ou notepad++)
Em seguida marcamos uma capacitação para iniciar o processo de ←↩produção:
- Capacitação: 3 de Abril, às 14:00, na ufpb virtual.
Os conteudistas poderão optar por duas formas de trabalho:1) Ambiente mínimo, com geração on-line da diagramação.ou2) Com todo o ambiente instalado no computador, com geração off-line ←↩
da diagramação.
As instruções abaixo são para os professores que optarem pela opção 2)
Os professores que optarem por possuir todo o ambiente instalado, ←↩tragam seus notebooks com os seguintes pacotes instalados:
Instalando o git:sudo apt-get install git
Processo de Produção 42 / 81
O mercurial não é necessário, mas será utilizado para baixar a nova ←↩versão do asciidoc.
sudo apt-get install mercurial
Instalar o latex:sudo apt-get install texliveousudo apt-get install texlive-full
Instalar o asciidoc e dbaltex. Depois serão removidos, mas é ←↩importante porque instala as dependências.
sudo apt-get install asciidocsudo apt-get install dblatex
Em seguida, precisaremos instalar as novas versões do asciidoc e ←↩dblatex:
-Remove asciidoc-Remove dbaltexsudo apt-get remove asciidocsudo apt-get remove dblatex
Instala nova versão do dblatexsudo apt-get install python-setuptoolssudo easy_install dblatex
Instala nova versão do asciidocmkdir ~/ambientecd ~/ambientehg clone -r 8.6.8 https://asciidoc.googlecode.com/hg/ asciidoc-8.6.8
Processo de Produção 43 / 81
Parte II
Ferramentas utilizadas no Processo deProdução
Processo de Produção 44 / 81
Capítulo 10
Instalação das Ferramentas
Este capítulo possui as instruções de como instalar o ambiente de desenvolvimento necessário para aprodução dos materiais.
10.1 Requisitos mínimos
• Conta de usuário no github
• git
• Editor de Texto + highlight plugin.
10.1.1 Criando conta de usuário no github
Para poder contribuir com alterações nos livros é necessário possuir uma conta no github, portanto,caso você não tenha um usuário crie sua conta agora.
ImportanteAcesse agora https://github.com para criar uma conta de usuário para você, caso você aindapossua. OBS: No github a senha precisa conter pelo menos um número e uma letra.
10.1.2 Instalando git no Linux
O seguinte comando instala o git no linux:
sudo apt-get install git-core gitg
ImportanteNa instalação do git, recomendamos a criação de uma chave ssh, conforme as instruçõesem https://help.github.com/articles/generating-ssh-keys.
Processo de Produção 45 / 81
CuidadoSe a versão do git (git --version) for inferior a 1.7.10, o clone com https não iráfuncionar. Neste caso você deve atualizar o git ou criar uma chave ssh e clonar o pro-jeto com o endereço ssh. Detalhes do erro e da solução pode ser encontrados respecti-vamente em: https://help.github.com/articles/https-cloning-errors e https://help.github.com/-articles/generating-ssh-keys.
10.1.3 Instalando git(hub) no Windows
DicaProduzimos um vídeo demonstrando a instalação no windows: http://youtu.be/-8XDR137mZK4.
As instruções de instalação do git no windows pode ser consultada em https://help.github.com/-articles/getting-started-with-github-for-windows.
O binário do git pode ser baixado em http://github-windows.s3.amazonaws.com/GitHubSetup.exe.
NotaNo cliente do git no windows, uma chave ssh é automaticamente criada e adicionada ao git.
10.1.4 Instalando git no Mac
ImportanteNa instalação do git, recomendamos a criação de uma chave ssh, conforme as instruçõesem https://help.github.com/articles/generating-ssh-keys.
Consulte http://git-scm.com/book/en/Getting-Started-Installing-Git#Installing-on-Mac.
10.1.5 Configurando sua identidade
Comando para configurar sua identidade
$ git config --global user.name "John Doe"$ git config --global user.email [email protected]
DicaPara mais configurações consulte http://git-scm.com/book/en/Getting-Started-First-Time-Git-Setup e Capítulo 13 [64].
Processo de Produção 46 / 81
10.1.6 Editor de texto no Linux
No linux recomendamos utilização do vim ou gedit para instalação do plugin de highlight do asciidoc.
Plugin de highlighthttps://launchpad.net/asciidoc-gtk-highlight ou https://launchpad.net/asciidoc-gtk-highlight/trunk/-0.1/+download/asciidoc-gtk-highlight.tar.gz. O arquivo possui um arquivo README com asintruções de instalação.
Figura 10.1: Highlight do plugin no gedit
10.1.7 Editor de texto no Windows
No window recomendamos utilizar o Notepad++ para edição. Baixe e instale a versão que desejar.
Versão sem instalaçãohttp://download.tuxfamily.org/notepadplus/6.3.1/npp.6.3.1.bin.zip
Versão com instalaçãohttp://download.tuxfamily.org/notepadplus/6.3.1/npp.6.3.1.Installer.exe
DicaCriamos um plugin de highlight para o Notepad++, está disponível em https://github.com/-edusantana/asciidoc-highlight. O seguinte vídeo ensina como instalar o plugin:http://youtu.be/_i-KxSb7cJM.
Processo de Produção 47 / 81
Figura 10.2: Highlight do plugin no Notepad++
10.2 Instalando ambiente para desenvolvimento off-line
Com as ferramentas descritas anteriormente são suficientes para a produção dos livros. Caso vocêdeseje desenvolver as atividades sem o Servidor da Produção, você necessitará instalar o ambientede desenvolvimento off-line (Capítulo 16 [71]).
ImportanteEmbora possa parecer que a geração através do servidor demore alguns instantes, a gera-ção em seu computador pessoal talvez demore ainda mais, dependendo da performance dasua máquina. A instalação off-line é recomendada quando o usuário possui acesso limitadoa internet.
Processo de Produção 48 / 81
Capítulo 11
AsciiDoc cheatsheet
Nesta seção são apresentadas vários recursos do asciidoc. Verifique o código fonte para aprender quala sintaxe que produz este texto.
A melhor forma de aprender o asciidoc é consultando o site oficial.
Sumário das funcionalidadeshttp://xpt.sourceforge.net/techdocs/nix/tool/asciidoc-syn/ascs01-AsciiDocMarkupSyntaxQuickSummary/-single/
AsciiDoc cheatsheethttp://powerman.name/doc/asciidoc
Site oficialhttp://www.methods.co.nz/asciidoc/
Exemplo de livrohttps://asciidoc.googlecode.com/hg/doc/book.txt
Guida do usuáriohttp://www.methods.co.nz/asciidoc/userguide.html
Matemáticahttp://www.methods.co.nz/asciidoc/latexmath.pdf
FAQhttp://www.methods.co.nz/asciidoc/faq.html
Apresentaçãohttp://mojavelinux.github.com/decks/asciidoc-with-pleasure/
11.1 Seções
== Nível de capítulo (section) 1Texto.
=== Nível de subseção 2Texto.
Processo de Produção 49 / 81
==== Level 3Texto.
===== Level 4Texto.
CuidadoNão pode existir seções sem texto. Sempre coloque algum texto, caso contrário o arquivonão será gerado.
11.2 Parágrafos
Título do parágrafo opcional Texto do parágrafo aqui.
Título do parágrafo opcional
Texto do parágrafo aqui.Precisa começar com espaço em branco.
Optional Title
die ’connect: ’.$dbh->errstr;
Este parágrafo não faz parte do código.
NotaThis is an example single-paragraph note.
NotaThis is an example single-paragraph note.
DicaTexto.
ImportanteTexto.
Processo de Produção 50 / 81
AtençãoTexto.
CuidadoTexto.
11.3 Blocos
Optional Title
*Listing* Block
Use: code or file listings
Optional Title
# *Source* block# Use: highlight code listings# (require ‘source-highlight‘ or ‘pygmentize‘)use DBI;my $dbh = DBI->connect(’...’,$u,$p)
or die "connect: $dbh->errstr";
Optional Title
Sidebar Block
Use: sidebar notes :)
Example 11.1 Titulo do bloco de exemploBloco de Exemplo.Utilize exemplos! :)
Bloco de Exemplo sem título.
Utilize exemplos! :)
Título desde blocoNOTE BlockUse: multi-paragraph notes.
Título desde bloco (opcional)
Processo de Produção 51 / 81
*Literal* Block
Use: workaround when literalparagraph (indented) like
1. First.2. Second.
incorrectly processed as list.
OPTIONAL TITLE
Quote Block
Use: cite somebody
— cite author cite source
11.4 Text
forçandoquebra de linha.
normal, italic, bold, mono.
“double quoted”, ‘single quoted’.
normal, super, sub.
Command: ls -al
Path: /some/filez.txt, .b
© ® ™ — . . . →←⇒⇐ ¶
11.5 Macros: Referencias, images & include
Como inserir imagens[[minha_imagem_exemplo]].Exemplo de imagemimage::images/inicio-rapido/nova-sugestao.png[scaledwidth="60%"]
Figura 11.1: Exemplo de imagem
Processo de Produção 52 / 81
No trecho acima [[minha_imagem_exemplo]] é opcional. Deve ser usado apenas quando sedeseja fazer refência a ela.
Como fazer referências[[texto-secao]]=== Text
Exemplo de referencias: <<texto-secao>> e <<minha_imagem_exemplo>>.
Exemplo de referencia para seção: Seção 11.4 [51]. Exemplo de referência para imagem: Figura 11.1[51].
11.6 Código fonte de programas
Exemplo de código fonte/* Hello World program */
#include<stdio.h> // x1main(){
printf("Hello World"); // x2 imprime "Hello Word" na tela.}
x1 , x3 , x1 Incluindo biblioteca de entrada/saída.x2 , x4 , x2 Chamada à função printf, que envia para a saída padrão (o console) o texto recebido.
NotaPadronizamos que os códigos devem ser salvos dentro da pasta capitulos/code/,mantendo o mesmo padrão de organização das imagens.
11.6.1 Trecho de código
Exemplo de trecho de código.
#include<stdio.h>main() { printf("Hello World"); }
11.7 Listas
BULLETED
• bullet
Processo de Produção 53 / 81
• bullet
– bullet
– bullet
• bullet
– bullet
– bullet
* bullet
* bullet· bullet· bullet
[Error: itemizedlist too deeply nested]· bullet
* bullet
– bullet
• bullet
BULLETED 2
• bullet
– bullet
ORDERED
1. number
2. number
a. letter
b. letter
3. number
a. loweralpha
b. loweralpha
i. lowerromanii. lowerroman
A. upperalphaB. upperalpha
[Error: orderedlist too deeply nested]C. upperalpha
iii. lowerroman
Processo de Produção 54 / 81
c. loweralpha
4. number
ORDERED 2
a. letter
b. letter
a. letter2
b. letter2
1. number2. number
1. number22. number23. number24. number2
3. number
c. letter2
c. letter
LABELED
Termo 1Definição 1
Termo 2Definição 2
Termo 2.1Definição 2.1
Termo 2.2Definição 2.2
Termo 3Definição 3
Termo 4Definição 4
Termo 4.1Definição 4.1
Termo 4.2Definição 4.2
Termo 4.3Definição 4.3
Processo de Produção 55 / 81
Termo 5Definição 5
LABELED 2
Termo 1Definição 1
Termo 1.1Definição 1.1
Tabela 11.1: Labeled horizontal
Termo 1 Definição 1. ashkjahgsjhagkjshgkjhag jhasgjh agfsjhgafsjhgafhsgfjasjh ajshgkjahsg khagskjhagskjhsak.
Termo 2 Definição 2 kajshkljahskjah lskjha lkjshlaksjlkagsksjahgskjhgk ahsgka lashlkajhsl kjahlskjahls.
Q&A
1. Questão 1
Resposta da pergunta 1 aqui.
2. Questão 2
Resposta da pergunta 2 aqui.
INDENT IS OPTIONAL
• bullet
– another bullet
1. number1. again number
a. lettera. again letterb. letter
2. number
– bullet
• bullet
BREAK TWO LISTS
Processo de Produção 56 / 81
1. number
2. number
Independent paragraph break list.
1. number
HEADER BREAK LIST TOO
1. number
1. List block define list boundary too
2. number
3. number
1. number
2. number
CONTINUATION
• bullet continuation
1. number continuation– bullet
literal continuation
a. letterNon-literal continuation.any block can be
included in list
Last continuation.
LIST BLOCK ALLOW SUBLIST INCLUSION
• bullet
– bullet
* bullet
* bullet– bullet
• bullet
1. numbera. letter
1. numbera. letter
b. letter2. number
Processo de Produção 57 / 81
11.8 Tabelas
You can fill table from CSV file using include:: macros inside table.
Tabela 11.2: An example table
Col 1 Col 2 Col 31 Item 1 a2 Item 2 b3 Item 3 c6 Three items d
Tabela 11.3: CSV data, 15% each column
1 2 3 4a b c dA B C D
ID FName LName Address Phone1 Vasya Pupkin London +1232 X Y A,B 45678
Tabela 11.4: Multiline cells, row/col span
Date Duration Avg HR Notes22-Aug-08
10:24157 Worked out MSHR
(max sustainableheart rate) by goinghard for this interval.
22-Aug-08 152 Back-to-back withprevious interval.
24-Aug-08 none
11.9 Matemática
Ver https://asciidoc.googlecode.com/hg/doc/latexmath.txt e comparar com http://www.methods.co.nz/-asciidoc/latexmath.pdf
Processo de Produção 58 / 81
C = α +βY γ + ε
EQUATION 11.1: Uma equação qualquer.
Colocar equação no meio do texto, C = α + βY γ + ε , também é possível. Mas o mais legal éreferencia-la (ver Equação 11.1 [58]).
11.10 Comentários
O Comentário é um importantíssemo recurso do nosso processo.
Como inserir um comentário
////Um comentário inicia com 4 barrase finaliza com outras 4 barras.Tudo que for inserido no meio nãoserá impresso.////
Processo de Produção 59 / 81
Capítulo 12
Desenhando gráficos
A elaboração de gráficos pode ser agilizada quando ela é feita dentro do próprio documento que estásendo escrito.
Através do graphviz é possível gerar várias imagens (Seção 12.1 [59]).
DOCUMENTAÇÃO DO GRAPHVIZ
Grafoshttp://www.graphviz.org/pdf/neatoguide.pdf
Dígrafoshttp://www.graphviz.org/pdf/dotguide.pdf
Layoutshttp://code.google.com/p/asciidoc/source/browse/filters/graphviz/asciidoc-graphviz-sample.txt?name=8.6.8
12.1 Exemplos do graphviz
Nas seções a seguir alguns exemplos de gráficos.
DicaNo site http://www.graphviz.org/Gallery.php temos uma galeria de gráficos que podem serbaixados e customizados.
12.1.1 Grafos
["graphviz", "grafo.png", width="30%"].Exemplo de grafo.--------------------------------------------------------------------- ←↩
graph G {n0 -- n1 -- n2 -- n3 -- n0;
}--------------------------------------------------------------------- ←↩
Processo de Produção 60 / 81
Figura 12.1: Exemplo de grafo.
Figura 12.2: Exemplo de grafo (width="50%")
["graphviz"]--------------------------------------------------------------------- ←↩
digraph G { rankdir=LR; Graphviz->AsciiDoc->HTML}--------------------------------------------------------------------- ←↩
.Com tamanho menor["graphviz", "sample2x.png", width="60%"]--------------------------------------------------------------------- ←↩
digraph automata_0 {size ="4, 5";node [shape = circle];0 [ style = filled, color=lightgrey ];
Processo de Produção 61 / 81
2 [ shape = doublecircle ];0 -> 2 [ label = "a " ];0 -> 1 [ label = "other " ];1 -> 2 [ label = "a " ];1 -> 1 [ label = "other " ];2 -> 2 [ label = "a " ];2 -> 1 [ label = "other " ];"Machine: a" [ shape = plaintext ];}--------------------------------------------------------------------- ←↩
Figura 12.3: Com tamanho menor
["graphviz", "sample3.png", "dot", width="70%"]--------------------------------------------------------------------- ←↩
digraph finite_state_machine {rankdir=LR;size="8,5"node [shape = doublecircle]; LR_0 LR_3 LR_4 LR_8;node [shape = circle];LR_0 -> LR_2 [ label = "SS(B)" ];LR_0 -> LR_1 [ label = "SS(S)" ];LR_1 -> LR_3 [ label = "S($end)" ];LR_2 -> LR_6 [ label = "SS(b)" ];LR_2 -> LR_5 [ label = "SS(a)" ];LR_2 -> LR_4 [ label = "S(A)" ];LR_5 -> LR_7 [ label = "S(b)" ];LR_5 -> LR_5 [ label = "S(a)" ];LR_6 -> LR_6 [ label = "S(b)" ];LR_6 -> LR_5 [ label = "S(a)" ];LR_7 -> LR_8 [ label = "S(b)" ];LR_7 -> LR_5 [ label = "S(a)" ];
Processo de Produção 62 / 81
LR_8 -> LR_6 [ label = "S(b)" ];LR_8 -> LR_5 [ label = "S(a)" ];}--------------------------------------------------------------------- ←↩
Processo de Produção 63 / 81
Figura 12.4: Tipo barramento
Processo de Produção 64 / 81
Capítulo 13
Git
Nesta seção mantemos referências a vários outros manuais sobre o git.
1. http://rogerdudler.github.com/git-guide/index.pt_BR.html
2. http://windows.github.com/help.html (github para o windows, em inglês)
3. http://ruby-br.org/?p=1318 (vários tutoriais)
4. http://git-scm.com/documentation (Inglês, possui vídeos)
13.1 Configurando o git com chave ssh
DicaNós recomendamos o uso do git com uma chave ssh configurada, agiliza a produção. Casovocê use o github para o Windows, você pode ignorar estes passos, pois ele configura auto-maticamente.
O git possibilita utilizar chaves ssh para conectar com o servidor. Uma vez que você configure aschaves num computador que você confia, não necessitará mais colocar a senha sempre que enviar umcommit.
Comandos para configurar git com ssh
cd ~/.sshssh-keygen -t rsa -C "[email protected]"
Em seguida, vá no github https://github.com/settings/ssh e adicione sua chave, que é o conteúdo doarquivo ~/.ssh/id_rsa.pub.
ImportanteEstas instruções foram extraídas de https://help.github.com/articles/generating-ssh-keys.Para maiores detalhes consulte o link (em inglês).
Processo de Produção 65 / 81
13.2 Configurando o git com cor no linux
Para configurar o git com cores no terminal do linux, digite o seguite comando:
git config color.ui true
13.3 Commit rápido
Para agilizar o trabalho, o seguinte comando commit e submete os arquivos alterados para o servidor:
Comitando e submetendo os arquivos modificados
git -a commit -m "mensagem do seu commit"; git push
CuidadoSomente os arquivos que já estavam adicionados. Se você criou um arquivo novo ou mesmouma nova imagem, este comando não adiciona eles.
13.4 Configurações avançadas
Configurações avançadas do git podem ser consultadas em http://git-scm.com/book/en/Customizing-Git-Git-Configuration.
Processo de Produção 66 / 81
Capítulo 14
Outras Ferramentas
14.1 Convertendo arquivos do Word para Asciidoc
1. Salve o arquivo como .txt
2. Abra o arquivo e inclua as marcações de capítulo e seções
3. Separe cada parágrafo com uma linha em branco
4. Execute o comando fold para quebrar as linhas em 80 caracteres:
Comando para dividir parágrafos em 80 caracteres
fold -w 80 -s nome-do-arquivo.txt > nome-do-arquivo.asc
ImportanteNão utilize o comando fold redirecionando a saída para o mesmo arquivo, casocontrário você perderá o conteúdo dele. No exemplo acima temos dois arquivos, um.txt e outro .asc.
Processo de Produção 67 / 81
Parte III
Implementação do processo
Processo de Produção 68 / 81
Nesta parte documentamos a implementação do processo. Ela possui a dupla função de documentar oprocesso e de instruir como outras pessoas podem replicar a infraestrutura necessária para produçãodos materiais.
Processo de Produção 69 / 81
Capítulo 15
Criando um novo livro
No github, criamos um novo repositório com o nome da disciplina com o sufixo -livro, que tem afinalidade apenas de marcar quais repositórios estão em conformidade com este modelo.
Exemplo de repositório: https://github.com/edusantana/introducao-a-programacao-livro
15.1 Baixando o projeto
Se você possui o ssh configurado pelo github:
git clone [email protected]:edusantana/introducao-a-programacao-livro.git
Caso contrário:
git clone https://github.com/edusantana/introducao-a-programacao-livro.git
ImportanteA configuração do git está descrita em https://help.github.com/articles/set-up-git. A configu-ração avançada, com o ssh está disponível em: https://help.github.com/articles/generating-ssh-keys. Os comandos desta parte utilizam a configuração com ssh.
15.2 Criando a estrutura inicial do projeto
Os projetos devem possuir arquivos modelos para que os autores possam iniciar o trabalho com faci-lidade (Seção 7.1 [39]).
Os arquivos que compõe a estrutura inicial de um novo projeto serão mantidos no repositório destelivro. Baixe o projeto deste livro e copie os arquivos dentro do novo projeto.
$ git clone [email protected]:edusantana/producao-computacao-ead- ←↩ufpb.git
$ git clone [email protected]:seu-usuario/seu-projeto-livro.git$ cd seu-projeto-livro$ rsync -r ../producao-computacao-ead-ufpb/estrutura-inicial/ .
Processo de Produção 70 / 81
$ cp ../producao-computacao-ead-ufpb/.gitignore .$ git rm README.md ; git add . ; git commit -m "Commit inicial"; ←↩
git push$ git push
15.2.1 Gerando um pdf do livro (off-line)
O seguinte comando gera o pdf do livro:
~/ambiente/asciidoc-8.6.8/a2x.py -v -f pdf livro.asc
NotaEste pdf gerado não possui os estilos utilizados na versão final do livro, mas serve para teruma idéia de como será gerado.
15.2.2 Gerando o pdf do livro (off-line estilizado)
O PDF estilizado utiliza um estilo (Seção 16.6 [73]) personalizado na geração.
O código para geração final do PDF é executado pelo script de geração contido no servidor web,disponível em: https://github.com/edusantana/producao-computacao-ead-ufpb/blob/master/cgi/pull-pdf.py
DicaQuem utiliza o ambiente para geração off-line pode ignorar a instalação deste estilo, uma vezque não há garantias que ele permaneça o mesmo ao longo da produção. É importante queos autores do livro compreendam que o visal do livro não é responsabilidade deles.
Processo de Produção 71 / 81
Capítulo 16
Instalando ambiente para desenvolvimento off-line
Nas seções a seguir temos instruções para instalação do ambiente off-line.
ImportanteEste manual somente descreve as instruções para a instalação do ambiente off-line para olinux.
16.1 Instalando o git
Necessário para baixar e enviar os textos e imagens produzidas.
sudo apt-get install git-core
16.2 Instalando o mercurial
O mercurial não é necessário, mas será utilizado para baixar a nova versão do asciidoc.
sudo apt-get install mercurial
16.3 Instalar o latex
A produção do livro utiliza uma cadeia de várias ferramentas, uma delas é o latex.
sudo apt-get install texliveousudo apt-get install texlive-full
Processo de Produção 72 / 81
16.4 Instalar o asciidoc e dbaltex
Depois serão removidos, mas é importante porque instala as dependências.
sudo apt-get install asciidocsudo apt-get install dblatex
16.4.1 Removendo e atualizando o asciidoc e dbaltex
Em seguida, precisaremos instalar as novas versões do asciidoc e dblatex.
sudo apt-get remove asciidocsudo apt-get remove dblatex
16.4.2 Instala nova versão do dblatex
Instalando a nova versão do dblatex através do easy_install do python.
sudo apt-get install python-setuptoolssudo easy_install dblatex
NotaA instalação irá ocorrer um diretório parecido com: /usr/local/lib/python2.7/dist-packages/dblatex-0.3.4-py2.7.egg/share/doc/dblatex
16.4.3 Instala nova versão do asciidoc
Baixando e instalando a nova versão do asciidoc.
mkdir ~/ambientecd ~/ambientehg clone -r 8.6.8 https://asciidoc.googlecode.com/hg/ asciidoc ←↩
-8.6.8
ImportanteA nova versão é necessária principalmente devido a uma funcionalidade que permite ostítulos das seções possuirem acentos (atributo :ascii-ids:).
16.5 graphviz
Para gerar gráficos dentro do texto (Capítulo 12 [59]).
sudo apt-get install graphviz
Processo de Produção 73 / 81
16.6 Instalando estilo do dblatex para geração do pdf estilizado
O nosso estilo personalizado está disponível em: https://github.com/edusantana/producao-computacao-ead-ufpb/tree/master/dblatex-computacao-ufpb
O processo de instalação de estilos se encontra descrito no manual do dblatex, na seção Adding a NewFormatting Style.
Path: /usr/local/lib/python2.7/dist-packages/dblatex-0.3.4-py2.7.egg/share/doc/dblatex/manual.pdf
Instalação no servidor
mkdir ~/gitreposcd ~/gitreposgit clone [email protected]:edusantana/producao-computacao-ead-ufpb ←↩
.gitsudo mkdir /var/www/.dblatexsudo rsync -r ~/gitrepos/producao-computacao-ead-ufpb/dblatex- ←↩
computacao-ufpb/* /var/www/.dblatex/
16.7 Instalação dos scripts cgi
O Servidor da Produção funciona através de scripts cgi python, que recebem as solicitações html eexecutam os comandos para a geração do livro e slides.
A configuração do Servidor CGI foi realizada seguindo as intruções de http://jonathanferretti.com/-blog/?p=76.
Após a configuração do servidor e o projeto deste manual baixado em ~/gitrepos, os seguintescomandos instalam os scripts:
cd ~/gitrepossudo cp -v producao-computacao-ead-ufpb/cgi/*.py /var/www/cgi- ←↩
bin/sudo cp -v producao-computacao-ead-ufpb/cgi/*.html /var/www/
Processo de Produção 74 / 81
Parte IV
Projetos e Pessoas
Processo de Produção 75 / 81
Esta parte do livro mantém um lista de repositórios de livros que podem ser gerados pelo Servidor deProdução.
Basicamente estamos mantendo os repositórios dos livros das disciplinas do curso de Licenciatura emComputação a distância na UFPB. No entanto, não há um compromisso com esta limitação.
O último capítulo desta parte é uma relação de colaboradores, que cresce sempre que alguém aprendea colaborar com o nosso processo (Capítulo 2 [5]).
Processo de Produção 76 / 81
Capítulo 17
Projetos de produção de livros
Nesta seção iremos manter os projetos dos livros que iremos produzir. Você poderá utiliza-la paraencontrar os endereços dos repositórios.
17.1 Este manual
Este Manual de Produçãohttps://github.com/edusantana/producao-computacao-ead-ufpb
17.2 Licenciatura em Computação a Distância - UFPB
Nesta seção encontram-se os repositórios das disciplinas deste curso.
17.2.1 Período 1
Matemática Elementarhttps://github.com/edusantana/matematica-elementar-livro-tex
Introdução a EaDhttps://github.com/edusantana/introducao-a-ead-livro
Fundamentos Sócio-Históricos da Educaçãohttps://github.com/edusantana/fundamentos-socio-historico-da-educacao-livro
Introdução à Programaçãohttps://github.com/edusantana/introducao-a-programacao-livro
Introdução à Computaçãohttps://github.com/edusantana/introducao-a-computacao-livro
Processo de Produção 77 / 81
17.2.2 Período 2
Cálculo Diferencial e Integralhttps://github.com/edusantana/calculo-diferencial-e-integral-livro
Inglês Instrumentalhttps://github.com/edusantana/ingles-instrumental-livro
Fundamentos Psicológicos da Educaçãohttps://github.com/edusantana/fundamentos-psicologicos-da-educacao-livro
Linguagem de Programação Ihttps://github.com/edusantana/linguagem-de-programacao-i-livro
Metodologia do Trabalho Científicohttps://github.com/edusantana/metodologia-do-trabalho-cientifico-livro
17.2.3 Período 3
Matemática Computacionalhttps://github.com/edusantana/matematica-computacional-livro
Pesquisa Aplicada à Computaçãohttps://github.com/edusantana/pesquisa-aplicada-a-computacao-livro
Fundamentos Antropo-Filosóficos da Educaçãohttps://github.com/edusantana/fundamentos-antropo-filosoficos-da-educacao-livro
Estruturas de Dadoshttps://github.com/edusantana/estruturas-de-dados-livro
Introdução a Arquitetura de Computadoreshttps://github.com/edusantana/introducao-a-arquitetura-de-computadores-livro
Ética Profissionalhttps://github.com/edusantana/etica-profissional-livro
17.2.4 Período 4
Probabilidade e Estatísticaindisponível
Optativa Iindisponível
Didáticaindisponível
Linguagem de Programação IIindisponível
Processo de Produção 78 / 81
Banco de Dadosindisponível
Estagio Supervisionado Iindisponível
17.2.5 Período 5
Interface Humano-Computador de Software Educativoindisponível
Seminário Temático: Objeto Digitais e Educação em Computaçãoindisponível
Computadores e Sociedadeindisponível
Análise e Projeto de Sistemasindisponível
Sistemas Operacionaisindisponível
Estagio Supervisionado IIindisponível
17.2.6 Período 6
Teoria da Computaçãoindisponível
Seminário Temático: A Computação como Ciência Básicaindisponível
Produção de Materiais Instrucionaisindisponível
Engenharia de Softwareindisponível
Redes de Computadoresindisponível
Estagio Supervisionado IIIindisponível
Processo de Produção 79 / 81
17.2.7 Período 7
Optativa IIindisponível
LIBRASindisponível
Política e Gestão da Educaçãoindisponível
Sistema WEBindisponível
Agentes Inteligentes em Educaçãoindisponível
Estagio Supervisionado IVindisponível
17.2.8 Período 8
Trabalho de Conclusão de Cursoindisponível
Estagio Supervisionado Vindisponível
Optativa IIIindisponível
Processo de Produção 80 / 81
Capítulo 18
Pessoas
Esta seção é utilizada com o propósito de treinamento (Seção 2.7 [11]).
Importante
• Formato da lista: Nome — Função, Ano que iniciou as atividades.
• Adicione o seu nome na ordem alfabética.
• Mantenha a mesma formatação: normal — negrito, monospace.
Agora é sua vez, adicione o seu nome na lista abaixo:
1. Alisson Vasconcelos de Brito — Professor Conteudista, 2013.1.
2. Camyle de Araújo Silva — Revisora Ortográfica, 2013.1.
3. Eduardo de Santana Medeiros Alexandre — Editor, 2013.1.
4. Felipe Antonio Garcia Moreno — Professor Conteudista, 2013.1.
5. Gilberto Farias de Sousa Filho — Professor Conteudista, 2013.1.
6. Iguatemi Eduardo da Fonseca — Professor Conteudista, 2013.1.
7. Kely Diana Villacorta Villacorta — Professora Conteudista, 2013.1.
8. Natasha Correia Queiroz Lino — Professora Conteudista, 2013.1.
9. Miguel Aroztegui — Professor Conteudista, 2013.1.
Processo de Produção 81 / 81
Capítulo 19
Índice Remissivo
Bbaixando projeto, 69Baixar livro em PDF, 6
Ccor, 65
Ddblatex
Estilo do pdf, 73
EEstilo do pdf, 73
Ggit
cor, 65ssh, 44, 45, 64
githubbaixando projeto, 69ssh, 69
graphviz, 72
LLivro em PDF
Baixar livro em PDF, 6
PPessoas, 80Projetos, 76
RRepositórios, 76
SServidor da Produção, 6ssh, 44, 45, 64, 69
WWord para Asciidoc, 66
