Differences between revisions 5 and 21 (spanning 16 versions)
⇤ ← Revision 5 as of 2005-12-14 19:51:23 →
Size: 3833
Editor: DavidGoodger
Comment: is this the right way to make an IRC link?
← Revision 21 as of 2008-11-15 13:59:52 → ⇥
Size: 6308
Editor: localhost
Comment: converted to 1.6 markup
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
#acl All:read
Line 6: Line 7:
.. contents::
Line 9: Line 13:
The Docutils sprint at PyConTX2006 will be held over 4 days, from 9:00 The Docutils sprint at PyConTX2006 was held over 4 days, from 9:00
Line 11: Line 15:
There is no cost to attend the sprints beyond being present at PyCon. There was no cost to attend the sprints beyond being present at PyCon.
Line 45: Line 49:
* `Thomas Drake <bistroy@mac.com>`_ (Monday, Tuesday, Wednesday)
* pythondrs@drstovallfoundation.com (I'm ready anytime but I am on WinXP in Singapore Internet cafe)
* `John Gill <swfiua@gmail.com>`_ (Monday, Tuesday)
* Facundo Batista
Line 47: Line 55:


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**
    ******************************foo******************************

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


Plugins
=======

Other projects with plugin mechanisms:

* `On Plug-ins and Extensible Architectures
  <http://www.acmqueue.org/modules.php?name=Content&pa=printer_friendly&pid=286&page=2>`__
* `The Firedrop Plugin System
  <http://www.voidspace.org.uk/python/firedrop_plugins.html>`__
* `Twisted Documentation: The Twisted Plugin System
  <http://twistedmatrix.com/users/warner/doc-latest/core/howto/plugin.html>`__
* `TurboGears Plugins
  <http://www.turbogears.org/docs/plugins/index.html>`__
* `The Firedrop2 Plugin System
  <http://www.voidspace.org.uk/python/firedrop2/plugins.html>`__
* `MoinDev/PluginConcept - MoinMoin
  <http://moinmoin.wikiwikiweb.de/MoinDev/PluginConcept>`__
Line 123: Line 172:

A source reader that several people (including myself) are using is `Pudge <http://pudge.lesscode.org>`_, 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

Preliminaries

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 (irc.freenode.net, channel #docutils).

Sprinters

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**
******************************foo******************************

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

Schedule

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.

Topics

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.

Comments

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.