.. -*- restructuredtext -*-

===============
Release History
===============

**1.5** (2012-10-01)
====================

New Features
------------
    * Added ``plain``, ``centered``, and ``fullwidth`` css classes for positioning tables
      (see the :ref:`theme options <cloud-theme-usage>`).
    * Added new extension :mod:`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`` or ``px`` font sizes,
      all sizes now specified as % of browser default.

    * Various improvements to mobile layout, including use of "viewport" metatag.

Bugfixes
--------
    * Now compatible with jquery 1.8 (and thus sphinx 1.2)
    * Sticky sidebar code now more intelligent about various border cases.
    * Sticky sidebar now works when logo not present (:issue:`5`)
    * Sidebar toggle and headers now displayed correctly when printed (:issue:`4`)

**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 named ``docwidth``).

        - "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 named ``smallwidth``).

    * Added :mod:`~cloud_sptheme.ext.issue_tracker` extension,
      for auto-creating links to a project's issue tracker.

    * Added :mod:`~cloud_sptheme.ext.escaped_samp_literals` extension,
      which patches Sphinx to allow literal ``{`` characters in *samp* roles.

    * Added optional Google Analytics integration.

    * Added ``collapsiblesidebar`` option, as well as ``defaultcollapsed`` 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 :mod:`~cloud_sptheme.ext.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.
