Tree [r7747] / trunk / sandbox /
History



File Date Author Commit
OpenDocument 2009-03-02 dkuhlman [r5881] Fixes to wrapping of images and figures
aafigure 2009-06-08 cliechti [r5980] - wrap main in a function for easier script usage
aahz 2005-09-20 wiemann [r3892] Merged "transforms" branch into trunk.
agurtovoy 2009-08-24 agurtovoy [r6097] Re: MPL refmanul fixes
amk 2011-12-28 grubert [r7293] reST
axk 2005-04-22 axk [r3242] renaming my sandbox to my changed berlios username
bbum 2003-11-15 bbum [r1742] Patched to generate from test.txt successfully ...
blais 2008-10-14 blais [r5672] rst-fields: Fixed minor bug with enclosing sect...
cben 2005-06-20 wiemann [r3533] renamed tools/pep.py to rstpep2html.py
chm-writer 2009-10-12 grubert [r6177] Move the chm writer into its own directory.
cliechti 2009-06-15 cliechti [r5987] - Remove old code. This was once moved to trunk...
code-block-directive 2012-12-17 milde [r7573] GM sandbox project update
codeintro 2007-03-01 johnmulder [r4977] Changed execution flow description to describe ...
davidg 2010-12-07 milde [r6495] Move the orphaned python source reader to the s...
delza 2003-10-21 daddygravity [r1723] Fix for filepath exception, prevent multiple in...
dkuhlman 2007-03-21 dkuhlman [r5034] Moved OpenDocument to a project directory in sa...
docbook 2012-10-03 paultremblay [r7524] Using lxml for transformations. Test files will...
docpy-writer 2006-06-12 grubert [r4626] Add a modified version of elemttree doc.
docutils_xml 2013-12-07 smerten [r7738] Added class `ZipFileInput`.
dpriest 2007-03-02 wiemann [r4985] removed csvtable implementation; already in the...
dreamcatcher 2003-05-29 dreamcatcher [r1357] Ooops.
dugui 2006-02-28 facundobatista [r4360] Library liberated from SiGeFi project.
edloper 2007-03-02 wiemann [r4984] removed role proposal; already in the core
grubert 2012-05-05 grubert [r7426] remove reportlab license
gschwant 2006-03-22 goodger [r4442] updates from Gunnar Schwant
holdenweb 2004-03-21 holdenweb [r1845] Added to sandbox for PyCON DC 2004 sprint sharing.
html4strict 2013-09-28 milde [r7722] html4-strict: Fix depart_table.
html4trans 2008-03-07 milde [r5533] Correct file locations in internal links
ianb 2005-09-20 wiemann [r3892] Merged "transforms" branch into trunk.
infrastructure 2013-07-23 grubert [r7702] reminder to upload to pypi
jensj 2008-04-30 aisaac [r5544] Add 'dot' to the over dictionary.
lalo 2003-12-05 lalo [r1762] enumerated lists, and some minor (mostly cosmet...
latex-variants 2009-10-15 milde [r6179] Clean up my sandbox
latex_directive 2006-03-01 wiemann [r4365] fixed executable property
manpage-writer 2013-03-16 grubert [r7631] add test of postscript encoding
mly 2003-06-12 mly [r1432] Added README and my current CSS file.
mmgilbe 2005-01-22 mmgilbe [r2945] Changed recursive include limiting from just a ...
mwh 2002-10-25 mwh [r862] Slightly more robust now, I think.
newlatex 2010-12-07 milde [r6496] Move orphaned "newlatex" writer to the sandbox.
odf2docutils 2013-12-07 smerten [r7739] Adapted to docutils_xml V0.5.
oliverr 2011-10-20 grubert [r7192] Add math-output option , for html-writer
package-doc 2007-08-21 wiemann [r5417] removed hash-mark qualifier syntax alternative;...
paultremblay 2012-02-14 paultremblay [r7354] Directories not needed.
pobrien 2003-12-22 pobrien [r1777] Various fixes
presentations 2007-05-31 wiemann [r5174] adjusted name and email address
py-rest-doc 2007-12-07 gbrandl [r5469] Remove nonexisting external.
richard 2011-12-27 grubert [r7288] rename readme.txt to README.txt for apache
roff-writer 2014-01-03 grubert [r7742] corrections
rst2beamer 2010-11-02 smerten [r6468] Adapted to current latex2e implementation.
rst2chunkedhtml 2008-02-25 amohari [r5519] Moved writer logic out of HTMLChunker.write_chu...
rst2context 2012-01-10 al-quaknaa [r7312] Fix README.txt; footnotes not supported yet.
rst2graph 2013-06-22 smerten [r7676] Added `README` and man page in `rst2graph.rst`.
rst2odp 2010-10-14 smerten [r6444] `pygments` is not needed unless there are `.. c...
rst2outline 2010-10-31 smerten [r6463] Internal improvements.
rst2pdf 2008-08-25 goodger [r5638] correction: I didn't write rst2latex.py (or any...
rst2pdf-rubber 2009-01-28 milde [r5857] rename rst2pdf projekt dir to rst2pdf-rubber to...
rst2wiki 2012-06-29 joshuagraff [r7467] - Explicitly check for strings in strip function.
rst2wordml 2007-10-20 icosahedron [r5459] 0.5 of rst2wordml, including a very few unit te...
rstdiff 2012-01-06 grubert [r7309] readd README.txt
rtf-writer 2013-07-18 grubert [r7689] benouits contribution
simonb 2003-03-22 goodger [r1227] functionality implemented as embedded URIs; exa...
slides_tests 2010-09-17 aisaac [r6422] Add test for image handling.
stylesheets 2013-03-27 milde [r7642] Fix LaTeX syntax-highlight stylesheets pygments...
texinfo-writer 2010-09-20 jonwaltman [r6426] More documentation updates for Texinfo writer
tibs 2011-12-27 grubert [r7286] change file extension and make README uppercase...
uml-plantUml 2010-05-15 mauriciocap [r6326]
verse-writer 2007-01-04 grubert [r4847] Chg: stanza end to \\!
wilk 2003-08-27 goodger [r1650] updated
xhtml2rest 2007-05-31 wiemann [r5174] adjusted name and email address
xml2rst 2013-12-15 smerten [r7741] Added support for <substitution_reference>.
xsl_fo 2012-02-14 paultremblay [r7351] Files moved from paul_tremblay to a much more a...
README.txt 2012-01-30 milde [r7333] Update sandbox README.

Read Me

..                            -*- 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 Subversion repository but it isn't
distributed as part of Docutils_ releases.

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: http://docutils.sourceforge.net/
.. _Docutils Project Policies:
   http://docutils.sourceforge.net/docs/dev/policies.html#the-sandbox
.. _Docutils Web Site: http://docutils.sourceforge.net/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: http://docutils.sf.net/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.sourceforge.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