jgm/pandoc

some RST paragraphs are written out like lists

Open

#4422 aperta il 1 mar 2018

Vedi su GitHub
 (5 commenti) (0 reazioni) (0 assegnatari)Haskell (3850 fork)batch import
format:RSTgood first issuewriter

Metriche repository

Star
 (44.133 star)
Metriche merge PR
 (Merge medio 7g) (7 PR mergiate in 30 g)

Descrizione

paragraphs starting with the same prefix of a list will have the semantics of a list when written by pandoc, and can be represented as paragraphs by escaping the starting character. from the doc:

If a single-line paragraph begins with text identical to an enumerator ("A.", "1.", "(b)", "I)", etc.), the first character will have to be escaped in order to have the line parsed as an ordinary paragraph:

\A. Einstein was a really smart dude.

Guida contributor

Direzione di ricerca
Esamina l'implementazione del lettore RST in pandoc, probabilmente in src/Text/Pandoc/Readers/RST.hs. Il problema descrive che i paragrafi che iniziano con un testo identico a un enumeratore (es. 'A.', '1.') vengono analizzati erroneamente come elenchi. La correzione prevede di eseguire l'escape del primo carattere di tali paragrafi per assicurarsi che vengano trattati come paragrafi ordinari. Per le regole esatte di escape, fare riferimento alla documentazione di docutils all'indirizzo http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#enumerated lists.
Tech stack
Nessuno
Dominio
backend
Tipo issue
Bug
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
3
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
1-3 ore
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Datata
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Chiara
Prerequisiti
Familiarity with pandoc's RST readerBasic Haskell knowledge
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
30