Re: [Docutils-users] need help on parsing and split value from a reStructured Text

[Guenter M. <mi...@us...>]

On 2011-05-04, Yunfan Jiang wrote:

> hi, 
> i got some knowledges here
> http://docutils.sourceforge.net/docs/howto/rst-directives.html while i
> am looking for the documents for developer

Did you find the developer docs in the
http://docutils.sourceforge.net/docs/dev/ directory, too?

> i am doing my own blog system which use rst as the main format,
> currently my target is to use a single rst file to contains all the
> field that a blog entry needs, like title, tags, uri_code, and content,
> and i want to store the title, tags, and uri_code in the file's
> FieldList like this

>:title: the first blog of mine
>:uri_code: the-first-blog
>:tags: test python about

> here is content

> but the problem is i dont know how to parsing a reSturctured text and
> got the target field's value , there's so many documents that tolds how
> to translate from rst to another format ( html, xml, ...), could you
> show me same documents about this target, or could you give me some
> sample?

This depends on what exactly you want to achieve. In any case you might
need to look at the source (in addition to the developers documentation).

a) do you implement a "blog-writer" and want to use the field values in
   them?
   
   -> have a look at html4css1/__init__.py or latex2e/__init__.py to see
   how special field names are detected (hint: look at the
   visit_docinfo() and visit_field_name() definitions).
   
b) do you want to parse the rst source separtely?

   -> convert to XML and use standard tools to extract the info, 
   
   or convert to a Docutils doctree and extract the info traversing
      the tree (similar to what is done in the transforms 
      -> see docutils/docutils/transforms/*.py).
      
Günter