livro-aberto / BookCloud

A collaborative platform to write books based on git
GNU General Public License v3.0
7 stars 2 forks source link

Sphinx: regra dos múltiplos de 3 não é verdadeira #410

Open hjbortol opened 6 years ago

hjbortol commented 6 years ago

Caros, a diretiva é que os parágrafos sempre se iniciem com espaços múltiplos de 3. Tenho um contraexemplo. Vejam só:

Caso 1: múltiplo de 3, mas o parágrafo sai do bloco do item anterior, algo que eu não quero.

image

Caso 2: múltiplo de 3, mas o parágrafo fica em itálico esquisito.

image

Caso 3: múltiplo de 3, mas o parágrafico fica em itálico mais esquisito ainda.

image

Caso 4: não é múltiplo de 3 e dá o resultado que eu quero.

image

augustoteixeira commented 6 years ago

Hum... de fato se for usar sempre três espacos, temos que mudar um pouco a notacão do enumerate. Vamos discutir com o Fábio também pra ver como fica melhor. Mas isso daqui funciona (com um espaco a mais depois do asterisco):

*  Primeiro ítem

*  Segundo ítem

   .. figure:: https://upload.wikimedia.org/wikipedia/commons/thumb/e/e9/Cuban_green_woodpecker_%28Xiphidiopicus_percussus_percussus%29_female.JPG/500px-Cuban_green_woodpecker_%28Xiphidiopicus_percussus_percussus%29_female.JPG
      :width: 200px
      :align: center

   Continua aqui

*  Terceiro ítem
simas0 commented 6 years ago

Caso 1: Você incluiu a figura com 3 espaços adicionais no início da linha. Houve algum motivo para isso? Acredito que se colocar a figura no mesmo nível verde do parágrafo anterior e posterior, tudo vai funcionar bem.

Caso 2: Na sintaxe está explicado que três espaços no texto significa citação. Não use três espaços no início da linha de um parágrafo se você não quer fazer uma citação.

Caso 3: Você inseriu a figura com três espaços e mais três espaços para o início do próximo parágrafo. Esta é a sintaxe para se inserir uma legenda na figura. O parágrafo virou legenda da figura.

Caso 4: Isso também está explicado na sintaxe. Se espaços múltiplos de três corretamente, então tudo funciona. A recíproca não é verdadeira em geral. Atenção: o uso de espaços não múltiplos de três pode gerar resultados indesejados nos parágrafos seguintes.

Confira se estou certo, por favor. Se tudo que eu escrevi estiver certo, peço que troque os dois labels por 'tutorial' e feche o issue.

hjbortol commented 6 years ago

@simas,

Seguindo sua sugestão para o Caso 1, há uma quebra na indentação das bolinhas dos itens:

image

Bem, a única combinação que deu certo continua sendo a do Caso 4 onde a quantidade de espaços iniciais não é múltiplo de 3.

hjbortol commented 6 years ago

Hum... de fato se for usar sempre três espacos, temos que mudar um pouco a notacão do enumerate. Vamos discutir com o Fábio também pra ver como fica melhor. Mas isso daqui funciona (com um espaco a mais depois do asterisco)

Puxa ...