augustoteixeira
commented
6 years ago Vamos por partes:
- Layout. O layout de livro escrito no Sphinx é definido em Latex. Ou mais precisamente, o Sphinx gera um arquivo Latex e daí nós geramos um PDF com a classe e o estilo que quisermos.
- O livro que permite ver a definição separada. Se não me engano você está falando da linguagem MathBook XML. Essa linguagem é muito legal e foi considerada nas opções. O maior problema que ela tem é a complicação de extender para novas funcionalidades. Eu acho que o Sphinx permite aquela funcionalidade de ver a definição lá no índice, mas tenho que verificar.
- Macros. Existem em Sphinx, mas são chamados substitutions
- Misturar negrito com index. Eu acho que todos os indexes deveriam ser iguais e deveriam ter o estilo colocado automaticamente. Se você coloca negrito e alguém depois coloca itálico, não fica uniforme. O que temos que fazer é decidir como vai ser e colocar todos automaticamente (tenho quase certeza que o Sphinx permite isso).
- Continuar linha numerada. Isso é muito ruim mesmo e você tem minha simpatia ao criticar o Sphinx por essa decisão.
simas0
@gutosurrex e @simas0,
Vocês conhecem livros com layout bonitos escritos a partir do Sphinx?
Encontrei estes, mas o layout é espartano:
http://www.theoretical-physics.net/dev/index.html
http://www.theoretical-physics.net/
@simas, aquele livro (que permite ver a definição separada) daquele professor do encontro do livro didático da UFRJ foi escrito em que linguagem?
Coisas do Sphinx que dão nos nervos:
(a) Não ter macros (que permitem flexibilidade e mudanças na escolha de notações). (b) Não poder misturar negrito com :index:. (c) Para continuar uma lista numerada, a indentação entre os itens da numeração não segue o padrão natural.