1. Bitbucket
  2. Public Issue Tracker
  3. master
  4. Issues


Issue #7682 wontfix

Add support for 'include' directive in reStructuredText preview in source browser (BB-8854)

Matt Williams
created an issue

It would be great if the include directive worked in the source browser.

The documentation for it is at http://docutils.sourceforge.net/docs/ref/rst/directives.html#including-an-external-document-fragment and an example of where I would like it to work is at https://bitbucket.org/volumesoffun/polyvox/src/master/documentation/changelog.rst

Comments (4)

  1. Jonathan Mooring staff

    Hey Matt,

    You're right, this would be neat. There isn't currently any time scheduled for markup work on our roadmap, but I've raised an issue in our internal tracker and will update this public issue when we have more to share.


  2. Arto Bendiken

    Hopefully you'll reconsider in the future. I just encountered this problem myself. It seems that for the time being content just has to be duplicated verbatim into the README file, which is pretty unfortunate and not very maintainable in the long run.

    As suggested in the corresponding GitHub feature request, security issues could be avoided by simply only permitting includes from the current directory and its subdirectories, which is the only thing that makes sense for top-level README files anyhow.

  3. Log in to comment