--- a/src/source/dev_guide/howto-paragraph.rst Mon Dec 17 18:07:56 2018 +0100
+++ b/src/source/dev_guide/howto-paragraph.rst Tue Dec 18 11:48:01 2018 +0100
@@ -1,20 +1,19 @@
.. _paragraphhowto:
-
-How to create a Paragraph type?
-===============================
+Creating new Paragraph (or blocks)
+==================================
Paragraphs or Blocks are components that contain elements/fields and provide one or many renderer methods to compose
the front office website
+How to create a Paragraph type?
+-------------------------------
-Create a Paragraph
-""""""""""""""""""
In this example we will create a contact paragraph to display at the user, who to contact.
1) Interface
-------------
+^^^^^^^^^^^^
At first we create a new paragraph interface.
@@ -47,7 +46,7 @@
2) Implement the interface
---------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^
An implementation of the interface
@@ -79,7 +78,7 @@
3) Renderers Vocabulary
------------------------
+^^^^^^^^^^^^^^^^^^^^^^^
The list of rendered available for a paragraph is build automatically and is based on adapters that provide this interface
@@ -98,10 +97,10 @@
Paragraph in the ZMI
-""""""""""""""""""""
+--------------------
1) Container Paragraph
-----------------------
+^^^^^^^^^^^^^^^^^^^^^^
For example :py:class:`IParagraphContainerTarget`, it's a marker interface for paragraph containers.
@@ -140,7 +139,7 @@
To display and manage the new paragraph in the ZMI, you should create this associated forms
2) Create the Paragraph addform button in the menu
---------------------------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
We have created a new form and we want add a quick access button to create a new paragraph
@@ -159,7 +158,7 @@
3) Create Edit inner form
--------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^
.. code-block:: python
@@ -196,7 +195,7 @@
4) Create an Edit modal form
-----------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
This form is used inside modals popup
@@ -229,7 +228,7 @@
5) Paragraph Factory
---------------------
+^^^^^^^^^^^^^^^^^^^^
If you want to create automatically a paragraph object for a shared content you must define a factory
@@ -250,21 +249,16 @@
How to associate links or Illustrations to a Paragraph ?
-========================================================
+--------------------------------------------------------
Adding the following marker interface, we add new behavior to the Paragraph `ContactPhoneParagraph` .
-
-
-Paragraph advanced
-""""""""""""""""""
-
You can attach Associated files, links or illustration and manage them directly through the rubric `Links and Attachments`.
.. image:: ../_static/select_links_n_attachment.png
1) Paragraph with Links and Attachements
-----------------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
To "activate" this features the paragrath object must to implement specific interface
@@ -318,7 +312,7 @@
2) Add link and association form
---------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
You can add form to manage links and attachments directly in paragraph form to do that your form must implement
``IPropertiesEditForm`` and/or ``IAssociationParentForm``