#29 include directive and parsed literals


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


  • 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.


Log in to post a comment.

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

JavaScript is required for this form.

No, thanks