Primeiras contribuições incorporadas

3 views
Skip to first unread message

Luciano Ramalho

unread,
Apr 13, 2009, 2:59:42 PM4/13/09
to Aprenda Computação com Python
Pessoal, hoje finalmente consegui um tempinho para incorporar as
contribuições do Francisco, Cabello e Fabio.

Muito grato pela ajuda, pessoal!

Ficou evidente para mim que o esquema de edição distribuída funciona
bem. Foi muito simples fazer:

$ hg pull http://bitbucket.org/franciscosouza/aprendacompy/overview/
$ hg merge
$ hg commit
$ hg pull http://bitbucket.org/cabello/aprendacompy/overview/
$ hg merge
$ hg commit

e assim por diante, depois

$ hg push

para publicar as mudanças todas no repositório central [1].

[1] http://bitbucket.org/ramalho/aprendacompy/overview/

Agora, algumas observações:

- 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;

- não é preciso que todas as marcações de título sejam feitas acima e
abaixo do título; observe os outros capítulos e note que já havíamos
estabelecido um padrão; usamos sinais de igual acima e abaixo para
títulos de primeiro nível, depois hifens acima e abaixo, e depois
somente marcações abaixo; notei que no apêndice a foi usado ^^^^ acima
e abaixo mas não precisa introduzir esta nova marcação, bastaria usar
---- ou ==== somente abaixo, conforme o caso.

- 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

Francisco Antônio da Silva Souza

unread,
Apr 13, 2009, 3:24:23 PM4/13/09
to aprend...@googlegroups.com
Oi Luciano,

2009/4/13 Luciano Ramalho <ram...@gmail.com>


- 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;

Vou fazer estes ajustes no Apêndice A, também ajustarei o "^". Você poderia indicar qual o problema no Capítulo 2?

Acabo de revisar o Capítulo 4 e dar um commit, vou acertar o Apêndice A, commitar e dar um push no fork.

Abraços,
Francisco Antônio da Silva Souza
Linux User #488128
http://franciscossouza.blogspot.com



2009/4/13 Luciano Ramalho <ram...@gmail.com>

Luciano Ramalho

unread,
Apr 13, 2009, 3:32:04 PM4/13/09
to Aprenda Computação com Python
On Apr 13, 4:24 pm, Francisco Antônio da Silva Souza
<franciscosso...@gmail.com> wrote:
> Oi Luciano,
>
> 2009/4/13 Luciano Ramalho <rama...@gmail.com>
>
> - 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;
>
> Vou fazer estes ajustes no Apêndice A, também ajustarei o "^". Você poderia
> indicar qual o problema no Capítulo 2?

Já corrigi. Era um problema com o uso de ** para fazer negrito no
início de umas palavras. Isso não funciona, e eu mudei o texto para
contornar.

Francisco, você não consegue rodar o make do Sphinx?

>
> Acabo de revisar o Capítulo 4 e dar um commit, vou acertar o Apêndice A,
> commitar e dar um push no fork.

Já consertei o Apêndice A.


Grato pela força, Francisco!

[ ]s
Luciano

Francisco Antônio da Silva Souza

unread,
Apr 13, 2009, 3:39:56 PM4/13/09
to aprend...@googlegroups.com
Olá Luciano,

2009/4/13 Luciano Ramalho <ram...@gmail.com>

Já corrigi. Era um problema com o uso de ** para fazer negrito no
início de umas palavras. Isso não funciona, e eu mudei o texto para
contornar.

Ah, compreendi.

Francisco, você não consegue rodar o make do Sphinx?

Eu rodo o comando:

$ sphinx-build ./ ./_build/

Ta certo?

Abraços,
Francisco Antônio da Silva Souza
2009/4/13 Luciano Ramalho <ram...@gmail.com>

Francisco Antônio da Silva Souza

unread,
Apr 13, 2009, 3:41:31 PM4/13/09
to aprend...@googlegroups.com
2009/4/13 Francisco Antônio da Silva Souza <francis...@gmail.com>

Eu rodo o comando:

$ sphinx-build ./ ./_build/

Ta certo?

Esquece, agora que eu fui ver que tem um Makefile lá.


Abraços,
Francisco Antônio da Silva Souza
Linux User #488128
http://franciscossouza.blogspot.com



2009/4/13 Francisco Antônio da Silva Souza <francis...@gmail.com>

Emanuel Woiski

unread,
Apr 13, 2009, 4:56:42 PM4/13/09
to aprend...@googlegroups.com
Luciano,

2009/4/13 Luciano Ramalho <ram...@gmail.com>

snip]

- 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)


Deixe-me entender. Os '?' já vieram com o texto, não foram produzidos no meu gedit (que usa UTF-8). Portanto, posso substitui-los por '' ou '-'  ou algo adequado... é isso?


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

um abraço
woiski

Marco Antonio

unread,
Apr 19, 2009, 7:40:02 AM4/19/09
to Aprenda Computação com Python
Com relação a:

"Agora, algumas observações:

- 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. "

Me cadastrei no Bitbucket, instalei o Mercurial e seguindo a receita
daqui consegui me virar sem problema, porém com o Sphinx eu estou
tendo dificuldade. Instalei ele, cheguei a rodar o tal sphinx-
quickstart mas a partir daí me perdi... :(

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... ;)

Abs

--
Marco Antonio
* Pier de Ipanema: http://www.pierdeipanema.com.br/
* Twitter: @pier_de_ipanema

Luciano Ramalho

unread,
Apr 19, 2009, 10:12:51 AM4/19/09
to aprend...@googlegroups.com
2009/4/19 Marco Antonio <coyo...@gmail.com>:

>
> Com relação a:
>
> "Agora, algumas observações:
>
> - 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. "
>
> Me cadastrei no Bitbucket, instalei o Mercurial e seguindo a receita
> daqui consegui me virar sem problema, porém com o Sphinx eu estou
> tendo dificuldade. Instalei ele, cheguei a rodar o tal sphinx-
> quickstart mas a partir daí me perdi... :(

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

Marco Antônio

unread,
Apr 19, 2009, 11:38:31 AM4/19/09
to aprend...@googlegroups.com
Elementar meu caro, foi mal... :)

Segue minha configuração:
Ubuntu 8.04;
Python 2.5.2
hg version: Mercurial Distributed SCM (version 0.9.5)

Como instalei o Sphinx (via terminal):
1. easy_install -U Sphinx
2. após instalado, fiz: sphinx-quickstart e respondi com o padrão
3. depois disso não sabia o que fazer.
4. vi que ele criou umas pastas na minha home que apaguei, já que não conseguia fazer nada...

Aguardo orientação.



Marco Antonio
* Pier de Ipanema: http://www.pierdeipanema.com.br/
* Twitter: @pier_de_ipanema


Luciano Ramalho escreveu:

Luciano Ramalho

unread,
Apr 19, 2009, 1:16:54 PM4/19/09
to aprend...@googlegroups.com
2009/4/19 Marco Antônio <coyo...@gmail.com>:

> Elementar meu caro, foi mal... :)
>
> Segue minha configuração:
> Ubuntu 8.04;
> Python 2.5.2
> hg version: Mercurial Distributed SCM (version 0.9.5)
>
> Como instalei o Sphinx (via terminal):
> 1. easy_install -U Sphinx
> 2. após instalado, fiz: sphinx-quickstart e respondi com o padrão
> 3. depois disso não sabia o que fazer.
> 4. vi que ele criou umas pastas na minha home que apaguei, já que não
> conseguia fazer nada...

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

Marco Antônio

unread,
Apr 19, 2009, 2:32:32 PM4/19/09
to aprend...@googlegroups.com
Beleza, as páginas html foram geradas. Já o pdf deu o seguinte erro:

~/bitbucket/aprendacompy/edicao_1.1/_build/latex$ make all-pdf
pdflatex 'AprendaComputaocomPython.tex'
make: pdflatex: Comando não encontrado
make: ** [AprendaComputaocomPython.pdf] Erro 127

Mais dúvidas:

1. eu edito (caso necessário) os arquivos rst que estão dentro da pasta
edicao_1.1 e uso o html gerado pelo sphinx só como referência para
testar a marcação ? Ou continuo não entendendo nada ?...

2. quando atualizar o rst, eu faço o mesmo procedimento para atualizar
os htmls (make html), é isso ?

Abs

Marco Antonio
* Pier de Ipanema: http://www.pierdeipanema.com.br/
* Twitter: @pier_de_ipanema



Luciano Ramalho escreveu:

Danilo Faustinoni Cabello

unread,
Apr 19, 2009, 2:45:01 PM4/19/09
to aprend...@googlegroups.com
2009/4/19 Marco Antônio <coyo...@gmail.com>:

>
> Beleza, as páginas html foram geradas. Já o pdf deu o seguinte erro:
>
> ~/bitbucket/aprendacompy/edicao_1.1/_build/latex$ make all-pdf
> pdflatex  'AprendaComputaocomPython.tex'
> make: pdflatex: Comando não encontrado
> make: ** [AprendaComputaocomPython.pdf] Erro 127
>
> Mais dúvidas:
>
> 1. eu edito (caso necessário) os arquivos rst que estão dentro da pasta
> edicao_1.1 e uso o html gerado pelo sphinx só como referência para
> testar a marcação ? Ou continuo não entendendo nada ?...
>
> 2. quando atualizar o rst, eu faço o mesmo procedimento para atualizar
> os htmls (make html), é isso ?

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.

Marco Antônio

unread,
Apr 19, 2009, 3:18:02 PM4/19/09
to aprend...@googlegroups.com
Maravilha Danilo.
Agora é "só" partir para a ação e ver que bicho vai dar... :)


Marco Antonio
* Pier de Ipanema: http://www.pierdeipanema.com.br/
* Twitter: @pier_de_ipanema


Danilo Faustinoni Cabello escreveu:
Reply all
Reply to author
Forward
0 new messages