43
Sphinx Documentation, Release 1.4.1
– In the Python domain, references like:func:‘.name‘ now look for matching names with any
prefix if no direct match is found.
• Configuration:
– Addedrst_prolog config value.
– Addedhtml_secnumber_suffix config value tocontrol section numberingformat.
– Addedhtml_compact_lists configvalue to control docutils’ compact lists feature.
– Thehtml_sidebars config valuecan now contain patterns as keys, and the values can be lists
that explicitly select which sidebar templates should be rendered. That means that the builtin
sidebar contents can be included only selectively.
– html_static_path can now contain singlefile entries.
– The new universal config value exclude_patterns makes the old unused_docs,
exclude_trees and exclude_dirnames obsolete.
– Addedhtml_output_encoding config value.
– Added thelatex_docclass configvalue and madethe“twoside”documentclassoptionover-
ridableby“oneside”.
– Added thetrim_doctest_flags config value, which is true by default.
– Addedhtml_show_copyright config value.
– Addedlatex_show_pagerefs andlatex_show_urls config values.
– Thebehaviorofhtml_file_suffix changed slightly: theemptystringnow means“nosuffix”
instead of“default suffix”,useNone for “default suffix”.
• New builders:
– Added a builder forthe Epub format.
– Added a builder formanual pages.
– Added a single-file HTML builder.
• HTML output:
– Inline roles now get a CSS class with their name, allowing styles to customize their appearance.
Domain-specific roles gettwoclasses,domain and domain-rolename.
– References now get the class internal if they are internal to the whole project, as opposed to
internal tothe current page.
– External references can be styled differently with thenew externalrefs theme option for the
default theme.
– In the default theme, the sidebar can experimentally now be made collapsible using the new
collapsiblesidebar theme option.
– #129: Toctrees are now wrapped in a div tag with class toctree-wrapper in HTML output.
– Thetoctree callableintemplatesnow hasamaxdepth keyword argumenttocontrolthedepth
ofthe generated tree.
– Thetoctree callable in templates now accepts a titles_only keyword argument.
– Added htmltitle block in layout template.
– In the JavaScript search, allow searching for object names including the module name, like
sys.argv.
20.33. Release 1.0 (Jul 23, 2010)
239
