Sphinx 0.5 released

[kgmuller]

Happy Birthday, Georg! Thanks for a great tool!

Klaus "SimPy" Muller 

> -----Original Message-----
> From: Georg Brandl [mailto:georg at python.org] 
> Sent: Sonntag, 23. November 2008 19:45
> To: sphinx-dev at googlegroups.com; python-announce at python.org
> 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. ;)
> 
> 
>