autre_essai.rst

Bonjour, ReStructuredText ! : essai d'un tutoriel

Une introduction à https://fr.wikipedia.org/wiki/ReStructuredText

essai de documentation et d'essais de mise en formes diverses.

Une table des matières est mise en place automatiquement.

Table des matières

• 1   Première Partie
  • 1.1   gras, italiques et autres mises en forme
  • 1.2   des touches ?
  • 1.3   Symboles ? et ligne de séparation
  • 1.4   des liens
  • 1.5   Références dans le document
  • 1.6   des listes
  • 1.7   des anotations et remarques
  • 1.8   citation et commentaire non affiché
  • 1.9   des notes
• 2   Deuxième Partie
  • 2.1   Inclure du code ou autre texte dans un cadre
  • 2.2   Inclure des images
  • 2.3   Les labels
  • 2.4   Les tableaux

1   Première Partie

1.1   gras, italiques et autres mises en forme

du texte en gras ou en italique ou encore essai mis en cadre dans la phrase.

Pour du texte souligné ?

1.2   des touches ?

Séquence de touches ? kbd::[Alt+F11]

1.3   Symboles ? et ligne de séparation

3. 18. (TM) -- ... -> <- => <=

On peut utiliser le signe "fin de paragraphe" ? &#182;

Et aussi rajouter une ligne de séparation :

---

du texte ici en dessous de la ligne de séparation.

1.4   des liens

• exemple

https://fr.wikipedia.org/wiki/ReStructuredText

• autre exemple

Une phrase avec un lien vers restrutured et le site de SambaÉDU.

1.5   Références dans le document

On peut revenir sur un titre de la table des matières, par exemple gras, italiques et autres mises en forme ou bien Les tableaux.

On peut aussi créer une ancre et ensuite s'y référer au cours du texte ; voir un lien dans le § Les tableaux.

C'est pratique, non ?

1.6   des listes

liste non numérotée :

• item 1

  • sous-item

    • encore un sous-item
    • dfgt

• item 2

• item 3

  • sous-item
  • sous-item

liste numérotée automatiquement :

1. liste 1

   1. sousliste a
   2. sousliste b

2. liste 2

3. liste suivante

   1. sousliste a

      1. sous-sous-liste

   2. sousliste b

   3. sousliste c

liste encore avec numérotation :

1. liste n
2. liste nb

1.7   des anotations et remarques

Error

C'est une erreur ?

Important

• c'est important
• bien le lire
• se concentrer
• se reposer…

Note

• une liste
• est possible
• À noter genre remarque…

Warning

• comme ci-dessus
• on peut avoir une liste

Attention!

on peut faire aussi attention :-)

1.8   citation et commentaire non affiché

Après la pluie le beau temps.

C'est la fête à la grenouille !

avec un commentaire qui n'apparaît pas dans l'affichage, juste entre les deux lignes ci-dessous :-)

---

---

1.9   des notes

on peut avoir une note [1] et une autre note [2] qui devraient être numérotées automatiquement.

autre texte éventuel…

[1]	c'est la 1ère note.

[2]	c'est la 2e note.

2   Deuxième Partie

2.1   Inclure du code ou autre texte dans un cadre

Voici du code

# lsblk
NAME   MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
sda      8:0    0 698,7G  0 disk
├─sda1   8:1    0  19,9G  0 part /
├─sda2   8:2    0  19,9G  0 part
├─sda3   8:3    0     1K  0 part
├─sda5   8:5    0   5,5G  0 part [SWAP]
└─sda6   8:6    0 653,3G  0 part /home
sr0     11:0    1  1024M  0 rom

autre exemple

int main ( int argc, char *argv[] ) {
    printf("Hello World\n");
    return 0;
}

2.2   Inclure des images

voici une image :

2.3   Les labels

Term 1

Definition 1

Term 2

Definition 2

2.4   Les tableaux

Voici un tableau :

Inputs		Output
A	B	A or B
False	False	False
True	False	True
False	True	True
True	True	True

On peut revenir dans le texte à l'ancre monAncre.