por Eduardo Santana -...

Curso Processo Ágil para Produção de Livros i

Curso Processo Ágil para Produção deLivros

por Eduardo Santana

Ed. v1.3

Curso Processo Ágil para Produção de Livros 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/ .

Curso Processo Ágil para Produção de Livros iii

COLLABORATORS

TITLE :

Curso Processo Ágil para Produção deLivros

ACTION NAME DATE SIGNATURE

WRITTEN BY Eduardo Santana 12 de julho de 2013

REVISION HISTORY

NUMBER DATE DESCRIPTION NAME

v1.3 Junho 2013 Inclusão de Simulação de um leitorenviando uma correção (Pull request).

Eduardo

v1.2 Junho 2013 Inclusão do Glossário. Eduardo

v1.1 Junho 2013 Inclusão de seções: Intruções sobre osvídeos. Cronograma. FAQ.

Eduardo

v1.0 Maio 2013 Primeira versão do curso básico. Eduardo

Curso Processo Ágil para Produção de Livros iv

Sumário

I Curso Básico 1

1 Apresentação do curso 3

1.1 Planejamento do curso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2 Sobre o participante do curso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.2.1 Instruções iniciais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.2.2 Sobre os vídeos e as instruções . . . . . . . . . . . . . . . . . . . . . . . . . 5

1.2.3 Cronograma para execução das atividades . . . . . . . . . . . . . . . . . . . 6

1.2.4 Na Aula presencial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

1.2.5 Na continuidade do curso on-line . . . . . . . . . . . . . . . . . . . . . . . 6

1.2.6 Produção individual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

1.3 Atuação dos ministrantes do curso . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

1.4 Informações técnicas sobre o processo . . . . . . . . . . . . . . . . . . . . . . . . . 8

1.5 Encontrou erros no livro? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

1.6 Atividades na plataforma . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

2 Aula presencial 10

2.1 Condução das Atividades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

2.2 Apresentação do curso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.3 Agenda do dia presencial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.4 1º 25 min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2.4.1 Apresentar livros já produzidos no processo tradicional . . . . . . . . . . . . 12

2.5 2º 25 min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2.5.1 Características da produção de livros na EAD . . . . . . . . . . . . . . . . . 12

2.6 3º 25 min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

2.6.1 Discussão sobre os processos . . . . . . . . . . . . . . . . . . . . . . . . . . 13

2.7 Break — 10 min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

2.8 4º 25 min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Curso Processo Ágil para Produção de Livros v

2.8.1 Iniciando um livro (atividade individual) . . . . . . . . . . . . . . . . . . . 15

2.9 5º 25 min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2.9.1 Revisando e tendo o seu livro revisado (atividade em dupla) . . . . . . . . . 17

2.10 6º 25 min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

2.10.1 Atividades on-line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

2.10.2 Produção do seu livro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

2.10.3 Culminância . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

2.10.4 Avaliação das atividades . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

2.10.5 Fóruns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

2.10.6 Curso intermediário . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

2.11 7º 25 min . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

2.11.1 Fixando o que foi visto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

2.12 Exemplos de livros que utilizam este processo . . . . . . . . . . . . . . . . . . . . . 21

3 Playground 22

3.1 Resumo do que será aprendido no Playground . . . . . . . . . . . . . . . . . . . . . 22

3.2 Realizando um Fork do Playground . . . . . . . . . . . . . . . . . . . . . . . . . . 23

3.2.1 Gerando o livro a partir do fork do playground . . . . . . . . . . . . . . . . 23

3.3 Playground - Parte 1/3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

3.3.1 Gerando o livro do Playground 1 . . . . . . . . . . . . . . . . . . . . . . . . 24

3.3.2 Estudando o Playground . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

3.3.3 Próximos passos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25




3.4.3 Próximos passos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26




3.5.3 Próximos passos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

4 Produção do seu livro 28

4.1 Adição e submissão de imagem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

4.2 Sugestões, erros e correções . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

4.2.1 Simulação de um leitor enviando uma correção . . . . . . . . . . . . . . . . 29

4.3 Compartilhando com os demais a sua produção . . . . . . . . . . . . . . . . . . . . 30

Curso Processo Ágil para Produção de Livros vi

5 Culminância 31

5.1 Avaliando o curso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

6 Perguntas frequentes - FAQ 32

6.1 Perguntas gerais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

6.1.1 Além de livros, pode ser utilizado para monografias, dissertações, teses erelatórios? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

6.1.2 Depois de várias revisões, eu posso retomar uma revisão antiga e continuar apartir dela? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

6.1.3 É possível juntar todos os livros e gerar um único para o livro do período? . . 32

6.1.4 Como apago um repositório ou fork? . . . . . . . . . . . . . . . . . . . . . 32

6.1.5 Como faço para alterar minha foto no github? . . . . . . . . . . . . . . . . . 33

6.1.6 Como inserir um link clique aqui no texto? . . . . . . . . . . . . . . . . . . 33

7 Glossário 34

II Adoção do Processo ágil 36

8 Iniciando a produção de uma nova edição do livro 38

8.1 Requisitos técnicos para uma Produção Ágil . . . . . . . . . . . . . . . . . . . . . . 39

8.2 Fluxo de trabalho do processo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

8.2.1 Diferencial de um Processo Ágil . . . . . . . . . . . . . . . . . . . . . . . . 40

8.2.2 Processos Tradicionais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

8.3 Seleção de Autores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

8.4 O livro anterior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

8.5 Instruções para os autores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

8.6 Priorizando a escrita do texto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

8.6.1 Calendário da produção . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

8.6.2 Atualizando as Instruções para os autores . . . . . . . . . . . . . . . . . . . 43

8.6.3 Entregando tudo para os autores . . . . . . . . . . . . . . . . . . . . . . . . 43

8.7 Recapitulando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

9 Logotipo do curso 45

10 Avaliando ferramentas 46

Curso Processo Ágil para Produção de Livros vii

11 Origem do processo 49

11.1 Processo editorial profissional . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

11.2 DocBook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

11.3 Asciidoc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

11.4 E-Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

11.5 Confiabilidade do Processo Ágil . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

12 Adoção do Processo 52

12.1 Possíveis dificuldades implementação do Processo . . . . . . . . . . . . . . . . . . 52

12.1.1 Desinformação . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

12.1.2 Falta de conhecimento técnico . . . . . . . . . . . . . . . . . . . . . . . . . 53

12.1.2.1 Autores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

12.1.2.2 Técnico da Produção . . . . . . . . . . . . . . . . . . . . . . . . 53

12.2 Recomendações para a adoção do Processo . . . . . . . . . . . . . . . . . . . . . . 54

12.2.1 Primeiro Momento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

12.2.2 Segundo Momento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

13 Consutoria 55

14 Índice Remissivo 56

Curso Processo Ágil para Produção de Livros 1 / 56

Parte I

Curso Básico


O curso básico tem a finalidade de apresentar o processo sem a utilização do ambiente de produção.

O participante do curso conhecerá o processo de produção, e será capaz de produzir um livro utili-zando o editor on-line do github.

No entanto, caso deseje escrever um livro utilizando o processo, recomandos a utilização do ambientede produção, que será abordado no curso intermediário.


Capítulo 1

Apresentação do curso

OBJETIVO DO CURSO

• Difundir método ágil de produção de material didático.

• Apresentar evidências da produtividade do método, utilizado no Curso de Licenciatura em Compu-tação, com intuito de compartilhá-lo para outras coordenações dos cursos a distância.

• Ao final do curso cada participante terá produzido um esqueleto de livro, com no mínimo um capí-tulo diagramado. Os livros produzidos serão apresentados no último dia de aula, em um encontropresencial (Culminância).

PÚBLICO ALVO

• Professores autores (ou que desejam ser)

• Membros das equipes de produção de livros

O propósito deste curso básico é que seus participantes conheçam um outro processo de produção demateriais, experimentando-o.

Quando o participante deste curso se deparar com a necessidade de elaboração de um novo livro, elesterão o conhecimento necessário para analisar e escolher um processo que melhor se adaptará aosrequisitos da nova produção.

Embora ao final do curso básico os participantes sejam capazes de produzir um livro, as ferramentasutilizadas no curso básico foram escolhidas por serem as mais simples1.

1.1 Planejamento do curso

Este curso foi elaborado para pessoas ocupadas e que dispõem de pouco tempo para empenhar nocurso. Desta forma, o curso foi planejado da seguinte forma:

• Atividades individuais1O ambiente de produção produtivo, recomendado para elaboração de livros reais, só será abordado no curso inter-

mediário.


• Atividades em grupo (somente no momento presencial)

• Baixa interação entre os participantes

• Vários fóruns com assuntos e momentos específicos.

1.2 Sobre o participante do curso

1.2.1 Instruções iniciais

A lista a seguir é um passo-a-passo para realização de todas as atividades do nosso curso.

1. Este livro será o seu guia para a execução do curso.

a. O livro encontra-se na sala de aula, sobre o nome “Livro do curso”. O livro está disponívelem duas versões: HTML e PDF. A versão HTML é preferível em relação à PDF, pois estelivro está em constante atualização, caso você opte por baixar a versão em PDF, lembre-seque depois o livro pode ter sido atualizado e talvez a sua versão não seja a mais recente.

b. Todas as instruções para o aluno se encontram no decorrer do livro

2. Ler o Capítulo 1 [3] do livro.

a. Este capítulo contém informações gerais sobre o curso.

3. Realizar as atividades da Aula presencial, contidas no Capítulo 2 [10].

NotaAs instruções da realização das atividades estão escritas no livro, mas também dis-ponibilizamos vídeos ilustrando-as.

a. Só avance para uma nova seção quando você tenha realizado todas as atividades da seçãoatual.

b. Utilize os fóruns apropriados para postar suas dúvidas.

c. Responda os questionários da plataforma indicados no livro

4. Realize as atividades do Playground no Capítulo 3 [22].

a. O playground é divido em 3 partes, faça uma de cada vez.

b. Realize a tarefa da plataforma indicada no último playground.

5. Trabalhe no seu livro.

a. Leia com atenção as instruções no Capítulo 4 [28]

b. Divulgue seu livro no fórum.

6. Apresente o seu livro na Culminância.


1.2.2 Sobre os vídeos e as instruções

O livro possui várias instruções e vídeos demonstrando a realização delas.

Quando você se deparar com as instruções, leia-as atentamente, procure entender o que está sendosolicitado.

INSTRUÇÕES PASSO A PASSO

1. Ande reto até a porta

2. Coloque sua mão sobre o trinco da porta

a. Gire o trinco no sentido horário e puxe a porta

b. Atravesse a porta

3. A porta irá abrir e você se deparará com um corredor

a. Siga o corredor à direita

4. Entre na segunda porta à esquerda

5. Procure uma xícara

6. Quando encontrar a xícara, vá até a máquina de café

7. Pressione a xícara contra a máquina de café

a. O café será despejado na xícara

8. Tome o seu café

Quando damos instruções passo a passo é difícil entender o resultado final, até que se chegue nele.

INSTRUÇÕES SIMPLES

1. Vá até a copa


2. Procure uma xícara e sirva-se na máquina de café

Pode parecer um exemplo besta, pois todos nós entendemos o que é a copa e como servir-se numamáquina de café.

Mas agora, imagine alguém que não sabe o que é copa, café, xícara, trinco e máquina de café.Como ela poderia seguir as instruções da segunda lista? Provavelmente ela teria dificuldades! Mas seela vir outra pessoa servindo-se, será mais fácil.

ImportanteTalvez você se sentirá um pouco assim em nossas práticas. Estarei dando instruções sim-ples, mas falando de coisas que você ainda não conhece ou nunca viu. Mas os vídeosestarão ali para lhe ajudar, você poderá consultá-los para entender como as instruções sãorealizadas. E, quando você realizar algumas vezes a nova prática, o processo será simplespara você também.

Elaboramos um Glossário [34] para ajuda-lo a compreender os termos do processo.

1.2.3 Cronograma para execução das atividades

O nosso curso não possui nenhum Cronograma semanal de atividades, quando você concluir as ativi-dades de uma seção, pode seguir para a próxima seção e realizar as atividades dela.

As atividades do curso irão encerrar no dia da Culminância.

1.2.4 Na Aula presencial

É esperado que o participante:

• Participe das discussões presenciais

• Respeite o limite do tempo reservado para a explanação dos assuntos na fase oral.

• Realize contribuições nos fóruns de discussões

NotaMesmo que você tenha participado na fase oral, a contribuição por escrito nos fóruns seráútil, uma vez que quem não pode participar do momento presencial só terá acesso a suacontribuição através dos fóruns.

1.2.5 Na continuidade do curso on-line

É esperado que o participante:

• Realize as atividades do Playground

• Caso tenha dúvidas, poste-as nos fóruns de discussões apropriados.


NotaExistem 3 fóruns de discussões, um para cada parte do Playground. Cada um deles espe-cifica os assuntos que devem ser tratados neles. Por exemplo, as Caixas de diálogo sãoabordadas no fórum 2, caso tenha dúvidas sobre elas, poste-as lá.Caso você tenha mais de uma dúvida, quebre sua dúvida em outras mensagens, de talforma a postá-las nos fóruns respectivos.

1.2.6 Produção individual

No curso será solicitado que o participante elabore um livro ou capítulo de livro, utilizando as ferra-mentas apresentadas no curso. Espera-se que o participante que se inscreveu no curso esteja em umdos seguintes perfis:

Deseja experimentar o processoQuem deseja experimentar o processo tem duas alternativas: utilizar um texto já produzidoou escrever um novo. Independente da escolha, espera-se que você esteja disposto e motivadoa empenhar seu tempo na sua produção individual.

AutoresProfessores que já escreveram disciplinas para EAD e desejam atualizar o material di-dático que possuem. Professores irão escrever o conteúdo de uma disciplina, ou aindaprofessores que desejam produzir livros independentes.

Técnicos de produçãoMembros da equipe de produção dos cursos. Trabalham diagramando os livros que outraspessoas escreveram. Neste caso, recomendo experimentar o processo com uma produçãoatual ou a mais recente. Para que você possa comparar os dois processos depois.

Deseja apenas conhecer o processoO participante que apenas deseja conhecer o processo talvez não esteja disposto a elaboraruma produção individual. Este seria o caso de pessoas que, apesar de estarem envolvidos naprodução dos livros, não atuam escrevendo ou produzindo os materiais (ex: Revisores ou coor-denadores de curso). Neste caso, você pode delegar a alguém, normalmente a pessoa encarre-gada disto no seu curso, para experimentar a produção individual. Utilize esta produção paraapresentar na Culminância.

1.3 Atuação dos ministrantes do curso

• Ministrar as aulas presenciais

• Acompanhar semanalmente o progresso de cada participante

• Responder às dúvidas sobre o curso básico

• Avaliar as atividades pontuadas

• Auxiliar na produção do livro (limitando-se ao conteúdo do curso básico)


1.4 Informações técnicas sobre o processo

Padrão utilizadoDocBook. Padrão internacional para produção de livros.

Linguagem utilizadaAsciidoc, linguagem simplificada, que exporta o conteúdo em conformidade com o padrãoDocBook.

Gerenciamento dos arquivosSistema de controle de versões de arquivos git, com repositórios remotos no Github.

Gerenciamento dos errosIssue track integrado do Github.

Editor de textoEditor web do Github. (Curso básico)

Engine de geração do livroServidor próprio, instalado na UFPB Virtual.

1.5 Encontrou erros no livro?

Nosso sistema de produção possui um gerenciamento de submissão de erros.

Figura 1.1: Exemplo de submissão de erro

DicaCaso você tenha encontrado erros no livro, por favor, poste o erro no link abaixo:https://github.com/edusantana/curso-processo-producao-livro/issues/new

http://pt.wikipedia.org/wiki/DocBook

http://asciidoc.org

https://github.com

https://github.com

https://github.com

https://github.com/edusantana/curso-processo-producao-livro/issues/new


1.6 Atividades na plataforma

Fórum para discussão

Capítulo 1 - Curso básico

http://www.ead.ufpb.br/mod/forum/view.php?id=31391



Capítulo 2

Aula presencial

OBJETIVOS DO MOMENTO PRESENCIAL

• Revisar o processo tradicional de produção de livros

• Compreender as vantagens do processo ágil

• Entender o que é o curso (Módulo básico)

– Ver livros prontos

– Mostrar delimitação do que será abordado no curso

• Conhecer como o curso será conduzido

• Realizar atividades que teriam dificuldades em realizarem sozinhos

2.1 Condução das Atividades

APRESENTAÇÃO

• Apresentar o curso

• A equipe

• Como o curso será conduzido (devido ao tempo curto)

– Atividades em blocos de 25 minutos, com contador visível

– Quando os 25 min acabarem, podemos ter mais 5 min adicionais no mesmo bloco

– Quando o tempo terminar, avançar para o próximo bloco


2.2 Apresentação do curso

Este curso consiste em apresentar um outro processo de produção de livros que possibilita sua aelaboração e re-edição rápida.

Mais detalhes podem ser consultados na Seção 1.4 [8].

DicaOs fóruns são recursos importantes, convido-os a participarem deles, mesmo durante nossosmomentos presenciais.

2.3 Agenda do dia presencial

• Início

– Apresentar o curso

– A equipe

– A condução da aula presencial

• 1º 25 min

– Apresentar livros já produzidos no processo tradicional

• 2º 25 min

– Características da produção na EAD

• 3º 25 min

– Discussão sobre os processos

• Break — 10 min

– Criando contas no github

– Escolher um tema para o livro

– Definindo grupos de autores e revisores

• 4º 25 min

– Iniciando um livro (atividade individual)

• 5º 25 min

– Revisando e tendo o seu livro revisado (atividade em grupo)

– Fazendo um fork do playground

• 6º 25 min


– Apresentação do restante do curso

– Como será a Avaliação

* Iniciando um livro e revisão 40%

* Asciidoc sintaxe (3 Partes) 60%

• 7º 25 min

– Fixando o que foi visto

– Respondendo dúvidas

2.4 1º 25 min

2.4.1 Apresentar livros já produzidos no processo tradicional

• Pedagogia

• Biologia

• Letras

• Matemática Outro

• Letras Libras

• Gestão Pública

• UFPB Virtual

NotaConvidar um representante de cada curso para apresentar o material do seu curso. Dividiro tempo apropriadamente.


1º 25 min - Apresentar livros já produzidos no processo ←↩tradicional

http://www.ead.ufpb.br/mod/forum/discuss.php?d=17333

2.5 2º 25 min

2.5.1 Características da produção de livros na EAD

• Recursos anuais para impressão.

• Livrão com várias disciplinas.

http://portal.virtual.ufpb.br/biblioteca-virtual/files/pub_1291084420.pdf

http://portal.virtual.ufpb.br/biblioteca-virtual/files/histaria_e_filosofia_das_ciancias_naturais_1361373549.pdf

http://portal.virtual.ufpb.br/biblioteca-virtual/files/linguastica_textual_1360183766.pdf

http://portal.virtual.ufpb.br/biblioteca-virtual/files/fundamentos_saciohistaricos_da_educaaao_1361970603.pdf


http://portal.virtual.ufpb.br/biblioteca-virtual/files/introduaao_aos_estudos_de_traduaao_1330351847.pdf


http://portal.virtual.ufpb.br/biblioteca-virtual/files/educaaao_a_distancia__coletanea_de_textos_para_subsidiar_a_docancia_online_1330089617.pdf



• O professor autor da disciplina costuma ser o primeiro a ministrá-la.

• Necessidade de atualização do material é constante.

• Ausência de financiamento para re-edição.

• O processo de produção tradicional dificulta a re-edição dos livros, mesmo com dinheiro para re-impressões.

Fazer é fácil, o difícil é manter.


2º 25 min - Características da produção de livros na EAD


2.6 3º 25 min

2.6.1 Discussão sobre os processos

Tabela 2.1: Tabela comparativa

Etapa Processo tradicional Processo propostoFluxo dotrabalho

Escrita→ Revisão→ Diagramação→RevisãoouEscrita→ Diagramação→ Revisão

Escrita→ Revisão→ Geração

Ferramentasde edição

Escrita: Word/Writer. Diagramação:Indesign/Word.

Escrita: Editor sem formatação (editorweb/gedit/mate/notepad++)

Envio dosarquivos

Autores enviam o texto somente nofinal, através de e-mail ou pen-drive.

Constantemente enviando a produção,através de um sistema de controle deversão (git/github).

Autores Quando dois autores trabalham em ummesmo texto, eles particionam otrabalho em capítulos e escrevemisoladamente.

Embora possam trabalharisoladamente, podem consultar ereferenciar o texto (em produção) dosdemais autores. Conhecem o estilo dooutro.

Revisão Realizada no impresso ou diretamenteno arquivo do word.

Realizada diretamente sobre osarquivos de texto. Pode ser feita porcapítulo.

Reportandoerros/suges-tões

Não há acompanhamento de erros. Osleitores não são incentivados areportarem erros.

Sistema padronizado para os leitoresreportarem erros e sugestões.Leitores podem submeter correções,que são avaliadas e podem serincorporadas através de um clique.




3º 25 min - Discussão sobre os processos


2.7 Break — 10 min

Durante este break é esperado que os participantes:

• Criem conta no github (quem ainda não criou)

• Decidir um tema para o livro que irá iniciar

• Escolher alguém para realizar atividade em dupla

ImportanteO próximo assunto é o mais importante do curso, não demorem no break.

2.8 4º 25 min

AtençãoAntes de prosseguir, certifique-se que você entende como os vídeos deve serem utilizados(Seção 1.2.2 [5]).O vídeo abaixo demonstra a realização desta atividade.

Figura 2.1: Iniciando um livro: http://youtu.be/0U32Or2eIlU


http://github.com

http://youtu.be/0U32Or2eIlU


2.8.1 Iniciando um livro (atividade individual)

CuidadoNesta seção solicito que realize uma alteração controlada, ou seja, altere somente o quefoi solicitado. Se você realizar outras alterações correrá o risco ter erro na geração do seulivro.

INICIANDO UM LIVRO (ATIVIDADE INDIVIDUAL)

1. Criar um login no github (somente se não o fez anteriormente)

2. Criar um repositório [35] para o seu livro

a. Link para criar repositório: https://github.com/new

b. O nome do repositório não pode conter acentos e espaços, ex: historia-da-traducao-pb-livro

ImportanteMarque a opção “Initialize this repository with a README”. Se esta opção nãofor marcada, o livro não será gerado.

c. Após a criação, você será direcionado para a página do repositório do seu livroi. Um questionário solicitará este endereço.

3. Criar um arquivo livro/livro.asc no seu repositório do github

a. Para criar clique no ícone e digite livro/livro.ascb. Em outra aba, acessar: https://raw.github.com/edusantana/curso-processo-producao-

livro/iniciando-livro/livro/livro.asc

AtençãoSe você estiver acessando o livro PDF através do navegador, é possível queclicando no link acima seu navegador saia do livro e entre no link indicado. Alémdisso, o CTRL+Clique não o abrirá em uma nova aba.Neste caso, recomendo copiar o link e abri-lo numa nova aba manualmente.

c. Copiar o conteúdo deste arquivo para o livro/livro.asc em criação.

d. Clique em Commit new file para concluir a criação do arquivo.

4. Gerar o livro

a. Entrar no site http://producao.virtual.ufpb.br/github.html

b. Digitar o endereço do seu repositório e clicar em Gerari. Um questionário solicitará este endereço como resposta.

5. Ver o pdf e o html do livro gerado

http://github.com

https://github.com/new

https://raw.github.com/edusantana/curso-processo-producao-livro/iniciando-livro/livro/livro.asc

https://raw.github.com/edusantana/curso-processo-producao-livro/iniciando-livro/livro/livro.asc

http://producao.virtual.ufpb.br/github.html


a. Após a geração do livro, são apresentados links para as duas versões do livro (PDF eHTML).

i. Um questionário solicitará estes links do pdf e do html.

6. Realizar alteração controlada no arquivo livro/livro.asc

a. Localize o arquivo livro/livro.asc e clique em Edit

b. Alterar o nome do primeiro capítulo: “Meu primeiro capítulo”. Altere para qualquer outronome.

7. Visualizar as alterações realizadas

a. Na página do seu repositório [35], clique em Commits. Localize o seu [commit] [34].

i. Um questionário solicitará o endereço deste commit.

Questionário na plataforma

4º 25 min - Iniciando um livro

• Qual o endereço do repositório do seu livro (no github)?

• Qual o endereço do livro pdf gerado (no servidor da produção)?

• Qual o endereço do livro html gerado (no servidor da produção)?

• Qual o endereço do commit mostrando as alterações realizadas (no github)?

http://www.ead.ufpb.br/mod/quiz/view.php?id=31076


Fórum referente a Aula Presencial‘-4º 25 min - Iniciando um livro





2.9 5º 25 min

AtençãoO vídeo a seguir demonstra a atividade que será realizada. No vídeo, Walmyra adiciona doisinstrutores como colaboradores. Ao realizar esta atividade em pares, adicione o seu revisortambém.Depois de receber a permissão, Camyle procura pelo repositório de Walmyra e realiza a re-visão nele. Você precisará conversar com o seu revisor para informar o nome do repositório,para que ele possa encontrar.

Figura 2.2: Revisando e tendo o seu livro revisado: http://youtu.be/TB4kvNhPqJw

2.9.1 Revisando e tendo o seu livro revisado (atividade em dupla)

REVISANDO E TENDO O SEU LIVRO REVISADO (ATIVIDADE EM DUPLA)

1. Definindo revisores

2. Dando permissão (revisor, ministrante e tutor) para atualizarem o seu livro

a. Na página do seu repositório [35], clicar em settings/Collaborators

b. Adicione: edusantana, camyle, login_do_seu_revisor

3. Revisar o conteúdo alheio

a. Após o seu par ter adicionado permissão para você alterar o repositório dele, abra apágina do repositório do seu par e edite o arquivo livro/livro.asc

AtençãoNo vídeo, pode parecer que deve logar com o usuário e senha de outra pessoa.Não é este o caso!Você deve ter trocado, com o seu par, os endereços dos repositórios de vocês.Esta troca pode ser realizada verbalmente ou através de mensagens privadas.Em seguida, com o seu próprio usuário, você irá abrir o repositório dele paraefetuar a revisão no livro dele.

http://youtu.be/TB4kvNhPqJw


i. Quem não veio no momento presencial ou ficou sem par, pode solicitar à tutora pararealizar a revisão em seu livro.

b. Altere o texto do segundo capítulo para ficar da seguinte forma:

== Capítulo para o revisor atuar

No primeiro dia, vamos fazer uma atividade em que teremoso nosso livro revisado por outra pessoa.

// REVISÃO: (escreva uma mensagem de revisão aqui)// Esta mensagem de revisão não será mostrada no livro,// apenas os autores tem acesso.

Este capítulo tem o intuito de fornecer um texto para quenosso revisor possa simular realização de uma revisão emnosso livro. Inclusive corrigindo este trecho que foiescrito errado de propósito, mas agora está correto.

c. Clique em Commit Changes para concluir a editação do arquivo.

4. Visualizando o commit da revisão

a. O commit mostra as alterações realizadas pelo revisor.

i. Um questionário solicitará o endereço deste commit.

Questionário na plataforma

5º 25 min - Revisando e tendo o seu livro revisado

• Qual o endereço do commit da revisão que realizei no livro da outra pessoa?

• Qual o endereço do commit da revisão que realizaram no meu livro?



Fórum referente a Aula Presencial‘-5º 25 min - Revisando e tendo o seu livro revisado





2.10 6º 25 min

Figura 2.3: Planejamento do curso

2.10.1 Atividades on-line

PLAYGROUNDS

• Playground - Parte 1/3 (atividade on-line individual)



2.10.2 Produção do seu livro

• Elaboração de no mínimo um capítulo de um livro

• Recebimento de erros, sugestões e correções

2.10.3 Culminância

• Apresentação dos livros/capítulos produzidos por vocês.

• Formulário de avaliação do curso (críticas e sugestões)

2.10.4 Avaliação das atividades

• Iniciando um livro e revisão 40%

• Playground (3 Partes) 60%

• Produção do livro não será pontuada

2.10.5 Fóruns

O curso possui vários fóruns temáticos. Caso você tenha várias dúvidas diferentes, ao invés de escre-ver uma mensagem só, procure quebrar suas dúvidas em mensagens menores e postá-las nos fórunsapropriados.


2.10.6 Curso intermediário

Os seguintes assuntos serão abordados apenas no curso intermediário:

1. Conjunto de ferramentas e padrões utilizados no processo

2. Instalação de ambiente de produção [34] no computador

3. Utilização de editores de texto (requer ambiente de produção)

4. Como submeter imagens (requer ambiente de produção)

5. Capítulos e Seções especiais (Prefácio, Referências, Glossário, Apêndice, etc.)

6. Uso avançado de tabelas

7. Como inserir vídeos do youtube com QRCODE

8. Como elaborar gráficos avançados

9. Como dividir o livro em arquivos por capítulo

10. Como dividir o livro por disciplina


6º 25 min - Planejamento do curso


2.11 7º 25 min

2.11.1 Fixando o que foi visto

• Livros produzidos no processo tradicional

• Características da produção dos livros na EAD

• Criando um repositório [35] e iniciando um livro

• Revisando e tendo o seu livro revisado

• Playground - atividades on-line

• Produção de um livro

• Apresentação do livro produzido

• Fóruns temáticos



2.12 Exemplos de livros que utilizam este processo

Para que você possa conhecer o layout do processo, elaboramos uma lista de livros que estão emprodução ou foram produzidos neste processo:

• Introdução a EAD: http://producao.virtual.ufpb.br/books/edusantana/introducao-a-ead-livro/livro/-livro.pdf

• Introdução a Computação: http://producao.virtual.ufpb.br/books/edusantana/introducao-a-computacao-livro/livro/livro.pdf

• Cálculo diferencial e integral: http://producao.virtual.ufpb.br/books/edusantana/calculo-diferencial-e-integral-livro/livro/livro.pdf

• Fundamentos Sócio-Históricos da Educação: http://producao.virtual.ufpb.br/books/edusantana/-calculo-diferencial-e-integral-livro/livro/livro.pdf

• Introdução a Programação: http://producao.virtual.ufpb.br/books/edusantana/introducao-a-programacao-livro/livro/livro.pdf

• Metodologia do Trabalho Científico: http://producao.virtual.ufpb.br/books/edusantana/-metodologia-do-trabalho-cientifico-livro/livro/livro.pdf

http://producao.virtual.ufpb.br/books/edusantana/introducao-a-ead-livro/livro/livro.pdf

http://producao.virtual.ufpb.br/books/edusantana/introducao-a-ead-livro/livro/livro.pdf

http://producao.virtual.ufpb.br/books/edusantana/introducao-a-computacao-livro/livro/livro.pdf

http://producao.virtual.ufpb.br/books/edusantana/introducao-a-computacao-livro/livro/livro.pdf

http://producao.virtual.ufpb.br/books/edusantana/calculo-diferencial-e-integral-livro/livro/livro.pdf




http://producao.virtual.ufpb.br/books/edusantana/introducao-a-programacao-livro/livro/livro.pdf

http://producao.virtual.ufpb.br/books/edusantana/introducao-a-programacao-livro/livro/livro.pdf

http://producao.virtual.ufpb.br/books/edusantana/metodologia-do-trabalho-cientifico-livro/livro/livro.pdf

http://producao.virtual.ufpb.br/books/edusantana/metodologia-do-trabalho-cientifico-livro/livro/livro.pdf


Capítulo 3

Playground

O objetivo do playground é ter contato com um texto já pronto, demonstrando os recursos básico doprocesso. Utilizar estes textos para gerar arquivos em PDF e compará-los com os textos originais.

3.1 Resumo do que será aprendido no Playground

PLAYGROUND - PARTE 1/3 (ATIVIDADE ON-LINE INDIVIDUAL)

• Alterando o título do livro

• Configurando os autores

• Capítulos e Seções

• Inserindo texto

• Referenciando capítulos e seções

• Listas


• Estilos de parágrafos

• Caixas de diálogo

• Nota de rodapé

• Índice remissivo

• Inserindo imagem (sem submissão)


• Estilos de caracteres

• Tabelas simples

• Gráficos simples

• Fórmulas matemáticas do latex


3.2 Realizando um Fork do Playground

Para iniciar as atividades do playground, primeiro será necessário criar um fork [34] do playgroundpara você.

AtençãoO fork [34] do repositório só precisa ser realizado vez. Quando você realizar o fork, o Github[34] irá criar uma cópia deste repositório [35] para você.A geração do livro a partir do seu fork do playground, demonstrada junto com este vídeo,será uma atividade que você irá repetir em todos os playgrounds.

Figura 3.1: Realizando fork do playground e gerando o livro: http://youtu.be/gI4X-kj5HlE

• Efetue seu login no github: https://github.com/login

• Realize um fork [34] no repositório do playground acessado o link: https://github.com/edusantana/-playground-asciidoc/fork

Após o fork, você será direcionado para um repositório com o nome do seu usuário:

Endereço do seu fork do playground

https://github.com/SEU-USUÁRIO-AQUI/playground-asciidoc/

3.2.1 Gerando o livro a partir do fork do playground

1. Acesse http://producao.virtual.ufpb.br/github.html e informe o endereço do seu fork [34] doplayground.

2. Fique para gerar o livro.

3. Verifique o livro gerado.

http://youtu.be/gI4X-kj5HlE

https://github.com/login

https://github.com/edusantana/playground-asciidoc/fork

https://github.com/edusantana/playground-asciidoc/fork

http://producao.virtual.ufpb.br/github.html


3.3 Playground - Parte 1/3

OBJETIVOS

Neste playground nós vamos aprender como:

• Alterando o título do livro• Configurando o autor• Como inserir capítulos e seções• Escrever parágrafos• Referenciando capítulos e seções• Como fazer Listas

Você irá aprender todos estes recurso no livro do playground que você irá gerar na próxima seção.

3.3.1 Gerando o livro do Playground 1

NotaAs instruções para gerar o livro deste playground são demonstradas no vídeo a seguir.

Figura 3.2: Gerando livro do Playground: http://youtu.be/6FAZFh_TiiY

A geração dos outros playgrounds são similares, não havendo a necessidade de novos ví-deos.

1. Acesse o arquivo: https://raw.github.com/edusantana/playground-asciidoc/playground1/livro/-livro.asc

2. Copie o conteúdo dele (Ctrl+C)

3. Abra o link do fork [34] do seu playground no navegador

a. O endereço do fork é o mesmo que foi mencionado em Endereço do seu fork do play-ground [23]

4. Edite o arquivo livro/livro.asc

5. Apague todo o conteúdo anterior e cole o conteúdo do arquivo mencionado acima.

Gere o livro do playground conforme explicado em Seção 3.2.1 [23].

http://youtu.be/6FAZFh_TiiY

https://raw.github.com/edusantana/playground-asciidoc/playground1/livro/livro.asc



3.3.2 Estudando o Playground

O estudo do playground deve ser feito comparando o livro pdf gerado com o código fonte do livro(livro/livro.asc).

3.3.3 Próximos passos


Fórum sobre Playground 1


• Realizar o Playground 2

• Aplicar o conhecimento adquirido aqui no seu livro


OBJETIVOS

Neste playground nós vamos aprender como usar:

• Estilos de parágrafos

• Caixas de diálogo

• Índice remissivo

• Nota de rodapé

• Imagem





3. Abra o fork [34] do seu playground

a. Este é o que foi mencionado em Endereço do seu fork do playground [23]














• Realizar o Playground 3



OBJETIVOS

Neste playground nós vamos aprender como usar:

• Estilos de caracteres

• Aspas

• Tabelas simples

• Desenhando gráficos

• Fórmulas matemáticas do Latex





3. Abra o fork [34] do seu playground

a. Este é o que foi mencionado em Endereço do seu fork do playground [23]











Atividade na plataforma

Playground (União de todas as partes)

http://www.ead.ufpb.br/mod/assign/view.php?id=31280





• Preparar seu livro para a Culminância




Capítulo 4

Produção do seu livro

Durante a realização dos playgrounds você praticou como gerar um livro a partir de um repositório[35]. Além disso, teve contato com a sintaxe da linguagem utilizada para criar os livros.

Agora você pode trabalhar no seu próprio livro, que foi iniciado na aula presencial inicial.

DicaVocê não precisa escrever um conteúdo novo, você pode simplesmente copiar o conteúdode uma disciplina já pronta, do material do seu curso, e utilizá-la.O objetivo desta atividade é criar um livro no formato apresentado neste curso, a originalidadedo texto é irrelevante.

Esperamos que você se dedique em colocar em prática as técnicas apresentadas no curso.

4.1 Adição e submissão de imagem

No Playground foi ensinado apenas a inserir imagens já submetidas ao repositório [35]. Isto porquea submissão de imagens requer um ambiente de produção [34] não abordado no curso básico.

Haverá na plataforma, uma atividade de envio único, que você poderá submeter até duas imagens.Os instrutores do curso irão receber estas imagens e adicioná-las ao seu repositório [35], para quevocê possa inserir no seu livro.

Atividade na Plataforma

Deseja adicionar uma imagem ao seu livro?


Para que os instrutores possam submeter as imagens é necessário que você tenha adicionado elescomo colaboradores no seu repositório [35], como indicado em Revisando e tendo o seu livro revisado(atividade em dupla) [17].



4.2 Sugestões, erros e correções

Na Seção 2.6.1 [13], nós mencionamos que neste processo nós temos um sistema padronizado paragerenciar erros e sugestões. Inclusive possibilitando submissão de correções.

NotaUm Issue [34] é um termo genérico que irá representar sugestões, erros, críticas ou corre-ções.

Como dono do repositório [35] que contém seu livro, você receberá um e-mail, informando sobre umIssue [34], sempre que os leitores enviarem uma sugestão, erro ou correção. Você terá total liberdadepara acatar ou rejeitar o Issue [34].

4.2.1 Simulação de um leitor enviando uma correção

Se você informou o repositório do seu livro, no questionário apropriado, na semana final do curso, osinstrutores do curso irão simular a atuação de um leitor do seu livro enviando uma correção para oseu repositório [35], através de um recurso chamado Pull Request [35].

Figura 4.1: Recebendo uma correção (pull request)

Como dono do repositório, você irá receber um e-mail informando sobra a existência de um PullRequest [35]. Clicando no link do e-mail ou em Pull Requests na página do seu repositório [35],você irá ter acesso à tela indicanda na Figura 4.1 [29]. Para verificar as correções sugeridas, vocêpoderá clicar em Commits. Em seguida você terá algumas opções:

Rejeitar as correçõesCaso não deseje aceitar as correções, escreva um comentário explicando para o leitor o porquêde está desconsiderando as correções dele. E clique em Close.


Aceitar as correçõesCaso deseje aceitar as correções, clique em Merge pull request. Depois escreva para o leitorinformando que suas alterações foram incorporadas ao livro. Clique em Close. As correçõesenviadas serão automaticamente incorporadas ao seu livro.

Conversar com o leitor sobre a correçãoCaso deseje conversar com o leitor sobre a correção sugerida, deixe um comentário para ele eclique em Comment.

AtençãoOs botões Close e Comment, junto com o espaço para digitar os comentários não estãoexibidos na Figura 4.1 [29], mas estarão lá, mais abaixo, na página.


Recebendo uma correção no seu livro


4.3 Compartilhando com os demais a sua produção

Neste momento convidamos a todos a incentivarem os demais participantes do grupo a iniciarem aprodução do seu livro. Compartilhe o link do seu livro, especialmente na etapa de produção (não es-pere que o livro esteja finalizado), no fórum abaixo para que os demais participantes possam aprendercom você.

Reserve um momento para conhecer e elogiar o trabalho dos seus colegas de turma.


Divulgando a produção do seu livro com os demais ←↩participantes





Capítulo 5

Culminância

Na Culminância todos participantes serão convidados à mostrar o livro que produziram, utilizando astécnicas e ferramentas mostradas nesse curso.

5.1 Avaliando o curso

Ao final do curso, iremos disponibilizar uma pesquisa de opinião para avaliar o curso.

Atividade na plataforma

Formulário de Avaliação do Curso

https://docs.google.com/forms/d/1heE7dPRJTyWIfWHnEkCaBywELnyJeGac6-CfBjh98-g/-viewform

https://docs.google.com/forms/d/1heE7dPRJTyWIfWHnEkCaBywELnyJeGac6-CfBjh98-g/viewform

https://docs.google.com/forms/d/1heE7dPRJTyWIfWHnEkCaBywELnyJeGac6-CfBjh98-g/viewform


Capítulo 6

Perguntas frequentes - FAQ

Este capítulo contém perguntas frequentes e suas respectivas respostas.

6.1 Perguntas gerais

6.1.1 Além de livros, pode ser utilizado para monografias, dissertações, tesese relatórios?

Os livros produzidos por este formato NÃO SEGUEM as normas da ABTN para os trabalhos acadê-micos. O livro gerado não servirá para os propósitos onde há esta restrição.

6.1.2 Depois de várias revisões, eu posso retomar uma revisão antiga e con-tinuar a partir dela?

Sim é possível, embora não será abordado no nosso curso básico.

6.1.3 É possível juntar todos os livros e gerar um único para o livro do pe-ríodo?

No curso básico nós temos um livro sendo gerado a partir de um único arquivo, portanto o participantedo curso pode ser levado a pensar que para gerar um livrão com todas as disciplinas seria necessáriojuntar vários livros.

No curso intermediário veremos como dividir o livro em partes (por disciplina), e em diversosaquivos, geralmente um por capítulo. Desta forma, diversos autores poderão manipular arquivosdiferentes, sem interferir no trabalho dos outros.

Ao final, teríamos um único livro, com um índice divido por partes: Parte 1 - Disciplina X, Parte 2 -Disciplina Y. Seguido dos capítulos e seções de cada parte.

6.1.4 Como apago um repositório ou fork?

Para apagar um repositório [35] ou fork [34], entre no endereço do repositório, clique em Settings,em seguida, clique no botão Delete this repository.


Uma mensagem similar com a seguinte irá aparecer:

Mensagem de confirmação de exclusão do repositório

This action CANNOT be undone. This will delete the edusantana/playground-asciidoc reposi-tory, wiki, issues, and comments permanently.

Please type in the name of the repository to confirm.

Para conseguir apagar o repositório, você precisará copiar e colar o nome dele, no exem-plo acima, o nome seria playground-asciidoc. Em seguida, clique em I understand theconsequences, delete this repository para efetivar a exclusão.

../redirect/questionario01.html

6.1.5 Como faço para alterar minha foto no github?

A foto do Github [34] pode ser configura no site: http://pt.gravatar.com. Basta que você se inscrevacom o mesmo e-mail da conta do github.

6.1.6 Como inserir um link clique aqui no texto?

Clique http://www.virtual.ufpb.br[aqui] para acessaro site da UFPB Virtual.

Clique aqui para acessar o site da UFPB Virtual.

CuidadoSe você for planeja distribuir o livro no impresso, não utilize o link desta forma, pois o leitornão irá ver o link. Prefira sempre digitar o link inteiro:

Acesse o site da UFPB Virtual: http://www.virtual.ufpb.br.

http://pt.gravatar.com

http://www.virtual.ufpb.br

http://www.virtual.ufpb.br


Capítulo 7

Glossário

Ambiente de produçãoConjunto de ferramentas utilizadas para a produção dos livros reais, por exemplo, para submis-são de imagens para o Github [34] é necessário o ambiente de produção. Como a utilizaçãodo ambiente de produção requer uma curva de aprendizado maior, o curso básico não abordanenhum recurso que necessite dele. Mas é importante saber que ele é essencial na produçãoreal de um livro.

CommitConjunto de alterações realizadas num arquivo e enviadas para o repositório [35].

ForkUm fork é basicamente uma cópia individual de um repositório [35] de outra pessoa. Nestecurso é solicitado realizar um fork do repositório do Playground. Portanto você terá um novorepositório cujo conteúdo é o mesmo do repositório original. Você poderá inclusive adicionarpermissões diferentes ao seu repositório. Perceba que você terá um link de acessa para o seufork/repositório: https://github.com/SEU-USUÁRIO-AQUI/playground-asciidoc/

Para saber mais sobre fork, consulte: https://help.github.com/articles/fork-a-repo.

GitGit é sistema de controle de versão descentralizado. Sem o ambiente de produção [34] o usuárionão perceberá a descentralização dos arquivos, pois os arquivos estarão mantidos apenas Github[34]. Para saber mais sobre o git consulte: http://git-scm.com ou http://git-scm.com/book/pt-br/Primeiros-passos-Sobre-Controle-de-Vers%C3%A3o.

GithubO github (http://github.com) é um site que oferece o serviço de controle de versão git [34], eum conjunto de outras ferramentas para auxiliar a gestão de um repositório [35], como Issuetracker.

IssueUm Issue é um incidente. O Github [34] possui um sistema de gerenciamento de incidentes(Issue tracker) integrado. Exemplos de incidentes são erros (bugs) e correções reportadas, queficam aguardando avaliações. Quando um incidente é registrado, ele é marcado como aberto(open), quando ele é finalizado alguém o marca como finalizado (closed).

https://github.com/SEU-USU�RIO-AQUI/playground-asciidoc/

https://help.github.com/articles/fork-a-repo

http://git-scm.com

http://git-scm.com/book/pt-br/Primeiros-passos-Sobre-Controle-de-Vers%C3%A3o


http://github.com


Para saber consulte mais sobre um Issue tracker consulte:http://en.wikipedia.org/wiki/Issue_tracking_system ou http://pt.wikipedia.org/wiki/-Sistema_de_gerenciamento_de_incidentes.

Pull RequestUm Pull Request é uma alteração submetida ao seu repositório [35]. O leitor que tiver osconhecimentos técnicos necessários para submissão de uma correção poderá fazê-lo através deum Pull Request. A vantagem da submissão da correção, em relação a submissão de errosé que o autor do livro pode aceitar as correções e elas serão automaticamente incorporadasao seu livro. Para saber mais, consulte: https://help.github.com/articles/using-pull-requests ehttps://help.github.com/articles/merging-a-pull-request.

RepositórioRepositório é um local que possibilita guardar arquivos mantendo um controle de versões, ouseja, as versões iniciais dos arquivos e todas as alterações realizadas neles. Um repositóriopossui propriedades de acesso (quem é o dono, quem pode ler os arquivos, quem pode alterar,etc.) e um histório de commits. Para saber mais sobre um repositório git [34], consulte:http://git-scm.com/book/pt-br/Primeiros-passos-Sobre-Controle-de-Vers%C3%A3o.

Quando fazemos referência à página do repositório, estamos nos refe-rindo à página do seu repositório no github. O link é parecido com:https://github.com/edusantana/introducao-a-computacao-livro.

Percebam que o link termina com o nome do repositório. Muitas pessoas confundem o link dorepositório passando outros valores no seu lugar. Exemplo de link errado: https://github.com/-edusantana/introducao-a-computacao-livro/tree/master/livro.

http://en.wikipedia.org/wiki/Issue_tracking_system

http://pt.wikipedia.org/wiki/Sistema_de_gerenciamento_de_incidentes

http://pt.wikipedia.org/wiki/Sistema_de_gerenciamento_de_incidentes

https://help.github.com/articles/using-pull-requests

https://help.github.com/articles/merging-a-pull-request


https://github.com/edusantana/introducao-a-computacao-livro/tree/master/livro

https://github.com/edusantana/introducao-a-computacao-livro/tree/master/livro


Parte II

Adoção do Processo ágil


Após ter contato com o Processo Ágil de Produção de livros no curso básico você pode estar desejandoque a coordenação do seu curso adote o processo também.

Nesta parte abordamos alguns pontos para auxiliar nas discussões sobre a adoção do Processo.


Capítulo 8

Iniciando a produção de uma nova edição dolivro

CENÁRIO

O coordenador do curso vem até você e diz que conseguiu financiamento para produziruma nova edição dos livro do curso, mas que o livro precisam ir para a gráfica dentrode três meses, caso contrário perdermos o financiamento. Embora vocês já tenham pro-duzidos livros antes, a equipe original de produção não mais trabalham com vocês. Vocêficou encarregado de todo o Processo de Produção:

• Quais as ferramentas que serão utilizadas na produção?• Quem serão as pessoas que irão trabalhar na produção?

– Quem serão os autores?– Quem serão os técnicos da produção?

• Qual é o trabalho que cada uma irá realizar no processo?• Como cada parte do livro deve ser produzida?• Como será o calendário das atividades?• Qual será o plano de contingência em caso de sobrecarga de trabalho com

– algum autor com outras ocupações e pouco tempo dedicar à produção?– com o revisor ao receber todos os textos numa mesma data?– os técnicos de produção ao receber todos os textos numa mesma data?

Apenas três meses para produzir uma nova edição de um livro com vários autores? Será que é possí-vel? Não temos tempo a perder!

Mas por onde começamos?

Obviamente precisamos chamar os autores para que eles iniciem a produção o quanto antes! Masquem serão os autores? Quais as obrigações deles?

Antes de chamar os autores você precisa definir como será a produção do livro, e quais as ferramentasserão utilizadas.

NotaPor enquanto, só temos uma certeza: Precisamos de um Processo Ágil de produção, poistemos pouco tempo!


Como decidir quais ferramentas serão utilizadas na produção? Quais parâmetros devo utilizar paracomparar e escolher as ferramentas?

Ainda bem que esta pesquisa já foi feita e está publicada a seguir.

8.1 Requisitos técnicos para uma Produção Ágil

Para que o Processo seja Ágil, precisamo utilizar ferramentas que facilitem o nosso trabalho.

Vamos ver uma relação de requisitos para uma Produção Ágil de livros:

Uniformidade nos estilosToda produção de qualidade possui uma uniformidade de estilos de página, de títulos, caixas,de parágrafos, tabelas, etc. Embora possamos atingir esta uniformidade configurando manu-almente cada parte do texto, nós queremos definir como são os estilos e apenas aplicá-los aolongo do livro.

Geração automática do sumárioEmbora o mais importante do livro seja o seu conteúdo, fazer um sumário manualmente de-manda tempo. Em nossa produção a geração do sumário deverá se automatizada.

Numeração automática para capítulos e seçõesOs capítulos e seções do livro deverão seguir uma numeração controlada pelos estilos aplicadosao texto. Isto irá garantir que não exista lacuna nas seções.

Numeração automática para imagensToda imagem no texto deverá conter uma numeração e ela será referenciada no texto através doseu número, exemplo: “Veja na Figura 2.5 . . . ”. A numeração das imagens deve ser controladapela ferramenta, para evitar duplicidade e caso haja necessidade de adicionar um nova imagem,isto não afetar o restante do texto.

Alterações não devem gerar impactos globaisSe for necessário realizar alguma alteração no livro, a alteração não irá gerar impacto no res-tando do documento. Por exemplo, se eu adicionar uma nova página com conteúdo, não pre-cisarei me preocupar com atualização de numeração de imagens, de seções ou de paginas nosumário.

Identificar o trabalho dos membro da equipePara poder acompanhar o trabalho de cada um dos envolvidos, deve existir alguma forma paraidentificar a extensão do trabalho realizado por cada um dos membros da produção.

Contratar mais pessoas para produção se necessárioO trabalho nunca poderá ficar “emperrado” em uma única pessoa. Se em algum momento euperceber que minha equipe de produção esteja sobrecarregada, poderei contratar outras pessoaspara ajudá-la. Os novos contratados poderão contribuir de imediato, sem precisar aguardar poroutras pessoas.

Re-edição fácilApesar de estarmos produzindo uma nova edição do livro agora, você sabe que no futuro o livroserá re-editado novamente, e você quer garantir que a re-edição seja o mais fácil possível.


Implementação em tempo hábilEmbora tudo isto seja desejável, o mais importante é produzir o livro dentro do limite detempo que possui. Se alguns destes pontos não ajudar a produzir o livro neste limite, entãodesconsidere-o da sua lista.

8.2 Fluxo de trabalho do processo

O fluxo de trabalho será o mesmo utilizado nas produções anteriores:

8.2.1 Diferencial de um Processo Ágil

Figura 8.1: Diferencial do fluxo ágil

8.2.2 Processos Tradicionais

Figura 8.2: Fluxo tradicional com produção inteira no Word


Figura 8.3: Fluxo tradicional com diagramação

Geralmente os autores serão os mesmos do livro anterior e cada uma será responsável por atualizar asua parte. Mas e se houver necessidade de chamar outros autores?

8.3 Seleção de Autores

Como chamar um alguém para ser autor do livro sem causar mal estar nos demais professores daequipe que não foram convidados?

Nós recomendamos a execução de um processo seletivo transparente, levando em consideração aexperiência dos professores na área de cada disciplina.

NotaFicou faltando referenciar exemplo de processo seletivo aqui. Você tem sugestões?

Os novos (ou antigos) autores irão receber o texto do livro da versão anterior, junto com as Instru-ções para os autores e lhe será solicitado que entregue um novo texto que irá compor a nova ediçãodo livro.

8.4 O livro anterior

Para que os novos autores possam escrever a nova edição do livro, vamos precisar entregar o livroda versão anterior para eles atualizarem. Mas como o livo anterior foi produzido? A seguir temos osprováveis casos:

Escrito no WordQuando o livro é escrito no Word e finalizado nele, o arquivo final da produção pode ser passadopara os autores iniciarem o trabalho. Este cenário é bastante simples.

Escrito no Word e Diagramado em outro programaQuando o livro é escrito no Word e diagramado em outro programa, a versão final do livro estánum programa diferente do Word. O livro sofreu alterações durante a diagramação, caixas efiguras foram postas em posições diferentes.

O arquivo final da diagramação serve apenas para a impressão. Por exemplo, ninguém irápassar para um autor um livro diagramado no In-Design esperando que ele atualize o livroneste programa.

O autor necessita de um arquivo num formato que possibilite editoração do texto.


AtençãoNeste caso o livro precisará ser exportado para o formato do Word, antes de ser entre-gue aos autores. Você precisará de um computador com o programa de diagramaçãoinstalado (as vezes precisa ser a mesma versão em que ele foi produzido) para realizaresta exportação.Esta exportação está longe de ser perfeita, vários elementos estarão desconfiguradose precisarão da atenção de alguém para colocá-los em ordem.

Escrito em LatexCaso o livro tenha sido escrito em Latex, os arquivos finais da produção serão repassados parao autor. Este cenário será simples ou complexo dependendo da habilidade do novo autor emsaber escrever em Latex.

Mas antes de enviar os arquivos da versão anterior para os autores, você ainda precisa criar o docu-mento Instruções para os autores para especificar o que você espera de cada autor.

8.5 Instruções para os autores

As Instruções para os autores é um documento especificando como o autor deverá entregar o textoatualizado.

Este documento provavelmente já existe das produções anteriores.

Algumas informações gerais contidas neste documento:

• Como deve ser a formatação do documento?

• Como deve ser a linguagem utilizada no texto?

• Quais os elementos necessários no texto?

• Será exigido seção contendo exercícios?

• As imagens devem ser entregues a parte?

• Quais as caixas de diálogos que podem ser utilizadas? Como elas devem ser criada?

• Com que frequência o autor deve enviar o trabalho em andamento?

NotaFicou faltando anexar aqui exemplos do documento Instruções para os autores.

Mas o conteúdo deste documento possui uma relação com o Processo de Produção do livro, que aindanão definimos:

• Qual a ferramenta que o autor deverá utilizar para edição do livro?


• Nós iremos fazer alguma diagramação ou apenas iremos juntar os arquivos dos autores e gerar umlivro, no mesmo formato que eles entregarem?

– O autor precisará aplicar os estilos da produção?

– O autor sabe trabalhar com aplicação de estilos?

– Estes estilos já foram criados?

• Se vamos diagramar, qual a ferramenta será utilizada?

• O autor deve entregar parciais do trabalho para que possamos monitorar o seu trabalho ou apenas olivro inteiro (após um prazo determinado)?

• O autor precisará ir às reuniões da produção?

8.6 Priorizando a escrita do texto

Nós não temos tempo a perder!

Quanto tempo irá demorar para definir o processo? Nós vamos utilizar o mesmo do anterior? Iremoscriar um novo, nos certificando de que ele será um processo ágil?

Devido ao tempo curto, você decide que a escrita do texto deve começar de imediato e inicia a elabo-ração de uma calendário da produção.

8.6.1 Calendário da produção

No Calendário da Produção, você reserva dois terços do tempo para a produção dos autores e orestante para finalizar o livro:

Escrita Produção Final2 Meses 1 Mês

Com o calendário pronto, falta atualizar as Instruções para os autores.

8.6.2 Atualizando as Instruções para os autores

Com base no seu documento anterior e as informações contidas na Seção 8.5 [42], você elabora onovo documento contendo as novas Instruções para os autores.

8.6.3 Entregando tudo para os autores

Você marca uma reunião com os autores, e entrega a cada um deles:

• Instruções para os autores

• Os arquivos da produção anterior

• O calendário de produção


• Planilha de contatos da sua equipe de produção (caso exista)

E solicita dos autores:

• Telefones para contato (celular, residencial, cônjuge)

NotaAs vezes será necessário entrar em contato com o autor em caráter de urgência, estestelefones irão ajudá-lo a conseguir caso o principal esteja inacessível.

8.7 Recapitulando

Você recebeu a responsabilidade de atuar na coordenação da produção do material didático do seucurso. Mas você só tem três meses para produzir uma nova versão de um livro.

Neste capítulo você aprendeu os Requisitos técnicos para uma Produção Ágil de um livro e definiuum fluxo de trabalho.

Antes de decidir sobre as ferramentas de produção, você optou por priorizar a produção dos autores,elaborando um calendário de produção e atualizando o documento “Instruções para os autores”. Vocêentregou tudo isso aos autores e iniciou o processo de escrita dos livros imediatamente.

Enquanto os autores estão escrevendo, você terá tempo para avaliar as ferramentas e determinar comoserá o processo de produção.


Capítulo 9

Logotipo do curso

Antes de pensar sobre o processo de produção, caso haja necessidade de elaborar um logotipo, reco-mendamos iniciar o processo de criação imediatamente.

Criar um logotipo que agrade muitos gostos demanda bastante tempo, caso esta atividade seja poster-gada poderá atrasar a produção no futuro.

Contrate um designer ([email protected]) para elaborar seu logo.

mailto:[email protected]


Capítulo 10

Avaliando ferramentas

A seguir são listados os requisitos necessários para uma produção ágil:

• Geração automática do sumário

• Uniformidade nos estilos

– Estilos de páginas

– Estilos de títulos

– Estilos de caixas

– Estilos de parágrafos: citações, versos, códigos, etc.

– Estilos de tabela, imagens e outros elementos visuais

• Utilização de numeração automática para Imagens e Tabelas

• Utilização de recursos de referências de capítulos e seções

• Alterações no texto não geram impactos globais no documento

• Alterações no texto podem ser identificadas e as revisões podem ser realizadas sobre elas

• É possível identificar e avaliar o trabalho realizado por cada um dos membros envolvidos na produ-ção

– Alterações realizadas pelos revisores

– Alterações realizadas pelos autores

– Alterações realizadas pelos técnicos de produção

• É possível verificar a diferença entre duas versões do documento

• Os leitores podem contribuir submetendo erros, sugestões e correções

• Produção de livros para impressão ou e-book

Para alcançar uma Produção Ágil é essencial que os envolvidos no processo utilizem uma ferramentaque implemente os recursos necessário para uma produção Ágil. Na Tabela 10.1 [47] mostramos osrecursos implementadas por algumas ferramentas:


Tabela 10.1: Comparação entre recursos das ferramentas

Recurso Word Indesign LatexEstilos de títulos, tabelas, legendas, parágrafos x x xGeração automática de sumário a partir dos títulos e seções x x xNumeração e referenciação de Imagens e Tabelas x x xControle de modificações x ? x1

Além disso, é essencial que os membros da produção possuam os conhecimentos técnicos sobre asferramentas para a utilização destes recursos.

Para exemplificar o que foi dito, imaginemos as seguintes situações:

Adição de ImagemQual o impacto de adicionar uma nova imagem ao texto?

1. Preciso alterar manualmente o número de todas as imagens seguintes?

2. Preciso alterar manualmente as referências no texto das imagens seguintes?

3. Caso a adição gerou uma nova página, preciso alterar a numeração do sumário?

4. Preciso configurar manualmente a fonte da legenda e os espaçamentos?

Adição de uma nova seção a um capítuloQual o impacto de adicionar uma nova seção ao texto?

1. Preciso alterar o sumário de alguma forma?

2. Preciso alterar manualmente a fonte e os espaçamentos do título da seção?

3. Caso minha seção adicionada possua imagens e tabelas, precisarei realizar alguma altera-ção além do texto que adicionei?

Revisor precisa realizar uma revisão no textoQual o impacto quando alguém diferente do autor precisa alterar o texto?

1. As revisões são realizadas apenas no impresso?

2. Preciso enviar texto por e-mail ou pen-drive?

3. Somente uma pessoa por vez pode editar o documento?

4. Eu não tenho controle sobre quais foram as modificações realizadas por outras pessoas?

Lançar uma nova ediçãoLançar um nova edição envolve realizar diversas alterações no texto, qual o impacto disso?

• É praticamente o mesmo de gerar um novo livro?

• A revisão precisa ser feita no livro inteiro, pois os revisores não sabem quais partes do textoforam modificadas?

1O controle pode ser feito externamente através de um controle de versão.


Se você respondeu afirmativamente a maioria destas perguntas, você não está utilizando um processoágil para produção dos livros. Isso provavelmente pode ser explicando por uma das seguintes razões:

• Sua equipe não está utilizando os recursos das ferramentas que possibilitam uma produção ágil; ou

• As ferramentas que estão utilizando não possibilitam uma produção ágil;

AtençãoApesar de Produção Ágil ser uma ideia, neste livro nós chamamos de Processo Ágil oprocesso proposto no livro, com o livro sendo escrito em Asciidoc e o Servidor de produçãogerando o livro.


Capítulo 11

Origem do processo

Quando estive trabalhando para o curso de Licenciatura em Computação à distância na UFPB, tive aoportunidade de propor um processo de trabalho para a produção dos livros.

O processo que elaborei foi fortemente influenciado pelo processo adotado pela editora O’reilly. Masfiz algumas adaptações:

• utilização do git ao invés do svn

• utilização do asciidoc ao invés do xml

• criação de um servidor próprio para geração do pdf

• utilização de um servidor de arquivos público (github)1

11.1 Processo editorial profissional

Fui buscar no fluxo de trabalho da O’Reilly o conhecimento sobre como é um processo editorial.

Processo editorialPara conhecer como é um processo de editoração profissional consulte: http://oreillynet.com/-oreilly/authors/welcome/editorial.csp e http://oreilly.com/oreilly/author/index.html.

Sugestões para os autoreshttp://oreillynet.com/oreilly/authors/welcome/advice.csp

Como atingir os leitores de forma mais eficientehttp://oreillynet.com/oreilly/authors/welcome/reachingreaders.csp

NotaConhecendo o processo da O’Reilly percebe-se que o papel de alguém fundamental estásendo deixado de fora nas produções dos livros da EAD: o Editor.Embora a editora O’Reilly não consiga conceber a produção dos livros sem um editor, nósestamos produzindo nossos livros sem ele. No lugar do editor, estamos utilizando um revisore talvez um coordenador pedagógico.

No processo da O’Reilly os autores entregam os livros no formato Docbook.1No entanto não há impedimentos para utilização de um servidor git privado

https://dl.dropboxusercontent.com/u/25413984/processo-agil/docbookguidelines_print.pdf

http://oreillynet.com/oreilly/authors/welcome/editorial.csp

http://oreillynet.com/oreilly/authors/welcome/editorial.csp

http://oreilly.com/oreilly/author/index.html

http://oreillynet.com/oreilly/authors/welcome/advice.csp

http://oreillynet.com/oreilly/authors/welcome/reachingreaders.csp


11.2 DocBook

O Docbook é um padrão internacional para produção de livros técnicos, mas que também pode serutilizado em outros contextos.

Embora o Docbook seja um padrão internacional, o público em geral desconhece a sua existência, damesma forma que um usuário comum acessa páginas da internet sem ter conhecimento sobre o que éHTML.

Para se ter uma noção sobre a importância do Docbook, podemos mencionar que toda a documentaçãodo Linux é escrita neste formato. Além disso, um livro produzido neste formato pode ser exportadopara HTML, EPUB, PDF e vários outros formatos.

DicaAlguns links para aprofundamento sobre o docbook:

• https://pt.wikipedia.org/wiki/DocBook

• http://oreilly.com/openbook/docbook/book/docbook.html

• http://xml.web.cern.ch/XML/goossens/dbatcern/dbatcern.pdf

11.3 Asciidoc

O Asciidoc é uma linguagem de marcação simples que pode ser exportada para docbook.

NotaNo momento da criação do Processo Ágil, a editora O’reilly já estava aceitando livros sendoproduzidos em asciidoc, de forma experimental. Mais informações sobre o fluxo do O’Reillypoder ser consultado em: http://chimera.labs.oreilly.com/books/1234000001574/index.html.

Recentemente a O’Reilly produziu uma ferramenta chamada Atlas, que utiliza o gerenciamento dosarquivos através do git e um editor de texto on-line para produção dos livros utilizando arquivos noformato Asciidoc. Você pode consultar um vídeo demonstrativo em http://chimera.labs.oreilly.com/-books/1230000000065/ch01.html. A ferramenta só está disponível para autores que estejam produ-zindo livros para a editora.

11.4 E-Book

Um livro produzido em docbook pode ser exportado para vários padrões de e-books, como PDF,EPUB e HTML. Desta forma, um livro produzido por este processo, além da versão para impressão,poderá ser publicado como e-book.

https://pt.wikipedia.org/wiki/DocBook

http://oreilly.com/openbook/docbook/book/docbook.html

http://xml.web.cern.ch/XML/goossens/dbatcern/dbatcern.pdf

http://oreillynet.com/oreilly/authors/welcome/asciidoc.csp

http://oreillynet.com/oreilly/authors/welcome/asciidoc.csp

http://chimera.labs.oreilly.com/books/1234000001574/index.html

http://chimera.labs.oreilly.com/books/1230000000065/ch01.html

http://chimera.labs.oreilly.com/books/1230000000065/ch01.html


11.5 Confiabilidade do Processo Ágil

Resumimos os seguintes pontos para mostrar a confiabilidade do processo:

• Utilização de padrão internacional para geração dos livros (docbook)

• Utilização de linguagem simples para escrita dos livros (asciidoc)

• Sistema de gerenciamento de arquivos confiável (git)

• Processo baseado em editora profissional

• Processo segue as tendências atuais do mercado

• Produção de livros para impressão e distribuição digital

• Cursos de capacitação periódicos (patrocinado pela UFPB Virtual)

• Consultoria disponível para adoção do processo

• Suporte para ajudá-lo na execução do processo


Capítulo 12

Adoção do Processo

OBJETIVO DO CURSO

• Difundir método ágil de produção de material didático.

• Apresentar evidências da produtividade do método, utilizado no Curso de Licenciatura em Compu-tação, com intuito de compartilhá-lo para outras coordenações dos cursos a distância.

• Ao final do curso cada participante terá produzido um esqueleto de livro, com no mínimo um capí-tulo diagramado. Os livros produzidos serão apresentados no último dia de aula, em um encontropresencial (Culminância).

Necessidade de atualizaçãoO diferencial do Processo Ágil é poder lançar novas edições do livro com facilidade. Caso nãoplaneje lançar atualizações dos livros, não haverá benefícios relevantes para adotar o ProcessoÁgil, em comparação com os Processos Tradicionais. Este caso se enquadra na produção deum livro contendo uma coleção de artigos.

12.1 Possíveis dificuldades implementação do Processo

• Desinformação

• Falta de conhecimento técnico

• Receio à mudança

• Falta de apoio para implementar o processo

• Resistência ao aprendizado de uma nova tecnologia

• Confiabilidade do novo Processo

• Tempo para realização das mudanças e ajustes

• Custo para implementação do processo

• Implicações sociais da implantação

• Performance real do novo processo


12.1.1 Desinformação

Como toda nova ideia, a desinformação pode ser um empecilho para sua adoção.

Dica

• Convidar os membros envolvidos na produção dos livros para participar de capacitaçãosobre o processo

• Utilizar conversas informais para divulgar produções pessoais que utilizam o processo

12.1.2 Falta de conhecimento técnico

A falta de conhecimento técnico dos membros dificulta a produção em qualquer processo.

12.1.2.1 Autores

Normas da Produção Geralmente os autores dos livros da EAD recebem um documento informandosobre as normas da produção, ou elas são transmitidas durante reuniões com os autores.

Escrevem no Word Os autores costumam utilizar o Word para escrever os seus capítulos, e revisãodo texto ocorre inicialmente no próprio documento.

Presunção de capacitação Presume-se que não há necessidade para capacitar os autores para escreveros livros no Word, e que eles entregarão os textos seguindo as normas que lhes foram entregues.

Entrega da produção Eventualmente, a produção final dos autores é passada para um técnico daprodução que será responsável pela composição do livro.

Para agilizar a produção dos livros, os autores precisam aplicar os seguintes conhecimentos técnicosnas produções:

• Utilizar estilos de títulos e parágrafos apropriadamente

• Evitar utilizar recursos gráficos do Word como: setas, caixas de texto e outros

• Gerar gráficos em editores externos e incorporá-lo no Word como imagens

• Utilizar imagens coma qualidade, e entregá-las junto com o documento

Quando os autores não tomam estes cuidados, o técnico da produção sofrerá as consequências disso.

12.1.2.2 Técnico da Produção

Em seguida, um membro da equipe de produção recebe dos autores as versões individuais de cadaum, e constrói um livro juntando as produções dos autores.


UTILIZAÇÃO ASCIIDOC NA MATEMÁTICA

• http://wehart.blogspot.com.br/2011/09/using-asciidoc-for-mathematical.html


http://wehart.blogspot.com.br/2011/09/using-asciidoc-for-mathematical.html


12.2 Recomendações para a adoção do Processo

12.2.1 Primeiro Momento

Este primeiro momento servirá para experimentar o processo com o mínimo de impacto para osautores.

1. Montar uma equipe de produção e capacitá-la sobre o Processo Ágil

2. Esta equipe será responsável por produzir os livros no novo formato

a. Caso seja uma nova produção

3. As alterações realizadas pelo revisor poderão ser evidenciadas e mostradas para os autores

a. Depois que o documento estiver no novo formato, todas as novas alterações deverão serrealizadas neste formato

b. Caso os autores desejem rejeitar alguma revisão ou alterar o texto de qualquer forma,apenas o documento onde ele deseja alterar será enviado para ele por e-mail.

c. Mesmo sem capacitação sobre o processo, o autor será capaz de realizar modificaçõespontuais e enviar o documento de volta por e-mail.

12.2.2 Segundo Momento

Capacitação voluntária para autoresEm geral, só aprende algo novo quem possui interesse no conteúdo. Realizar uma capacitaçãoforçada poderia ser prejudicial. Ao invés disso, contamos com o entusiamo de alguns queaceitam experimentar algo novo.

Formação de uma equipe de produçãotexto.

Aceitar produção inicial no Wordtexto.


Capítulo 13

Consutoria

Neste seção reunimos informações sobre consultores sobre o processo:

Nome Eduardo de Santana Medeiros AlexandreE-mail [email protected]

Telefone (83) 8108-1977

Não disponibilizado.

mailto:[email protected]


Capítulo 14

Índice Remissivo

AAsciidoc, 48

Bbenefícios, 52

Ccaixas de diálogos, 42Calendário da Produção, 43Capacitação, 51, 53capacitação, 53conhecimento técnico, 53conhecimentos técnicos, 47Consultoria, 51conversas informais, 53

DDesinformação, 53Docbook, 50

Ee-Book, 50EPUB, 50equipe sobrecarregada, 39exercícios, 42

Fformatação, 42

HHTML, 50

IInstruções para os autores, 42

LLatex, 42linguagem, 42

Nnormas da produção, 53

PPDF, 50Processo Ágil, 48

benefícios, 52Processo Tradicional, 52

Rre-edição, 39

SServidor de produção, 48Suporte, 51

WWord, 41, 53

por Eduardo Santana -...

Documents

Transcript of por Eduardo Santana -...