Re: [Docutils-users] store front-end-tool options in the rst file?

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

[David Goodger]
>> I don't think I would mind putting runtime settings in the document
>> though, something like this (from idea 2 above):
>>
>>    .. settings::
>>
>>       :title: A non-default title
>>       :datestamp:

[G. Milde]
> This looks nice to me.
>
> What would be the syntax for boolean variables?
>
>         :datestamp: 0
>         :datestamp: false
>         :datestamp: FALSE
>         :no-datestamp:

The config file parser currently supports "true", "yes", "on", and "1"
as True values, and "false", "no", "off", "0", and "" (no value) as
False values.  The directive would support the same values.

But the datestamp setting does not take a boolean value, but a format
string for Python's ``time.strftime``.  The --date, --time, and
--no-datestamp command-line options are shortcuts.  The equivalent of
--date would be:

    .. settings::

       :datestamp: %Y-%m-%d

The value for "--time" would be "%Y-%m-%d %H:%M UTC".  If you don't
want a datestamp at all (equivalent of --no-datestamp), we'd use:

    .. settings::

       :datestamp:

--=20
David Goodger <http://python.net/~goodger>