Re: [Docutils-develop] reST Includes

[David G. <go...@us...>]

I was updating the to-do list from the recent discussion, when I got to
thinking about the ":raw:" parameter:

    A "raw" flag (attribute with no value) would inform us that the
    imported data is raw (already in native format, like HTML).
    Perhaps there should be an attribute value, saying what the native
    format is.  Instead, perhaps the "raw" directive should take an
    "include" parameter (explicit attribute or second parameter in its
    directive data).

So, should it be::

    .. raw:: html fragment.html

or::

    .. include:: fragment.html
       :raw: html

?

A description of the "raw" directive is at
http://docutils.sf.net/spec/rst/directives.html#raw-data-pass-through.
The latest notes about the "include" directive are at
http://docutils.sf.net/spec/notes.html#misc-include.

-- 
David Goodger  <go...@us...>  Open-source projects:
  - Python Docutils: http://docutils.sourceforge.net/
    (includes reStructuredText: http://docutils.sf.net/rst.html)
  - The Go Tools Project: http://gotools.sourceforge.net/