Merge pull request #1 from YunoHost/grav

Grav

config/themes/yunohost-docs.yaml

@@ -1,11 +1,17 @@
+streams:
+  schemes:
+    theme:
+      type: ReadOnlyStream
+      prefixes:
+        '': [user/themes/yunohost-docs, user/themes/learn4]
 enabled: true
 production-mode: false
 grid-size: grid-xl
 github:
   note: false
   link: true
-  tree: https://github.com/yunohost/doc/blob/grav/
+  tree: 'https://github.com/yunohost/doc/blob/grav/'
-  commits: https://github.com/yunohost/doc/commits/grav/
+  commits: 'https://github.com/yunohost/doc/commits/grav/'
 spectre:
   exp: false
   icons: false

pages/01.administrate/01.selfhosting/01.whatisyunohost/whatsyunohost.md

@@ -52,6 +52,6 @@ You can host your friends, your family and your company safely and with ease, bu
 Black and white YunoHost PNG logo by ToZz (400 × 400 px):
 
 [![](image://ynh_logo_black_300dpi.png?resize=220)](image://ynh_logo_black_300dpi.png)
-[![](image://ynh_logo_white_300dpi.png?resize=220)](image://ynh_logo_white_300dpi.png)
+[![](image://ynh_logo_white_300dpi.png?resize=220&id=whitelogo)](image://ynh_logo_white_300dpi.png)
 
 Licence: CC-BY-SA 4.0

pages/01.administrate/01.selfhosting/02.tryyunohost/try.md

@@ -11,13 +11,14 @@ routes:
 
 [center]
 [columns]
-[<i class="fa fa-user"></i> User interface](https://demo.yunohost.org/?target=_blank&classes=btn,btn-lg,btn-success)  
+[[fa=user /] User interface](https://demo.yunohost.org/?target=_blank&classes=btn,btn-lg,btn-success)  
 Username: demo  
 Password: demo
 
-[<i class="fa fa-user"></i> Administration interface](https://demo.yunohost.org/yunohost/admin?target=_blank&classes=btn,btn-lg,btn-primary)  
+[[fa=cog /] Administration interface](https://demo.yunohost.org/yunohost/admin/?target=_blank&classes=btn,btn-lg,btn-primary)  
-Password: demo</p>
+Password: demo
+
 [/columns]
 [/center]
 
-!!! **Demo server gracefully provided by [Gitoyen](https://www.gitoyen.net?target=_blank)**
+!!!! **Demo server gracefully provided by [Gitoyen](https://www.gitoyen.net?target=_blank) [fa=heart /]**

pages/01.administrate/01.selfhosting/03.howtohostyourself/howtohostyourself.md

@@ -14,7 +14,7 @@ You can host yourself at home (on a small computer), or on a remote server. Each
 You can host yourself at home with an ARM board or a re-purposed regular computer, connected to your home router/box. 
 
 - **Pros**  : you will have physical control of the machine and only need to buy the hardware;
-- **Cons**  : you will have to [manually configure your internet box](/administrate/postinstall/ispbox) and [might be limited by your ISP](/administrate/advance/isp).
+- **Cons**  : you will have to [manually configure your internet box](/isp_box_config) and [might be limited by your ISP](/isp).
 
 ### At home, behind a VPN
 

pages/01.administrate/02.install/install.ar.md

@@ -18,56 +18,60 @@ routes:
 
 ## التجريب
 
-[columns][center]
+[div class="flex-container"]
 
-[[figure caption="الخادوم التجريبي"]![](image://logo.png?resize=150&class=inline)[/figure]](/try)
+[div class="flex-child"]
+[[figure caption="الخادوم التجريبي"]![](image://logo.png?height=150)[/figure]](/try)
+[/div]
 
-[[figure caption="التجريب على خادوم إفتراضي"]
+[div class="flex-child"]
-![](image://virtualbox.png?resize=150&class=inline)
+[[figure caption="التجريب على خادوم إفتراضي"]![](image://virtualbox.png?height=150)[/figure]](/install_on_virtualbox)
-[/figure]](/install_on_virtualbox)
+[/div]
 
-[/center][/columns]
+[/div]
 
 ## عملية النتصيب في المنزل
 
-[columns count=3][center]
+[div class="flex-container"]
 
-[[figure class="nomargin" caption="على راسبيري باي"]
+[div class="flex-child"]
-![](image://raspberrypi.jpg?resize=150,150)
+[[figure caption="على راسبيري باي"]![](image://raspberrypi.jpg?height=150)[/figure]](/install_on_raspberry)
-[/figure]](/install_on_raspberry)
+[/div]
-  
-[[figure class="nomargin" caption="على بطاقة أي أر آم ARM"]
-![](image://olinuxino.jpg?resize=150,150)
-[/figure]](/install_on_arm_board)
-  
-[[figure class="nomargin" caption="على حاسوب عادي"]
-![](image://computer.png?resize=150,150)
-[/figure]](/install_iso)
 
-[/center][/columns]
+[div class="flex-child"]
+[[figure caption="على بطاقة أي أر آم ARM"]![](image://olinuxino.jpg?height=150)[/figure]](/install_on_arm_board)
+[/div]
+
+[div class="flex-child"]
+[[figure caption="على حاسوب عادي"]![](image://computer.png?height=150)[/figure]](/install_iso)
+[/div]
+
+[/div]
 
 ## التنصيب عن بُعد
 
 !!! [fa=fa-heart /] بإِمكانْ جمعيات مُزَوِّدي الإنترنت القريبة منكم أن تُوفّر لكم *خادوماً إفتراضياً خاصاً* (VPS) ، خادوم يُديره بشرٌ و يحترمُ قيمةَ المُستخدِمين و [حِياديّةَ الإنترنت](https://en.wikipedia.org/wiki/Net_neutrality) ! إطّلعوا على [هذه الصفحة](https://db.ffdn.org/) للمزيد مِن المعلومات.
 
-[center]
+[div class="flex-container"]
 
-[[figure class="nomargin" caption="على خادوم مُستضاف أو خادوم إفتراضي خاص (VPS)"]
+[div class="flex-child"]
-![](image://vps.png?resize=150,150)
-[/figure]](/install_on_vps)
 
-[/center]
+[[figure caption="على خادوم مُستضاف أو خادوم إفتراضي خاص (VPS)"]![](image://vps.png?height=150)[/figure]](/install_on_vps)
+
+[/div]
+
+[/div]
 
 ## طُرُق مُتَقدِّمة / أخرى
 
-[columns count=2][center]
+[div class="flex-container"]
 
-[[figure class="nomargin" caption="على ديبيان 9 / ستريتش"]
+[div class="flex-child"]
-![](image://debian-logo.png?resize=150,150)
+[[figure caption="على ديبيان 9 / ستريتش"]![](image://debian-logo.png?height=150)[/figure]](/install_on_debian)
-[/figure]](/install_on_debian)
+[/div]
 
-[[figure class="nomargin" caption="Dev environment in LXD/LXC"]
+[div class="flex-child"]
-![](image://lxc.png?resize=150,150)
+[[figure caption="Dev environment in LXD/LXC"]![](image://lxc.png?height=150)[/figure]](/dev)
-[/figure]](/dev)
+[/div]
 
-[/center][/columns]
+[/div]

pages/01.administrate/02.install/install.es.md

@@ -15,56 +15,60 @@ Esta página enumera varios tipos de instalaciones, clasificados por categorías
 
 ## Probar
 
-[columns][center]
+[div class="flex-container"]
 
-[[figure caption="Servidor de demo"]![](image://logo.png?resize=150&class=inline)[/figure]](/try)
+[div class="flex-child"]
+[[figure caption="Servidor de demo"]![](image://logo.png?height=150)[/figure]](/try)
+[/div]
 
-[[figure caption="Probar en una máquina virtual"]
+[div class="flex-child"]
-![](image://virtualbox.png?resize=150&class=inline)
+[[figure caption="Probar en una máquina virtual"]![](image://virtualbox.png?height=150)[/figure]](/install_on_virtualbox)
-[/figure]](/install_on_virtualbox)
+[/div]
 
-[/center][/columns]
+[/div]
 
 ## Instalar en casa
 
-[columns count=3][center]
+[div class="flex-container"]
 
-[[figure class="nomargin" caption="En un Raspberry Pi"]
+[div class="flex-child"]
-![](image://raspberrypi.jpg?resize=150,150)
+[[figure caption="En un Raspberry Pi"]![](image://raspberrypi.jpg?height=150)[/figure]](/install_on_raspberry)
-[/figure]](/install_on_raspberry)
+[/div]
-  
-[[figure class="nomargin" caption="En un ARM board"]
-![](image://olinuxino.jpg?resize=150,150)
-[/figure]](/install_on_arm_board)
-  
-[[figure class="nomargin" caption="En un ordenador estándar"]
-![](image://computer.png?resize=150,150)
-[/figure]](/install_iso)
 
-[/center][/columns]
+[div class="flex-child"]
+[[figure caption="En un ARM board"]![](image://olinuxino.jpg?height=150)[/figure]](/install_on_arm_board)
+[/div]
+
+[div class="flex-child"]
+[[figure caption="En un ordenador estándar"]![](image://computer.png?height=150)[/figure]](/install_iso)
+[/div]
+
+[/div]
 
 ## Instalación remota
 
 !!! [fa=fa-heart /] Proveedores de Internet asociativos cerna de ti pueden proponerte un *Servidor Virtual Privado* (VPS), administrado por humanos que respetan los usuarios y la [Neutralitad de Internet](https://es.wikipedia.org/wiki/Neutralidad_de_red) ! Ver [esta página](https://db.ffdn.org/) por mas informaciones.
 
-[center]
+[div class="flex-container"]
 
-[[figure class="nomargin" caption="En un servidor dedicado o virtual (VPS)"]
+[div class="flex-child"]
-![](image://vps.png?resize=150,150)
-[/figure]](/install_on_vps)
 
-[/center]
+[[figure caption="En un servidor dedicado o virtual (VPS)"]![](image://vps.png?height=150)[/figure]](/install_on_vps)
+
+[/div]
+
+[/div]
 
 ## Avanzado / otros
 
-[columns count=2][center]
+[div class="flex-container"]
 
-[[figure class="nomargin" caption="Sur Debian 10/Buster"]
+[div class="flex-child"]
-![](image://debian-logo.png?resize=150,150)
+[[figure caption="Sur Debian 10/Buster"]![](image://debian-logo.png?height=150)[/figure]](/install_on_debian)
-[/figure]](/install_on_debian)
+[/div]
 
-[[figure class="nomargin" caption="Dev environment in LXD/LXC"]
+[div class="flex-child"]
-![](image://lxc.png?resize=150,150)
+[[figure caption="Dev environment in LXD/LXC"]![](image://lxc.png?height=150)[/figure]](/dev)
-[/figure]](/dev)
+[/div]
 
-[/center][/columns]
+[/div]

pages/01.administrate/02.install/install.fr.md

@@ -15,60 +15,64 @@ Cette page liste plusieurs types d’installations, classés par catégories.
 
 ## Essayer
 
-[columns][center]
+[div class="flex-container"]
 
-[[figure caption="Serveur de démo"]![](image://logo.png?resize=150&class=inline)[/figure]](/try)
+[div class="flex-child"]
+[[figure caption="Serveur de démo"]![](image://logo.png?height=150)[/figure]](/try)
+[/div]
 
-[[figure caption="Essayer dans une machine virtuelle"]
+[div class="flex-child"]
-![](image://virtualbox.png?resize=150&class=inline)
+[[figure caption="Essayer dans une machine virtuelle"]![](image://virtualbox.png?height=150)[/figure]](/install_on_virtualbox)
-[/figure]](/install_on_virtualbox)
+[/div]
 
-[/center][/columns]
+[/div]
 
 ## Installer à la maison
 
-[columns count=3][center]
+[div class="flex-container"]
 
-[[figure class="nomargin" caption="Sur un Raspberry Pi"]
+[div class="flex-child"]
-![](image://raspberrypi.jpg?resize=150,150)
+[[figure caption="Sur un Raspberry Pi"]![](image://raspberrypi.jpg?height=150)[/figure]](/install_on_raspberry)
-[/figure]](/install_on_raspberry)
+[/div]
-  
-[[figure class="nomargin" caption="Sur une carte ARM"]
-![](image://olinuxino.jpg?resize=150,150)
-[/figure]](/install_on_arm_board)
-  
-[[figure class="nomargin" caption="Sur un ordinateur standard"]
-![](image://computer.png?resize=150,150)
-[/figure]](/install_iso)
 
-[/center][/columns]
+[div class="flex-child"]
+[[figure caption="Sur une carte ARM"]![](image://olinuxino.jpg?height=150)[/figure]](/install_on_arm_board)
+[/div]
+
+[div class="flex-child"]
+[[figure caption="Sur un ordinateur standard"]![](image://computer.png?height=150)[/figure]](/install_iso)
+[/div]
+
+[/div]
 
 ## Installer à distance
 
 !!! [fa=fa-heart /] Des FAI associatifs près de chez vous sont peut-être capable de vous fournir un *Serveur Privé Virtuel* (VPS), géré par des humains qui respectent les utilisateurs et la [Neutralité du Net](https://fr.wikipedia.org/wiki/Neutralit%C3%A9_du_r%C3%A9seau) ! Voir [cette page](https://db.ffdn.org/) pour plus d'informations.
 
-[center]
+[div class="flex-container"]
 
-[[figure class="nomargin" caption="Sur un serveur dédié ou virtuel (VPS)"]
+[div class="flex-child"]
-![](image://vps.png?resize=150,150)
-[/figure]](/install_on_vps)
 
-[/center]
+[[figure caption="Sur un serveur dédié ou virtuel (VPS)"]![](image://vps.png?height=150)[/figure]](/install_on_vps)
+
+[/div]
+
+[/div]
 
 ## Avancé / autres
 
-[columns count=3][center]
+[div class="flex-container"]
 
-[[figure class="nomargin" caption="Sur Debian 10/Buster"]
+[div class="flex-child"]
-![](image://debian-logo.png?resize=150,150)
+[[figure caption="Sur Debian 10/Buster"]![](image://debian-logo.png?height=150)[/figure]](/install_on_debian)
-[/figure]](/install_on_debian)
+[/div]
 
-[[figure class="nomargin" caption="Environnement de dev avec LXD/LXC"]
+[div class="flex-child"]
-![](image://lxc.png?resize=150,150)
+[[figure caption="Environnement de dev avec LXD/LXC"]![](image://lxc.png?height=150)[/figure]](/dev)
-[/figure]](/dev)
+[/div]
 
-[[figure class="nomargin" caption="(Non-officiel !) Images docker"]
+[div class="flex-child"]
-![](image://docker.png?resize=150,150)
+[[figure caption="(Non-officiel !) Images docker"]![](image://docker.png?height=150)[/figure]](/docker)
-[/figure]](/docker)
+[/div]
 
-[/center][/columns]
+[/div]

pages/01.administrate/02.install/install.it.md

@@ -16,56 +16,60 @@ Questa pagina elenca alcune guide all'installazione.
 
 ## Provalo
 
-[columns][center]
+[div class="flex-container"]
 
-[[figure caption="Server demo"]![](image://logo.png?resize=150&class=inline)[/figure]](/try)
+[div class="flex-child"]
+[[figure caption="Server demo"]![](image://logo.png?height=150)[/figure]](/try)
+[/div]
 
-[[figure caption="Provalo in VirtualBox"]
+[div class="flex-child"]
-![](image://virtualbox.png?resize=150&class=inline)
+[[figure caption="Provalo in VirtualBox"]![](image://virtualbox.png?height=150)[/figure]](/install_on_virtualbox)
-[/figure]](/install_on_virtualbox)
+[/div]
 
-[/center][/columns]
+[/div]
 
 ## Installalo a casa
 
-[columns count=3][center]
+[div class="flex-container"]
 
-[[figure class="nomargin" caption="Su un Raspberry Pi"]
+[div class="flex-child"]
-![](image://raspberrypi.jpg?resize=150,150)
+[[figure caption="Su un Raspberry Pi"]![](image://raspberrypi.jpg?height=150)[/figure]](/install_on_raspberry)
-[/figure]](/install_on_raspberry)
+[/div]
-  
-[[figure class="nomargin" caption="Su una scheda ARM"]
-![](image://olinuxino.jpg?resize=150,150)
-[/figure]](/install_on_arm_board)
-  
-[[figure class="nomargin" caption="Su un computer normale"]
-![](image://computer.png?resize=150,150)
-[/figure]](/install_iso)
 
-[/center][/columns]
+[div class="flex-child"]
+[[figure caption="Su una scheda ARM"]![](image://olinuxino.jpg?height=150)[/figure]](/install_on_arm_board)
+[/div]
+
+[div class="flex-child"]
+[[figure caption="Su un computer normale"]![](image://computer.png?height=150)[/figure]](/install_iso)
+[/div]
+
+[/div]
 
 ## Installalo su un server remoto
 
 !!! [fa=fa-heart /] ISP locali potrebbero essere in grado di fornire un *Server Privato Vrituale* (VPS), gesito da esseri umani che rispettano gli utenti e si preoccupano della [Net Neutrality](https://en.wikipedia.org/wiki/Net_neutrality) ! Guarda [questa pagina](https://db.ffdn.org/) per maggiori informazioni.
 
-[center]
+[div class="flex-container"]
 
-[[figure class="nomargin" caption="Su un server dedicato o un server privato virtuale (VPS)"]
+[div class="flex-child"]
-![](image://vps.png?resize=150,150)
-[/figure]](/install_on_vps)
 
-[/center]
+[[figure caption="Su un server dedicato o un server privato virtuale (VPS)"]![](image://vps.png?height=150)[/figure]](/install_on_vps)
+
+[/div]
+
+[/div]
 
 ## Avanzate / altri
 
-[columns count=2][center]
+[div class="flex-container"]
 
-[[figure class="nomargin" caption="Su Debian 10/Buster"]
+[div class="flex-child"]
-![](image://debian-logo.png?resize=150,150)
+[[figure caption="Su Debian 10/Buster"]![](image://debian-logo.png?height=150)[/figure]](/install_on_debian)
-[/figure]](/install_on_debian)
+[/div]
 
-[[figure class="nomargin" caption="Dev environment in LXD/LXC"]
+[div class="flex-child"]
-![](image://lxc.png?resize=150,150)
+[[figure caption="Dev environment in LXD/LXC"]![](image://lxc.png?height=150)[/figure]](/dev)
-[/figure]](/dev)
+[/div]
 
-[/center][/columns]
+[/div]

pages/01.administrate/02.install/install.md

@@ -13,60 +13,64 @@ This page lists a few installation guides.
 
 ## Give it a try
 
-[columns][center]
+[div class="flex-container"]
 
-[[figure caption="Demo server"]![](image://logo.png?resize=150&class=inline)[/figure]](/try)
+[div class="flex-child"]
+[[figure caption="Demo server"]![](image://logo.png?height=150)[/figure]](/try)
+[/div]
 
-[[figure caption="Try with VirtualBox"]
+[div class="flex-child"]
-![](image://virtualbox.png?resize=150&class=inline)
+[[figure caption="Try with VirtualBox"]![](image://virtualbox.png?height=150)[/figure]](/install_on_virtualbox)
-[/figure]](/install_on_virtualbox)
+[/div]
 
-[/center][/columns]
+[/div]
 
 ## Install at home
 
-[columns count=3][center]
+[div class="flex-container"]
 
-[[figure class="nomargin" caption="On a Raspberry Pi"]
+[div class="flex-child"]
-![](image://raspberrypi.jpg?resize=150,150)
+[[figure caption="On a Raspberry Pi"]![](image://raspberrypi.jpg?height=150)[/figure]](/install_on_raspberry)
-[/figure]](/install_on_raspberry)
+[/div]
-  
-[[figure class="nomargin" caption="On an ARM board"]
-![](image://olinuxino.jpg?resize=150,150)
-[/figure]](/install_on_arm_board)
-  
-[[figure class="nomargin" caption="On a regular computer"]
-![](image://computer.png?resize=150,150)
-[/figure]](/install_iso)
 
-[/center][/columns]
+[div class="flex-child"]
+[[figure caption="On an ARM board"]![](image://olinuxino.jpg?height=150)[/figure]](/install_on_arm_board)
+[/div]
+
+[div class="flex-child"]
+[[figure caption="On a regular computer"]![](image://computer.png?height=150)[/figure]](/install_iso)
+[/div]
+
+[/div]
 
 ## Install on a remote server
 
 !!! [fa=fa-heart /] Local associative ISP near you might be able to provide you with a *Virtual Private Server* (VPS), managed by human beings who respect users and care about [Net Neutrality](https://en.wikipedia.org/wiki/Net_neutrality) ! Check out [this page](https://db.ffdn.org/) for more information.
 
-[center]
+[div class="flex-container"]
 
-[[figure class="nomargin" caption="On a dedicated or virtual private server"]
+[div class="flex-child"]
-![](image://vps.png?resize=150,150)
-[/figure]](/install_on_vps)
 
-[/center]
+[[figure caption="On a dedicated or virtual private server"]![](image://vps.png?height=150)[/figure]](/install_on_vps)
+
+[/div]
+
+[/div]
 
 ## Advanced / others
 
-[columns count=3][center]
+[div class="flex-container"]
 
-[[figure class="nomargin" caption="On Debian 10 Buster"]
+[div class="flex-child"]
-![](image://debian-logo.png?resize=150,150)
+[[figure caption="On Debian 10 Buster"]![](image://debian-logo.png?height=150)[/figure]](/install_on_debian)
-[/figure]](/install_on_debian)
+[/div]
 
-[[figure class="nomargin" caption="Dev environment in LXD/LXC"]
+[div class="flex-child"]
-![](image://lxc.png?resize=150,150)
+[[figure caption="Dev environment in LXD/LXC"]![](image://lxc.png?height=150)[/figure]](/dev)
-[/figure]](/dev)
+[/div]
 
-[[figure class="nomargin" caption="(Non-official!) Docker images"]
+[div class="flex-child"]
-![](image://docker.png?resize=150,150)
+[[figure caption="(Non-official!) Docker images"]![](image://docker.png?height=150)[/figure]](/docker)
-[/figure]](/docker)
+[/div]
 
-[/center][/columns]
+[/div]

pages/01.administrate/03.postinstall/01.isp_box_config/isp_box_config.es.md

@@ -5,9 +5,17 @@ taxonomy:
     category: docs
 routes:
   default: '/isp_box_config'
+  aliases:
+    - '/port_forwarding'
 ---
 
-Si te estás auto-alojando en casa y sin VPN, tienes que redirigirse los puertos de tu router (caja/box). Si quieres una explicación sencilla de lo que es y por qué necesitas redirigir los puertos, puedes echar un vistazo a [esta página](/port_forwarding). [Esta página](https://www.testdevelocidad.es/configuraciones/abrir-correctamente-los-puertos-router/) también propone explicaciones detalladas sobre el funcionamiento de los puertos, y las etapas de configuración para un router genérico.
+Si te estás auto-alojando en casa y sin VPN, tienes que redirigirse los puertos de tu router (caja/box).
+
+El esquema aquí abajo intenta explicar brevemente el rol de la redirección de los puertos durante la instalación de un servidor en tu casa.
+
+[figure caption="Ilustración de la importancia del redirección de puertos"]![](image://portForwarding_en.png)[/figure]
+
+[Esta página](https://www.testdevelocidad.es/configuraciones/abrir-correctamente-los-puertos-router/) también propone explicaciones detalladas sobre el funcionamiento de los puertos, y las etapas de configuración para un router genérico.
 
 ### 0. Diagnosticar los puertos abiertos
 

pages/01.administrate/03.postinstall/01.isp_box_config/isp_box_config.fr.md

@@ -5,9 +5,15 @@ taxonomy:
     category: docs
 routes:
   default: '/isp_box_config'
+  aliases:
+    - '/port_forwarding'
 ---
 
-Si vous vous auto-hébergez à la maison et sans VPN, il vous faut rediriger les ports de votre routeur ("machin-box"). Si vous souhaitez une explication courte de ce qu'est et pourquoi vous avez besoin de rediriger les ports, vous pouvez jeter un œil à [cette page-ci](/port_forwarding). [Cette page-là](https://craym.eu/tutoriels/utilitaires/ouvrir_les_ports_de_sa_box.html) propose également des explications détaillées sur le fonctionnement des ports, et les étapes de configuration pour différents routeurs.
+Si vous vous auto-hébergez à la maison et sans VPN, il vous faut rediriger les ports de votre routeur ("machin-box"). Le schéma ci-dessous tente d'expliquer brièvement le rôle de la redirection des ports lors de la mise en place d'un serveur à la maison.
+
+[figure caption="Illustration de l'importance de la redirection des ports"]![](image://portForwarding_fr.png)[/figure]
+
+[Cette page](https://craym.eu/tutoriels/utilitaires/ouvrir_les_ports_de_sa_box.html) propose également des explications détaillées sur le fonctionnement des ports, et les étapes de configuration pour différents routeurs
 
 ### 0. Diagnostiquer les ports ouverts
 

pages/01.administrate/03.postinstall/01.isp_box_config/isp_box_config.md

@@ -5,9 +5,13 @@ taxonomy:
     category: docs
 routes:
   default: '/isp_box_config'
+  aliases:
+    - '/port_forwarding'
 ---
 
-If you are self-hosting at home and without a VPN, you need to forward ports on your home router ("Internet box"). If you want a short explanation on what is and why you need port forwarding, have a look to [this page](/port_forwarding).
+If you are self-hosting at home and without a VPN, you need to forward ports on your home router ("Internet box"). The sketch below tries to briefly summarize the role and necessity of port forwarding when setting up a server at home.
+
+[figure caption="Illustration of the importance of port-forwarding"]![](image://portForwarding_en.png)[/figure]
 
 ### 0. Diagnose ports opened
 
@@ -16,7 +20,7 @@ correctly exposed.
 
 ### 1. Access your box/router administration interface
 
-Your box/router admin interface is usually reachable via http://192.168.0.1 or http://192.168.1.1. Then, you will probably need to authenticate yourself with your internet server provider's credentials.
+Your box/router admin interface is usually reachable via [http://192.168.0.1](http://192.168.0.1) or [http://192.168.1.1](http://192.168.1.1). Then, you will probably need to authenticate yourself the credentials given by your internet server provider.
 
 ### 2. Find the local IP of your server
 

pages/01.administrate/03.postinstall/01.ispbox/01.post_forwarding/port_forwarding.es.md

@@ -1,12 +0,0 @@
----
-title: Redirección de puertos
-template: docs
-taxonomy:
-    category: docs
-routes:
-  default: '/port_forwarding'
----
-
-El esquema aquí abajo intenta explicar brevemente el rol de la redirección de los puertos durante la instalación de un servidor en tu casa.
-
-![](image://portForwarding_en.png)

pages/01.administrate/03.postinstall/01.ispbox/01.post_forwarding/port_forwarding.fr.md

@@ -1,13 +0,0 @@
----
-title: Redirection de ports
-template: docs
-taxonomy:
-    category: docs
-routes:
-  default: '/port_forwarding'
----
-
-Le schéma ci-dessous tente d'expliquer brièvement le rôle de la redirection des
-ports lors de la mise en place d'un serveur à la maison.
-
-![](image://portForwarding_fr.png)

pages/01.administrate/03.postinstall/01.ispbox/01.post_forwarding/port_forwarding.md

@@ -1,13 +0,0 @@
----
-title: Port forwarding
-template: docs
-taxonomy:
-    category: docs
-routes:
-  default: '/port_forwarding'
----
-
-The sketch below tries to briefly summarize the role and necessity of port
-forwarding when setting up a server at home.
-
-![](image://portForwarding_en.png)

pages/01.administrate/03.postinstall/postinstall.md

@@ -9,7 +9,7 @@ routes:
 
 The step called "**post-installation**" is actually the initial configuration of YunoHost. It has to be done just after the installation of the system itself.
 
-NB: if you are in the process of restoring a server from scratch **and** you have a yunohost-made backup, you can skip this process and follow through with the "restoring during the postinstall" step, in the [backup](/backup) page.
+! If you are in the process of restoring a server from scratch **and** you have a yunohost-made backup, you can skip this process and follow through with the "restoring during the postinstall" step, in the [backup](/backup) page.
 
 ### From the web interface
 
@@ -21,21 +21,16 @@ During the first visit, you will very likely encounter a security warning relate
 
 You should then land on this page :
 
-![](image://postinstall_web.png)
+[figure caption="Preview of the Web post-installation"]![](image://postinstall_web.png)[/figure]
-
-<em><p class="text-muted">Preview of the Web post-installation</p></em>
 
 ### From the command line
 
 You can also perform the postinstallation with the command `yunohost tools postinstall` directly on the server, or [via SSH](/ssh).
 
-![](image://postinstall_cli.png)
 
-<em><p class="text-muted">Preview of the command-line post-installation</p></em>
+[figure caption="Preview of the command-line post-installation"]![](image://postinstall_cli.png)[/figure]
 
-<br>
+## Asked information
-
-## Informations asked
 
 ### Main domain
 

pages/01.administrate/04.learn/12.security/security.md

@@ -15,16 +15,16 @@ Two things remain important to note:
 
 * The fact that YunoHost is a well-spread software increases the chances of an attack. If a flaw is discovered, it could potentially affect all the YunoHost instances at once. Keep your system **up-to-date** to remain safe.
 
-*If you need advice, do not hesitate to [ask us](/help).*
+!!!! If you need advice, do not hesitate to [ask us](/help).
 
-*To discuss security flaws, contact the [YunoHost security team](/security_team).*
+!! [fa=shield /] To discuss security flaws, contact the [YunoHost security team](/security_team).
 
 ---
 
 ## Improve security
 If your YunoHost server is used in a critical production environment, or if you want to improve its safety, you may want to follow those good practices.
 
-**Attention:** *Following those instructions requires advanced knowledge of system administration.*
+! **Attention:** Following those instructions requires advanced knowledge of system administration.
 
 ### SSH authentication via key
 By default, the SSH authentication uses the administration password. Deactivating this kind of authentication and replacing it by a key mechanism is advised.

pages/01.administrate/04.learn/13.permissions/groups_and_permissions.md

@@ -176,7 +176,7 @@ $ yunohost user permission update mail --remove all_users --add bob
 
 Note that some permissions may be "protected", meaning that you won't be able to add/remove the visitor group to this permission. Generally, this is because it would make no sense (or is a security risk) to do so.
 
-The webadmin will issue a warning if you set a permission that is superseeded by a wider permission.
+The webadmin will issue a warning if you set a permission that is superseded by a wider permission.
 
 ![](image://groups_alerte-permission.png)
 

pages/01.administrate/05.specific_use_cases/01.domains/01.dns_nohost_me/dns_nohost_me.md

@@ -4,7 +4,7 @@ template: docs
 taxonomy:
     category: docs
 routes:
-  default: '/dns_nohost'
+  default: '/dns_nohost_me'
 ---
 
 In order to make self-hosting as accessible as possible, the YunoHost Project provides a *free* and *automatically configured* domain name service. By using this service, you won't have to [configure DNS records](/dns_config) yourself, which can be tedious and technical.
@@ -16,7 +16,7 @@ The following (sub)domains are proposed:
 
 To use this service, you simply have to choose such a domain during the post-installation. It will then be automatically configured by YunoHost!
 
-N.B.: As a fairness measure, each instance may only have **one such domain** setup at any given time.
+!!! As a fairness measure, each instance may only have **one such domain** setup at any given time.
 
 ### Subdomains
 
@@ -56,8 +56,7 @@ If you reinstall your server and want to use a domain already used previously, y
 
 If you wish to use a different automatic domain, you first have to remove your present domain registration. This is done in 3 steps:
 
-1. Remove the domain from your instance (via webadmin or the `yunohost domain remove` CLI). 
+1. Remove the domain from your instance (via webadmin or the `yunohost domain remove` in the CLI). 
-**/!\ Caution: this will remove any app installed on this domain, along with its data.**
 2. Ask for registration removal [in the dedicated forum thread](https://forum.yunohost.org/t/nohost-domain-recovery/442).
 3. Remove automatic domain configuration files on your server, via CLI only: `sudo rm /etc/cron.d/yunohost-dyndns && sudo rm -r /etc/yunohost/dyndns`
 

pages/01.administrate/05.specific_use_cases/01.domains/02.dns_dynamic_ip/dns_dynamicip.md

@@ -13,6 +13,13 @@ This tutorial aim to get around dynamic IP issue which is: when the IP public ad
 
 The method proposed here consists of automatizing the fact the box annonces its global IP adress change to the dynamic DNS, so that the DNS zone will automatically be updated.
 
+Here are some examples of registrars, companies where you can buy domain names:
+* [OVH](http://ovh.com/)
+* [GoDaddy](https://godaddy.com/)
+* [Gandi](http://gandi.net/)
+* [Namecheap](https://www.namecheap.com/)
+* [BookMyName](https://www.bookmyname.com/)
+
 If you own a domain name at **OVH**, you may go to step 4 and follow this [tutorial](/OVH), given that OVH proposes a DynDNS service.
 
 #### 1. Create an account to a Dynamic DNS service
@@ -34,7 +41,12 @@ This step consists in declaring to your [registrar](/registrar) that the DNS ser
 
 For this, fisrt declare in the NS field(s) the IP address provided by the DynDNS service.
 
-Then, remove any other item in the [DNS zones](/dns_config) (except the previous NS fields), from the [registrar](/registrar).
+Then, remove any other item in the [DNS zones](/dns_config) (except the previous NS fields), from the registrar. Here are from examples of registrars:
+* [OVH](http://ovh.com/)
+* [GoDaddy](https://godaddy.com/)
+* [Gandi](http://gandi.net/)
+* [Namecheap](https://www.namecheap.com/)
+* [BookMyName](https://www.bookmyname.com/)
 
 #### 4. Configure the client
 This client could be your ISP-box, or a package installed on your server, such as `ddclient`.

pages/01.administrate/05.specific_use_cases/05.external_storage/external_storage.md

@@ -62,7 +62,7 @@ Check with `lsblk` that your disk really does contain a single partition.
 
 Before you can use your disk it has to be formatted.
 
-You should be aware that **formating a drive implies to erasing every data on it !** If your disk is already "clean", you may ignore this step.
+! You should be aware that **formating a drive implies to erasing every data on it!** If your disk is already "clean", you may ignore this step.
 
 To format the partition :
 

pages/01.administrate/05.specific_use_cases/09.certificate_custom/certificate_custom.md

@@ -7,7 +7,7 @@ routes:
   default: '/certificate_custom'
 ---
 
-**Note:** since version 2.5, YunoHost integrates Let's Encrypt certificates automated management. You can easily and freely [install a Let's Encrypt certificate](/certificate). The following document describes the steps for installing a paid certificate from a certification authority (**Gandi**, **RapidSSL**, **StartSSL**, **Cacert**).
+! **Note:** since version 2.5, YunoHost integrates Let's Encrypt certificates automated management. You can easily and freely [install a Let's Encrypt certificate](/certificate). The following document describes the steps for installing a paid certificate from a certification authority (**Gandi**, **RapidSSL**, **StartSSL**, **Cacert**).
 
 Some changes have taken place which impact the procedures indicated below:
 

pages/01.administrate/05.specific_use_cases/11.moving_app_folder/moving_app_folder.md

@@ -9,9 +9,7 @@ routes:
 
 Applications folder are (*usually*) located in `/var/www/$appname`
 
-If an application folder is expected to get bigger because of the amount of data
+If an application folder is expected to get bigger because of the amount of data it contains, it might be relevant to move it to another storage (like an external hard drive).
-it contains, it might be relevant to move it to another storage (like an
-external hard drive).
 
 Here's a summary of how to do this the application wordpress. Here, is is assumed that
 [you already mounted the external hard-drive](/external_storage).

pages/01.administrate/05.specific_use_cases/specific_use_cases.md

@@ -0,0 +1,10 @@
+---
+title: Specific use cases
+template: docs
+taxonomy:
+    category: docs
+routes:
+  default: '/specific_use_cases'
+---
+
+In the following pages you will find tutorials for specific use cases.

themes/learn2-git-sync/CHANGELOG.md

@@ -1,8 +1,26 @@
+# v1.6.2
+## 01/26/2021
+
+1. [](#improved)
+    * Updated theme blueprints for Grav 1.7
+
+# v1.6.1
+## 01/15/2021
+
+1. [](#new)
+    * GoogleSlides shortcode updated to handle double `_` characters in URL (thanks @GeorgesPapas)
+
+# v1.6.0
+## 01/05/2021
+
+1. [](#new)
+    * Initial NextGen Editor support for GoogleSlides, H5P and PDF shortcodes
+
 # v1.5.9
 ## 05/19/2020
 
 1. [](#improved)
-    * Updated inherited theme file paths for multisite compatibility (thanks to @tituspijean for the PR!)
+    * Updated inherited theme file paths for multisite compatibility (thanks to @tituspijean for the PR and @mahagr for the debugging!)
 
 # v1.5.8
 ## 12/05/2019

themes/learn2-git-sync/blueprints.yaml

@@ -1,5 +1,7 @@
 name: Learn2 Git Sync
-version: 1.5.9
+type: theme
+slug: learn2-git-sync
+version: 1.6.2
 description: "A customized version of the Learn2 theme for use with the Learn2 with Git Sync skeleton package. Includes selectable visual styles."
 icon: git
 author:

themes/learn2-git-sync/learn2-git-sync.php

@@ -17,11 +17,29 @@ class Learn2GitSync extends Learn2
         return [
             'onTwigInitialized' => ['onTwigInitialized', 0],
             'onThemeInitialized' => ['onThemeInitialized', 0],
+            'onShortcodeHandlers' => ['onShortcodeHandlers', 0],
             'onTwigSiteVariables' => ['onTwigSiteVariables', 0],
-            'onTNTSearchIndex' => ['onTNTSearchIndex', 0]
+            'onTNTSearchIndex' => ['onTNTSearchIndex', 0],
+            'registerNextGenEditorPlugin' => ['registerNextGenEditorPluginShortcodes', 0]
         ];
     }
 
+    public function onShortcodeHandlers()
+    {
+        $this->grav['shortcode']->registerAllShortcodes('user://themes/learn2-git-sync/shortcodes');
+    }
+
+    public function registerNextGenEditorPluginShortcodes($event) {
+        $plugins = $event['plugins'];
+
+        $plugins['js'][] = 'user://themes/learn2-git-sync/nextgen-editor/shortcodes/googleslides.js';
+        $plugins['js'][] = 'user://themes/learn2-git-sync/nextgen-editor/shortcodes/h5p.js';
+        $plugins['js'][] = 'user://themes/learn2-git-sync/nextgen-editor/shortcodes/pdf.js';
+
+        $event['plugins']  = $plugins;
+        return $event;
+    }
+
     public function onTwigSiteVariables()
     {
         if ($this->isAdmin() && ($this->grav['config']->get('plugins.shortcode-core.enabled'))) {

themes/learn2-git-sync/templates/partials/search.html.twig

@@ -8,6 +8,6 @@
 {% endif %}
 {% if config.plugins.tntsearch.enabled %}
   <div class="adv-search">
-    <i class="fa fa-sliders"></i> <a href="{{ base_url_absolute }}/search">{{ 'THEME_LEARN2_ADVANCED_SEARCH'|t }}</a>
+    <i class="fa fa-sliders"></i> <a href="{{ base_url_absolute }}/tntsearch">{{ 'THEME_LEARN2_ADVANCED_SEARCH'|t }}</a>
   </div>
 {% endif %}

themes/learn2/CHANGELOG.md

@@ -1,3 +1,9 @@
+# v1.8.1
+## 01/15/2021
+
+1. [](#improved)
+    * Fixed autoescaping in preparation for Grav 1.7
+
 # v1.8.0
 ## 03/21/2019
 

themes/learn2/blueprints.yaml

@@ -1,5 +1,7 @@
 name: Learn2
-version: 1.8.0
+slug: learn2
+type: theme
+version: 1.8.1
 description: "Learn2 is a new modern documentation theme for Grav"
 icon: book
 author:

themes/learn2/templates/chapter.html.twig

@@ -3,7 +3,7 @@
 {% block content %}
 	<div id="chapter">
     	<div id="body-inner">
-			{{ page.content }}
+			{{ page.content|raw }}
 		</div>
     </div>
 {% endblock %}

themes/learn2/templates/error.html.twig

@@ -8,7 +8,7 @@
     	<div id="body-inner">
     		<h1>{{ 'PLUGIN_ERROR.ERROR'|t }} {{ header.http_response_code }}</h1>
 
-            {{ page.content }}
+            {{ page.content|raw }}
 
 		</div>
     </div>

themes/learn2/templates/partials/page.html.twig

@@ -1,6 +1,6 @@
 <div id="body-inner">
     <h1>{{ page.title }}</h1>
     <p>
-    	{{ page.content }}
+    	{{ page.content|raw }}
     </p>
 </div>

themes/learn2/templates/partials/sidebar.html.twig

@@ -62,7 +62,7 @@
                     class="fa fa-fw fa-history"></i> {{ 'THEME_LEARN2_CLEAR_HISTORY'|t }}</a><br/>
 
         <section id="footer">
-            <p>{{ 'THEME_LEARN2_BUILT_WITH_GRAV'|t }}</p>
+            <p>{{ 'THEME_LEARN2_BUILT_WITH_GRAV'|t|raw }}</p>
         </section>
     </div>
 </div>

themes/learn2/templates/search.html.twig

@@ -1,7 +1,7 @@
 {% embed 'partials/base.html.twig' with { github_link_position: false } %}
 
     {% block content %}
-        {{ page.content }}
+        {{ page.content|raw }}
 
         {% include 'partials/tntsearch.html.twig' with { in_page: true, placeholder: "Search the Grav documentation..." }%}
     {% endblock %}

themes/yunohost-docs/css/custom.css

@@ -28,6 +28,24 @@ img.center {
  margin-right: auto;
 }
 
+figure img {
+ margin: auto;
+}
+
+figure figcaption {
+ font-style: italic;
+}
+
+.flex-container {
+ display: flex;
+ justify-content: space-around;
+}
+
+.flex-child {
+ display: inline-flex;
+ text-align: center;
+}
+
 .nomargin * {
  margin: 0px auto;
 }
@@ -64,3 +82,8 @@ h1, h2, h3, h4, h5, h6 {
     font-weight: 700;
     font-style: normal;
 }
+
+img#whitelogo {
+    background-color: gray;
+    padding: 10px;
+}