From 7f34a6b7e4b7f2758ca4cb45c2d3f91589f4b2be Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Tue, 22 Sep 2026 15:47:25 +0200 Subject: [PATCH 1/3] Use the magic of globbing to include all files in a subdirectory in navigation. See https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-option-toctree-glob Also correct heading level of Next steps --- docs/mastering-plone/index.md | 3 ++- docs/mastering-plone/voting-story/index.md | 6 ++---- 2 files changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/mastering-plone/index.md b/docs/mastering-plone/index.md index b733cf8db..db0ef318e 100644 --- a/docs/mastering-plone/index.md +++ b/docs/mastering-plone/index.md @@ -35,6 +35,7 @@ For Plone Blicca see training {doc}`training2024:theming/index`, training {doc}` :name: toc-mastering :maxdepth: 3 :numbered: 2 +:glob: about_mastering intro @@ -66,7 +67,7 @@ volto_components_sponsors custom_block user_generated_content relations -voting-story/index +voting-story/* deployment_code appendix ``` diff --git a/docs/mastering-plone/voting-story/index.md b/docs/mastering-plone/voting-story/index.md index d92575ff2..63861e9ef 100644 --- a/docs/mastering-plone/voting-story/index.md +++ b/docs/mastering-plone/voting-story/index.md @@ -182,16 +182,14 @@ Then run `make frontend-install`. In this case you do not need a new entry in {file}`pnpm-workspace.yaml`, because mrs-developer clones the add-on repository in {file}`mastering-plone-project/frontend/packages`. ```` -# Next steps +## Next steps You are now ready to implement your voting behavior in the new add-on repository. The **voting story** continues in the next chapters: ```{toctree} ---- -maxdepth: 1 ---- +:maxdepth: 1 behaviors_2 endpoints From feb71f25ff06e6e0f63f8c79a767a9a0170ab65f Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Tue, 22 Sep 2026 16:54:39 +0200 Subject: [PATCH 2/3] Restore ugly af hack for numbering and suppress warnings --- docs/conf.py | 3 +++ docs/mastering-plone/index.md | 2 +- docs/mastering-plone/voting-story/index.md | 19 +++++++++++++++++-- 3 files changed, 21 insertions(+), 3 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index afadee156..f7906714f 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -109,6 +109,9 @@ exclude_patterns = [ ] +suppress_warnings = [ + "toc.secnum", # Suppress warnings about nested toctree numbering +] # -- Options for HTML output ------------------------------------------------- diff --git a/docs/mastering-plone/index.md b/docs/mastering-plone/index.md index db0ef318e..29ba686a9 100644 --- a/docs/mastering-plone/index.md +++ b/docs/mastering-plone/index.md @@ -67,7 +67,7 @@ volto_components_sponsors custom_block user_generated_content relations -voting-story/* +voting-story/index deployment_code appendix ``` diff --git a/docs/mastering-plone/voting-story/index.md b/docs/mastering-plone/voting-story/index.md index 63861e9ef..2a4b8c683 100644 --- a/docs/mastering-plone/voting-story/index.md +++ b/docs/mastering-plone/voting-story/index.md @@ -24,6 +24,19 @@ This chapter is a multi-part case study in which you will create an add-on to al - Add-on creation with {term}`Cookieplone` ```` +```{toctree} +--- +name: toc-voting-story +maxdepth: 1 +hidden: +--- + +behaviors_2 +endpoints +volto_actions +permissions +``` + ## The add-on concept Program committee members shall vote for talks to be accepted or rejected. @@ -182,14 +195,16 @@ Then run `make frontend-install`. In this case you do not need a new entry in {file}`pnpm-workspace.yaml`, because mrs-developer clones the add-on repository in {file}`mastering-plone-project/frontend/packages`. ```` -## Next steps +# Next steps You are now ready to implement your voting behavior in the new add-on repository. The **voting story** continues in the next chapters: ```{toctree} -:maxdepth: 1 +--- +maxdepth: 1 +--- behaviors_2 endpoints From 9ec0fee0e415bd727e33d7ef31e9273ba036dbef Mon Sep 17 00:00:00 2001 From: Steve Piercy Date: Tue, 22 Sep 2026 21:47:03 +0200 Subject: [PATCH 3/3] Update docs/mastering-plone/index.md Co-authored-by: David Glick --- docs/mastering-plone/index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/mastering-plone/index.md b/docs/mastering-plone/index.md index 29ba686a9..b733cf8db 100644 --- a/docs/mastering-plone/index.md +++ b/docs/mastering-plone/index.md @@ -35,7 +35,6 @@ For Plone Blicca see training {doc}`training2024:theming/index`, training {doc}` :name: toc-mastering :maxdepth: 3 :numbered: 2 -:glob: about_mastering intro