Re: [Docutils-users] like ".. important::"

[Brett g P. <bgp...@ac...>]

David Abrahams wrote:
> David Goodger <go...@py...> writes:
> I'm worried about your worry about flexibility (I'm a meta-worrywar=
t).
> I'm using Docutils to write a book (so far), and I am certain that =
if
> it doesn't sprout more of that sort of parametrization ability I'm
> going to outgrow ReST and have to drop the comfortable input syntax
> for something awful like TeX or more-likely, DocBook.
>=20

FWIW, I'm with David Abrahams -- I'm starting to use rST as my domina=
nt=20
writing tool. Right now I'm working on the documentation for a large =
SDK=20
that we're writing, and also gearing up to rewrite our programming st=
yle=20
guide. I'm starting to bump up against minor annoyances.

I don't know what the right answer is.

Here's an example of what I would love to be able to do for the style=
=20
guide, for instance:

I need to be able to include language-specific example code, and I wo=
uld=20
love to have a richer style-specification model, so I could create a=
=20
stylesheet entry that displays C++ examples against a light blue=20
background, Java against a different color (black text on a black bg=
=20
would be my personal choice there) , etc, etc, etc.
--
//  Today's Oblique Strategy (=A9 Brian Eno/Peter Schmidt):
//  Don't be afraid of things because they're easy to do
//  Brett g Porter * BgP...@ac...