tutorials: improve theme + use pandoc 2

tutorial/dockerfiles/entrypoint.md

@@ -9,8 +9,8 @@ Afin de faire bénéficier à nos utilisateurs d'une immersion parfaite, nous
 allons faire en sorte que notre image permette d'être utilisée ainsi :
 
 <div lang="en-US">
-```
-    42sh$ docker run -d -p 80:80 youp0m -bind :80
+```bash
+docker run -d -p 80:80 youp0m -bind :80
 ```
 </div>
 
@@ -19,16 +19,17 @@ Plutôt que de laisser l'utilisateur se débrouiller avec le chemin interne dans
 lequel il va trouver le bon binaire :
 
 <div lang="en-US">
-```
-    42sh$ docker run -d -p 80:80 youp0m /srv/youp0m -bind :80
+```bash
+docker run -d -p 80:80 youp0m /srv/youp0m -bind :80
 ```
 </div>
 
-Essayez les deux commandes, si vous avez utilisé l'instruction `CMD` dans votre
-`Dockerfile` jusqu'à présent, vous devez vous trouver dans le deuxième cas.
+Essayez les deux commandes, si vous avez utilisé l'instruction
+`CMD`{.dockerfile} dans votre `Dockerfile` jusqu'à présent, vous devez vous
+trouver dans le deuxième cas.
 
 Pour améliorer la situation, définissez
-l'[`ENTRYPOINT`](https://docs.docker.com/engine/reference/builder/#entrypoint)
+l'[`ENTRYPOINT`{.dockerfile}](https://docs.docker.com/engine/reference/builder/#entrypoint)
 de votre image sur le binaire `/srv/youp0m`.
 
 
@@ -43,26 +44,27 @@ Notre but, dans cette partie, sera de créer un utilisateur administrateur
 (pouvant passer le contrôle d'accès <http://localhost:8080/admin/>) :
 
 <div lang="en-US">
-```
-    42sh$ docker run -i --rm -p 8080:8080 -e YOUP0M_PASSWORD=admin youp0m
+```bash
+docker run -i --rm -p 8080:8080 -e YOUP0M_PASSWORD=admin youp0m
 ```
 </div>
 
 ### Bases du script
 
-Notre script d'`ENTRYPOINT` sera appelé avec en argument, ceux passés par
-l'utilisateur après le nom de l'image, ou, à défaut, le contenu de `CMD`.
+Notre script d'`ENTRYPOINT`{.dockerfile} sera appelé avec en argument, ceux
+passés par l'utilisateur après le nom de l'image, ou, à défaut, le contenu de
+`CMD`.
 
-C'est donc l'`ENTRYPOINT` qui est responsable de la bonne utilisation de
-ceux-ci, de leur modification, ...
+C'est donc l'`ENTRYPOINT`{.dockerfile} qui est responsable de la bonne
+utilisation de ceux-ci, de leur modification, ...
 
-À la fin d'un script d'`ENTRYPOINT`, afin de garder comme premier processus du
-conteneur le programme qui nous intéresse, on réalise un `execve(2)`, sans
-`fork(2)` :
+À la fin d'un script d'`ENTRYPOINT`{.dockerfile}, afin de garder comme premier
+processus du conteneur le programme qui nous intéresse, on réalise un
+`execve(2)`, sans `fork(2)` :
 
 <div lang="en-US">
-```shell
-    exec /srv/youp0m $@
+```bash
+exec /srv/youp0m $@
 ```
 </div>
 
@@ -70,8 +72,8 @@ Dans cet exemple : `exec` est la commande interne à notre shell pour lui
 indiquer de remplacer son fil d'exécution par cette commande (sans `exec`, il
 va `fork(2)` avant). `$@` est ici pour transmettre tel quel la liste des
 arguments passés au script (il s'agit de ceux donnés par l'utilisateur, sur la
-ligne de commande du `run`, ou du contenu de `CMD` si l'utilisateur n'a rien
-précisé).
+ligne de commande du `run`, ou du contenu de `CMD`{.dockerfile} si
+l'utilisateur n'a rien précisé).
 
 
 ### Format du fichier `htpasswd`
@@ -80,12 +82,12 @@ Le format attendu est celui d'un fichier `htpasswd` typique d'Apache. Vous
 pourriez obtenir un fichier valide avec :
 
 <div lang="en-US">
-```shell
-    (
-    	echo -n "$YOUP0M_USERNAME"
-	    echo -n ":"
-	    openssl passwd -crypt "$YOUP0M_PASSWORD"
-    ) > myhtpasswd
+```bash
+(
+	echo -n "$YOUP0M_USERNAME"
+    echo -n ":"
+    openssl passwd -crypt "$YOUP0M_PASSWORD"
+) > myhtpasswd
 ```
 </div>
 
@@ -93,22 +95,23 @@ Il faut ensuite passer le fichier sur la ligne de commande grâce à l'option
 `-htpasswd`.
 
 
-### Exercice
+### Exercice  {-}
 
-Écrivez un script d'`ENTRYPOINT`, analysant les variables d'environnement, à la
-recherche de `YOUP0M_USERNAME` et `YOUP0M_PASSWORD` pour initialiser le fichier
-`.htpasswd` qui sera ajouté à la liste des arguments à passer au service.
+Écrivez un script d'`ENTRYPOINT`{.dockerfile}, analysant les variables
+d'environnement, à la recherche de `YOUP0M_USERNAME` et `YOUP0M_PASSWORD` pour
+initialiser le fichier `.htpasswd` qui sera ajouté à la liste des arguments à
+passer au service.
 
 Par exemple :
 
 <div lang="en-US">
 ```
-  42sh$ docker run -d -p 8081:8081 -e YOUP0M_USERNAME=admin -e YOUP0M_PASSWORD=admin youp0m -bind=:8081
+42sh$ docker run -d -p 8081:8081 -e YOUP0M_USERNAME=admin -e YOUP0M_PASSWORD=admin youp0m -bind=:8081
 
-  42sh$ curl -u admin:badpasswd http://localhost:8081/admin/
-  You are not allowed to perform this request.
+42sh$ curl -u admin:badpasswd http://localhost:8081/admin/
+You are not allowed to perform this request.
 
-  42sh$ curl -u admin:admin http://localhost:8081/admin/
-  <!DOCTYPE html>
+42sh$ curl -u admin:admin http://localhost:8081/admin/
+<!DOCTYPE html>
 ```
 </div>