Re: [Docutils-develop] [docutils:feature-requests] #91 reST: include directive should support root-relative paths

[Guenter M. <mi...@us...>]

On 2022-05-06, Michal Urbanski via Docutils-develop wrote:

> [-- Type: text/plain, Encoding: 7bit --]

> Yes, this sounds like a reasonable solution - an option that tells the
> directive to use a path relative to something configurable. Obviously
> the path should be specified elsewhere - otherwise the directive would
> be just pointless.

For "elsewhere", I propose the `configuration settings`¹.

Before attempting a patch, we should check with the various frameworks
(Sphinx, Nicola, Pelican, ...) how useful they consider this to be
and whether we should

* provide an "include-root" for the include path, or

* provide a "standard-include-path" (list of directories to search for
  include files with the ``.. include:: <something>`` syntax².

Günter  
  
¹ https://docutils.sourceforge.io/docs/user/config.html
² https://docutils.sourceforge.io/docs/ref/rst/directives.html#including-an-external-document-fragment