jgm/pandoc

some RST paragraphs are written out like lists

Open

#4 422 ouverte le 1 mars 2018

Voir sur GitHub
 (5 commentaires) (0 réactions) (0 assignés)Haskell (3 850 forks)batch import
format:RSTgood first issuewriter

Métriques du dépôt

Stars
 (44 133 stars)
Métriques de merge PR
 (Merge moyen 7j) (7 PRs mergées en 30 j)

Description

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.

Guide contributeur

Direction de recherche
Examinez l'implémentation du lecteur RST dans pandoc, probablement dans src/Text/Pandoc/Readers/RST.hs. Le problème décrit que les paragraphes commençant par un texte identique à un énumérateur (par exemple 'A.', '1.') sont incorrectement analysés comme des listes. La correction consiste à échapper le premier caractère de ces paragraphes pour s'assurer qu'ils soient traités comme des paragraphes ordinaires. Reportez vous à la documentation de docutils à l'adresse http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#enumerated lists pour les règles d'échappement exactes.
Stack technique
Aucun
Domaine
backend
Type d'issue
Bug
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
3
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-3 heures
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Ancienne
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
Familiarity with pandoc's RST readerBasic Haskell knowledge
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
30