#29 include directive and parsed literals

open
nobody
None
5
2013-08-21
2012-08-31
Mike Solomon
No

With Docutils >= 0.9, it is impossible to include HTML files (without parsing of rst-inline-markup in the HTML file) with the "include" directive::

.. include:: test.html
:code: HTML

It would be nice to have a new option for the include directive that allowed one to pass the content of the included file to a "parsed literal" block. Something like:

.. include:: test.html
:parsed-literal: HTML

Discussion

  • David Goodger
    David Goodger
    2012-09-21

    I don't understand the request. What does "rst-inline-markup in the HTML file" mean? Please show an example of the input file and describe what you want as output.

     
  • Günter Milde
    Günter Milde
    2013-08-21

    • Group: --> Next_Release_(example)
     
  • Günter Milde
    Günter Milde
    2013-08-21

    It would be possible to add an option

    parsed-literal : flag (empty)
    The entire included text is inserted into the document as a single parsed-literal block.

    Is that what you want?

    The option argument "HTML" suggests that you want both, parsing and syntax highlight but this is not possible with Docutils.