Re: [Docutils-users] comments vs. directives

[Schimon J. <sc...@fe...>]

Günter. Good afternoon.

On Fri, 10 Oct 2025 10:53:29 +0200
Guenter Milde <gm...@e-...> wrote:

> Dear Schimon,
> 
> Am 10.10.25 schrieb Schimon Jehudah:
> 
> ...
> > I have created a test file which is based only on your text.  
> 
> > Upon executing command rst2xml, Docutils outputs a couple of errors,
> > one for author and one for date.  
> 
> > I assume that these are errors of the directives author:: and date::
> > with two colons.  
> 
> Correct. 
> 
> With two colons, it is rST directive syntax.
> With one colon, it is rST comment syntax.
> 
> Add/remove one colon and you get unexpected results.
> 

Now, I realize this.

> This is what I meant with my statement that
> 
> > > >> >> The preamble [...] looks confusingly similar to 
> > > >> >> reStructuredtext directives.  
> 

Then, do you imply, by that statement, that it be a preferable practice
for preambles to differ from reStructuredtext directives?

> ...
> 
> > > * Optionally repeat with
> > > 
> > >     .. date: 2025-10-09
> > > 
> > >     .. date: 2025-10-09
> > >   
> 
> > Did you mean to add two consequent colons to the second instance of
> > "date" (i.e. "date::")?  
> 
> Yes. I was confused.
> 

Thank you.

> Günter

Schimon