tutorials: improve theme + use pandoc 2

tutorial/dockerfiles/goodpractices.md

@@ -55,10 +55,10 @@ vous codez.
 Lorsqu'une ligne devient complexe, allez à la ligne :
 
 <div lang="en-US">
-```
-    RUN apt-get update && apt-get install -y \
-           nginx \
-           php5-fpm
+```dockerfile
+RUN apt-get update && apt-get install -y \
+       nginx \
+       php5-fpm
 ```
 </div>
 
@@ -70,13 +70,13 @@ Lorsque c'est possible, ordonnez vos lignes suivant un ordre logique. Par
 exemple :
 
 <div lang="en-US">
-```
-    RUN apt-get update && apt-get install -y \
-            bzr \
-            cvs \
-            git \
-            mercurial \
-            subversion
+```dockerfile
+RUN apt-get update && apt-get install -y \
+        bzr \
+        cvs \
+        git \
+        mercurial \
+        subversion
 ```
 </div>
 
@@ -99,9 +99,9 @@ Il y a un certain nombre de règles à connaître pour bien utiliser ce mécanis
   le(s) différente(s) image(s) qui dérive(nt) de la commande précédente. Si
   aucune commande correspondante n'est trouvé, le cache se retrouve invalidé
   pour les instructions suivantes.
-- Pour les instructions `ADD` et `COPY`, en plus de la comparaison précédente,
-  la somme de contrôle du fichier est ajoutée. Si le fichier a été modifié, le
-  cache se retrouve invalidé.
+- Pour les instructions `ADD`{.dockerfile} et `COPY`{.dockerfile}, en plus de
+  la comparaison précédente, la somme de contrôle du fichier est ajoutée. Si le
+  fichier a été modifié, le cache se retrouve invalidé.
 - Une fois que le cache est invalidé, toutes les commandes restantes à exécuter
   dans le `Dockerfile` vont être exécutées.
 
@@ -132,10 +132,10 @@ lors de sa construction.
 
 ## Exposez les ports standards
 
-La commande `EXPOSE` vous permet d'indiquer les ports sur lesquels votre
-conteneur s'attend à recevoir des paquets venant de l'extérieur. Ces ports ne
-sont pas partagés avec l'hôte ou les autres conteneur, donc vous n'avez pas de
-raison de ne pas utiliser les ports standards.
+La commande `EXPOSE`{.dockerfile} vous permet d'indiquer les ports sur lesquels
+votre conteneur s'attend à recevoir des paquets venant de l'extérieur. Ces
+ports ne sont pas partagés avec l'hôte ou les autres conteneur, donc vous
+n'avez pas de raison de ne pas utiliser les ports standards.
 
 Si vous faites cela, il y a de forte chance qu'il n'y ait pas besoin de
 modifier la configuration des autres logiciels contenu dans d'autres conteneurs
@@ -154,9 +154,9 @@ L'entrypoint peut être utilisé de deux manières différentes :
   indiqué dans l'entrypoint. Par exemple pour nginx :
 
 <div lang="en-US">
-```
-    ENTRYPOINT ["nginx"]
-    CMD ["-g daemon off;"]
+```dockerfile
+ENTRYPOINT ["nginx"]
+CMD ["-g daemon off;"]
 ```
 </div>
 
@@ -166,28 +166,29 @@ L'entrypoint peut être utilisé de deux manières différentes :
   l'image de PostgreSQL possède cet entrypoint :
 
 <div lang="en-US">
-```shell
-    #!/bin/bash
-    set -e
+```bash
+#!/bin/bash
+set -e
 
-    if [ "$1" = 'postgres' ]; then
-    chown -R postgres "$PGDATA"
+if [ "$1" = 'postgres' ]; then
+chown -R postgres "$PGDATA"
 
-    if [ -z "$(ls -A "$PGDATA")" ]; then
-      gosu postgres initdb
-    fi
+if [ -z "$(ls -A "$PGDATA")" ]; then
+  gosu postgres initdb
+fi
 
-    exec gosu postgres "$@"
-    fi
+exec gosu postgres "$@"
+fi
 
-    exec "$@"
+exec "$@"
 ```
 </div>
 
 
 ## `[""]`, `'` et sans `[]`
 
-Les instructions `ENTRYPOINT` et `CMD` peuvent prendre deux formes :
+Les instructions `ENTRYPOINT`{.dockerfile} et `CMD`{.dockerfile} peuvent
+prendre deux formes :
 
 - `["cmd", "arg1", "arg2"]` : ici, un simple `exexve` sera effectué avec ces
   arguments. Si d'éventuels variables se trouve dans les arguments, elles ne
@@ -201,14 +202,14 @@ pouvez pas utiliser les simple quotes.
 
 ## Volumes
 
-L'instruction `VOLUME` doit être utilisée pour exposer tous les espaces de
-stockage de données, configuration, ...
+L'instruction `VOLUME`{.dockerfile} doit être utilisée pour exposer tous les
+espaces de stockage de données, configuration,\ ...
 
 
 ## Réduisez les privilèges
 
-Utilisez l'instruction `USER` dès que vous le pouvez, lorsqu'un service ne
-réclame pas de privilège particulier.
+Utilisez l'instruction `USER`{.dockerfile} dès que vous le pouvez, lorsqu'un
+service ne réclame pas de privilège particulier.
 
 Il vous faudra sans doute créer l'utilisateur et son groupe dans le Dockerfile.