[Doc-SIG] verse construct (was Re: [Docutils-develop] Parsing
oddness)
David Goodger
goodger@users.sourceforge.net
Sat, 11 May 2002 12:50:10 -0400
Paul Moore wrote:
> The bulk of what I'm now saying is in terms of generalities. I'm
> really arguing that we have now reached a stage where a more
> conservative approach is called for.
I agree completely.
> Specifically, no new syntax should be added -
I'd add, "... without a thorough review". That's one of the reasons
I'm holding off on the `auto-enumerated lists`__ proposal.
__ http://docutils.sf.net/spec/rst/alternatives.html#auto-enumerated-lists
> directives form our extension mechanism,
Yes.
> and we should concentrate on consolidating the core, and if
> appropriate, building our "standard library".
By your use of "we" and "our", can I assume that you'll be ramping up
your involvement? Great!
> BTW, significant indentation? That could be hard - input is
> monospaced font, but output is proportional, so preserving the
> *appearance* of an indent won't be that easy.
Alignment of bits of text within lines can't be guaranteed, but the
line indentation itself (relative positions of just the left edges)
should be trivial.
> > I've rearranged the text of the directive definition to reflex this
> > emphasis:
> >
> > http://docutils.sf.net/spec/rst/reStructuredText.html#directives
>
> I'd add a bit more.
Noted and added. Thanks!
--
David Goodger <goodger@users.sourceforge.net> 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/