FAF: Documentation UI Twig Blocks

This commit is contained in:
Eric
2021-05-18 17:53:05 +02:00
parent 9405eae922
commit e246e79eeb
14 changed files with 197 additions and 41 deletions

View File

@@ -1,3 +1,6 @@
.. Copyright (C) 2010-2021 Combodo SARL
.. http://opensource.org/licenses/AGPL-3.0
Alert
=====

View File

@@ -1,21 +1,57 @@
.. Copyright (C) 2010-2021 Combodo SARL
.. http://opensource.org/licenses/AGPL-3.0
Button
======
*In Progress*
Description
-----------
----
Output Result
-------------
:Example Buttons:
.. image:: Button-all.png
----
Twig Tag
--------
:Tag: **UIButton**
:Syntax:
::
{% UIButton Type {Parameters} %}
Content Goes Here
{% EndUIButton %}
:Type:
+------------------------------+-----------------------------------------------------+
| *Standard* | Create a *Default Button* |
+------------------------------+-----------------------------------------------------+
:Button common parameters:
+-------------------+--------+-----------+----------------------------------+
| *sId* | string | optional | ID of the HTML block |
+-------------------+--------+-----------+----------------------------------+
:See also: :ref:`UIBlock Common parameters <UIBlock_parameters>`
----
Examples
--------
.. image:: Button-all.png
Example to generate a button::
Factory Methods
---------------
{% UIButton Type {Parameters} %}
Content Goes Here
{% EndUIButton %}
Class Methods
-------------
Twig
----

View File

@@ -1,20 +1,56 @@
.. Copyright (C) 2010-2021 Combodo SARL
.. http://opensource.org/licenses/AGPL-3.0
ButtonGroup
===========
*In Progress*
Description
-----------
----
Output Result
-------------
:Example ButtonGroups:
----
Twig Tag
--------
:Tag: **UIButtonGroup**
:Syntax:
::
{% UIButtonGroup Type {Parameters} %}
Content Goes Here
{% EndUIButtonGroup %}
:Type:
+------------------------------+-----------------------------------------------------+
| *Standard* | Create a *Default ButtonGroup* |
+------------------------------+-----------------------------------------------------+
:ButtonGroup common parameters:
+-------------------+--------+-----------+----------------------------------+
| *sId* | string | optional | ID of the HTML block |
+-------------------+--------+-----------+----------------------------------+
:See also: :ref:`UIBlock Common parameters <UIBlock_parameters>`
----
Examples
--------
Example to generate a ButtonGroup::
Factory Methods
---------------
{% UIButtonGroup Type {Parameters} %}
Content Goes Here
{% EndUIButtonGroup %}
Class Methods
-------------
Twig
----

View File

@@ -1,20 +1,56 @@
.. Copyright (C) 2010-2021 Combodo SARL
.. http://opensource.org/licenses/AGPL-3.0
CollapsibleSection
==================
*In Progress*
Description
-----------
----
Output Result
-------------
:Example CollapsibleSections:
----
Twig Tag
--------
:Tag: **UICollapsibleSection**
:Syntax:
::
{% UICollapsibleSection Type {Parameters} %}
Content Goes Here
{% EndUICollapsibleSection %}
:Type:
+------------------------------+-----------------------------------------------------+
| *Standard* | Create a *Default CollapsibleSection* |
+------------------------------+-----------------------------------------------------+
:CollapsibleSection common parameters:
+-------------------+--------+-----------+----------------------------------+
| *sId* | string | optional | ID of the HTML block |
+-------------------+--------+-----------+----------------------------------+
:See also: :ref:`UIBlock Common parameters <UIBlock_parameters>`
----
Examples
--------
Example to generate a CollapsibleSection::
Factory Methods
---------------
{% UICollapsibleSection Type {Parameters} %}
Content Goes Here
{% EndUICollapsibleSection %}
Class Methods
-------------
Twig
----

View File

@@ -1,3 +1,6 @@
.. Copyright (C) 2010-2021 Combodo SARL
.. http://opensource.org/licenses/AGPL-3.0
UI Component
============

View File

@@ -1,3 +1,6 @@
.. Copyright (C) 2010-2021 Combodo SARL
.. http://opensource.org/licenses/AGPL-3.0
DataTable
=========
@@ -18,8 +21,8 @@ Static DataTable
.. image:: DatatableStatic.png
Twig
----
Twig Tag
--------
:Tag: **UIDataTable**

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.3 KiB

View File

@@ -1,3 +1,6 @@
.. Copyright (C) 2010-2021 Combodo SARL
.. http://opensource.org/licenses/AGPL-3.0
Title
=====
@@ -8,7 +11,7 @@ Display a title.
Output Result
-------------
.. image:: Title.png
----
@@ -73,3 +76,13 @@ Twig Tag
Examples
--------
:The following code:
::
{% UITitle ForPage {sTitle: 'UI:FullTextSearchTitle_Text'|dict_format(sFullText)} %}{% EndUITitle %}
:Will display:
.. image:: Title.png

View File

@@ -1,3 +1,6 @@
.. Copyright (C) 2010-2021 Combodo SARL
.. http://opensource.org/licenses/AGPL-3.0
UIBlock
=======
@@ -7,8 +10,8 @@ Description
UIBlock is the root class for all the other blocks.
Twig
----
Twig Tag
--------
This block has no Twig tag, but the following parameters are common to all the other Twig blocks.

View File

@@ -1,4 +1,6 @@
=========
.. Copyright (C) 2010-2021 Combodo SARL
.. http://opensource.org/licenses/AGPL-3.0
UI Layout
=========

View File

@@ -1,3 +1,6 @@
.. Copyright (C) 2010-2021 Combodo SARL
.. http://opensource.org/licenses/AGPL-3.0
UIContentBlock
==============

View File

@@ -0,0 +1,11 @@
/*!
* @copyright Copyright (C) 2010-2021 Combodo SARL
* @license http://opensource.org/licenses/AGPL-3.0
*/
/* theme.css | .doc/UI/build/html/_static/css/theme.css */
.wy-nav-content {
max-width: 1024px;
min-height: 100%;
}

View File

@@ -71,4 +71,8 @@ html_logo = "img/itop-logo.png"
# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
html_static_path = ['_static']
html_static_path = ['_static']
html_css_files = [
'css/ui-doc.css',
]

View File

@@ -1,10 +1,13 @@
.. iTop UI documentation master file, created by
sphinx-quickstart on Wed Apr 7 10:53:55 2021.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
.. Copyright (C) 2010-2021 Combodo SARL
.. http://opensource.org/licenses/AGPL-3.0
Welcome to iTop UI's documentation!
===================================
.. iTop UI documentation master file, created by
sphinx-quickstart on Wed Apr 7 10:53:55 2021.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
Welcome to iTop 3.0 UI's documentation!
=======================================
.. toctree::
:maxdepth: 2