jgm/pandoc

Admonition blocks not converted back from html to rst.

Open

#4.511 geöffnet am 30. März 2018

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

Repository-Metriken

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

Beschreibung

Not sure if this is a bug or just an unimplemented feature.

Converting rST admonition blocks to html and back to rST doesn't produce the same rST syntax. Instead, there are raw inclusions. Tested on Pandoc 2.1.3.

It would be nice to recognize note blocks, like it happens with <pre>.

Here's a full demo: https://github.com/NickVolynkin/pandoc-admonition-demo And a short example.

Expected output:

.. note::

   Note text

Actual output:


.. raw:: html

   <div class="note">

.. raw:: html

   <div class="admonition-title">

Note

.. raw:: html

   </div>

Note text

.. raw:: html

   </div>

Contributor Guide

Research-Richtung
Untersuche den HTML Reader und den rST Writer in Pandoc, um zu verstehen, warum benutzerdefinierte HTML divs bei der Rundumwandlung nicht als Admonitions erkannt werden. Das Demo Repository unter https://github.com/NickVolynkin/pandoc admonition demo bietet Testfälle. Erwäge, Unterstützung für das Mapping spezifischer HTML Klassen (wie 'note') zur entsprechenden rST Direktive im Writer hinzuzufügen.
Tech Stack
Keine
Domain
backendclidocumentation
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.
Halber Tag
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
GitHaskellPandoc internals
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
40