[Docutils-users] Using reST in a Wiki

[Ian B. <ia...@co...>]

To serve as an instructional sample I'm making a very simply Wiki -- I'd
like to use reST as the markup, since it's not an example in parsing
(and I like the reST markup more than most Wiki markups to boot).

So, to do this I need to convert reST to HTML.  I looked around in
buildhtml.py to get an idea, but I found it surprisingly difficult to
figure out just what I would need to do.  This is the (not working) code
I came up with:

        pub = core.Publisher()
        pub.set_reader(reader_name='standalone',
                       parser_name='restructuredtext', parser=None)
        pub.set_writer(writer_name='html')
        pub.source = io.FileIO(None, source_path=sourceFile)
        pub.destination = io.FileIO(
            None, destination_path=destFile)

Could someone perhaps tell me what the easiest way to do this is?  I'm
not sure of the relevance of the options, the importance of FileIO, or
some of the other abstractions involved in this operation.

Also -- is there a good hook in reST that I can use for Wiki links?  The
linking mechanism reST has is fine for internal and external links, but
doesn't fit right for Wiki links (which fall somewhere in between).  If
I could capture failed internal links and turn them into inter-wiki-page
links, that would be perfect.  Failing that, if there was some way I
could introduce another markup easily that would be great.

If there isn't an easy way, I'll probably just look for WikiNames in the
generated HTML, and do the substitution then.  I'll have to do some
dynamic fixup anyway, to distinguish between existent Wiki pages and
to-be-created links.

Thanks,
  Ian