add more info

Author: santonelli

icons.md

@@ -17,12 +17,28 @@ Icons are shipped via plone.staticresources. Check out the [package.json](https:
 # Registration
 
 * Icons are registered in Plone's registry
-* Override of icons via xml
+* Registrered to override of icons via xml
+* Option to customize UI and contenttype icons
 * [Bootstrap Icons](https://github.com/plone/plone.staticresources/blob/master/src/plone/staticresources/profiles/default/registry/icons_bootstrap.xml)
 * [Contenttypes](https://github.com/plone/plone.staticresources/blob/master/src/plone/staticresources/profiles/default/registry/icons_contenttype.xml)
 * [Plone UI](https://github.com/plone/plone.staticresources/blob/master/src/plone/staticresources/profiles/default/registry/icons_plone.xml)
 
 
+# Contextual Icons
+
+We definde contextual icons. If you don't like e.g. the share icon - override it without touching the share icon used by the system.
+
+* Icons like copy, cut, paste
+* Identical function all over the site
+* That's why we reuse those icons
+* Specific icon name is based on the usage in the system
+
+## Icon expression
+
+* icon_expression field is used again to define icons (e.g. for actions, contenttypes)
+* Use icon name for icon expressions
+
+
 # Customization
 
 * Add custom icons
@@ -32,9 +48,9 @@ Icons are shipped via plone.staticresources. Check out the [package.json](https:
 
 # Icon Font
 
-* TODO
 * Setup profile to install icon font
 * Usage as known from e.g. Font Awesome
+* TODO
 
 
 # Iconresolver
@@ -49,8 +65,16 @@ URL method of @@icons view returns the actual URL to the SVG icon. This can be u
 
 ## Get Icon Tag
 
-Tag method is used with tal:replace and returns an entire inline SVG image. tag_class and tag_alt is used to pass in custom classes and an alt text.
+Tag method is used with tal:replace and returns an entire inline SVG image. Inline icons can be styled via CSS. tag_class and tag_alt is used to pass in custom classes and an alt text.
 
 ```
 <tal:icon tal:replace="structure python:icons.tag('archive', tag_class='custom-class', tag_alt='foobar')" />
 ```
+
+## Resource Path
+
+SVG Files are avaiblae as resource.
+
+```
+++plone++bootstrap-icons/lightning.svg
+```

theming/barceloneta/index.md

@@ -1,8 +1,49 @@
 # Plone Classic UI Theming based on Barceloneta
 
-* TODO
-* SCSS
+* 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
+* We used Bootstrap markup in templates
+* We used Bootstrap components wherever possible
+* Most of look and feel can be touched via Bootstrap's variables
+* Hint: order is important in SCSS
+
+
+# Theme Package
+
+* Generated theme package can be uploaded as ZIP-file
+
+
+# Theme Structure
+
+## base.scss
+
+* Basices required for backend
+
+## barceloneta.scss
+
+* Barceloneta Theme basis
+
+
+# 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
+
+
+# Add-Ons and Templates
+
+Make live easy with...
+
+* use Bootstrap markup
+* use Bootstrap components
+* use Bootsrap variables

theming/basics/index.md theming/theme-package/index.mdtheming/basics/index.md renamed to theming/theme-package/index.md

@@ -1,3 +1,10 @@
 # Plone Classic UI Theme Add-On
 
 Create a filesystem package to keep an installable theme for Plone 6 Classic UI.
+
+# bobtemplates.plone
+
+* Boilerplate
+* package.json
+* Fertige basis
+* Plone CLI