#497: Introduce separate background color for the sidebar collapse button, making it easier to see.

CHANGES

@@ -15,6 +15,9 @@ Release 1.0.3 (in development)
 
 * #510: Fix inheritance diagrams for classes that are not picklable.
 
+* #497: Introduce separate background color for the sidebar collapse
+  button, making it easier to see.
+
 * #502, #503, #496: Fix small layout bugs in several builtin themes.
 
 

doc/theming.rst

@@ -119,6 +119,8 @@ These themes are:
   - **footerbgcolor** (CSS color): Background color for the footer line.
   - **footertextcolor** (CSS color): Text color for the footer line.
   - **sidebarbgcolor** (CSS color): Background color for the sidebar.
+  - **sidebarbtncolor** (CSS color): Background color for the sidebar collapse
+    button (used when *collapsiblesidebar* is true).
   - **sidebartextcolor** (CSS color): Text color for the sidebar.
   - **sidebarlinkcolor** (CSS color): Link color for the sidebar.
   - **relbarbgcolor** (CSS color): Background color for the relation bar.

sphinx/themes/default/static/default.css_t

@@ -147,6 +147,12 @@ div.sphinxsidebar input {
     font-size: 1em;
 }
 
+{% if theme_collapsiblesidebar|tobool %}
+/* for collapsible sidebar */
+div#sidebarbutton {
+    background-color: {{ theme_sidebarbtncolor }};
+}
+{% endif %}
 
 /* -- hyperlink styles ------------------------------------------------------ */
 

sphinx/themes/default/static/sidebar.js

@@ -91,6 +91,7 @@ $(function() {
         '<div id="sidebarbutton"><span>&laquo;</span></div>'
     );
     var sidebarbutton = $('#sidebarbutton');
+    light_color = sidebarbutton.css('background-color');
     // find the height of the viewport to center the '<<' in the page
     var viewport_height;
     if (window.innerHeight)
@@ -144,4 +145,4 @@ $(function() {
   add_sidebar_button();
   var sidebarbutton = $('#sidebarbutton');
   set_position_from_cookie();
-});
+});

sphinx/themes/default/theme.conf

@@ -12,6 +12,7 @@ externalrefs = false
 footerbgcolor    = #11303d
 footertextcolor  = #ffffff
 sidebarbgcolor   = #1c4e63
+sidebarbtncolor  = #3c6e83
 sidebartextcolor = #ffffff
 sidebarlinkcolor = #98dbcc
 relbarbgcolor    = #133f52