Re: [Docutils-users] customize for literature book

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

William Dode wrote:
> (incredible 30 developers on this project !!!).

Not so incredible.  Almost everybody who contributes becomes a developer.
Sometimes I offer, sometimes they ask.  The doors are wide open.

> I don't like to put it in the text when they can be put automaticaly.
> I thought making a special html writers or use an external script
> after the writers.

Looking at the article you cite, a specialized writer may be necessary.  It
seems that very publisher has a different article structure.  However, I'd
recommend a *pre*-processing script, *before* Docutils, to automate
insertion of non-breaking spaces and other character processing (like
turning "<<" into the &laquo; guillemet symbol).

> Just a litle question : how to don't have space with a replace ? (and
> also with [#]) ?
> Python |tm| work but Python|tm| will not work.

That's one of the "issues still to resolve":

>> There are a couple of issues still to resolve.  See
>> <http://article.gmane.org/gmane.comp.python.documentation/418> for details.

Specifically, I think the "\ " escape sequence idea works nicely.  So it
would be "Python\ |tm|".  It's ugly, but it works.  Or it will, once
implemented (soon).

>>> - how can i have a new type of paragraph (like a right-indented for
>>> citation between title and text) : i begin to look at adding a
>>> directive...
>> 
>> I can't say without seeing an example; can you provide one?  A directive may
>> be the correct option.
> 
> http://atheles.org/editeur.php?ref_editeur=&main=lyber&ref_lyber=273
> 
> there is a title, a subtitle (long line), a citation on the right (exergue).
> 
> if i could do .. exergue:: after i can manage it easily with stylesheet.

Interesting word, "exergue".  My French-English dictionary translates it to
"exergue" also in English, which means "the space beneath the device on a
coin or medal, which lists the date and/or place of minting".  My old "Micro
Robert En Poche" wasn't very helpful either, since my French is rusty.

The "exergue" appears to me to be a block quote used to introduce an article
(does it appear anywhere else?).  A directive could do it, or a
bibliographic field (":exergue: ..."), or just have your custom Writer (or a
transform) recognize the first block quote after the document title.
Another idea that was brought up recently was for a directive to add a
"class" attribute to arbitrary objects.  Something like this::

    =====
    Title
    =====

        .. class:: exergue

        This is the block quote "exergue"...

    Main text here...

Then you'd end up with <block_quote class="exergue">...</> and your
stylesheet can select on the class.  The "class" directive hasn't been
implemented yet.

>>> - is interpreted text a way to customize ?
>> 
>> Yes, depending on what you want to do.  It's currently in development and
>> discussion.  Please provide examples if you want more specific answers.
> 
> For example, if i want a special font or color for foreigns word in the middle
> of a paragraph. Somethings like that :foreign:`bonjour`

Yes, that's what interpreted text is for.

-- David Goodger    http://starship.python.net/~goodger

Programmer/sysadmin for hire: http://starship.python.net/~goodger/cv