Meilleurs mise en formes reStructuredText

diff --git a/source/conf.py b/source/conf.py
index 232458f64268050289cf44c760637a85fcabc3bc..28e1ccd92881614d6d624ffd4527a52998b342e9 100644 (file)
--- a/source/conf.py
+++ b/source/conf.py
@@ -7,9 +7,9 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
 project = 'papier-crayon'
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
 project = 'papier-crayon'

-copyright = '2024, M. Le Meur'
+copyright = '2024-2025, M. Le Meur'

 author = 'M. Le Meur'
 author = 'M. Le Meur'

-release = '0.1.3b'
+release = '0.1.5b'

 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

diff --git a/source/machine/FS-mmdebstrap.rst b/source/machine/FS-mmdebstrap.rst
index 5046a6826dc23b78c94e45ae66a2acb12142f79b..1780d07d36f1d8c6fa9adb552254839fd2613dac 100644 (file)
--- a/source/machine/FS-mmdebstrap.rst
+++ b/source/machine/FS-mmdebstrap.rst
@@ -8,7 +8,7 @@ Gérer un emplacement pertinent
 
 .. code-block:: bash
    :linenos:
 
 .. code-block:: bash
    :linenos:

-   :emphasize-lines: 20,28
+   :emphasize-lines: 17,17

 
    cd
    pwd
 
    cd
    pwd

diff --git a/source/machine/pont-nmcli.rst b/source/machine/pont-nmcli.rst
index d6210b31dad9c49eee2965c022b5a59b6cf544dc..bdd9ddcc83f7d06e03acab0cf3cafdbf0aa5c60f 100644 (file)
--- a/source/machine/pont-nmcli.rst
+++ b/source/machine/pont-nmcli.rst
@@ -6,58 +6,71 @@ en particulier *Example 10* !
 
 *sans* super-privilège
 
 
 *sans* super-privilège
 

-::
+.. code-block:: bash
+   :emphasize-lines: 2,4

 
    nmcli d s
 
    nmcli d s

+   nmcli d help

    nmcli c s
    nmcli c help
    nmcli c up help
    nmcli c down help
 
    nmcli c s
    nmcli c help
    nmcli c up help
    nmcli c down help
 

-**AVEC** super-privilège
+Si "pont1" n'existe pas, le créer (une fois par STA [#]_ )
+----------------------------------------------------------

 
 

-* si "pont1" n'existe pas, le créer (une fois par STA [#]_ )
+**AVEC** super-privilège

 
 

-.. warning::
+.. caution::

 
    choisir une des deux présentations de la même commande complexe..., 
    c'est-à-dire à comprendre et adapter à chaque situation.
 
 
    choisir une des deux présentations de la même commande complexe..., 
    c'est-à-dire à comprendre et adapter à chaque situation.
 

-::
+.. code-block:: bash

 
 

-   # en une ligne longue
+   # soit en une ligne longue

    nmcli c a type bridge con-name co-pont1 ifname pont1
 
    nmcli c a type bridge con-name co-pont1 ifname pont1
 

-::
-
-   # en "multi-lignes"
+.. code-block:: bash
+   :linenos:
+   
+   # soit en "multi-lignes"

    nmcli connection add \
    type bridge \
    con-name co-pont1 \
    ifname pont1
 
    nmcli connection add \
    type bridge \
    con-name co-pont1 \
    ifname pont1
 

-* et après, asservir l'interface physique validée avec ``nmcli d s``
+et après, asservir l'interface physique
+---------------------------------------
+
+Prendre soin de valider le nom de l'interface en question à l'aide de 
+``nmcli d s``

 
 .. warning::
 
    choisir une des deux présentations de la même commande complexe..., 
    c'est-à-dire à comprendre et adapter à chaque situation.
 
 
 .. warning::
 
    choisir une des deux présentations de la même commande complexe..., 
    c'est-à-dire à comprendre et adapter à chaque situation.
 

-::
+.. code-block:: bash

 
 

-   # en une ligne longue
+   # soit en une ligne longue

    nmcli c a type ethernet con-name co-eno1-pont1 ifname eno1 master pont1
 
    nmcli c a type ethernet con-name co-eno1-pont1 ifname eno1 master pont1
 

-::
+.. code-block:: bash
+   :linenos:

 
 

-   # en "multi-lignes"
+   # soit en "multi-lignes"

    nmcli connection add \
    type ethernet \
    con-name co-eno1-pont1 \
    ifname eno1 \
    master pont1
 
    nmcli connection add \
    type ethernet \
    con-name co-eno1-pont1 \
    ifname eno1 \
    master pont1
 

-* éventuellement **(dés)activer** la (les) *connection(s)* en trop\ …
+
+.. admonition:: Dans certains cas...
+   :collapsible: closed
+   
+   Éventuellement **(dés)activer** la (les) *connection(s)* en trop\ …

 
 ----
 
 
 ----