Olá pessoal! - Minha primeira contribuição

[sergio]

Sou o Sérgio, mas na web também sou conhecido pelo nick "voyeg3r",
mantenho o blog vivaotux, faço parte do PUG-CE e do python brasil,
atualmente mantenho o projeto do livro do vim:
http://code.google.com/p/vimbook - um livro em português sobre o amado
vim.

Espero poder contribuir da melhor maneira possível.

Tenho grande interesse em ver a melhoria deste maravilhoso trabalho,
pois desde que li o livro pela primeira vez vi que estava diante de
algo singular.

Minha 1ª contribuição diz respeito à norma tipográfica - Sempre gostei
de gerar documentos no latex, e para aprender tive que ler um bocado,
num desse manuais achei uma dica de ouro:

Uma linha não pode ultrapassar 66 caracteres, isto leva ao conhecido
problema do usuário ler duas vezes a mesma linha. Então, tanto no css
da página html quando no programa gerado do pdf temos que proceder as
alterações necessárias para resolver este problema.

Minha 2ª contribuição:
Divulguei no meu blog:
http://vivaotux.blogspot.com/2009/04/contribua-com-o-projeto-do-livro-como.html

[Luciano Ramalho]

On Apr 6, 8:15 am, sergio <voye...@gmail.com> wrote:
> Sou o Sérgio, mas na web também sou conhecido pelo nick "voyeg3r",
> mantenho o blog vivaotux, faço parte do PUG-CE e do python brasil,

> atualmente mantenho o projeto do livro do vim:http://code.google.com/p/vimbook- um livro em português sobre o amado

> vim.
>
> Espero poder contribuir da melhor maneira possível.

Seja muito bem vindo, Sérgio!

>
> Tenho grande interesse em ver a melhoria deste maravilhoso trabalho,
> pois desde que li o livro pela primeira vez vi que estava diante de
> algo singular.

Eu também gosto muito do livro.

>
> Minha 1ª contribuição diz respeito à norma tipográfica - Sempre gostei
> de gerar documentos no latex, e para aprender tive que ler um bocado,
> num desse manuais achei uma dica de ouro:
>
>   Uma linha não pode ultrapassar 66 caracteres, isto leva ao conhecido
> problema do usuário ler duas vezes a mesma linha.  Então, tanto no css
> da página html quando no programa gerado do pdf temos que proceder as
> alterações necessárias para resolver este problema.

Sim, com certeza esta é uma excelente recomendação. Você está a fim de
dar uma estudada nos templates e folhas de estilo do Sphinx para
descobrir onde fazer estes ajustes?

Vamos usar a versão 0.6.1 do Sphinx, que é a mais recente que veio
quando dei o comando "easy_install -U sphinx" para atualizar a minha
instalação.

> Minha 2ª contribuição:
> Divulguei no meu blog:

>  http://vivaotux.blogspot.com/2009/04/contribua-com-o-projeto-do-livro...

Legal, valeu, Sérgio!

[ ]s
Luciano

[Henrique Baggio]

Olá!

On 6 abr, 13:24, Luciano Ramalho <rama...@gmail.com> wrote:
> On Apr 6, 8:15 am, sergio <voye...@gmail.com> wrote:
>
> > Sou o Sérgio, mas na web também sou conhecido pelo nick "voyeg3r",
> > mantenho o blog vivaotux, faço parte do PUG-CE e do python brasil,

> > atualmente mantenho o projeto do livro do vim:http://code.google.com/p/vimbook-um livro em português sobre o amado

> > vim.
>
> > Espero poder contribuir da melhor maneira possível.
>
> Seja muito bem vindo, Sérgio!
>
>
>
> > Tenho grande interesse em ver a melhoria deste maravilhoso trabalho,
> > pois desde que li o livro pela primeira vez vi que estava diante de
> > algo singular.
>
> Eu também gosto muito do livro.
>
>
>
> > Minha 1ª contribuição diz respeito à norma tipográfica - Sempre gostei
> > de gerar documentos no latex, e para aprender tive que ler um bocado,
> > num desse manuais achei uma dica de ouro:
>
> >   Uma linha não pode ultrapassar 66 caracteres, isto leva ao conhecido
> > problema do usuário ler duas vezes a mesma linha.  Então, tanto no css
> > da página html quando no programa gerado do pdf temos que proceder as
> > alterações necessárias para resolver este problema.
>
> Sim, com certeza esta é uma excelente recomendação. Você está a fim de
> dar uma estudada nos templates e folhas de estilo do Sphinx para
> descobrir onde fazer estes ajustes?
>
> Vamos usar a versão 0.6.1 do Sphinx, que é a mais recente que veio
> quando dei o comando "easy_install -U sphinx" para atualizar a minha
> instalação.

Pensei no comprimento das linhas quando olhei a seção de apresentação
da versão em PDF, que tem um texto e parágrafos mais longos.

O que seria ideal nesse caso? Dividir em duas colunas?

[]'s
--
Henrique Baggio

[Luciano Ramalho]

2009/4/6 Henrique Baggio <hnrqb...@gmail.com>:

> Pensei no comprimento das linhas quando olhei a seção de apresentação
> da versão em PDF, que tem um texto e parágrafos mais longos.
>
> O que seria ideal nesse caso? Dividir em duas colunas?

Colunas complicam muito a diagramação. Acho melhor criar uma margem
externa bem larga, onde podem ser colocadas chamadas, notas, boxes
etc. A margem externa fica do lado esquerdo nas páginas esquerdas
(pares) e do lado direito nas páginas ímpares.

Só não sei ainda onde mexer para fazer isso.

[ ]s
Luciano

[Henrique Baggio]

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

2009/4/6 Henrique Baggio <hnrqb...@gmail.com>:

> Pensei no comprimento das linhas quando olhei a seção de apresentação
> da versão em PDF, que tem um texto e parágrafos mais longos.
>
> O que seria ideal nesse caso? Dividir em duas colunas?

Colunas complicam muito a diagramação. Acho melhor criar uma margem
externa bem larga, onde podem ser colocadas chamadas, notas, boxes
etc. A margem externa fica do lado esquerdo nas páginas esquerdas
(pares) e do lado direito nas páginas ímpares.

Ótima idéia! Melhora-se a leitura e ainda posiciona melhor as notas sobre o texto. =]

 

Só não sei ainda onde mexer para fazer isso.

Eu dei uma buscada (bem) rápida no google sobre isso, mas não deu muito resultado. Só o sphinx pra fazer coisas simples até agora.

[]s

Henrique

[sergio]

Documentação do Sphinx:

http://sphinx.pocoo.org/config.html#options-for-html-output
http://sphinx.pocoo.org/theming.html
http://sphinx.pocoo.org/config.html#options-for-latex-output

Não pude alterar os estilos ainda pois em casa minha Internet está
deplorável
e aqui onde estou trabalhando no momento não posso instalar o Sphinx.
mas acho que essa é o caminho das pedras, tão logo tenha oportunidade
vou tentar contribuir neste ponto.


On 6 abr, 16:54, Henrique Baggio <hnrqbag...@gmail.com> wrote:
> 2009/4/6 Luciano Ramalho <rama...@gmail.com>
>
>
>
> > 2009/4/6 Henrique Baggio <hnrqbag...@gmail.com>:

[Henrique Baggio]

# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
html_static_path = ['_static']

Não encontrei essa pasta _static na listagem dos arquivos em [1]. É preciso baixar os arquivos pra isso? Pq eu só tentei pela web...

Nessa pasta que colocaríamos um CSS que permitiria o uso do painel lateral e o ajuste da largura da página.

[1]http://bitbucket.org/ramalho/aprendacompy/src/27ee61edf9d7/edicao_1.1/

2009/4/7 sergio <voy...@gmail.com>

--
Henrique Baggio
Computer Engineering - Unicamp

AAACEC - Atlética da Ciência e Engenharia de Computação
Gestão 2009 - Diretoria do 100Nossão
www.ic.unicamp.br/~aaacec

Microsoft Innovation Center - Unicamp
Software Engineer
http://www.lms.ic.unicamp.br
http://lmsu.codeplex.com

[Henrique Baggio]

2009/4/8 Henrique Baggio <hnrqb...@gmail.com>

# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
html_static_path = ['_static']

Ah, esqueci de dizer que isso é parte do conteúdo do arquivo conf.py

http://bitbucket.org/ramalho/aprendacompy/src/27ee61edf9d7/edicao_1.1/conf.py 

[Danilo Faustinoni Cabello]

2009/4/8 Henrique Baggio <hnrqb...@gmail.com>:
>> # Add any paths that contain custom static files (such as style sheets)
>> here,
>> # relative to this directory. They are copied after the builtin static
>> files,
>> # so a file named "default.css" will overwrite the builtin "default.css".
>> html_static_path = ['_static']
>
> Ah, esqueci de dizer que isso é parte do conteúdo do arquivo conf.py
> http://bitbucket.org/ramalho/aprendacompy/src/27ee61edf9d7/edicao_1.1/conf.py

Eu já personalizei um pouco uma documentação em Sphinx, assim que der
eu envio minha contribuição com algumas cores diferentes pro pessoal
já saber onde mexer.

[Francisco Antônio da Silva Souza]

Oi Henrique,
ao "compilar" o rst para html, o Sphinx cria o diretório '_static' no destino da compilação e coloca os arquivos internos dele (do estilo padrão que ele cria lá dentro).

Caso exista no projeto (no caso, o diretório edicao_1.1) o diretório _static, o Sphinx copiará também o conteúdo deste diretório.

Resumindo: o diretório não existe, mas você pode criá-lo perfeitamente. Lembre-se de, ao criar o diretório, adicioná-lo ao ser repositório no mercurial (hg add <diretório>).

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

2009/4/8 Henrique Baggio <hnrqb...@gmail.com>

[Henrique Baggio]

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

Oi Henrique,
ao "compilar" o rst para html, o Sphinx cria o diretório '_static' no destino da compilação e coloca os arquivos internos dele (do estilo padrão que ele cria lá dentro).

Caso exista no projeto (no caso, o diretório edicao_1.1) o diretório _static, o Sphinx copiará também o conteúdo deste diretório.

Resumindo: o diretório não existe, mas você pode criá-lo perfeitamente. Lembre-se de, ao criar o diretório, adicioná-lo ao ser repositório no mercurial (hg add <diretório>).

Ah, entendi! Então atualmente o CSS usado é o padrão do Sphinx. Vou instalar o mercurial aqui e brincar um pouco com o CSS pra tentar gerar o formato que queremos.

Quem quiser ajudar, me avise. Assim, ninguém reinventa a roda. 

Abraços!

--
Henrique Baggio

[Luciano Ramalho]

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

> Oi Henrique,
> ao "compilar" o rst para html, o Sphinx cria o diretório '_static' no
> destino da compilação e coloca os arquivos internos dele (do estilo padrão
> que ele cria lá dentro).
>
> Caso exista no projeto (no caso, o diretório edicao_1.1) o diretório
> _static, o Sphinx copiará também o conteúdo deste diretório.
>
> Resumindo: o diretório não existe, mas você pode criá-lo perfeitamente.
> Lembre-se de, ao criar o diretório, adicioná-lo ao ser repositório no
> mercurial (hg add <diretório>).

É isso mesmo, Francisco.

Vale lembrar que o Mercurial (assim como o Git) não armazena
diretórios vazios no repositório. Na minha cópia de trabalho eu tenho
o diretório _static, mas ele foi gerado pelo Sphinx e está vazio, por
isso não foi para o repositório.

[ ]s
Luciano