Clean up outlines of theming files

Update index for structure
Fix Sphinx warnings and errors

Author: stevepiercy

docs/classic-ui/icons.md

@@ -34,7 +34,7 @@ This provides an option to customize the contenttype and Plone UI icons by overr
 - [Plone UI](https://github.com/plone/plone.staticresources/blob/master/src/plone/staticresources/profiles/default/registry/icons_plone.xml)
 
 
-(classic-ui-icons-registration-label)=
+(classic-ui-icons-contextual-icons-label)=
 
 ## Contextual Icons
 

docs/classic-ui/index.md

@@ -3,7 +3,7 @@
 # Plone Classic UI
 
 ```{todo}
-Perhaps some of this introduction should be an include, so we don't have to repear ourselves?
+Perhaps some of this introduction should be an include, so we don't have to repeat ourselves?
 ```
 
 Plone 6 ships with two user interfaces or frontends.
@@ -40,23 +40,14 @@ This chapter is a developer reference manual for working with Classic UI.
 :maxdepth: 2
 
 static-resources
-theming
+theming/index
 templates
 views
 viewlets
 forms
 portlets
 csrf
-through-the-web
-whatsnew
-
-bodyclasses
 icons
-registry/index
-theming/barceloneta/index
-theming/diazo/index
-theming/from-scratch/index
-theming/index
-theming/theme-package/index
-theming/ttw/index
+recipes
+whatsnew
 ```

docs/classic-ui/theming.md

@@ -1,49 +1,59 @@
-# Plone Classic UI Theming based on Barceloneta
+(classic-ui-theming-barceloneta-label)=
+
+# Plone Classic UI Theming Based on Barceloneta
+
+```{todo}
+This page is only an outline and needs a lot of work.
+```
 
 * Use of SCSS
-* Colors, fonts and sizes via variable changable
-* Properties for shadows, rounded corners, gradients, etc.
-* plonetheme.barceloneta npm package for includes
-* bobtemplates.plone template
-* Theming is based on Bootstrap 5
+* 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 look and feel can be touched via Bootstrap's variables
+* Most of the look and feel can be changed via Bootstrap's variables
 * Hint: order is important in SCSS
 
 
-# Theme Package
+(classic-ui-theming-barceloneta-theme-package-label)=
+
+## Theme Package
 
 * Generated theme package can be uploaded as ZIP-file
 
 
-# Theme Structure
+(classic-ui-theming-barceloneta-theme-structure-label)=
+
+## Theme Structure
 
-## base.scss
+### `base.scss`
 
 * Basices required for backend
 
-## barceloneta.scss
+### `barceloneta.scss`
 
 * Barceloneta Theme basis
 
 
-# npm Package
+## npm Package
 
 * npm package with files required for Plone
 * dependencies required by theme to compile
 
 
 # Bootstrap Components
 
-* Default components are extended with some custom components (e.g. dropdown menu)
-* We use Boostrap variables in this 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
 
-Make live easy with...
+Make life easy with...
 
 * use Bootstrap markup
 * use Bootstrap components
-* use Bootsrap variables
+* use Bootstrap variables

docs/classic-ui/theming/barceloneta.md

@@ -1,3 +1,5 @@
+(classic-ui-theming-diazo-label)=
+
 # Plone Classic UI Theming with Diazo
 
 Theming based on Diazo.

docs/classic-ui/theming/diazo.md

@@ -1,5 +1,11 @@
+(classic-ui-theming-from-scratch-label)=
+
 # Plone Classic UI Theming based on Barceloneta
 
+```{todo}
+This page is only an outline and needs a lot of work.
+```
+
 Theming based on a filesystem package without any dependency.
 
 * Theming for Plone 6 Classic UI
@@ -9,23 +15,23 @@ Theming based on a filesystem package without any dependency.
 * No Diazo needed
 
 
-# Theme Package
+## Theme Package
 
 * Create a theme package as explained here.
-* Temove what you do not need
+* Remove what you do not need
 * Add [package.json](https://github.com/collective/plonetheme.munich/blob/master/package.json)
 * 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
 
-```
+```xml
 <!-- Publish static files -->
 <plone:static
     name="plonetheme.munich"
@@ -34,14 +40,14 @@ Directory: src/plonetheme/munich/browser/static
     />
 ```
 
-# Theme
+## Theme
 
-## Manifest
+### Manifest
 
 * Manifest for your theme
 * Keep rules empty to disable Diazo
 
-```
+```ini
 [theme]
 title = Munich Theme
 description = A modernized Plone 6 theme
@@ -51,9 +57,9 @@ prefix = /++theme++plonetheme.munich
 doctype = <!DOCTYPE html>
 ```
 
-## Bundle Registration
+### Bundle Registration
 
-```
+```xml
 <?xml version="1.0"?>
 <registry
     xmlns:i18n="http://xml.zope.org/namespaces/i18n"
@@ -70,51 +76,52 @@ doctype = <!DOCTYPE html>
 </registry>
 ```
 
-## Theme Registration
+### Theme Registration
 
 Register your theme via theme.xml
 
-```
+```xml
 <?xml version="1.0" encoding="UTF-8"?>
 <theme>
   <name>munich</name>
   <enabled>true</enabled>
 </theme>
 ```
 
-## Compile the bundle
+### Compile the bundle
 
 * Compile SASS to SCSS
 
 Install all requirements and dependencies from package.json:
 
-```
+```shell
 yarn install
 ```
 
 Build the actual bundle:
 
-```
+```shell
 yarn dist
 ```
 
 
-# Theming
+### 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)
 
-## Templates
+
+#### Templates
 
 * 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)

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

@@ -1,11 +1,14 @@
-# Plone Classic UI Theming
+# Plone 6 Classic UI Theming
 
-TODO
+```{todo}
+This page is only an outline and needs a lot of work.
+```
 
-# Contents
+```{toctree}
+:maxdepth: 2
 
-* Basics and Requirements
-* Minor CSS changes via controlpanel (TTW)
-* Theming based on Barceloneta
-* Theming from scratch (without dependencies)
-* Theming with Diazo
+barceloneta
+diazo
+from-scratch
+through-the-web
+```

docs/classic-ui/theming/index.md

@@ -2,6 +2,10 @@
 
 # Through-the-web (TTW) Theme Customization in Plone 6 Classic UI
 
+```{todo}
+This page is only an outline and needs a lot of work.
+```
+
 TTW customization is useful when you need to make small CSS changes.
 Theme changes can be made via control panels or by updating Plone 6 Classic UI's `custom.css`.
 Other theming methods should be used for larger customizations or entire website designs.

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

@@ -1,3 +1,5 @@
+(classic-ui-whatsnew-label)=
+
 # What's new in Plone 6 Classic UI
 
 - HTML markup is now based on [Twitter Bootstrap 5](https://getbootstrap.com/).

docs/classic-ui/whatsnew.md

@@ -3,7 +3,7 @@ html_meta:
   "description": "How to set up the Plone Documentation locally"
   "property=og:description": "How to set up the Plone Documentation locally"
   "property=og:title": "Building and Checking the Quality of Documentation"
-  "keywords": ""
+  "keywords": "setup, build, documentation, quality, development, spellcheck, linkcheck"
 ---
 
 (setup-build-label)=