jgm/pandoc

some RST paragraphs are written out like lists

Open

#4.422 geöffnet am 1. März 2018

Auf GitHub ansehen
 (5 Kommentare) (0 Reaktionen) (0 zugewiesene Personen)Haskell (3.850 Forks)batch import
format:RSTgood first issuewriter

Repository-Metriken

Stars
 (44.133 Stars)
PR-Merge-Metriken
 (Durchschn. Merge 7T) (7 gemergte PRs in 30 T)

Beschreibung

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.

Contributor Guide

Research-Richtung
Untersuchen Sie die Implementierung des RST Readers in pandoc, wahrscheinlich in src/Text/Pandoc/Readers/RST.hs. Das Problem beschreibt, dass Absätze, die mit einem Text beginnen, der einem Aufzählungszeichen (z.B. 'A.', '1.') entspricht, fälschlicherweise als Listen geparst werden. Die Lösung besteht darin, das erste Zeichen solcher Absätze zu maskieren, um sicherzustellen, dass sie als normale Absätze behandelt werden. Konsultieren Sie die docutils Dokumentation unter http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#enumerated lists für die genauen Maskierungsregeln.
Tech Stack
Keine
Domain
backend
Issue Type
Fehler
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
3
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-3 Stunden
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Veraltet
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
Familiarity with pandoc's RST readerBasic Haskell knowledge
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
30