- o ideal é que todos os que se propuserem a fazer edições extensivas
tenham o sphinx instalado e possam gerar os HTMLs; sem isso você não
vai ver eventuais erros na codificação ReST.
Por exemplo, no momento tem vários erros no apendice a, no capitulo 2
e no capítulo 6. Não tenho tempo agora de corrigir nem detalhar os
erros, mas a maioria dos erros no apêndice A são muito simples: basta
fazer com que a marcação acima e abaixo do título da seção tenha no
mínimo a mesma largura em caracteres que o título em si;
[snip]
- no prefácio existem várias ocorrências de ? que são falhas de
codificação
O problema é que o Windows usa uma a codificação Codepage 1252, que é
uma extensão da norma ISO-8859-1 [2] que tem alguns caracteres que não
fazem parte da norma ISO, tais como travessão, aspas assimétricas
etc.
[2] http://pt.wikipedia.org/wiki/ISO_8859-1
Nós estamos usando a codificação UTF-8, e estes caracteres também
existem em UTF-8 mas a conversão nem sempre funciona porque a Codepage
1252 não é aderente à norma ISO, porém muitos aplicativos insistem em
fingir que Codepage 1252 é o mesmo que ISO-8869-1.
Para evitar um trabalho que não vale a pena a meu ver, pois pode
introduzir problemas nas listagens de código, devemos nos limitar a
usar os caracteres da tabela ISO-8859-1, codificados como UTF-8. Isso
significa que vamos usar os seguintes caracteres
- aspas duplas: " (ASCII 34 decimal)
- aspas simples ou apóstrofe: ' (ASCII 39 decimal)
- travessão: -- (duas vezes o hífen, ASCII 45 decimal, sem espaço
entre os hífens)
Se tiver mais algum caractare no texto que não consta na tabela
ISO-8859-1, mandem para cá que a gente decide como fazer.
Valeu, pessoal!
[ ]s
Luciano
Oi, Marco Antonio, grato pelo seu interesse em ajudar.
> 1. Seria possível me indicar como proceder a partir do ponto acima,
> considerando que na minha máquina criei um diretório ~/bitbucket/
> aprendacompy/ onde fiz o clone do repositório.
>
> 2. Eu devo trabalhar em qual pasta, edição_1 ou edição_1.1 ?
>
> Desculpe as perguntas idiotas, mas sou um total analfa nessa questão
> de cvs e tais... ;)
Estamos trabalhando na edicao_1.1.
Para poder ajudar, precisamos saber se você está usando Windows, Linux
ou MacOSX, e qual a versão do sistema, OK?
[ ]s
Luciano
Você só deve usar o sphinx-quickstart para começar um novo projeto. No
nosso caso, o projeto já existe.
Basta entrar no diretório edicao_1.1, onde está o Makefile, e digitar
o comando make html (funciona no Linux e no MacOS, se as ferramentas
de desenvolvimento estiverem instaladas) e pronto, as páginas html
serão geradas no diretório _build. Para gerar o pdf use make latex e
veja as instruções na tela (tem um monte de dependências para gerar o
PDF).
No Windows não existe o make, mas tem um script do Sphinx para fazer o
build, só não sei como é porque não estou usando Windows. Tem na
documentação do Sphinx.
[ ]s
Luciano
Editando os arquivos .rst você já estará alterando os arquivos que
gerarão html, latex e pdf, você pode revisar e procurar por erros de
digitação, português, entre outras coisas no próprio editor de texto,
mas para ter certeza que você não corrompeu as maracações do sphinx,
você deve dar um make html e abrir a página que você alterou para dar
uma revisada final.
Sempre que rodar o make html, o sphinx procurará por rst alterados e
gerará novos html deles.