search

livro-aberto / BookCloud

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

Dar destaque a definições secundárias geradas num parágrafo #329

Open simas0 opened 7 years ago

simas0 commented 7 years ago

Gostaria de dar às definições escritas em um parágrafo algum destaque, mesmo que isso seja alterado depois. Combinamos de usar o comando .. glossary:: para as definições principais e o comando :index: para aquelas colocadas no meio de um parágrafo. A primeira já possui um destaque dado pela linguagem do sphinx, o outro não dá qualquer destaque no texto.

No código precisamos que os termos no texto criados com
:index:`termo no texto <termo no glossario>` sejam colocados em itálico.

Acho que o comando :index: também está sendo utilizado para levar usos de termos definidos para o glossário. Mas em princípio, eles podem receber o mesmo destaque que as definições.

O que me diz @hjbortol ?

hjbortol commented 7 years ago

Sim, eu gostaria muito que as palavras marcadas com :index: tivessem uma formatação diferente. Vejo que muitos livros usam negrito, mas mesmo itálico é melhor do que formatação alguma.

hjbortol commented 7 years ago

Sim, eu gostaria muito que as palavras marcadas com :index: tivessem uma formatação diferente. Vejo que muitos livros usam negrito, mas mesmo itálico é melhor do que formatação alguma.

augustoteixeira commented 7 years ago

Gente, eu procurei isso e não achei um lugar que esteja feito do jeito correto. Outras pessoas já precisaram disso:

https://stackoverflow.com/questions/46505432/inline-index-keyword-highlighted

Eles sugerem usar o método:

In this chapter, we introduce :index:`\ <Foo>`\ *Foo*, a
crucial concept in this example

que funciona, mas é claramente uma gambiarra. Mais uma vez se faz necessário aprender a extender o Sphinx.

simas0 commented 7 years ago

@gutosurrex, eu me pergunto se esta alternativa que você propõe vale a pena. Ela não será compatível com a solução definitiva porque não será possível trocar o itálico por negrito, por exemplo, se isso for uma decisão posterior.

A solução definitiva é que coloquei no início da discussão, certo? que o termo no texto em :index: `termo no texto <termo no glossário>` apareça em itálico.

Melhor deixar como está e procurar algo que seja realmente uma solução.

simas0 commented 6 years ago

Este é o problema de edição TOP4.