Archive Mastering Plone 5

- Support SPHINXOPTS to allow suppression of warnings via command line. For example: `make SPHINXOPTS="-D suppress_warnings='misc.highlighting_failure'" clean html`
plone · Nov 30, 2024 · 2a0001e · 2a0001e
1 parent b1a50eb
commit 2a0001e
Show file tree

Hide file tree

Showing 87 changed files with 10 additions and 14,998 deletions.
diff --git a/Makefile b/Makefile
@@ -1,13 +1,16 @@
 # Makefile for Sphinx documentation
-#
+.DEFAULT_GOAL   = help
+SHELL           = bash
 
 # You can set these variables from the command line.
-SPHINXOPTS    = 
+SPHINXOPTS      ?=
+VALEOPTS        ?=
+
 SPHINXBUILD     = "$(realpath venv/bin/sphinx-build)"
 SPHINXAUTOBUILD = "$(realpath venv/bin/sphinx-autobuild)"
-PAPER         =
-DOCS_DIR      = ./docs/
-BUILDDIR      = ../_build
+PAPER           =
+DOCS_DIR        = ./docs/
+BUILDDIR        = ../_build
 
 # Internal variables.
 PAPEROPT_a4     = -D latex_paper_size=a4
@@ -16,7 +19,6 @@ ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 # the i18n builder cannot share the environment and doctrees with the others
 I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 VALEFILES       := $(shell find $(DOCS_DIR) -type f -name "*.md" -print)
-VALEOPTS        ?=
 
 # Add the following 'help' target to your Makefile
 # And add help text after each target name starting with '\#\#'
@@ -48,7 +50,7 @@ html: venv/bin/python  ## Build html
 
 .PHONY: livehtml
 livehtml: venv/bin/python  ## Rebuild Sphinx documentation on changes, with live-reload in the browser
-	cd "$(DOCS_DIR)" && $(SPHINXAUTOBUILD) \
+	cd "$(DOCS_DIR)" && ${SPHINXAUTOBUILD} \
 		--ignore "*.swp" \
 		-b html . "$(BUILDDIR)/html" $(SPHINXOPTS) $(O)
 

diff --git a/docs/index.md b/docs/index.md
@@ -17,7 +17,6 @@ A collection of trainings developed and created by the Plone community.
 :hidden: true
 
 mastering-plone/index
-mastering-plone-5/index
 volto-customization/index
 customizing-volto-light-theme/index
 voltohandson/index
@@ -47,11 +46,6 @@ teaching/index
 
 :   Best practices of Plone development for both the backend and frontend.
 
-{ref}`mastering-plone5-label`
-
-:   Mastering Plone 5 development training is the predecessor of the Plone 6 version.
-    It includes also Plone Classic UI topics including viewlets, views, portlets, and other customizations.
-
 {doc}`testing/index`
 
 :   Best practices for testing Plone add-ons.

diff --git a/docs/mastering-plone-5/_static/add_ons_debug_toolbar.png b/docs/mastering-plone-5/_static/add_ons_debug_toolbar.png
diff --git a/docs/mastering-plone-5/_static/add_ons_easyform_1.png b/docs/mastering-plone-5/_static/add_ons_easyform_1.png
diff --git a/docs/mastering-plone-5/_static/add_ons_easyform_2.png b/docs/mastering-plone-5/_static/add_ons_easyform_2.png
diff --git a/docs/mastering-plone-5/_static/configuring_customizing_logo.png b/docs/mastering-plone-5/_static/configuring_customizing_logo.png
diff --git a/docs/mastering-plone-5/_static/dexterity_3_sponsor_schema.png b/docs/mastering-plone-5/_static/dexterity_3_sponsor_schema.png
diff --git a/docs/mastering-plone-5/_static/dexterity_reference_choice_and_list_fields.png b/docs/mastering-plone-5/_static/dexterity_reference_choice_and_list_fields.png
diff --git a/docs/mastering-plone-5/_static/dexterity_reference_datagridfield_edit.png b/docs/mastering-plone-5/_static/dexterity_reference_datagridfield_edit.png
diff --git a/docs/mastering-plone-5/_static/dexterity_reference_datagridfield_view.png b/docs/mastering-plone-5/_static/dexterity_reference_datagridfield_view.png
diff --git a/docs/mastering-plone-5/_static/dexterity_reference_datetime_fields.png b/docs/mastering-plone-5/_static/dexterity_reference_datetime_fields.png
diff --git a/docs/mastering-plone-5/_static/dexterity_reference_default_fields.png b/docs/mastering-plone-5/_static/dexterity_reference_default_fields.png
diff --git a/docs/mastering-plone-5/_static/dexterity_reference_file_fields.png b/docs/mastering-plone-5/_static/dexterity_reference_file_fields.png
diff --git a/docs/mastering-plone-5/_static/dexterity_reference_number_fields.png b/docs/mastering-plone-5/_static/dexterity_reference_number_fields.png
diff --git a/docs/mastering-plone-5/_static/dexterity_reference_other_fields.png b/docs/mastering-plone-5/_static/dexterity_reference_other_fields.png
diff --git a/docs/mastering-plone-5/_static/dexterity_reference_relation_fields.png b/docs/mastering-plone-5/_static/dexterity_reference_relation_fields.png
diff --git a/docs/mastering-plone-5/_static/features_add_rule_1.png b/docs/mastering-plone-5/_static/features_add_rule_1.png
diff --git a/docs/mastering-plone-5/_static/features_add_rule_2.png b/docs/mastering-plone-5/_static/features_add_rule_2.png
diff --git a/docs/mastering-plone-5/_static/features_add_rule_3.png b/docs/mastering-plone-5/_static/features_add_rule_3.png
diff --git a/docs/mastering-plone-5/_static/features_add_rule_4.png b/docs/mastering-plone-5/_static/features_add_rule_4.png
diff --git a/docs/mastering-plone-5/_static/features_add_user_form.png b/docs/mastering-plone-5/_static/features_add_user_form.png
diff --git a/docs/mastering-plone-5/_static/features_control_panel.png b/docs/mastering-plone-5/_static/features_control_panel.png
diff --git a/docs/mastering-plone-5/_static/features_create_site_form.png b/docs/mastering-plone-5/_static/features_create_site_form.png
diff --git a/docs/mastering-plone-5/_static/features_new_navigation.png b/docs/mastering-plone-5/_static/features_new_navigation.png
diff --git a/docs/mastering-plone-5/_static/features_pending_collection.png b/docs/mastering-plone-5/_static/features_pending_collection.png
diff --git a/docs/mastering-plone-5/_static/features_plone_running.png b/docs/mastering-plone-5/_static/features_plone_running.png
diff --git a/docs/mastering-plone-5/_static/features_the_event_folder_content.png b/docs/mastering-plone-5/_static/features_the_event_folder_content.png
diff --git a/docs/mastering-plone-5/_static/instructions_plone_running.png b/docs/mastering-plone-5/_static/instructions_plone_running.png
diff --git a/docs/mastering-plone-5/_static/relations_with_selectwidget.png b/docs/mastering-plone-5/_static/relations_with_selectwidget.png
diff --git a/docs/mastering-plone-5/about_mastering.md b/docs/mastering-plone-5/about_mastering.md