Sphinx 1.4-alpha1 released

Takayuki Shimizukawa shimizukawa at gmail.com
Sun Feb 14 09:32:19 EST 2016


Hi all,

I'm very happy to announce the release of Sphinx 1.4-alpha1 available on the
Python package index at <http://pypi.python.org/pypi/Sphinx/1.4a1>.
This is the first testing release for Sphinx 1.4 that includes:
* 31 features
* 10 incompatible changes
* 20 fixes of bugs/buglets
from the 1.3.5 version of Sphinx

For the full changelog, go to <
http://www.sphinx-doc.org/en/master/changes.html>.
Thanks to all coraborators and contributers!

What's new in 1.4 (very short version)?
=======================================

Features added
--------------

* 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
--------------------

* 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


More information about the Python-announce-list mailing list