Happy Birthday, Georg! Thanks for a great tool! Klaus "SimPy" Muller
> -----Original Message----- > From: Georg Brandl [mailto:[EMAIL PROTECTED] > Sent: Sonntag, 23. November 2008 19:45 > To: [EMAIL PROTECTED]; [EMAIL PROTECTED] > Subject: Sphinx 0.5 released > > Hi all, > > I'm proud to announce the release of Sphinx 0.5 - Birthday > edition! [1] > > What is it? > =========== > > Sphinx is a tool that makes it easy to create intelligent and > beautiful documentation for Python projects (or other > documents consisting of multiple reStructuredText source files). > > Its website is at <http://sphinx.pocoo.org/>. > > Important changes > ================= > (full changelog at <http://sphinx.pocoo.org/changes.html>) > > There have been lots of changes since the 0.4 series. > > First of all, development moved to Mercurial and BitBucket.org. > The new project page is <http://www.bitbucket.org/birkenfeld/sphinx>, > which is also the repo URL. See the Wiki there for more > information on Mercurial, issues and extensions. > > Highlights of new features -- in no particular order: > > - Added support for internationalization in generated text with the > ``language`` and ``locale_dirs`` config values. Many thanks to > language contributors: > > * Horst Gutmann -- German > * Pavel Kosina -- Czech > * David Larlet -- French > * Michal Kandulski -- Polish > * Yasushi Masuda -- Japanese > * Guillem Borrell -- Spanish > * Luc Saffre and Peter Bertels -- Dutch > * Fred Lin -- Traditional Chinese > * Roger Demetrescu -- Brazilian Portuguese > * Rok Garbas -- Slovenian > > - The new extensions ``sphinx.ext.jsmath`` and > ``sphinx.ext.pngmath`` > provide math support for both HTML and LaTeX builders. > > - The new extension ``sphinx.ext.intersphinx`` half-automatically > creates links to Sphinx documentation of Python objects in other > projects. > > - The new extension ``sphinx.ext.todo`` allows the insertion of > "To do" directives whose visibility in the output can be toggled. > It also adds a directive to compile a list of all todo items. > > - The JavaScript search now searches for objects before searching in > the full text. > > - Citations are now global: all citation defined in any file can be > referenced from any file. Citations are collected in a > bibliography > for LaTeX output. > > - Footnotes are now properly handled in the LaTeX builder: > they appear > at the location of the footnote reference in text, not at > the end of > a section. Thanks to Andrew McNamara for the initial patch. > > - You can now document several programs and their options with the > new ``program`` directive. > > - Figures with captions can now be referred to like section titles, > using the ``:ref:`` role without an explicit link text. > > - Only generate a module index if there are some modules in the > documentation. > > - The new config value ``latex_elements`` allows to > override all LaTeX > snippets that Sphinx puts into the generated .tex file by default. > > - Added ``source_encoding`` config value to select input encoding. > > - sphinx.ext.autodoc has been improved considerably with respect to > customization and extensibility. > > - Added a command-line switch ``-A``: it can be used to supply > additional values into the HTML templates. > > - Added a command-line switch ``-C``: if it is given, no > configuration > file ``conf.py`` is required. > > - Added a distutils command `build_sphinx`: When Sphinx is > installed, > you can call ``python setup.py build_sphinx`` for > projects that have > Sphinx documentation, which will build the docs and place them in > the standard distutils build directory. > > Many thanks go to the many contributors, bug reporters and > discussion participants on the mailing list who helped shape > this release. > > Enjoy, > Georg > > [1] Yes, it's my birthday today. Yes, I have a life. ;) > > > -- http://mail.python.org/mailman/listinfo/python-list