🎨 add page for formatting block text

docs/content-editing/format-block-text.md

@@ -0,0 +1,116 @@
+---
+myst:
+  html_meta:
+    "description": "How to Format Text in a Block"
+    "property=og:description": "How to Format Text in a Block"
+    "property=og:title": "How to Format Text in a Block"
+    "keywords": "Plone, Format, Block, Text"
+---
+
+# How to Format Text in a Block
+
+We show how to select text in order to format it.
+
+1. In this example, we are editing a page. 
+
+    It contains a block in which we would like to format this text.
+
+   ````{card}
+   ```{image} _static/format-block-text-01.jpeg
+   :alt: Highlight the text to be formatted
+   :target: _static/format-block-text-01.jpeg
+   ```
+   +++
+   _Highlight the text to be formatted_
+   ````
+
+
+2. Use the mouse to select the text you want to format.
+
+    The formatting toolbar appears.
+
+    In this example, we click {guilabel}`B` to boldface the selected text.
+
+   ````{card}
+   ```{image} _static/format-block-text-02.jpeg
+   :alt: Click B to boldface the selected text
+   :target: _static/format-block-text-02.jpeg
+   ```
+   +++
+   _Click B to boldface the selected text_
+   ````
+
+
+3. This is the text after being bolded.
+
+   ````{card}
+   ```{image} _static/format-block-text-03.jpeg
+   :alt: The text after being formatted
+   :target: _static/format-block-text-03.jpeg
+   ```
+   +++
+   _The text after being formatted_
+   ````
+
+
+4. You can remove a particular format by clicking it again. 
+
+    In this case, we have clicked {guilabel}`B` again to unbold the text.
+
+   ````{card}
+   ```{image} _static/format-block-text-04.jpeg
+   :alt: Click B again to unbold currently bolded text
+   :target: _static/format-block-text-04.jpeg
+   ```
+   +++
+   _Click B again to unbold currently bolded text_
+   ````
+
+
+5. You can apply more than one format to the selected text.
+
+    In this example, we click {guilabel}`I` to italicize the already bolded text.
+
+   ````{card}
+   ```{image} _static/format-block-text-05.jpeg
+   :alt: Click I to italicize text
+   :target: _static/format-block-text-05.jpeg
+   ```
+   +++
+   _Click I to italicize text_
+   ````
+
+
+6. This is the resulting bolded, italicized text.
+
+   ````{card}
+   ```{image} _static/format-block-text-06.jpeg
+   :alt: Bolded, italicized text
+   :target: _static/format-block-text-06.jpeg
+   ```
+   +++
+   _Bolded, italicized text_
+   ````
+
+
+7. The other formats you can apply are:
+   - strikethrough
+   - creating a link
+   - creating a heading
+   - creating a subheading
+   - subscripting
+   - superscripting
+   - inserting a numbered list
+   - inserting an unordered list 
+   - creating a blockquote
+
+   ````{card}
+   ```{image} _static/format-block-text-07.jpeg
+   :alt: Other formats that can be applied to selected text
+   :target: _static/format-block-text-07.jpeg
+   ```
+   +++
+   _Other formats that can be applied to selected text_
+   ````
+
+

docs/content-editing/index.md

@@ -54,6 +54,7 @@ tour-of-plone
 logging-in-and-out
 content-creation-to-publication
 pages
+format-block-text
 use-pages-to-organize-content
 add-a-file
 add-a-link