[Web-SIG] WSGI is now Python 3-friendly

Ben Finney ben+python at benfinney.id.au
Mon Sep 27 03:15:06 CEST 2010


"P.J. Eby" <pje at telecommunity.com> writes:

> (For that matter, if anybody knows how to make it not turn *every* PEP
> reference into a link, that'd be good too! It doesn't really need to
> turn 5 or 6 occurrences of "PEP 333" in the same paragraph into
> separate links. ;-) )

reST, being designed explicitly for Python documentation, has support
for PEP references built in:

    The :pep-reference: role is used to create an HTTP reference to a
    PEP (Python Enhancement Proposal). The :PEP: alias is usually used.
    For example:

        See :PEP:`287` for more information about reStructuredText.

    This is equivalent to:

        See `PEP 287`__ for more information about reStructuredText.

        __ http://www.python.org/peps/pep-0287.html

    <URL:http://docutils.sourceforge.net/docs/ref/rst/roles.html#pep-reference>.

-- 
 \     “What is needed is not the will to believe but the will to find |
  `\              out, which is the exact opposite.” —Bertrand Russell |
_o__)                                                                  |
Ben Finney



More information about the Web-SIG mailing list