Sphinx 1.4 released

[Takayuki Shimizukawa]

Hi all,

I'm very happy to announce the release of Sphinx 1.4-final available on the Python package index at <http://pypi.python.org/pypi/Sphinx/1.4>.

Sphinx-1.4 includes many updates from 1.3.6 version:

* 49 features

* 17 incompatible changes

* 40 fixes of bugs/buglets

For the full changelog, go to <http://www.sphinx-doc.org/en/1.4/changes.html>.

Thanks to all coraborators and contributers!

What's new in 1.4 (short version)?

=================================

Features added

--------------

* I18N: figure substitutions by language and figure_language_filename

* Config: suppress_warnings to suppress arbitrary warning message (experimental)

* Directive: glossary term supports grouping key for index entries by using classifier syntax (experimental)

* Directive: Support Imgmath (pngmath with svg support).

* Builder: XeTeX and LuaTeX for the LaTeX builder.

* Builder: Add the ``dummy`` builder: syntax check without output.

* Builder: Add EPUB 3 builder (experimental)

* Search: Chinese language search index.

* Search: Japanese language search index by using Janome

* Search: splitter customization for Japanese language search index

* Domain: cpp domain improvements

* Ext: Add sphinx.ext.githubpages to publish the docs on GitHub Pages

* Ext: Add ``sphinx.ext.autosectionlabel`` extension to allow reference

  sections using its title.

* API: Add Sphinx.add_source_parser() to add source_suffix and source_parsers from extension

* Image recognition by using  ``imagesize`` package w/o PIL/Pillow

Incompatible changes

--------------------

* manpage writer: don't make whole of item in definition list bold if it includes strong node.

* Remove hint message from quick search box for html output.

* sphinx_rtd_theme has become optional. Please install it manually.

* :confval:`html_extra_path` also copies dotfiles in the extra directory, and

  refers to :confval:`exclude_patterns` to exclude extra files and directories.

* Under glossary directive, each terms are converted into individual ``term`` nodes and ``termsep`` node is removed.

  By this change, output layout of every builders are changed a bit.

* The default highlight language is now Python 3.  This means that source code

  is highlighted as Python 3 (which is mostly a superset of Python 2), and no

  parsing is attempted to distinguish valid code.

* `Locale Date Markup Language

  <http://unicode.org/reports/tr35/tr35-dates.html#Date_Format_Patterns>`_ like

  ``"MMMM dd, YYYY"`` is default forma for `today_fmt` and `html_last_updated_fmt`.

  However strftime format like ``"%B %d, %Y"`` is also supported for backward

  compatibility until Sphinx-1.5. Later format will be disabled from Sphinx-1.5.

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).

Website: http://sphinx-doc.org/

IRC: #sphinx-doc on irc.freenode.net

Enjoy!

--

Takayuki SHIMIZUKAWA

http://about.me/shimizukawa