add download links
This commit is contained in:
gwen
parent
a0e556e7c1
commit
638442273b
2 changed files with 44 additions and 49 deletions
|
|
@ -1,7 +1,7 @@
|
|||
.. _installation:
|
||||
|
||||
Installation
|
||||
===============
|
||||
Rougail library installation
|
||||
======================================
|
||||
|
||||
Activate you virtual environment
|
||||
------------------------------------
|
||||
|
|
|
|||
|
|
@ -14,7 +14,7 @@ Getting started
|
|||
- We assume that Rougail's library is :ref:`installed <installation>` on your computer.
|
||||
- If you want to follow with this tutorial with the help of the corresponding :tutorial:`Rougail-tutorials git repository <>`,
|
||||
this workshop page corresponds to the tags :tutorial:`v1.1_000 <src/tag/v1.1_000>` to :tutorial:`v1.1_011 <src/tag/v1.1_011>`
|
||||
in the repository.
|
||||
in the repository:
|
||||
|
||||
::
|
||||
|
||||
|
|
@ -33,25 +33,11 @@ Creating a structure file
|
|||
└── 00-proxy.yml
|
||||
|
||||
- Let's make a :file:`rougail-tutorials` directory, with a :file:`firefox` subfolder.
|
||||
- First, we wil create a :term:`structure file <structure file>`, so let's create a :file:`00-proxy.yml` file
|
||||
- First, we will create a :term:`structure file <structure file>`, so let's create a :file:`00-proxy.yml` file
|
||||
located in the :file:`firefox` subfolder.
|
||||
|
||||
.. type-along:: An empty structure file
|
||||
|
||||
.. note::
|
||||
|
||||
If you don't want to manualy create a file in your favorite text editor
|
||||
and prefer to start with a ready-made project, you can clone the
|
||||
:tutorial:`v1.1_000 version of the rougail-tutorials git repository: <src/tag/v1.1_000>`
|
||||
|
||||
::
|
||||
|
||||
git clone https://forge.cloud.silique.fr/stove/rougail-tutorials.git
|
||||
git switch v1.1_000
|
||||
|
||||
Otherwise you can copy/paste this file content:
|
||||
|
||||
|
||||
This is an empty Rougail :term:`structure description file: <structure file>`
|
||||
|
||||
.. extinclude:: https://forge.cloud.silique.fr/stove/rougail-tutorials/raw/tag/v1.1_000/firefox/00-proxy.yml
|
||||
|
|
@ -63,24 +49,12 @@ This is an empty Rougail :term:`structure description file: <structure file>`
|
|||
---
|
||||
version: 1.1
|
||||
|
||||
:tutorial:`Download this file from the rougail-tutorials git repository <src/tag/v1.1_000/firefox/00-proxy.yml>`
|
||||
|
||||
Let's add our first variable
|
||||
------------------------------
|
||||
|
||||
A variable is defined at a minimum by its name.
|
||||
|
||||
.. note::
|
||||
|
||||
If you don't want to manualy create a file in your favorite text editor
|
||||
and prefer to start with a ready-made project, you can clone the
|
||||
:tutorial:`v1.1_010 version of the rougail-tutorials git repository: <src/tag/v1.1_010>`
|
||||
|
||||
::
|
||||
|
||||
git clone https://forge.cloud.silique.fr/stove/rougail-tutorials.git
|
||||
git switch v1.1_010
|
||||
|
||||
Otherwise you can copy/paste this file content:
|
||||
.. note:: A variable is defined at a minimum by its name.
|
||||
|
||||
A :term:`variable` in the :term:`structure description file <structure file>`
|
||||
|
||||
|
|
@ -93,7 +67,7 @@ A :term:`variable` in the :term:`structure description file <structure file>`
|
|||
---
|
||||
proxy_mode:
|
||||
|
||||
:download:`download this file <https://forge.cloud.silique.fr/stove/rougail-tutorials/raw/tag/v1.1_001/firefox/00-proxy.yml>`
|
||||
:tutorial:`Download this file from the rougail-tutorials git repository <src/tag/v1.1_001/firefox/00-proxy.yml>`
|
||||
|
||||
Let's run the Rougail CLI utility command:
|
||||
|
||||
|
|
@ -113,8 +87,6 @@ we will actually have an error:
|
|||
┣━━ The following variables are mandatory but have no value:
|
||||
┗━━ - proxy_mode
|
||||
|
||||
.. FIXME on parle ici de l'option --cli.read_write ??
|
||||
|
||||
Because this variable is :term:`mandatory` and needs to be set **but** there's no value yet.
|
||||
|
||||
We can therefore deduce the fact that:
|
||||
|
|
@ -146,6 +118,9 @@ Let's add a variable's description, which is not mandatory but which is a good p
|
|||
---
|
||||
proxy_mode: # Configure Proxy Access to the Internet
|
||||
|
||||
:tutorial:`Download this file from the rougail-tutorials git repository <src/tag/v1.1_002/firefox/00-proxy.yml>`
|
||||
|
||||
|
||||
.. type-along:: how to set a value -- the default value
|
||||
|
||||
We need to set a value to this `proxy_mode` variable. A first way to do it is *to set a value by default*.
|
||||
|
|
@ -168,6 +143,9 @@ So let's define a variable with a description -- **and a default value**
|
|||
---
|
||||
proxy_mode: No proxy # Configure Proxy Access to the Internet
|
||||
|
||||
:tutorial:`Download this file from the rougail-tutorials git repository <src/tag/v1.1_003/firefox/00-proxy.yml>`
|
||||
|
||||
|
||||
|
||||
.. type-along:: how to set a value -- the assignment
|
||||
|
||||
|
|
@ -219,42 +197,59 @@ he is responsible of other files called the :term:`user data file`\ s.
|
|||
|
||||
.. exercise:: Folder structure update
|
||||
|
||||
Now we add a :file:`config/config.yml` file in our project::
|
||||
Now we add a :file:`config/config.yaml` file in our project::
|
||||
|
||||
workplace
|
||||
rougail-tutorials
|
||||
├── firefox
|
||||
│ ├── struct.yml
|
||||
│ ├── 00-proxy.yml
|
||||
└── config
|
||||
└── config.yml
|
||||
└── config.yaml
|
||||
|
||||
.. type-along:: how to set a value in a user datas file
|
||||
|
||||
So for example if the integrator has not set any default value in his structure file,
|
||||
the operator can do it like this:
|
||||
it's up to the operator to do the job in the `config.yaml` file:
|
||||
|
||||
.. extinclude:: https://forge.cloud.silique.fr/stove/rougail-tutorials/raw/tag/v1.1_003/config/02/config.yaml
|
||||
.. extinclude:: https://forge.cloud.silique.fr/stove/rougail-tutorials/raw/tag/v1.1_001/config/02/config.yaml
|
||||
:language: yaml
|
||||
:caption: A Rougail user datas file :file:`config/config.yml`, with a default value set.
|
||||
:caption: A Rougail user datas file :file:`config/config.yaml`, with a default value set.
|
||||
:name: RougailConfigDefaultValue
|
||||
|
||||
..
|
||||
---
|
||||
proxy_mode: No proxy
|
||||
|
||||
With the rougail CLI the operator has to add the `-u file -ff config/config.yml` options:
|
||||
:tutorial:`Download this file from the rougail-tutorials git repository <src/tag/v1.1_001/config/02/config.yaml>`
|
||||
|
||||
|
||||
With the rougail CLI the operator has to add the `-u file -ff config/config.yaml` options:
|
||||
|
||||
.. code-block:: text
|
||||
:class: terminal
|
||||
:caption: A rougail Command Line Utility call with the :file:`config/config.yml` Rougail user datas file
|
||||
:caption: A rougail Command Line Utility call with the :file:`config/config.yaml` Rougail user datas file
|
||||
|
||||
rougail -v 1.1 -m firefox -u file -ff config/01/config.yaml
|
||||
rougail -m firefox -u yaml -ff config/02/config.yaml
|
||||
|
||||
Let us clarify this essential point:
|
||||
which gives us this output:
|
||||
|
||||
- the integrator works on structure files
|
||||
- the operator works on user data files
|
||||
.. raw:: html
|
||||
:url: https://forge.cloud.silique.fr/stove/rougail-tutorials/raw/tag/v1.1_001/config/02/output_ro.html
|
||||
:class: output
|
||||
|
||||
..
|
||||
<pre>╭──────── Caption ────────╮
|
||||
│ Variable Modified value │
|
||||
╰─────────────────────────╯
|
||||
Variables:
|
||||
<span style="color: #5c5cff">┗━━ </span>📓 proxy_mode: No proxy ◀ loaded from the YAML file "config/02/config.yaml"
|
||||
</pre>
|
||||
|
||||
.. admonition:: Important fact
|
||||
|
||||
- the integrator works on structure files
|
||||
- the operator works on user data files
|
||||
|
||||
.. note:: Most of the time, the integrator and the operator are one and the same person, here we are talking about roles and not necessarily about people.
|
||||
Most of the time, the integrator and the operator are one and the same person, here we are talking about roles and not necessarily about people.
|
||||
|
||||
Variable's type
|
||||
-----------------
|
||||
|
|
|
|||
Loading…
Reference in a new issue