Skip to content

Commit

Permalink
Merge pull request #155 from potassco/documentation
Browse files Browse the repository at this point in the history
Moved images
  • Loading branch information
susuhahnml authored Dec 13, 2023
2 parents 1fc64b1 + 2bbd8f3 commit 76fe387
Show file tree
Hide file tree
Showing 31 changed files with 14 additions and 59 deletions.
Binary file added docs/client.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
28 changes: 14 additions & 14 deletions docs/clinguin/reference.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ All components of the diagram are explained in detail in this guide.

In this diagram, operations are marked in gray, states corresponding to sets of facts are depicted in green, and input files appear in red.

.. figure:: ../img/workflow.png
.. figure:: ../workflow.png


------------------------------------------------------------------------------------
Expand All @@ -22,7 +22,7 @@ Structure
Server
******

.. figure:: ../img/server.png
.. figure:: ../server.png

The server is responsible for executing clingo and computing the information required to define the UI. This process unfolds in two distinct steps:

Expand Down Expand Up @@ -52,7 +52,7 @@ Server
Client
******

.. figure:: ../img/client.png
.. figure:: ../client.png

The client is responsible for rendering the UI and responding to the user's actions.
When it is loaded, it requests the :ref:`ui-state` from the server.
Expand Down Expand Up @@ -80,7 +80,7 @@ Input
domain-files
************

.. figure:: ../img/domfiles.png
.. figure:: ../domfiles.png

The domain-specific ASP encodings that will generate solutions to the problem (including the instance).
These files will be used by the :ref:`domain-control`.
Expand All @@ -90,7 +90,7 @@ domain-files
ui-files
************

.. figure:: ../img/uifiles.png
.. figure:: ../uifiles.png

The encoding that will generate the :ref:`ui-state` using the :ref:`domain-state` as input.
They are provided when starting the server via the command line in argument ``--ui-files``.
Expand All @@ -108,7 +108,7 @@ States are sets of ASP facts that are used to define diferent aspects of the sys
ui-state
********

.. figure:: ../img/uistate.png
.. figure:: ../uistate.png

A User Interface is defined in `clinguin` using the three predicates below.
These facts are generated by calling clingo with the :ref:`domain-state` and the provided :ref:`ui-files`.
Expand Down Expand Up @@ -193,7 +193,7 @@ ui-state
domain-state
************

.. figure:: ../img/domstate.png
.. figure:: ../domstate.png

A set of facts defining the state of the domain, which will be used as input to the :ref:`ui-files`.
These facts are generated by multiple domain-state constructors defined by the backend.
Expand Down Expand Up @@ -304,7 +304,7 @@ Control
domain-control
**************

.. figure:: ../img/domcontrol.png
.. figure:: ../domcontrol.png


The *Clingo* control that will be handled by the Backend.
Expand All @@ -315,7 +315,7 @@ domain-control
ui-control
**************

.. figure:: ../img/uicontrol.png
.. figure:: ../uicontrol.png


The *Clingo* control that will be used to compute the :ref:`ui-state` using the :ref:`ui-files`.
Expand All @@ -334,7 +334,7 @@ GET
When the UI is first loaded and in every reload, the client will do a ``GET`` request which will update the UI.


.. figure:: ../img/get.png
.. figure:: ../get.png


****
Expand All @@ -344,7 +344,7 @@ POST
When the user triggers as event that is associiated with a ``call`` action, the client will do a ``POST`` request.
This request will include the selected operations and the context.

.. figure:: ../img/post.png
.. figure:: ../post.png

**********
Operations
Expand All @@ -353,14 +353,14 @@ Operations
The operations are defined by the backend. These operations will interact with the domain control while performing all the required changes.
Each backend will define an available list of operations. These lists can be found in :ref:`Backends`.

.. figure:: ../img/operation.png
.. figure:: ../operation.png


********
Context
********

.. figure:: ../img/context.png
.. figure:: ../context.png


The context can be used to store information provided by the user before calling the server. For instance, it can store the input of a text field, or the value of a checkbox. Therefore, it is usefull for creating input forms within the UI. Internally, the context is represented by a dictionary in the client and it can be accesed in three ways.
Expand Down Expand Up @@ -430,7 +430,7 @@ Context
JSON UI
********

.. figure:: ../img/json.png
.. figure:: ../json.png


The :ref:`ui-state` is represented by a JSON to comunicate between client and server. This JSON is generated in a herachical fashion where each element apears with the following form.
Expand Down
Binary file added docs/context.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/domcontrol.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/domfiles.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/domstate.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/get.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 0 additions & 3 deletions docs/img/client.png

This file was deleted.

3 changes: 0 additions & 3 deletions docs/img/context.png

This file was deleted.

3 changes: 0 additions & 3 deletions docs/img/domcontrol.png

This file was deleted.

3 changes: 0 additions & 3 deletions docs/img/domfiles.png

This file was deleted.

3 changes: 0 additions & 3 deletions docs/img/domstate.png

This file was deleted.

3 changes: 0 additions & 3 deletions docs/img/get.png

This file was deleted.

3 changes: 0 additions & 3 deletions docs/img/input.png

This file was deleted.

3 changes: 0 additions & 3 deletions docs/img/json.png

This file was deleted.

3 changes: 0 additions & 3 deletions docs/img/operation.png

This file was deleted.

3 changes: 0 additions & 3 deletions docs/img/post.png

This file was deleted.

3 changes: 0 additions & 3 deletions docs/img/server.png

This file was deleted.

3 changes: 0 additions & 3 deletions docs/img/uicontrol.png

This file was deleted.

3 changes: 0 additions & 3 deletions docs/img/uifiles.png

This file was deleted.

3 changes: 0 additions & 3 deletions docs/img/uistate.png

This file was deleted.

3 changes: 0 additions & 3 deletions docs/img/workflow.png

This file was deleted.

Binary file added docs/input.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/json.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/operation.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/post.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/server.png
Binary file added docs/uicontrol.png
Binary file added docs/uifiles.png
Binary file added docs/uistate.png
Binary file added docs/workflow.png

0 comments on commit 76fe387

Please sign in to comment.