Hello community, here is the log from the commit of package python3-alabaster for openSUSE:Factory checked in at 2016-07-20 09:16:29 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Comparing /work/SRC/openSUSE:Factory/python3-alabaster (Old) and /work/SRC/openSUSE:Factory/.python3-alabaster.new (New) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "python3-alabaster" Changes: -------- --- /work/SRC/openSUSE:Factory/python3-alabaster/python3-alabaster.changes 2016-05-17 17:09:20.000000000 +0200 +++ /work/SRC/openSUSE:Factory/.python3-alabaster.new/python3-alabaster.changes 2016-07-20 09:16:31.000000000 +0200 @@ -1,0 +2,35 @@ +Tue Jul 12 15:28:29 UTC 2016 - [email protected] + +- update to version 0.7.8: + * #51 (via #67): Hide Github button if github_user and github_repo + aren't set. This is necessary since github_button defaults to + True. Thanks to Sam Whited for the report & Dmitry Shachnev for + the patch. + * #75: Use SVG version of the Travis-CI button. Thanks to Sebastian + Wiesner for the patch. + * #41: Update the Github buttons to use a newer linked image & + change the link to their docs. Thanks to Tomi Hukkalainen. + * #45 (via #46) Tweak styling of nested bullet lists to prevent an + issue where they all collapse to the same indent level when + viewed on smaller display sizes. Thanks to Bram Geron for catch & + patch, and to Jochen Kupperschmidt for review/discussion. + * #44 (partial; via #57) Add an opt-in fixed sidebar behavior for + users who prefer a sidebar that never scrolls out of + view. Credit: Joe Cross. + * #61: Set a small-but-nonzero footnote width to work around a + common browser display bug. Thanks to Konstantin Molchanov for + catch & patch. + * #64: Add config options for font size and caption font + size/family. Credit: Marçal Solà. + * #78: Add custom stylesheet support. (This release will thus be the + last to merge simplistic style tweaks as feature toggles - only + thorny CSS issues or actual template-related changes will be + merged afterwards.) + * #65: Wrap the sidebar's "Navigation" header in Sphinx's + translation helper so it gets translated if possible. Thanks to + @uralbash. + * #77: Fix image link styling to remove a bottom border which + appears in some situations. Thanks to Eric Holscher for the patch + & @barbara-sfx for the report. + +------------------------------------------------------------------- @@ -6 +40,0 @@ - Old: ---- alabaster-0.7.7.tar.gz New: ---- alabaster-0.7.8.tar.gz ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Other differences: ------------------ ++++++ python3-alabaster.spec ++++++ --- /var/tmp/diff_new_pack.QJwgNI/_old 2016-07-20 09:16:32.000000000 +0200 +++ /var/tmp/diff_new_pack.QJwgNI/_new 2016-07-20 09:16:32.000000000 +0200 @@ -17,7 +17,7 @@ Name: python3-alabaster -Version: 0.7.7 +Version: 0.7.8 Release: 0 Summary: Modified Kr Sphinx doc theme License: BSD-3-Clause ++++++ alabaster-0.7.7.tar.gz -> alabaster-0.7.8.tar.gz ++++++ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/alabaster-0.7.7/LICENSE new/alabaster-0.7.8/LICENSE --- old/alabaster-0.7.7/LICENSE 2015-01-26 22:53:29.000000000 +0100 +++ new/alabaster-0.7.8/LICENSE 2016-05-06 00:56:17.000000000 +0200 @@ -1,4 +1,4 @@ -Copyright (c) 2015 Jeff Forcier. +Copyright (c) 2016 Jeff Forcier. Based on original work copyright (c) 2011 Kenneth Reitz and copyright (c) 2010 Armin Ronacher. diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/alabaster-0.7.7/PKG-INFO new/alabaster-0.7.8/PKG-INFO --- old/alabaster-0.7.7/PKG-INFO 2015-12-22 03:25:46.000000000 +0100 +++ new/alabaster-0.7.8/PKG-INFO 2016-05-06 01:17:32.000000000 +0200 @@ -1,6 +1,6 @@ Metadata-Version: 1.0 Name: alabaster -Version: 0.7.7 +Version: 0.7.8 Summary: A configurable sidebar-enabled Sphinx theme Home-page: https://github.com/bitprophet/alabaster Author: Jeff Forcier @@ -13,8 +13,8 @@ What is Alabaster? ================== - Alabaster is a visually (c)lean, responsive, configurable theme for the `Sphinx - <http://sphinx-doc.org>`_ documentation system. It is Python 2+3 compatible. + Alabaster is a visually (c)lean, responsive, configurable theme for the + `Sphinx`_ documentation system. It is Python 2+3 compatible. It began as a third-party theme, and is still maintained separately, but as of Sphinx 1.3, Alabaster is an install-time dependency of Sphinx and is selected @@ -30,14 +30,12 @@ Features ======== - Specifically, as compared to Kenneth's theme: - * Easy ability to install/use as a Python package (tip o' the hat to `Dave & Eric's sphinx_rtd_theme <https://github.com/snide/sphinx_rtd_theme>`_ for showing the way); - * Style tweaks, such as better code-block alignment, Github button placement, - page source link moved to footer, improved (optional) related-items sidebar - item, etc; + * Style tweaks compared to the source themes, such as better code-block + alignment, Github button placement, page source link moved to footer, + improved (optional) related-items sidebar item, and many more; * Many customization hooks, including toggle of various sidebar & footer components; header/link/etc color control; etc; * Improved documentation for all customizations (pre-existing & new). @@ -113,6 +111,25 @@ html_static_path = ['_static'] + Custom stylesheet + ================= + + If you need to modify Alabaster's default CSS styles in a way not covered by + the theme options from the next section, you may provide a custom CSS + stylesheet as follows: + + * Create a file named ``custom.css`` anywhere you prefer (typically + ``_static/``, but this is solely convention) containing your desired + overrides to the CSS found in Alabaster's ``static/alabaster_css_t``. + * Set the core Sphinx option `html_static_path + <http://www.sphinx-doc.org/en/stable/config.html#confval-html_static_path>`_ + to either that file's path, or the directory it lives within. + + .. note:: + As of Alabaster 0.7.8, we will stop accepting feature requests which are + more appropriately solved by using this functionality instead. + + Theme options ============= @@ -155,8 +172,8 @@ * If ``true``, requires that you set ``github_user`` and ``github_repo``. * See also these other related options, which behave as described in - `Github Buttons' README - <https://github.com/mdo/github-buttons#usage>`_: + `Github Buttons' documentation + <https://ghbtns.com>`_: * ``github_type``: Defaults to ``watch``. * ``github_count``: Defaults to ``true``. @@ -209,6 +226,10 @@ Defaults to ``940px``. * ``sidebar_width``: CSS width specifier controlling default sidebar width. Defaults to ``220px``. + * ``fixed_sidebar``: Makes the sidebar 'fixed' or pinned in place, so that the + main body of the page scrolls but the sidebar remains visible. (Applies only + to desktop window sizes; the mobile view is unaffected.) Defaults to + ``false``. Style colors ------------ @@ -265,23 +286,25 @@ * ``font_family``: Font family of body text. Defaults to ``'goudy old style', 'minion pro', 'bell mt', Georgia, 'Hiragino Mincho Pro', serif``. + * ``font_size``: Font size of body text. Defaults to ``17px`` (``1.0625em``). * ``head_font_family``: Font family of headings. Defaults to ``'Garamond', 'Georgia', serif``. * ``code_font_size``: Font size of code block text. Defaults to ``0.9em``. * ``code_font_family``: Font family of code block text. Defaults to ``'Consolas', 'Menlo', 'Deja Vu Sans Mono', 'Bitstream Vera Sans Mono', monospace``. - + * ``caption_font_size``: Font size of caption block text. Defaults to ``font-size``. + * ``caption_font_family``: Font family of caption block text. Defaults to ``font-family``. Project background ================== Alabaster is a modified (with permission) version of `Kenneth Reitz's - <http://kennethreitz.org>`_ "Kr" `Sphinx <http://sphinx-doc.org/>`_ theme (no - official repo, but it's the one used in his `Requests - <http://python-requests.org>`_ project). Kenneth's theme was itself originally - based on Armin Ronacher's `Flask <http://flask.pocoo.org/>`_ theme. Many thanks - to both for their hard work. + <http://kennethreitz.org>`_ `"krTheme" Sphinx theme + <https://github.com/kennethreitz/kr-sphinx-themes>`_ (it's the one used + in his `Requests <http://python-requests.org>`_ project). Kenneth's + theme was itself originally based on Armin Ronacher's `Flask + <http://flask.pocoo.org/>`_ theme. Many thanks to both for their hard work. Implementation notes @@ -471,8 +494,38 @@ Marvin Pinto for catch & patch. * Add `Codecov`_ badge support to sidebar. + 0.7.8 (2016-05-05) + ------------------ + + * #51 (via #67): Hide Github button if ``github_user`` and ``github_repo`` + aren't set. This is necessary since ``github_button`` defaults to True. + Thanks to Sam Whited for the report & Dmitry Shachnev for the patch. + * #75: Use SVG version of the Travis-CI button. Thanks to Sebastian Wiesner for + the patch. + * #41: Update the Github buttons to use a newer linked image & change the link + to their docs. Thanks to Tomi Hukkalainen. + * #45 (via #46) Tweak styling of nested bullet lists to prevent an issue where + they all collapse to the same indent level when viewed on smaller display + sizes. Thanks to Bram Geron for catch & patch, and to Jochen Kupperschmidt + for review/discussion. + * #44 (partial; via #57) Add an opt-in fixed sidebar behavior for users who + prefer a sidebar that never scrolls out of view. Credit: Joe Cross. + * #61: Set a small-but-nonzero footnote width to work around a common browser + display bug. Thanks to Konstantin Molchanov for catch & patch. + * #64: Add config options for font size and caption font size/family. Credit: + Marçal Solà. + * #78: Add custom stylesheet support. (This release will thus be the last to + merge simplistic style tweaks as feature toggles - only thorny CSS issues or + actual template-related changes will be merged afterwards.) + * #65: Wrap the sidebar's "Navigation" header in Sphinx's translation helper so + it gets translated if possible. Thanks to ``@uralbash``. + * #77: Fix image link styling to remove a bottom border which appears in some + situations. Thanks to Eric Holscher for the patch & ``@barbara-sfx`` for the + report. + .. _Codecov: https://codecov.io + .. _Sphinx: http://sphinx-doc.org Platform: UNKNOWN Classifier: Intended Audience :: Developers diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/alabaster-0.7.7/README.rst new/alabaster-0.7.8/README.rst --- old/alabaster-0.7.7/README.rst 2015-12-22 03:22:20.000000000 +0100 +++ new/alabaster-0.7.8/README.rst 2016-05-06 01:00:10.000000000 +0200 @@ -5,8 +5,8 @@ What is Alabaster? ================== -Alabaster is a visually (c)lean, responsive, configurable theme for the `Sphinx -<http://sphinx-doc.org>`_ documentation system. It is Python 2+3 compatible. +Alabaster is a visually (c)lean, responsive, configurable theme for the +`Sphinx`_ documentation system. It is Python 2+3 compatible. It began as a third-party theme, and is still maintained separately, but as of Sphinx 1.3, Alabaster is an install-time dependency of Sphinx and is selected @@ -22,14 +22,12 @@ Features ======== -Specifically, as compared to Kenneth's theme: - * Easy ability to install/use as a Python package (tip o' the hat to `Dave & Eric's sphinx_rtd_theme <https://github.com/snide/sphinx_rtd_theme>`_ for showing the way); -* Style tweaks, such as better code-block alignment, Github button placement, - page source link moved to footer, improved (optional) related-items sidebar - item, etc; +* Style tweaks compared to the source themes, such as better code-block + alignment, Github button placement, page source link moved to footer, + improved (optional) related-items sidebar item, and many more; * Many customization hooks, including toggle of various sidebar & footer components; header/link/etc color control; etc; * Improved documentation for all customizations (pre-existing & new). @@ -105,6 +103,25 @@ html_static_path = ['_static'] +Custom stylesheet +================= + +If you need to modify Alabaster's default CSS styles in a way not covered by +the theme options from the next section, you may provide a custom CSS +stylesheet as follows: + +* Create a file named ``custom.css`` anywhere you prefer (typically + ``_static/``, but this is solely convention) containing your desired + overrides to the CSS found in Alabaster's ``static/alabaster_css_t``. +* Set the core Sphinx option `html_static_path + <http://www.sphinx-doc.org/en/stable/config.html#confval-html_static_path>`_ + to either that file's path, or the directory it lives within. + +.. note:: + As of Alabaster 0.7.8, we will stop accepting feature requests which are + more appropriately solved by using this functionality instead. + + Theme options ============= @@ -147,8 +164,8 @@ * If ``true``, requires that you set ``github_user`` and ``github_repo``. * See also these other related options, which behave as described in - `Github Buttons' README - <https://github.com/mdo/github-buttons#usage>`_: + `Github Buttons' documentation + <https://ghbtns.com>`_: * ``github_type``: Defaults to ``watch``. * ``github_count``: Defaults to ``true``. @@ -201,6 +218,10 @@ Defaults to ``940px``. * ``sidebar_width``: CSS width specifier controlling default sidebar width. Defaults to ``220px``. +* ``fixed_sidebar``: Makes the sidebar 'fixed' or pinned in place, so that the + main body of the page scrolls but the sidebar remains visible. (Applies only + to desktop window sizes; the mobile view is unaffected.) Defaults to + ``false``. Style colors ------------ @@ -257,23 +278,25 @@ * ``font_family``: Font family of body text. Defaults to ``'goudy old style', 'minion pro', 'bell mt', Georgia, 'Hiragino Mincho Pro', serif``. +* ``font_size``: Font size of body text. Defaults to ``17px`` (``1.0625em``). * ``head_font_family``: Font family of headings. Defaults to ``'Garamond', 'Georgia', serif``. * ``code_font_size``: Font size of code block text. Defaults to ``0.9em``. * ``code_font_family``: Font family of code block text. Defaults to ``'Consolas', 'Menlo', 'Deja Vu Sans Mono', 'Bitstream Vera Sans Mono', monospace``. - +* ``caption_font_size``: Font size of caption block text. Defaults to ``font-size``. +* ``caption_font_family``: Font family of caption block text. Defaults to ``font-family``. Project background ================== Alabaster is a modified (with permission) version of `Kenneth Reitz's -<http://kennethreitz.org>`_ "Kr" `Sphinx <http://sphinx-doc.org/>`_ theme (no -official repo, but it's the one used in his `Requests -<http://python-requests.org>`_ project). Kenneth's theme was itself originally -based on Armin Ronacher's `Flask <http://flask.pocoo.org/>`_ theme. Many thanks -to both for their hard work. +<http://kennethreitz.org>`_ `"krTheme" Sphinx theme +<https://github.com/kennethreitz/kr-sphinx-themes>`_ (it's the one used +in his `Requests <http://python-requests.org>`_ project). Kenneth's +theme was itself originally based on Armin Ronacher's `Flask +<http://flask.pocoo.org/>`_ theme. Many thanks to both for their hard work. Implementation notes @@ -463,5 +486,35 @@ Marvin Pinto for catch & patch. * Add `Codecov`_ badge support to sidebar. +0.7.8 (2016-05-05) +------------------ + +* #51 (via #67): Hide Github button if ``github_user`` and ``github_repo`` + aren't set. This is necessary since ``github_button`` defaults to True. + Thanks to Sam Whited for the report & Dmitry Shachnev for the patch. +* #75: Use SVG version of the Travis-CI button. Thanks to Sebastian Wiesner for + the patch. +* #41: Update the Github buttons to use a newer linked image & change the link + to their docs. Thanks to Tomi Hukkalainen. +* #45 (via #46) Tweak styling of nested bullet lists to prevent an issue where + they all collapse to the same indent level when viewed on smaller display + sizes. Thanks to Bram Geron for catch & patch, and to Jochen Kupperschmidt + for review/discussion. +* #44 (partial; via #57) Add an opt-in fixed sidebar behavior for users who + prefer a sidebar that never scrolls out of view. Credit: Joe Cross. +* #61: Set a small-but-nonzero footnote width to work around a common browser + display bug. Thanks to Konstantin Molchanov for catch & patch. +* #64: Add config options for font size and caption font size/family. Credit: + Marçal Solà. +* #78: Add custom stylesheet support. (This release will thus be the last to + merge simplistic style tweaks as feature toggles - only thorny CSS issues or + actual template-related changes will be merged afterwards.) +* #65: Wrap the sidebar's "Navigation" header in Sphinx's translation helper so + it gets translated if possible. Thanks to ``@uralbash``. +* #77: Fix image link styling to remove a bottom border which appears in some + situations. Thanks to Eric Holscher for the patch & ``@barbara-sfx`` for the + report. + .. _Codecov: https://codecov.io +.. _Sphinx: http://sphinx-doc.org diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/alabaster-0.7.7/alabaster/_version.py new/alabaster-0.7.8/alabaster/_version.py --- old/alabaster-0.7.7/alabaster/_version.py 2015-12-22 03:24:48.000000000 +0100 +++ new/alabaster-0.7.8/alabaster/_version.py 2016-05-06 01:00:18.000000000 +0200 @@ -1,2 +1,2 @@ -__version_info__ = (0, 7, 7) +__version_info__ = (0, 7, 8) __version__ = '.'.join(map(str, __version_info__)) diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/alabaster-0.7.7/alabaster/about.html new/alabaster-0.7.8/alabaster/about.html --- old/alabaster-0.7.7/alabaster/about.html 2015-12-22 03:20:55.000000000 +0100 +++ new/alabaster-0.7.8/alabaster/about.html 2016-05-06 00:56:17.000000000 +0200 @@ -15,12 +15,14 @@ <p class="blurb">{{ theme_description }}</p> {% endif %} +{% if theme_github_user and theme_github_repo %} {% if theme_github_button|lower == 'true' %} <p> -<iframe src="https://ghbtns.com/github-btn.html?user={{ theme_github_user }}&repo={{ theme_github_repo }}&type={{ theme_github_type }}&count={{ theme_github_count }}&size=large" +<iframe src="https://ghbtns.com/github-btn.html?user={{ theme_github_user }}&repo={{ theme_github_repo }}&type={{ theme_github_type }}&count={{ theme_github_count }}&size=large&v=2" allowtransparency="true" frameborder="0" scrolling="0" width="200px" height="35px"></iframe> </p> {% endif %} +{% endif %} {% if theme_travis_button|lower != 'false' %} {% if theme_travis_button|lower == 'true' %} @@ -31,8 +33,8 @@ <p> <a href="https://travis-ci.org/{{ path }}"> <img - alt="https://secure.travis-ci.org/{{ path }}.png?branch=master" - src="https://secure.travis-ci.org/{{ path }}.png?branch=master" + alt="https://secure.travis-ci.org/{{ path }}.svg?branch=master" + src="https://secure.travis-ci.org/{{ path }}.svg?branch=master" /> </a> </p> diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/alabaster-0.7.7/alabaster/layout.html new/alabaster-0.7.8/alabaster/layout.html --- old/alabaster-0.7.7/alabaster/layout.html 2015-12-07 20:57:05.000000000 +0100 +++ new/alabaster-0.7.8/alabaster/layout.html 2016-05-06 00:56:17.000000000 +0200 @@ -2,6 +2,7 @@ {%- block extrahead %} {{ super() }} + <link rel="stylesheet" href="{{ pathto('_static/custom.css', 1) }}" type="text/css" /> {% if theme_touch_icon %} <link rel="apple-touch-icon" href="{{ pathto('_static/' ~ theme_touch_icon, 1) }}" /> {% endif %} @@ -12,6 +13,31 @@ {%- block relbar1 %}{% endblock %} {%- block relbar2 %}{% endblock %} +{# Nav should appear before content, not after #} +{%- block content %} +{%- if theme_fixed_sidebar|lower == 'true' %} + <div class="document"> + {{ sidebar() }} + {%- block document %} + <div class="documentwrapper"> + {%- if render_sidebar %} + <div class="bodywrapper"> + {%- endif %} + <div class="body" role="main"> + {% block body %} {% endblock %} + </div> + {%- if render_sidebar %} + </div> + {%- endif %} + </div> + {%- endblock %} + <div class="clearer"></div> + </div> +{%- else %} +{{ super() }} +{%- endif %} +{%- endblock %} + {%- block footer %} <div class="footer"> {% if show_copyright %}©{{ copyright }}.{% endif %} diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/alabaster-0.7.7/alabaster/navigation.html new/alabaster-0.7.8/alabaster/navigation.html --- old/alabaster-0.7.7/alabaster/navigation.html 2015-01-26 22:11:42.000000000 +0100 +++ new/alabaster-0.7.8/alabaster/navigation.html 2016-05-06 00:56:17.000000000 +0200 @@ -1,4 +1,4 @@ -<h3>Navigation</h3> +<h3>{{ _('Navigation') }}</h3> {{ toctree(includehidden=theme_sidebar_includehidden) }} {% if theme_extra_nav_links %} <hr /> diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/alabaster-0.7.7/alabaster/static/alabaster.css_t new/alabaster-0.7.8/alabaster/static/alabaster.css_t --- old/alabaster-0.7.7/alabaster/static/alabaster.css_t 2015-12-06 20:32:13.000000000 +0100 +++ new/alabaster-0.7.8/alabaster/static/alabaster.css_t 2016-05-06 00:59:38.000000000 +0200 @@ -21,13 +21,14 @@ body { font-family: {{ theme_font_family }}; - font-size: 17px; + font-size: {{ theme_font_size }}; background-color: white; color: #000; margin: 0; padding: 0; } + div.document { width: {{ theme_page_width }}; margin: 30px auto 0 auto; @@ -44,6 +45,8 @@ div.sphinxsidebar { width: {{ theme_sidebar_width }}; + font-size: 14px; + line-height: 1.5; } hr { @@ -72,6 +75,11 @@ color: {{ theme_footer_text }}; } +p.caption { + font-family: {{ theme_cation_font_family }}; + font-size: {{ theme_caption_font_size }}; +} + {% if theme_show_related|lower == 'false' %} div.relations { display: none; @@ -88,11 +96,6 @@ border-bottom: 1px solid {{ theme_sidebar_link_underscore }}; } -div.sphinxsidebar { - font-size: 14px; - line-height: 1.5; -} - div.sphinxsidebarwrapper { padding: 18px 10px; } @@ -359,7 +362,7 @@ } table.footnote td.label { - width: 0px; + width: .1px; padding: 0.3em 0 0.3em 0.5em; } @@ -382,6 +385,7 @@ } ul, ol { + /* Matches the 30px from the narrow-screen "li > ul" selector below */ margin: 10px 0 10px 30px; padding: 0; } @@ -419,6 +423,11 @@ border-bottom: 1px dotted {{ theme_link }}; } +/* Don't put an underline on images */ +a.image-reference, a.image-reference:hover { + border-bottom: none; +} + a.reference:hover { border-bottom: 1px solid {{ theme_link_hover }}; } @@ -468,6 +477,11 @@ margin-left: 0; } + li > ul { + /* Matches the 30px from the "ul, ol" selector above */ + margin-left: 30px; + } + .document { width: auto; } @@ -510,7 +524,11 @@ display: block; float: none; width: 102.5%; + {%- if theme_fixed_sidebar|lower == 'true' %} + margin: -20px -30px 20px -30px; + {%- else %} margin: 50px -30px -20px -30px; + {%- endif %} padding: 10px 20px; background: {{ theme_narrow_sidebar_bg }}; color: {{ theme_narrow_sidebar_fg }}; @@ -568,6 +586,15 @@ } } +{%- if theme_fixed_sidebar|lower == 'true' %} +@media screen and (min-width: 876px) { + div.sphinxsidebar { + position: fixed; + margin-left: 0; + } +} +{%- endif %} + /* misc. */ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/alabaster-0.7.7/alabaster/static/custom.css new/alabaster-0.7.8/alabaster/static/custom.css --- old/alabaster-0.7.7/alabaster/static/custom.css 1970-01-01 01:00:00.000000000 +0100 +++ new/alabaster-0.7.8/alabaster/static/custom.css 2016-05-06 00:56:17.000000000 +0200 @@ -0,0 +1 @@ +/* This file intentionally left blank. */ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/alabaster-0.7.7/alabaster/theme.conf new/alabaster-0.7.8/alabaster/theme.conf --- old/alabaster-0.7.7/alabaster/theme.conf 2015-12-22 03:17:13.000000000 +0100 +++ new/alabaster-0.7.8/alabaster/theme.conf 2016-05-06 00:56:17.000000000 +0200 @@ -60,10 +60,14 @@ narrow_sidebar_bg = #333 narrow_sidebar_fg = #FFF narrow_sidebar_link = +font_size = 17px +caption_font_size = inherit code_font_size = 0.9em code_font_family = 'Consolas', 'Menlo', 'Deja Vu Sans Mono', 'Bitstream Vera Sans Mono', monospace font_family = 'goudy old style', 'minion pro', 'bell mt', Georgia, 'Hiragino Mincho Pro', serif head_font_family = 'Garamond', 'Georgia', serif +caption_font_family = inherit code_highlight = #FFC page_width = 940px sidebar_width = 220px +fixed_sidebar = false diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/alabaster-0.7.7/alabaster.egg-info/PKG-INFO new/alabaster-0.7.8/alabaster.egg-info/PKG-INFO --- old/alabaster-0.7.7/alabaster.egg-info/PKG-INFO 2015-12-22 03:25:46.000000000 +0100 +++ new/alabaster-0.7.8/alabaster.egg-info/PKG-INFO 2016-05-06 01:17:32.000000000 +0200 @@ -1,6 +1,6 @@ Metadata-Version: 1.0 Name: alabaster -Version: 0.7.7 +Version: 0.7.8 Summary: A configurable sidebar-enabled Sphinx theme Home-page: https://github.com/bitprophet/alabaster Author: Jeff Forcier @@ -13,8 +13,8 @@ What is Alabaster? ================== - Alabaster is a visually (c)lean, responsive, configurable theme for the `Sphinx - <http://sphinx-doc.org>`_ documentation system. It is Python 2+3 compatible. + Alabaster is a visually (c)lean, responsive, configurable theme for the + `Sphinx`_ documentation system. It is Python 2+3 compatible. It began as a third-party theme, and is still maintained separately, but as of Sphinx 1.3, Alabaster is an install-time dependency of Sphinx and is selected @@ -30,14 +30,12 @@ Features ======== - Specifically, as compared to Kenneth's theme: - * Easy ability to install/use as a Python package (tip o' the hat to `Dave & Eric's sphinx_rtd_theme <https://github.com/snide/sphinx_rtd_theme>`_ for showing the way); - * Style tweaks, such as better code-block alignment, Github button placement, - page source link moved to footer, improved (optional) related-items sidebar - item, etc; + * Style tweaks compared to the source themes, such as better code-block + alignment, Github button placement, page source link moved to footer, + improved (optional) related-items sidebar item, and many more; * Many customization hooks, including toggle of various sidebar & footer components; header/link/etc color control; etc; * Improved documentation for all customizations (pre-existing & new). @@ -113,6 +111,25 @@ html_static_path = ['_static'] + Custom stylesheet + ================= + + If you need to modify Alabaster's default CSS styles in a way not covered by + the theme options from the next section, you may provide a custom CSS + stylesheet as follows: + + * Create a file named ``custom.css`` anywhere you prefer (typically + ``_static/``, but this is solely convention) containing your desired + overrides to the CSS found in Alabaster's ``static/alabaster_css_t``. + * Set the core Sphinx option `html_static_path + <http://www.sphinx-doc.org/en/stable/config.html#confval-html_static_path>`_ + to either that file's path, or the directory it lives within. + + .. note:: + As of Alabaster 0.7.8, we will stop accepting feature requests which are + more appropriately solved by using this functionality instead. + + Theme options ============= @@ -155,8 +172,8 @@ * If ``true``, requires that you set ``github_user`` and ``github_repo``. * See also these other related options, which behave as described in - `Github Buttons' README - <https://github.com/mdo/github-buttons#usage>`_: + `Github Buttons' documentation + <https://ghbtns.com>`_: * ``github_type``: Defaults to ``watch``. * ``github_count``: Defaults to ``true``. @@ -209,6 +226,10 @@ Defaults to ``940px``. * ``sidebar_width``: CSS width specifier controlling default sidebar width. Defaults to ``220px``. + * ``fixed_sidebar``: Makes the sidebar 'fixed' or pinned in place, so that the + main body of the page scrolls but the sidebar remains visible. (Applies only + to desktop window sizes; the mobile view is unaffected.) Defaults to + ``false``. Style colors ------------ @@ -265,23 +286,25 @@ * ``font_family``: Font family of body text. Defaults to ``'goudy old style', 'minion pro', 'bell mt', Georgia, 'Hiragino Mincho Pro', serif``. + * ``font_size``: Font size of body text. Defaults to ``17px`` (``1.0625em``). * ``head_font_family``: Font family of headings. Defaults to ``'Garamond', 'Georgia', serif``. * ``code_font_size``: Font size of code block text. Defaults to ``0.9em``. * ``code_font_family``: Font family of code block text. Defaults to ``'Consolas', 'Menlo', 'Deja Vu Sans Mono', 'Bitstream Vera Sans Mono', monospace``. - + * ``caption_font_size``: Font size of caption block text. Defaults to ``font-size``. + * ``caption_font_family``: Font family of caption block text. Defaults to ``font-family``. Project background ================== Alabaster is a modified (with permission) version of `Kenneth Reitz's - <http://kennethreitz.org>`_ "Kr" `Sphinx <http://sphinx-doc.org/>`_ theme (no - official repo, but it's the one used in his `Requests - <http://python-requests.org>`_ project). Kenneth's theme was itself originally - based on Armin Ronacher's `Flask <http://flask.pocoo.org/>`_ theme. Many thanks - to both for their hard work. + <http://kennethreitz.org>`_ `"krTheme" Sphinx theme + <https://github.com/kennethreitz/kr-sphinx-themes>`_ (it's the one used + in his `Requests <http://python-requests.org>`_ project). Kenneth's + theme was itself originally based on Armin Ronacher's `Flask + <http://flask.pocoo.org/>`_ theme. Many thanks to both for their hard work. Implementation notes @@ -471,8 +494,38 @@ Marvin Pinto for catch & patch. * Add `Codecov`_ badge support to sidebar. + 0.7.8 (2016-05-05) + ------------------ + + * #51 (via #67): Hide Github button if ``github_user`` and ``github_repo`` + aren't set. This is necessary since ``github_button`` defaults to True. + Thanks to Sam Whited for the report & Dmitry Shachnev for the patch. + * #75: Use SVG version of the Travis-CI button. Thanks to Sebastian Wiesner for + the patch. + * #41: Update the Github buttons to use a newer linked image & change the link + to their docs. Thanks to Tomi Hukkalainen. + * #45 (via #46) Tweak styling of nested bullet lists to prevent an issue where + they all collapse to the same indent level when viewed on smaller display + sizes. Thanks to Bram Geron for catch & patch, and to Jochen Kupperschmidt + for review/discussion. + * #44 (partial; via #57) Add an opt-in fixed sidebar behavior for users who + prefer a sidebar that never scrolls out of view. Credit: Joe Cross. + * #61: Set a small-but-nonzero footnote width to work around a common browser + display bug. Thanks to Konstantin Molchanov for catch & patch. + * #64: Add config options for font size and caption font size/family. Credit: + Marçal Solà. + * #78: Add custom stylesheet support. (This release will thus be the last to + merge simplistic style tweaks as feature toggles - only thorny CSS issues or + actual template-related changes will be merged afterwards.) + * #65: Wrap the sidebar's "Navigation" header in Sphinx's translation helper so + it gets translated if possible. Thanks to ``@uralbash``. + * #77: Fix image link styling to remove a bottom border which appears in some + situations. Thanks to Eric Holscher for the patch & ``@barbara-sfx`` for the + report. + .. _Codecov: https://codecov.io + .. _Sphinx: http://sphinx-doc.org Platform: UNKNOWN Classifier: Intended Audience :: Developers diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/alabaster-0.7.7/alabaster.egg-info/SOURCES.txt new/alabaster-0.7.8/alabaster.egg-info/SOURCES.txt --- old/alabaster-0.7.7/alabaster.egg-info/SOURCES.txt 2015-12-22 03:25:46.000000000 +0100 +++ new/alabaster-0.7.8/alabaster.egg-info/SOURCES.txt 2016-05-06 01:17:32.000000000 +0200 @@ -17,4 +17,5 @@ alabaster.egg-info/dependency_links.txt alabaster.egg-info/pbr.json alabaster.egg-info/top_level.txt -alabaster/static/alabaster.css_t \ No newline at end of file +alabaster/static/alabaster.css_t +alabaster/static/custom.css \ No newline at end of file
