From 8551188ad680da3a6028d38eeda5f0e6358880cc Mon Sep 17 00:00:00 2001 From: Jesse Tan Date: Wed, 11 Apr 2018 14:20:19 +0200 Subject: [PATCH 1/4] Make code block line emphasis span entire line (#608) --- sass/_theme_rst.sass | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/sass/_theme_rst.sass b/sass/_theme_rst.sass index 814281c0..edb6924a 100644 --- a/sass/_theme_rst.sass +++ b/sass/_theme_rst.sass @@ -79,6 +79,11 @@ font-family: $code-font-family display: block overflow: auto + & .hll + // Line emphasis spans full width + display: block + margin: 0 -1 * $base-line-height / 2 + padding: 0 $base-line-height / 2 pre.literal-block, div[class^='highlight'] pre, .linenodiv pre font-size: 12px line-height: normal From b97a7ee4454d4e7aa24fa0fa7c51210f72b0b3fe Mon Sep 17 00:00:00 2001 From: Jesse Tan Date: Thu, 12 Apr 2018 01:08:30 +0200 Subject: [PATCH 2/4] Fix centered tables (#601) * Fix centered tables Centered elements get `display: block` which does not work with tables. This commit excepts tables, so they will still use `display: table` and center properly Fixes #599. * Update changelog --- docs/changelog.rst | 11 +++++++++++ sass/_theme_rst.sass | 4 +++- 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/docs/changelog.rst b/docs/changelog.rst index 06177d0a..d3081f40 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -6,6 +6,17 @@ Changelog master ====== +New Features +------------- + +Fixes +----- + +* Fix table centering (#599) + +Other Changes +-------------- + v0.3.0 ====== diff --git a/sass/_theme_rst.sass b/sass/_theme_rst.sass index edb6924a..cce2e9fe 100644 --- a/sass/_theme_rst.sass +++ b/sass/_theme_rst.sass @@ -148,7 +148,9 @@ margin: 0px $base-line-height $base-line-height 0px .align-center margin: auto - display: block + // Do not override display:table for tables + &:not(table) + display: block .toctree-wrapper p.caption @extend h2 From bb82cd22fd84600348be221f407918656fd6aa19 Mon Sep 17 00:00:00 2001 From: Mike Edmunds Date: Wed, 11 Apr 2018 18:46:06 -0700 Subject: [PATCH 3/4] Add spacing between items in "open" lists (#591) Override wyrm's `... li p:last-child { margin-bottom: 0 }` from .wy-plain-list-disc and .wy-plain-list-decimal. Fixes #590. (And probably #354.) --- sass/_theme_rst.sass | 2 ++ 1 file changed, 2 insertions(+) diff --git a/sass/_theme_rst.sass b/sass/_theme_rst.sass index cce2e9fe..9293dc16 100644 --- a/sass/_theme_rst.sass +++ b/sass/_theme_rst.sass @@ -127,6 +127,8 @@ @extend .wy-plain-list-decimal .section ol p, .section ul p margin-bottom: $base-line-height / 2 + &:last-child + margin-bottom: $base-line-height .line-block margin-left: 0px margin-bottom: $base-line-height From 7cd846b4fdd0e971f2c409ad9a2af24070b7b111 Mon Sep 17 00:00:00 2001 From: Aaron Carlisle Date: Wed, 11 Apr 2018 22:04:32 -0400 Subject: [PATCH 4/4] Docs: correct navigation_depth discription (#609) * Docs: correct navigation_depth discription * Docs: add note about large toctrees * Docs: Cleanup: use different note markup Github does not mark the syntax correctly otherwise --- docs/configuring.rst | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/docs/configuring.rst b/docs/configuring.rst index eb382a70..67c91bce 100644 --- a/docs/configuring.rst +++ b/docs/configuring.rst @@ -26,7 +26,7 @@ file of this repository, and can be defined in your project's ``conf.py`` via 'style_external_links': False, 'vcs_pageview_mode': '', # Toc options - 'collapse_navigation': False, + 'collapse_navigation': True, 'sticky_navigation': True, 'navigation_depth': 4, 'includehidden': True, @@ -56,12 +56,19 @@ TOC Options These effect how we display the Table of Contents in the side bar. You can read more about them here: http://www.sphinx-doc.org/en/stable/templating.html#toctree * ``collapse_navigation`` Bool. With this enabled, you will lose the ``[+]`` drop downs next to each section in the sidebar. - This is useful for *very large* documents. * ``sticky_navigation`` Bool. This causes the sidebar to scroll with the main page content as you scroll the page. -* ``navigation_depth`` Int. Indicate the max depth of the tree; by default, all levels are included. +* ``navigation_depth`` Int. Indicate the max depth of the tree; by default, 4 levels are included; + set it to -1 to allow unlimited depth. * ``includehidden`` Bool. Specifies if the sidebar includes toctrees marked with the ``:hidden:`` option * ``titles_only`` Bool. If True, removes headers within a page from the sidebar. +.. note:: + + Setting ``collapse_navigation`` to False and using a high ``navigation_depth`` + can cause projects with many files and a deep file structure to generate HTML files + that are significantly larger in file size and much longer compilation times. + + HTML Context Options --------------------