Albert Ting wrote: > I'm currently pre-processing a file into a reStructuredText format, > then call core.publish_string(). There probably is a better way, by > writing my own reader, but not sure how Reader class is used. If you're not trying to do anything fancy, core.publish_string() should be fine. It's when you need to do special processing that you need a custom Reader; see http://docutils.sf.net/spec/pep-0258.html#readers for an overview. There have been some discussions of Reader classes on the docutils-develop list lately (http://lists.sf.net/lists/listinfo/docutils-develop). If you describe your goals, I can advise you if you need a Reader. And FYI, all the Docutils runtime settings are listed in http://docutils.sf.net/docs/tools.html#configuration-file-entries . -- David Goodger <goodger@users.sourceforge.net> 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/