added documentation about zope4 ZMI template updating #329
Conversation
docs/ZMI.rst
Outdated
| typical bootstrap class names like ``text-warning``. | ||
|
|
||
| **Icons:** | ||
| Zope4 object classes which are show in the ZMI have declared a global variable |
There was a problem hiding this comment.
My understanding is that these are instance variables? Is Zope Speak here different to standard python?
docs/ZMI.rst
Outdated
| ZPT-Example see: ``../Zope/src/Products/PageTemplates/www/ptEdit.zpt`` | ||
|
|
||
| **File upload element:** | ||
| The file upload element has an own form container (classfied as ``zmi-upload``). |
There was a problem hiding this comment.
Maybe "it's own form container" could be more fluid.
docs/ZMI.rst
Outdated
| Bootstraps requires an explictit CSS class ``table`` for any table; espcially | ||
| long item lists should get an additional CSS class ``table-sm`` and maybe another | ||
| class ``table-striped`` for a better readability. Finally it is recommended | ||
| to add a specific identifying class name. The table structure is |
There was a problem hiding this comment.
This seems to be missing part of the sentence
docs/ZMI.rst
Outdated
| Update your Zope2 ZMI template code | ||
| +++++++++++++++++++++++++++++++++++ | ||
|
|
||
| The Zope4 ZMI uses some basic CSS class names of the bootstrap cCSS framework |
docs/ZMI.rst
Outdated
| fowllowing the typical element nesting: | ||
| any form element has a bootstrap-like form-group structure containing a label | ||
| and an input field. Important: the width of the input field is defined by the | ||
| nesting div-container using the responsive grid classes ``col-sm-9 col-and md-10``. |
There was a problem hiding this comment.
The grid classes should rather be col-sm-9 col-md-10 as in the example.
docs/ZMI.rst
Outdated
| prefixed ``zmi-`` whereas the basic layout is done by usual bootstrap classes | ||
| fowllowing the typical element nesting: | ||
| any form element has a bootstrap-like form-group structure containing a label | ||
| and an input field. Important: the width of the input field is defined by the |
There was a problem hiding this comment.
_T_he width of the input field...
docs/ZMI.rst
Outdated
| and an input field. Important: the width of the input field is defined by the | ||
| nesting div-container using the responsive grid classes ``col-sm-9 col-and md-10``. | ||
| The input field width is completed to 12 (=100%) by the preceeding label classes | ||
| ``col-sm-3`` and ``col-md-2`` |
There was a problem hiding this comment.
Maybe:
With the classes ``col-sm-3 col-md-2`` for the label, a complete bootstrap row of 12 is filled.
docs/ZMI.rst
Outdated
| <label for="title" class="form-label col-sm-3 col-md-2">Title</label> | ||
| <div class="col-sm-9 col-md-10"> | ||
| <input id="title" class="form-control" type="text" name="title" | ||
| value="<dtml-if title>&dtml-title;</dtml-if>" /> |
There was a problem hiding this comment.
one space before value= could be deleted.
docs/ZMI.rst
Outdated
|
|
||
| **File upload element:** | ||
| The file upload element has it's own form container (classfied as ``zmi-upload``). | ||
| All subseqeunt elements are nested as 'input-group' containing a div classified as |
There was a problem hiding this comment.
subseq_ue_nt ... ``input-group`` as you used this notation for all CSS-classes
docs/ZMI.rst
Outdated
| supplied by the Fontawsome web font (https://fontawesome.com/icons) | ||
|
|
||
| **Tables:** | ||
| Bootstraps requires an explictit CSS class ``table`` for any table; espcially |
There was a problem hiding this comment.
Bootstrap__ ... explic__it ... esp_e_cially
docs/ZMI.rst
Outdated
| bootstrap standard table (https://getbootstrap.com/docs/4.1/content/tables/). | ||
|
|
||
| **ZMI-classes:** | ||
| All basic stylings of the zmi-elements are defined in the CSS file, see: |
There was a problem hiding this comment.
one whitespace ... zmi-elements_ _are
docs/ZMI.rst
Outdated
| Bootstraps requires an explictit CSS class ``table`` for any table; espcially | ||
| long item lists should get an additional CSS class ``table-sm`` and maybe another | ||
| class ``table-striped`` for a better readability. Finally it is recommended | ||
| to add a specific identifying class name. The table structure is compliant to |
There was a problem hiding this comment.
can you please give an example for such a name?
please check comprehensibility, thanks Frank