[Bf-docboard-svn] bf-manual: [9367] branches/blender-3.2-release/blender_docs: Epub: Add back table of contents

Aaron Carlisle noreply at blender.org
Fri Jun 17 22:22:12 CEST 2022


Revision: 9367
          https://developer.blender.org/rBM9367
Author:   Blendify
Date:     2022-06-17 22:22:11 +0200 (Fri, 17 Jun 2022)
Log Message:
-----------
Epub: Add back table of contents

Sphinx's `.. only::` markup does not affect the sidebar
table of contents this results in duplicated items if
two toctrees are defined.

To work around this use css to hide the toc in the theme css.

Fixes T98868

Modified Paths:
--------------
    branches/blender-3.2-release/blender_docs/manual/index.rst
    branches/blender-3.2-release/blender_docs/resources/theme/css/theme_overrides.css

Modified: branches/blender-3.2-release/blender_docs/manual/index.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/index.rst	2022-06-16 23:46:09 UTC (rev 9366)
+++ branches/blender-3.2-release/blender_docs/manual/index.rst	2022-06-17 20:22:11 UTC (rev 9367)
@@ -39,7 +39,18 @@
 
          :doc:`/getting_started/help`
 
+.. container:: global-index-toc
 
+   .. toctree::
+      :caption: Getting Started
+      :maxdepth: 1
+
+      getting_started/about/index.rst
+      getting_started/installing/index.rst
+      getting_started/configuration/index.rst
+      getting_started/help.rst
+
+
 Sections
 ========
 
@@ -173,7 +184,31 @@
          :ref:`Manual Index <genindex>`
             A list of terms linked to the Glossary.
 
+.. container:: global-index-toc
 
+   .. toctree::
+      :caption: Sections
+      :maxdepth: 2
+
+      interface/index.rst
+      editors/index.rst
+      scene_layout/index.rst
+      modeling/index.rst
+      sculpt_paint/index.rst
+      grease_pencil/index.rst
+      animation/index.rst
+      physics/index.rst
+      render/index.rst
+      compositing/index.rst
+      movie_clip/index.rst
+      video_editing/index.rst
+      files/index.rst
+      addons/index.rst
+      advanced/index.rst
+      troubleshooting/index.rst
+      glossary/index.rst
+
+
 Get Involved
 ============
 
@@ -184,39 +219,6 @@
 .. just so this is included in the toc (not user visible).
 
 .. toctree::
-   :caption: Getting Started
-   :maxdepth: 1
-   :hidden:
-
-   getting_started/about/index.rst
-   getting_started/installing/index.rst
-   getting_started/configuration/index.rst
-   getting_started/help.rst
-
-.. toctree::
-   :caption: Sections
-   :maxdepth: 2
-   :hidden:
-
-   interface/index.rst
-   editors/index.rst
-   scene_layout/index.rst
-   modeling/index.rst
-   sculpt_paint/index.rst
-   grease_pencil/index.rst
-   animation/index.rst
-   physics/index.rst
-   render/index.rst
-   compositing/index.rst
-   movie_clip/index.rst
-   video_editing/index.rst
-   files/index.rst
-   addons/index.rst
-   advanced/index.rst
-   troubleshooting/index.rst
-   glossary/index.rst
-
-.. toctree::
    :caption: Get Involved
    :maxdepth: 1
    :hidden:

Modified: branches/blender-3.2-release/blender_docs/resources/theme/css/theme_overrides.css
===================================================================
--- branches/blender-3.2-release/blender_docs/resources/theme/css/theme_overrides.css	2022-06-16 23:46:09 UTC (rev 9366)
+++ branches/blender-3.2-release/blender_docs/resources/theme/css/theme_overrides.css	2022-06-17 20:22:11 UTC (rev 9367)
@@ -218,6 +218,9 @@
 .rst-content .line-block {margin-left:0px}
 
 /* Applied on main index:sections. */
+
+.global-index-toc {display: none;}
+
 /* Start section description. */
 @media screen and (min-width: 450px){
 	.tocdescr {



More information about the Bf-docboard-svn mailing list