1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
.. -*- rst-mode -*-
=====================
README: The Sandbox
=====================
The Sandbox_ is a place to play around, to try out and share ideas.
The `sandbox/`_ directory is a part of the `Docutils Subversion repository`_
but it isn't distributed as part of Docutils_ releases.
To get a snapshot of the sandbox/ directory, go to
https://sourceforge.net/p/docutils/code/HEAD/tree/trunk/sandbox/
and click the "Download Snapshot" button.
It's OK to make a mess in the Sandbox! But please, play nice.
A project-specific subdirectory should be created for each new project.
Any developer who wants to play in the sandbox may create their own
subdirectory (suggested name: SourceForge ID, or given name + family
initial), but project directories are recommended over personal directories,
which discourage collaboration.
For more information, please see the `Docutils Project Policies`_. The
Sandbox is mirrored at the Docutils web site, so the `Docutils Web Site`_
documentation applies as well.
.. These links give readers a way to *go to* the sandbox:
.. _sandbox:
.. _sandbox/: ./
.. _Docutils: https://docutils.sourceforge.io/
.. _Docutils Subversion repository:
https://docutils.sourceforge.io/docs/dev/repository.html
.. _Docutils Project Policies:
https://docutils.sourceforge.io/docs/dev/policies.html#the-sandbox
.. _Docutils Web Site: https://docutils.sourceforge.io/docs/dev/website.html
Sandbox Projects
================
See the `sandbox/`_ directory for a complete list.
Some Sandbox projects, are also sorted into the `Docutils Link List`_.
.. _Docutils Link List: https://docutils.sourceforge.io/docs/user/links.html
.. TODO: update the list of important sandbox projects (here or in the link
list?)
The remainder of this section contained descriptions and links to obsolete
or abadoned projects. Commented out because this give an impression of an
attic instead of a place for experimenting.
Projects that are now implemented in Docutils
---------------------------------------------
* `<code-block-directive>`_ contains documentation, reasoning and
experimental code for support of syntax highlight in Docutils.
Preparational work for the `code`_ directive available since version 0.9.
* `LaTeX math for reST`_ by Jens J. Mortensen writes Math to
LaTeX or MathML. This is the base of math_ support since version 0.8.
.. _code: docutils/docs/ref/rst/directives.txt#code
.. _math: docutils/docs/ref/rst/directives.txt#math
.. _LaTeX math for reST:
http://docutils.sf.net/sandbox/jensj/latex_math/
Documenting Python
------------------
Since Python 2.6, the markup used for the official `Python documentation`_
is `reStructuredText`_, amended by custom directives. The Sphinx_ toolset is
used to generate the HTML and LaTeX versions.
The sandbox contains some of the pervious work done on enabling Docutils to
write the `"Documenting Python"`__ using rST.
__ http://docs.python.org/doc/doc.html
* `Edward Loper's sandbox
<http://docutils.sf.net/sandbox/edloper/docpy/>`__. The example
"asyncore.rst" file was originally adapted by Steve Holden and Bill
Sconce.
* `Dave Kuhlman's sandbox
<http://docutils.sf.net/sandbox/dkuhlman/>`__ and `his homepage
<http://www.rexx.com/~dkuhlman/rstpythonlatex_intro.html>`__.
* `docpy-writer <http://docutils.sf.net/sandbox/docpy-writer/>`__ was
used for ctypes documentation.
.. _Python documentation: http://docs.python.org/
.. _reStructuredText: http://docutils.sf.net/rst.html
.. _Sphinx: http://sphinx.pocoo.org/
Project Infrastructure
----------------------
`docutils-update <infrastructure/docutils-update>`_ is a script that
was installed as a cron job on BerliOS.de to automatically update the
Docutils `web site`_ whenever the SVN files change. Any .html
document with a corresponding .txt file is regenerated whenever the
.txt file changes.
.. _web site: http://docutils.sf.net/docs/dev/website.html
|
