RestructuredText .. include:: directive.

Issue #5411 wontfix
Michael Forbes
created an issue

It would be nice if the reST processor could parse .. include:: directives. The use-case is allowing one to factor out a set of links and replacements (I like to keep them in a top-level .links.rst file) so that one can freely use them in various .rst files throughout a project without having to redefine them in each file.

(It would actually be nice to be able to include a set of links from the web so that I only have to maintain one set, but this is probably a security problem, which is probably why ReStructuredText does not permit.)

Comments (4)

  1. Jesper Noehr

    You are correct: This is indeed disabled for security purposes. We use docutils for rST, and it does not permit sandboxing includes. If we had it on, it would be a giant security risk.

  2. Log in to comment