2013-10-16 7 views
5

Spesso ho la situazione in cui voglio collegare un termine al glossario ma il termine viene enunciato al plurale.Scrittura di termini al plurale senza ridondanza

Quindi normalmente si fa qualcosa di simile in singolare:

Some text before the term :term:`important word` then the stuff after the term 

questo è considerato un termine completamente diverso:

Some text before the term :term:`important words` then the stuff after the term 

Questo non viene analizzato:

Some text before the term :term:`important word`s then the stuff after the term 

E questo è molto ridondante (ma l'unica scelta che ho con le mie attuali conoscenze):

Some text before the term :term:`important words<important word>` then the stuff after the term 

C'è un altro modo per scrivere un termine al plurale senza dover indicare il termine due volte?

risposta

11

Sto affrontando lo stesso problema. Non sono un esperto, ma ecco quello che ho trovato (parzialmente sovrapposte le proprie scoperte):

.. won't resolve to "foo" 
:term:`foos` 

.. reST doesn't parse the string 
:term:`foo`s 

.. ugly markup and gives different formatting for "foo" and "s" 
:term:`foo`\ s 

.. redundant and verbose, but most versatile 
:term:`foos<foo>` 

Mentre il modello penultima funziona, un po ', l'ultimo è veramente quello che vuoi. Non solo formatta il plurale "s" come il resto della parola (a differenza di :term:`foo`\ s, che può darti qualcosa come pippo s), ma funziona quando il plurale non è solo una semplice concatenazione. Per esempio. considera directory/directory o dati/dati. Per questi casi, un meccanismo di riscrittura completo è il migliore.

È possibile rendere il documento meno prolissa definendo substitutions:

.. |foos| replace:: :term:`foos<foo>` 

Poi ovunque si desidera che i "Foos" plurale, è possibile scrivere il riferimento sostituzione (vedi link precedente) |foos|, e la processore documento trattarlo come :term:`foos<foo>`


Riferimenti:

https://sourceforge.net/p/docutils/mailman/message/31536488/

+0

Ho usato il reST per la mia tesi completa e ho trovato molti esempi in cui non è progettato bene per un uso intenso. Posso solo consigliare di guardare altri formati. Ho ascoltato ASCIIdoc molte volte come suggerimento per lunghi testi. – erikbwork

+0

Ho aggiunto il collegamento a cui mi riferisco, ora che ho abbastanza reputazione per farlo. E se la risposta fosse utile, ti dispiacerebbe accettarla? – goodmami

+0

Sì, lo farei. Mentre sono d'accordo sul fatto che tu abbia elencato le soluzioni alternative che esistono, nessuna delle due è una soluzione reale. Non è colpa tua però. – erikbwork