jgm/pandoc

Admonition blocks not converted back from html to rst.

Open

#4 511 ouverte le 30 mars 2018

Voir sur GitHub
 (3 commentaires) (0 réactions) (0 assignés)Haskell (3 850 forks)batch import
enhancementformat: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

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>

Guide contributeur

Direction de recherche
Étudiez le lecteur HTML et le rédacteur rST dans Pandoc pour comprendre pourquoi les div HTML personnalisés ne sont pas reconnus comme des admonitions lors de la conversion aller retour. Le dépôt de démonstration sur https://github.com/NickVolynkin/pandoc admonition demo fournit des cas de test. Envisagez d'ajouter la prise en charge du mappage de classes HTML spécifiques (comme 'note') vers la directive rST appropriée dans le rédacteur.
Stack technique
Aucun
Domaine
backendclidocumentation
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.
Une demi journée
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
GitHaskellPandoc internals
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
40