Release History¶
1.8.3 (2017-2-8)¶
Bugfix release
- bugfix:
relbar_links
: fixed potential label/title mixup, added some unittests.- updated documentation.
- added tox.ini script, with some very minimal tests.
- bugfix: setup script should no longer append timestamp when building from sdist; which should fix some reproducible-build issues downstream.
1.8.2 (2017-1-30)¶
Bugfix release
- bugfix:
relbar_links
: resolve translation proxies to prevent hash() error
1.8.1 (2017-1-30)¶
relbar_toc
extension deprecreated, replaced with more flexiblerelbar_links
extension. This should also fix issues with broken links under ‘dirhtml’ and other builders.- Assorted internal fixes to CSS template.
- Documentation layout updated.
1.8 (2016-11-20)¶
- Admonitions now support “without-title” class to hide title prefix (“Note”, “See also”, etc)
- Added
role_index
extension- Added
page_only
extension- Fixed
index_styling
extension to be compatible with Sphinx 1.4- Sticky sidebar code now allows sidebar to be scrolled independantly of main document – just scroll mouse while overing over sidebar.
- Sidebar can now be viewed from mobile mode; hidden state is stored independantly of large screen menu.
collapsablesidebar
flag is now ignored, sidebar is always collapsable. flag will be removed in 1.9.- A large amount of the sidebar css & js was rewritten, many of the DOM classes have changed.
- Now requires Sphinx >= 1.4.
1.7.1 (2015-12-12)¶
1.7 (2015-07-25)¶
Note
This theme now requires Sphinx >= 1.2 (some of the javascript code won’t work with the jquery version bundled in Sphinx 1.1 and earlier).
New Features¶
- Function, class, and other object declaration now have colored backgrounds (controlled by
colored_objects
flag).- All python code blocks now have button to hide prompts & output text, for easier copying (Adapted from python’s copybutton.js) (issue 17).
- Added font sizing options.
- Added document options to customize look and feel.
- Added
cloud_sptheme.ext.autoattribute_search_bases
extension.- Added
cloud_sptheme.ext.docfield_markup
extension.
Other Changes¶
autodoc_sections
has been completely rewritten. now utilitizes docutil’s native RST parser, creates real section elements rather than hacked up definition lists; should now handle any valid rest directive that can be put at module-level.- Added styling for 2nd-level section headers, and the nested section headers generated by
autodoc_sections
.- Default font size adjusted for compactness.
- The
popuptoc
feature has been removed. It was just too awkward to maintain the required styling. May revisit in the future using a JS-based approach.- Unified button hover look & color through relbar, sidebar, and body.
- Completely rewrote TOC highlighter code, now indicates active section, and collapses inactive TOC entries that are too large.
- Makes use of Sphinx 1.2’s egg entry point, so
get_theme_dir()
no longer needs to be used directly.
Bugfixes¶
autodoc_sections
now monkeypatches sphinx so that :param foo: and other fields get formatted correctly when they’re embedded in a nested section (issue 21).- now compatibile with Sphinx 1.3’s switch from
<tt>
to<code>
for literals.autodoc_sections
now monkeypatches sphinx so that:param foo:
and other fields get formatted correctly when they’re embedded in a nested section (issue 21).autodoc_sections
now handles method descriptors correctly (issue 16).- the sidebar collapse state is now consistent across subfolders of document (issue 9).
- jumping to method or attribute permalink will now highlight the object.
1.6 (2013-12-28)¶
New Features¶
- Added
rightsidebar
option to base theme, ala the Sphinx default theme.- TOC entries which overflow sidebar now popup when hovered over (can be disabled via
popuptoc = false
).- Added
sidebar_localtoc_title
and a number of other options for changing the titles of various links in the sidebar.- Added a sidebar called
quicklinks.html
, which mirrors the navbar at the top and bottom of the page.- Various other small styling changes.
1.5 (2012-10-01)¶
New Features¶
- Added
plain
,centered
, andfullwidth
css classes for positioning tables (see the theme options).- Added new extension
cloud_sptheme.ext.table_styling
, which adds some per-column styling options to the.. table::
directive.
Other Changes¶
- Changed default font to Open Sans, for readability.
- Removed all hardcoded
pt
orpx
font sizes, all sizes now specified as % of browser default.- Various improvements to mobile layout, including use of “viewport” metatag.
1.4 (2012-08-02)¶
- Sidebar now collapsible by default (issue 3).
- Sidebar now “sticks” to window when scrolling.
- Sidebar TOC now highlights sections currently being shown in window.
- Numerous documentation updates.
- Various minor bugfixes.
- Now natively compatible with Python 3, the 2to3 command is no longer required.
1.3 (2012-05-01)¶
Cleaned up documentation.
Redid css layouts. Cloud now has three layouts, controlled by css media queries:
- “Normal” mode displays the document as a center-aligned box within the browser window. It will not grow to be larger than
max_width
(default 11 inches) in size. (This theme parameter was previously nameddocwidth
).- “Compact” mode strips the body padding to fill the whole window, but otherwise looks “Normal” mode. It will be used when the browser is less than
compact_width
(default 960 pixels) in size. This layout is new in 1.3.- “Minimal” mode strips excess padding, hides the sidebar, and does other things to reduce it’s footprint as much as possible. This mode will be used if the browser is less than
minimal_width
in size (currently 700px), or if it uses the"handheld"
css media type. (This theme parameter was previously namedsmallwidth
).Added
issue_tracker
extension, for auto-creating links to a project’s issue tracker.Added
escaped_samp_literals
extension, which patches Sphinx to allow literal{
characters in samp roles.Added optional Google Analytics integration.
Added
collapsiblesidebar
option, as well asdefaultcollapsed
option. Though sidebar is still always hidden under minimal mode.Added a number of other
rst-class
styling directives.
1.2 (2011-07-11)¶
Minor stylistic changes to theme:
- Changed section headers have colored background.
- Added icons to admonitions.
- Changed default font.
- Other minor changes.
1.1 (2011-05-04)¶
New features:
- CSS media query automatically hides sidebar & trim for small displays (e.g. mobile devices)
- Toggleable sections javascript code rewritten, now auto-expands based on url hash.
- The parser used by the
autodoc_sections
extension is now much more robust, and relies on fewer assumptions about the source.- Fixed header margin glitch that was occurring under Chrome.
- Various minor layout enhancements.
1.0 (2011-03-25)¶
First public release.