Tidy up the theming section

Author: stevepiercy

docs/classic-ui/theming/barceloneta.md

@@ -1,68 +1,69 @@
 ---
 myst:
   html_meta:
-    "description": ""
-    "property=og:description": ""
-    "property=og:title": ""
-    "keywords": ""
+    "description": "Plone Classic UI theming based on Barceloneta"
+    "property=og:description": "Plone Classic UI theming based on Barceloneta"
+    "property=og:title": "Plone Classic UI theming based on Barceloneta"
+    "keywords": "Plone, Classic UI, theming, Barceloneta"
 ---
 
 (classic-ui-theming-barceloneta-label)=
 
-# Plone Classic UI Theming Based on Barceloneta
+# Classic UI theming based on Barceloneta
 
 ```{todo}
 This page is only an outline and needs a lot of work.
+See https://github.com/plone/documentation/issues/1286
 ```
 
-* Use of SCSS
-* Colors, fonts and sizes via variable changeable
-* Properties for shadows, rounded corners, gradients.
-* `plonetheme.barceloneta` npm package for includes
-* `bobtemplates.plone` template
-* Theming is based on Twitter Bootstrap 5
-* We used Bootstrap markup in templates
-* We used Bootstrap components wherever possible
-* Most of the look and feel can be changed via Bootstrap's variables
-* Hint: order is important in SCSS
+-   Use of SCSS
+-   Colors, fonts, and sizes via variables is changeable
+-   Properties for shadows, rounded corners, gradients.
+-   `plonetheme.barceloneta` npm package for includes
+-   `bobtemplates.plone` template
+-   Theming is based on Twitter Bootstrap 5
+-   We use Bootstrap markup in templates
+-   We use Bootstrap components wherever possible
+-   Most of the look and feel can be changed via Bootstrap's variables
+-   Hint: order is important in SCSS
 
 
 (classic-ui-theming-barceloneta-theme-package-label)=
 
-## Theme Package
+## Theme package
 
-* Generated theme package can be uploaded as ZIP-file
+-   Generated theme package can be uploaded as a .zip file.
 
 
 (classic-ui-theming-barceloneta-theme-structure-label)=
 
-## Theme Structure
+## Theme structure
 
 ### `base.scss`
 
-* Basices required for backend
+-   Basics required for backend
 
 ### `barceloneta.scss`
 
-* Barceloneta Theme basis
+-   Barceloneta theme basics
 
 
-## npm Package
+## npm package
 
-* npm package with files required for Plone
-* dependencies required by theme to compile
+-   npm package with files required for Plone
+-   dependencies required by theme to compile
 
 
-# Bootstrap Components
+## Bootstrap components
 
-* Default components are extended with some custom components, such as a select or dropdown menu.
-* We use Boostrap variables in these cases.
+-   Default components are extended with some custom components, such as a select or dropdown menu.
+-   We use Boostrap variables in these cases.
 
 
-# Add-Ons and Templates
+## Add-ons and templates
 
 Make life easy with...
 
-* use Bootstrap markup
-* use Bootstrap components
-* use Bootstrap variables
+-   use Bootstrap markup
+-   use Bootstrap components
+-   use Bootstrap variables

docs/classic-ui/theming/diazo.md

@@ -1,14 +1,19 @@
 ---
 myst:
   html_meta:
-    "description": ""
-    "property=og:description": ""
-    "property=og:title": ""
-    "keywords": ""
+    "description": "Plone Classic UI theming with Diazo"
+    "property=og:description": "Plone Classic UI theming with Diazo"
+    "property=og:title": "Plone Classic UI theming with Diazo"
+    "keywords": "Plone, Classic UI, theming, Diazo"
 ---
 
 (classic-ui-theming-diazo-label)=
 
-# Plone Classic UI Theming with Diazo
+# Classic UI theming with Diazo
+
+```{todo}
+This page is only an outline and needs a lot of work.
+See https://github.com/plone/documentation/issues/1286
+```
 
 Theming based on Diazo.

docs/classic-ui/theming/from-scratch.md

@@ -1,43 +1,44 @@
 ---
 myst:
   html_meta:
-    "description": ""
-    "property=og:description": ""
-    "property=og:title": ""
-    "keywords": ""
+    "description": "Plone Classic UI theming from scratch"
+    "property=og:description": "Plone Classic UI theming from scratch"
+    "property=og:title": "Plone Classic UI theming from scratch"
+    "keywords": "Plone, Classic UI, theming, scratch"
 ---
 
 (classic-ui-theming-from-scratch-label)=
 
-# Plone Classic UI Theming based on Barceloneta
+# Classic UI theming from scratch
 
 ```{todo}
 This page is only an outline and needs a lot of work.
+See https://github.com/plone/documentation/issues/1286
 ```
 
 Theming based on a filesystem package without any dependency.
 
-* Theming for Plone 6 Classic UI
-* Theme stored in a filesystem package
-* Built from scratch
-* No dependencies to Barceloneta
-* No Diazo needed
+-   Theming for Plone 6 Classic UI
+-   Theme stored in a filesystem package
+-   Built from scratch
+-   No dependencies to Barceloneta
+-   No Diazo needed
 
 
-## Theme Package
+## Theme package
 
-* Create a theme package as explained here.
-* Remove what you do not need
-* Overrides
-* Static files
+-   Create a theme package as explained here.
+-   Remove what you do not need
+-   Overrides
+-   Static files
 
 
-## Static Files
+## Static files
 
 Register directory to keep static files
 
-File: src/plonetheme/munich/browser/configure.zcml
-Directory: src/plonetheme/munich/browser/static
+File: `src/plonetheme/munich/browser/configure.zcml`
+Directory: `src/plonetheme/munich/browser/static`
 
 ```xml
 <!-- Publish static files -->
@@ -52,8 +53,8 @@ Directory: src/plonetheme/munich/browser/static
 
 ### Manifest
 
-* Manifest for your theme
-* Keep rules empty to disable Diazo
+-   Manifest for your theme
+-   Keep rules empty to disable Diazo
 
 ```ini
 [theme]
@@ -65,7 +66,7 @@ prefix = /++theme++plonetheme.munich
 doctype = <!DOCTYPE html>
 ```
 
-### Bundle Registration
+### Bundle registration
 
 ```xml
 <?xml version="1.0"?>
@@ -84,7 +85,7 @@ doctype = <!DOCTYPE html>
 </registry>
 ```
 
-### Theme Registration
+### Theme registration
 
 Register your theme via theme.xml
 
@@ -98,7 +99,7 @@ Register your theme via theme.xml
 
 ### Compile the bundle
 
-* Compile SASS to SCSS
+-   Compile SASS to SCSS
 
 Install all requirements and dependencies from package.json:
 
@@ -115,22 +116,21 @@ yarn dist
 
 ### Theming
 
-* Make use of Bootstrap [variables](https://github.com/twbs/bootstrap/blob/main/scss/_variables.scss)
-* Tweak basic settings like rounded corners, shadows, etc.
-* Set custom fonts
-* Define your own stuff
-* Import Boostrap (as basis)
+-   Make use of Bootstrap [variables](https://github.com/twbs/bootstrap/blob/main/scss/_variables.scss)
+-   Tweak basic settings like rounded corners, shadows, and so on.
+-   Set custom fonts
+-   Define your own stuff
+-   Import Boostrap (as basis)
 
 
 #### Templates
 
-* Add z3c.jbot overrides
-* Copy Templates to customize
-* Add custom views for your story
+-   Add `z3c.jbot` overrides
+-   Copy templates to customize
+-   Add custom views for your story
 
 
-### Available Themes
+### Available themes
 
-* plonetheme.tokyo (mobile first, onw column)
-* plonetheme.munic (minimalistic)
-* plonetheme.berlin (based on Barceloneta)
+-   [`plonetheme.tokyo`](https://github.com/collective/plonetheme.tokyo/) (mobile first, one column)
+-   [`plonetheme.munich`](https://github.com/collective/plonetheme.munich/) (minimalistic)

docs/classic-ui/theming/index.md

@@ -4,15 +4,16 @@ myst:
     "description": "Theming of Plone 6 Classic UI"
     "property=og:description": "Theming of Plone 6 Classic UI"
     "property=og:title": "Theming of Plone 6 Classic UI"
-    "keywords": "Theming, Plone 6, Classic UI"
+    "keywords": "Theming, Plone 6, Classic UI, Barceloneta, Diazo, scratch, through-the-web"
 ---
 
 (classic-ui-theming-index-label)=
 
-# Theming of Plone 6 Classic UI 
+# Theming of Classic UI 
 
 ```{todo}
 This page is only an outline and needs a lot of work.
+See https://github.com/plone/documentation/issues/1286
 ```
 
 ```{toctree}

docs/classic-ui/theming/through-the-web.md

@@ -1,18 +1,19 @@
 ---
 myst:
   html_meta:
-    "description": ""
-    "property=og:description": ""
-    "property=og:title": ""
+    "description": "Through-the-web (TTW) theme customization in Plone 6 Classic UI"
+    "property=og:description": "Through-the-web (TTW) theme customization in Plone 6 Classic UI"
+    "property=og:title": "Through-the-web (TTW) theme customization in Plone 6 Classic UI"
     "keywords": ""
 ---
 
 (classic-ui-through-the-web-label)=
 
-# Through-the-web (TTW) Theme Customization in Plone 6 Classic UI
+# Through-the-web (TTW) theme customization
 
 ```{todo}
 This page is only an outline and needs a lot of work.
+See https://github.com/plone/documentation/issues/1286
 ```
 
 TTW customization is useful when you need to make small CSS changes.
@@ -22,7 +23,7 @@ Other theming methods should be used for larger customizations or entire website
 
 (classic-ui-through-the-web-control-panels-label)=
 
-## Control Panels
+## Control panels
 
 You can make the following changes through control panels.
 
@@ -44,7 +45,7 @@ Add screenshots.
 
 (classic-ui-through-the-web-css-variables-label)=
 
-## CSS Variables
+## CSS variables
 
 Plone uses Twitter Bootstrap's CSS variables.
 They are used to tweak colors, fonts, spacing, and other CSS attributes.
@@ -54,10 +55,9 @@ Provide usage.
 ```
 
 
-
 (classic-ui-through-the-web-theming-control-panel-label)=
 
-## Theming Control Panel
+## Theming control panel
 
 The Theming control panel is limited to downloading and uploading themes.
 
@@ -69,10 +69,10 @@ The Theming control panel is limited to downloading and uploading themes.
 
 (classic-ui-through-the-web-restricted-python-label)=
 
-### Restricted Python
+### Restricted python
 
 
 (classic-ui-through-the-web-content-types-label)=
 
-### Content Types
+### Content types