jgm/pandoc

some RST paragraphs are written out like lists

Open

#4,422 建立於 2018年3月1日

在 GitHub 查看
 (5 留言) (0 反應) (0 負責人)Haskell (44,133 star) (3,850 fork)batch import
format:RSTgood first issuewriter

描述

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.

貢獻者指南

技術棧
無
領域
backend
議題類型
bug
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
3
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
1-3 hours
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
stale
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
clear
前置要求
Familiarity with pandoc's RST readerBasic Haskell knowledge
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
30
研究方向
Examine the RST reader implementation in pandoc, likely in src/Text/Pandoc/Readers/RST.hs. The issue describes that paragraphs beginning with text identical to an enumerator (e.g., 'A.', '1.') are incorrectly parsed as lists. The fix involves escaping the first character of such paragraphs to ensure they are treated as ordinary paragraphs. Refer to the docutils documentation at http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#enumerated lists for the exact escaping rules.
some RST paragraphs are written out like lists · jgm/pandoc#4422 | Good First Issue