Re: [Docutils-develop] Transforms...?

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

Adam Chodorowski wrote:
> I would like to implement a transform/filter with which you can
> select a single section (by name or ordering) to be processed
> further, filtering all the other ones out. This can be used for
> extracting the abstract of a document, for example, so you can put
> it on a separate page (with a link to the full document perhaps).
> 
> I would greatly apreciate any directions and tips where to start
> with this.  I guess I would inherit from Transform or Filter? Can
> you (in the application using docutils) specify/add extra
> transforms/filters to be used when processing a source?

Can you give us some background on what you're trying to accomplish?
I'm not sure that a transform is what you want.  A transform modifies
a document tree; perhaps you just want to extract part of an existing
document tree?  Are you writing a custom Writer, such as to generate a
multi-page web site?  Perhaps a subclass of the html4css1.py Writer?

> Also, I noticed that there seems to be some provision for language
> localization. Is this in a usable state and is the current API
> reasonable stable? If so, I can contribute some code to support
> swedish.

Usable: yes, in English.  No other language is installed yet, so I
couldn't say.  Also, the code itself is not localized, just some
strings for the parser to recognize and for use in generating output.

Stable API: that depends on whether or not it works.  It hasn't really
been tested properly; just my first stab.  I imagine it will need some
work, but that can only be determined through real-life use.

Contributions: always welcome.  I was wondering -- Chodorowski -- a
good Swedish name that.

-- 
David Goodger  <go...@us...>  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/