Merge branch 'main' into deployment-updates

# Conflicts: # docs/mastering-plone-5/buildout_1.md # docs/mastering-plone-5/deployment_sites.md # docs/mastering-plone-5/installation.md # docs/mastering-plone-5/restapi.md
plone · Dec 1, 2024 · bda8c38 · bda8c38
2 parents 017cc82 + 402ca67
commit bda8c38
Show file tree

Hide file tree

Showing 89 changed files with 16 additions and 15,000 deletions.
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -0,0 +1,5 @@
+{
+  "[markdown]": {
+    "editor.formatOnSave": false
+  }
+}
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/customizing-volto-light-theme/installing-vlt.md b/docs/customizing-volto-light-theme/installing-vlt.md
@@ -7,7 +7,6 @@ myst:
     "keywords": "Plone, Volto, Training, Volto Light Theme"
 ---
 
-
 # Installing Volto Light Theme
 
 Follow the steps below to install and configure VLT in your project. VLT provides a clean and modern design with ready-to-use blocks and components.
@@ -21,7 +20,7 @@ For now we'll be using an `alpha` release, so we need to specify the correct ver
 ```
 
 ```shell
-pnpm install @kitconcept/[email protected].1
+pnpm install @kitconcept/[email protected].2
 ```
 
 While in your project package folder, add VLT to the `addons` list in your {file}`package.json`, as follows:

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