The Docutils sprint at PyConTX2006 was held over 4 days, from 9:00 Monday February 27 through Thursday March 2 inclusive. There was no cost to attend the sprints beyond being present at PyCon. For introductory information and information about the other sprints going on at PyConTX2006, please see PyCon2006/Sprints. Also see the Docutils home page and the reStructuredText home page. The PyCon DC 2004 Docutils sprint details are here: DocutilsSprint.

Please feel free to add your comments here (prefered); I'll be notified of all changes to this page. If you can't edit the wiki, you can email me.

If you cannot attend the Docutils sprints in person but would still like to follow the progress and/or participate, you can, via Internet Relay Chat (, channel #docutils).


Everyone is welcome! No prior Docutils hacking experience is required. Participants should be one or more of:

  • experienced Python programmers
  • interested in text/documentation processing
  • users of Docutils/reStructuredText

Sprinters planning to attend:

Please add your name to the list above or email me.

Nested Inline Markup

Things that we may need to think about when adding nested inline markup:

`foo :bar:`/baz` qux`   (inline start-string probably takes priority)
***foo** bar*
***foo* bar**

The inline parser must determine whether a role contains literal or parsed text before it starts parsing the contents:

:raw:`This *contains ``uninterpreted `markup`

We probably have to disallow (or at least deprecate) postfix notation for literal (or for all) roles, because of this:

`contents`:raw:    // This happens to work
`This *contains ``uninterpreted `markup`:raw:

In the latter case, the parser cannot know at the time it parses the role contents that they are literal


We will begin the sprint with an interactive overview of the Docutils architecture and codebase. Then we will determine sprint topics and get hacking! Sprinters are free to work alone, work in pairs (pair programming), or however they feel comfortable.


The topics below are in no particular order. Please feel free to add topics & comments.

There are more ideas in the Docutils to-do list.


Please feel free to add any comments you like below. Please include your name & email address for feedback; anonymous comments are OK too. I hope to see you at PyCon! -- David Goodger

A source reader that several people (including myself) are using is Pudge, which has proven useful but also has lots of room for work. It provides quite a few features that aren't exactly reST-specific, but those are features that really fill it out into a useful tool, and are the kind of features that kind of complete the experience of using reST so that it really feels like a nice way to document code. A lot of its issues aren't about restructured-text per se, but if the project was really turned into a nice polished piece of work it would certainly help many of the people people who use restructured text. -- Ian Bicking

PyCon2006/Sprints/DocutilsSprint (last edited 2008-11-15 13:59:52 by localhost)

Unable to edit the page? See the FrontPage for instructions.