YunoHost · Plumf · Sep 4, 2019 · Sep 4, 2019 · Sep 5, 2019 · Sep 5, 2019
diff --git a/app_jirafeau_fr.md b/app_jirafeau_fr.md
@@ -0,0 +1,66 @@
+# <img src="/images/jirafeau_logo.png" alt="logo de Jirafeau"> Jirafeau
+
+**Index**
+ - [Utilisation de Jirafeau](#UtilisationJirafeau)  
+ - [Administrer Jirafeau](#AdminJirafeau)  
+    - [Interface d'administation](#AdminPhpJirafeau)  
+    - [Modifier les paramètres de fonctionnements](#AdminParametres)  
+    - [Modifier les Conditions Générales d'Utilisations](#AdminCgu)  
+ - [Liens utiles](#LiensUtiles)
+
+[![Installer Jirafeau avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=jirafeau)
+
+Jirafeau est un service simple de partage de fichiers en un lien. Il permet de limiter la durée de la disponibilité du fichier dans le temps ou au nombre de téléchargements. Il est aussi possible de protéger l'accès au fichier avec un mot de passe. Une démonstration de la dernière version disponible est disponible ici : [jirafeau.net](https://jirafeau.net/).
+
+## Utilisation de Jirafeau <a name="UtilisationJirafeau"></a>
+
+l'utilisation de Jirafeau est simple il existe de façons pour envoyer le fichier :
+ + Il est possible de le sélectionner en cliquant sur le `+` au milieu de la page et en allant chercher le fichier concerné dans l'arborescence.  
+ + Le fichier peut être déposé par un glisser/déposer à partir de votre explorateur de fichiers.
+
+![Capture d'écran de Jirafeau](/images/app_jirafeau_capture.png)
+
+## Administrer Jirafeau <a name="AdminJirafeau"></a>
+
+### Interface d'administration <a name="AdminPhpJirafeau"></a>
+
+**Pour accéder à la page d'administration vous devez être connecté avec le compte administrateur déclaré lors de l'installation de l'application Jirafeau sur votre serveur**
+L'interface d'administration de Jirafeau est disponible en allant sur la page : `https://nom.domaine.tld/service/admin.php`
+
+### Modifier les paramètres de fonctionnement <a name="AdminParametres"></a>
+
+**Pour modifier les paramètres il faut être connecté en `root` à l'aide d'un terminal.**
+Le fichier de configuration se trouve ici : `/var/www/jirafeau/lib/`  
+Il faut modifier le fichier `config.local.php`
+
+Dans le cas ou le fichier n'existe pas il est nécessaire de copier et renommer le fichier `config.original.php` à l'aide la commande `cp`
+
+#### Utilisation de la commande `cp`
+```
+$ cd /var/www/jirafeau/lib/  
+$ cp config.original.php config.local.php
+
+```
+Plus d'information sur la commande `cp` : `$cp --help`
+
+Quelques paramètres de configurations
+
+| Fonctions | Ligne de code | Utilisation | Commentaire |
+|-----------|---------------|-------------|-------------|
+| Modifier la durée et les options de stockage des fichiers | `$cfg['availabilities'] = array(`| Valeur boléen : `true` `false` | Si l'option est `true` l'option est utilisé |
+| Modifier le nom de l'installation | `$cfg['title'] = 'Nom de l'Installation';` | Valeur texte | Le nom que vous désirez afficher |
+
+Cette liste n'est pas exhaustive, explorer le fichier de configuration.
+
+
+### Modifier les Conditions Générales d'Utilisations <a name="AdminCgu"></a>
+
+**Pour modifier les Conditions Générales d'Utilisations il faut être connecté en `root` à l'aide d'un terminal.**
+Le fichier des CGU se trouve ici : `/var/wwww/jirafeau/lib/`
+Il faut modifier le fichier `tos.original.txt`
+
+## Liens Utiles <a name="LiensUtiles"></a>
+ - Site officiel du projet - [gitlab.com/mojo42/Jirafeau](https://gitlab.com/mojo42/Jirafeau)
+ - Site de démonstration de Jirafeau [jirafeau.net](https://jirafeau.net/)
+ - Depot de l'application Jirafeau pour Yunohost - [github.com/YunoHost-apps/jirafeau_ynh](https://github.com/YunoHost-apps/jirafeau_ynh)
+ - Trouver de l'aide et poser toutes vos questions : [forum.yunohost.org](https://forum.yunohost.org/c/support)
diff --git a/app_nextcloud_fr.md b/app_nextcloud_fr.md
@@ -1,9 +1,29 @@
-# Ajouter de l'espace de stockage
+# <img src="/images/nextcloud-logo.png" alt="logo de Nextcloud"> Nextcloud  
+
+ - [Découverte de l'environnement de Nextcloud](#EnvironnementNextcloud)
+ - [Logiciels Clients pour mobile et ordinateur](#LogicielsClients)
+ - [Manipulations & Problèmes rencontrés utiles](#ManipulationsUtiles)
+    - [Ajouter de l'espace à Nextcloud](#AjoutEspace)
+ - [Applications tiers](#AppsTiers)
+ - [Liens utiles](#liensutiles)
+
+Nextcloud est un service d'hébergement de fichiers, de nombreuses applications peuvent être installés afin de lui offrir de nouvelles fonctionnalités tel que un agenda, un répertoire, des notes et pleins d'autres (vous pouvez trouver quelques applications dans la partie [applications tiers](#AppsTiers) mais il en existe pleins d'autres suivant vos besoins).
+
+## <a name="EnvironnementNextcloud">Découverte de l'environnement de Nextcloud</a>
+
+Du fait de la constitution de Nextcloud, une base avec des applications tiers à installer, cette découverte de nextcloud ne concernera que la base de nextcloud sans applications ajoutés. Plus d'informations sur les applications dans la partie dédiée ou sur le catalogue d'application de nextcloud : https://apps.nextcloud.com/
+
+## <a name="LogicielsClients">Logiciels Clients</a>
+Il existe des logiciels client pour l'ensemble plateformes. Vous pouvez les retrouver sur le site officiel de nextcloud : https://nextcloud.com/install/#install-clients
+
+## <a name="ManipulationsUtiles"> Manipulations utiles & Problèmes rencontrés</a>
+
+### <a name="AjoutEspace">Ajouter de l'espace à Nextcloud</a>
 
 La solution I) permet d'ajouter un lien vers un dossier local ou distant.  
 La solution II) permet de déplacer l'espace de stockage principal de nextcloud.
 
-## I) Ajouter un espace de stockage externe
+#### I. Ajouter un espace de stockage externe
 
 Paramètre => [Administration] Stockages externe.
 
@@ -13,7 +33,7 @@ Vous pouvez restreindre ce dossier à un ou plusieurs utilisateurs nextcloud ave
 Avec l'engrenage vous pouvez autoriser ou interdire la prévisualisation et le partage des fichiers.  
 Enfin cliquer sur la coche pour valider le dossier.
 
-## II) Migrer les données de Nextcloud dans une partition plus grosse
+#### II. Migrer les données de Nextcloud dans une partition plus grosse
 
 **Remarque** : Ce qui suit suppose que vous avez un disque dur monté sur `/media/stockage`. Référez-vous à [cet article](/external_storage_fr) pour préparer votre système.
 
@@ -24,9 +44,9 @@ Commencez par éteindre le serveur web avec la commande:
 systemctl stop nginx  
 ```
 
-### Choix de l'emplacement
+##### Choix de l'emplacement
 
-#### Cas A : Stockage vierge, exclusif à Nextcloud
+**Cas A : Stockage vierge, exclusif à Nextcloud**
 
 Pour l'instant seul root peut y écrire dans `/media/stockage`; ce qui signifie que nginx et nextcloud ne pourront donc pas l'utiliser.
 
@@ -35,7 +55,7 @@ chown -R nextcloud:nextcloud /media/stockage
 chmod 775 -R /media/stockage
 ```
 
-#### Cas B : Stockage partagé, données déjà présentes, données Nextcloud dans un sous-dossier
+**Cas B : Stockage partagé, données déjà présentes, données Nextcloud dans un sous-dossier**
 
 Si vous souhaitez utiliser ce disque pour d'autres applications, vous pouvez créer un sous-dossier appartenant à Nextcloud.
 
@@ -45,7 +65,7 @@ chown -R nextcloud /media/stockage/nextcloud_data
 chmod 775 -R /media/stockage/nextcloud_data
 ```
 
-### Migrer les données
+##### Migrer les données
 
 Migrez vos données vers le nouveau disque. Pour ce faire *(soyez patient, cela peut être long)* :
 
@@ -65,7 +85,7 @@ Cas A : ls -al /media/stockage
 Cas B : ls -al /media/stockage/nextcloud_data/nextcloud
 ```
 
-### Configurer Nextcloud
+##### Configurer Nextcloud
 
 Pour informer Nextcloud de son nouveau répertoire, modifiez le fichier `/var/www/nextcloud/config/config.php` avec la commande:
 
@@ -112,7 +132,33 @@ sudo -u nextcloud php occ files:scan --all
 
 C'est terminé. À présent testez si tout va bien, essayez de vous connecter à votre instance Nextcloud, envoyer un fichier, vérifiez sa bonne synchronisation.
 
-# L'application KeeWeb
+
+### Nextcloud et Cloudflare
+
+Si vous utilisez Cloudflare pour vos DNS, *ce qui peut-être pratique si vous avez une IP dynamique*, vous aurez très probablement des problèmes d'authentification avec l'application Nextcloud. Sur Internet beaucoup de gens propose de créer une règle ayant pour effet de désactivé tous les options relié à la sécurité et à la vitesse de Cloudflare pour l'url pointant sur votre instance Nextcloud. Malgré que cela fonctionne, ce n'est pas la solution optimial. Je vous propose, certes de créé une règle pour l'url pointant sur votre instance Nextcloud mais de désactivé seulement 2 options. Voici donc comment:
+
+#### Cloudflare Page Rules
+
+Dans le panneau de controle de Cloudflare choisissez votre domaine et trouver Page Rules
+l'url dans votre barre d'addresse ressemblera à : https://dash.cloudflare.com/*/domain.tld/page-rules
+
+#### Ajouter une règle
+
+La règle à ajouter doit s'appliquer pour l'url de votre instance Nextcloud soit:
+
+- `https://nextcloud.domain.tld/*` si vous utilisez un sous domain
+- `https://domain.tld/nextcloud/*` si vous avez déployé Nextcloud dans un répertoire
+
+Les options à désactiver (Off) sont :
+
+- Rocket Loader
+- Email Obfuscation
+
+Sauvegarder et nettoyer vos caches (Cloudflare, navigateur, ...) et le tour est joué.
+
+## <a name="AppsTiers">Les applications Tiers</a>
+
+### L'application KeeWeb
 
 L'application KeeWeb est un gestionnaire de mots de passe incorporé à Nextcloud. Elle permet par exemple de lire un fichier de type KeePass (*.kdbx*) stocké sur votre instance Nextcloud. 
 Mais il arrive parfois que Nextcloud ne laisse pas l'application prendre en charge ces fichiers, ce qui rend alors impossible leur lecture de KeeWeb. Pour remédier à cela, 
@@ -142,25 +188,7 @@ Enregistrer le fichier (**CTRL** + **o**) et quitter nano (**CTRL** + **c**).
 
 A présent, le problème est corrigé.
 
-# Nextcloud et Cloudflare
-
-Si vous utilisez Cloudflare pour vos DNS, *ce qui peut-être pratique si vous avez une IP dynamique*, vous aurez très probablement des problèmes d'authentification avec l'application Nextcloud. Sur Internet beaucoup de gens propose de créer une règle ayant pour effet de désactivé tous les options relié à la sécurité et à la vitesse de Cloudflare pour l'url pointant sur votre instance Nextcloud. Malgré que cela fonctionne, ce n'est pas la solution optimial. Je vous propose, certes de créé une règle pour l'url pointant sur votre instance Nextcloud mais de désactivé seulement 2 options. Voici donc comment:
-
-## Cloudflare Page Rules
-
-Dans le panneau de controle de Cloudflare choisissez votre domaine et trouver Page Rules
-l'url dans votre barre d'addresse ressemblera à : https://dash.cloudflare.com/*/domain.tld/page-rules
-
-### Ajouter une règle
-
-La règle à ajouter doit s'appliquer pour l'url de votre instance Nextcloud soit:
-
-- `https://nextcloud.domain.tld/*` si vous utilisez un sous domain
-- `https://domain.tld/nextcloud/*` si vous avez déployé Nextcloud dans un répertoire
-
-Les options à désactiver (Off) sont :
-
-- Rocket Loader
-- Email Obfuscation
-
-Sauvegarder et nettoyer vos caches (Cloudflare, navigateur, ...) et le tour est joué.
+## <a name="liensutiles">Quelques liens utiles</a>
++ Site officiel : [nextcloud.com (En anglais)](https://nextcloud.com/)
++ Catalogue d'application pour nextcloud : [apps.nextcloud.com](https://apps.nextcloud.com/)
++ Trouver de l'aide et poser toutes vos questions : [forum.yunohost.org](https://forum.yunohost.org/c/support)
diff --git a/app_pleroma_fr.md b/app_pleroma_fr.md
@@ -1,14 +1,12 @@
 # <img src="/images/pleroma_logo.png" alt="logo de Pleroma"> Pleroma
 
-| Index |
-|-------|
-| [Découverte de l'interface de Pleroma](#decouvertegeneralepleroma) |
-| [Logiciels Clients pour mobile et ordinateur](#LogicielsClients) |
-| [Liens utiles](#liensutiles) |
+ - [Découverte de l'interface de Pleroma](#decouvertegeneralepleroma) |
+ - [Logiciels Clients pour mobile et ordinateur](#LogicielsClients) |
+ - [Liens utiles](#liensutiles) |
 
 Pleroma est un réseau social décentralisé de micro-blogging qui propose une alternative à Twitter, le protocole Activy Pub qu'il utilise permet d'interagir avec le fediverse composé notamment de Mastodon, GNU Social, et d'autres. Il a l'avantage d'être plus léger que mastodon et se prête donc plus facilement à l'auto-hébergement.
 
-## <a name="#decouvertegeneralepleroma">Découverte de l'interface de Pleroma
+## <a name="decouvertegeneralepleroma">Découverte de l'interface de Pleroma</a>
 Pour ceux et celles qui n'ont pas ou peu l'habitude des réseaux sociaux, voici en détail l'utilisation de chacune des fenêtres proposées.
 
 ### Accueil de l'interface
@@ -36,7 +34,7 @@ Cet espace permet de choisir l'agencement de Pleroma, il est proposé deux agenc
 6. Notifications  
 On retrouve dans cette zone les messages où vous avez été cité, mais aussi les abonnements à votre compte.
 
-## <a name="LogicielsClients"> Applications clients
+## <a name="LogicielsClients"> Applications clients</a>
 
 | Nom de l'applications | Plateforme | Multi-comptes | Autre réseaux supportés | Play Store | F-Droid | Apple Store |
 |---|---|---|---|---|---|---|
@@ -48,4 +46,4 @@ On retrouve dans cette zone les messages où vous avez été cité, mais aussi l
 ## <a name="liensutiles">Quelques liens utiles</a>
 + Site officiel : [pleroma.social (En anglais)](https://pleroma.social)
 + Trouver d'autres instances de Pleroma : [fediverse.network/pleroma](https://fediverse.network/pleroma)
-+ Trouver de l'aide et poser toutes vos questions : [forum.yunohost.org](https://forum.yunohost.org/c/support)
++ Trouver de l'aide et poser toutes vos questions : [forum.yunohost.org](https://forum.yunohost.org/c/support)
diff --git a/contributordoc.md b/contributordoc.md
@@ -1,12 +1,15 @@
 # Contributor documentation
 
-* [General ways of contributing to YunoHost](/contribute)
-* [Writing documentation](/write_documentation)
-* [Chat rooms](/chat_rooms)
+* [General ways of contributing to YunoHost](contribute)
+* [Writing documentation](write_documentation)
+   * [Guide to writing documentation](doc_wrinting_guide_fr)
+   * [Markdown Guide](doc_markdown_guide_fr)
+   * [Propel your contribution with git](doc_use_git_fr) 
+* [Chat rooms](chat_rooms)
 * Application packaging
-   * [Apps wishlist](/apps_wishlist)
-   * [General introduction to app packaging](/packaging_apps_start)
-   * [Technical introduction to app packaging](/packaging_apps)
+   * [Apps wishlist](apps_wishlist)
+   * [General introduction to app packaging](packaging_apps_start)
+   * [Technical introduction to app packaging](packaging_apps)
    * [Setting up a dev environment with VirtualBox](packaging_apps_virtualbox_fr)
    * [Manifest](packaging_apps_manifest)
    * [Scripts](packaging_apps_scripts)
@@ -24,11 +27,11 @@
        * [App CI dashboard](https://dash.yunohost.org/appci/branch/stable)
        * [App Continuous Integration for packagers](/packaging_apps_ci)
        * [YEP - YunoHost Enhancement Proposals](packaging_apps_guidelines_fr)
-* [Contributing to the YunoHost core](/dev)
+* [Contributing to the YunoHost core](dev)
    * [Setting up a dev environment with ynh-dev](https://github.com/YunoHost/ynh-dev/blob/master/README.md)
    * [Deb build chain](https://github.com/YunoHost/vinaigrette/blob/master/README.md)
    * Image building
        * [x86 ISO](https://github.com/YunoHost/cd_build)
        * [Raspberry Pi images](https://github.com/YunoHost/rpi-image)
        * [Other ARM board images](https://github.com/YunoHost/arm-images)
-* [Using the YunoHost API outside of the webadmin](/admin_api)
+* [Using the YunoHost API outside of the webadmin](admin_api)
diff --git a/contributordoc_fr.md b/contributordoc_fr.md
@@ -1,12 +1,15 @@
 # Guide du contributeur
 
-* [Liste des façons de contribuer à YunoHost](/contribute_fr)
-* [Écrire de la documentation](/write_documentation_fr)
-* [Salons de discussion](/chat_rooms_fr)
+* [Liste des façons de contribuer à YunoHost](contribute_fr)
+* [Écrire de la documentation](write_documentation_fr)
+   * [Guide de rédaction de la documentation](doc_wrinting_guide_fr)
+   * [Guide Markdown](doc_markdown_guide_fr)
+   * [Propulser sa contribution avec git](doc_use_git_fr)
+* [Salons de discussion](docs_chat_rooms_fr)
 * Packaging d'application
-   * [Liste d'apps souhaitées par la communauté](/apps_wishlist_fr)
-   * [Introduction générale au packaging d'apps](/packaging_apps_start_fr)
-   * [Introduction technique au packaging d'apps](/packaging_apps_fr)
+   * [Liste d'apps souhaitées par la communauté](apps_wishlist_fr)
+   * [Introduction générale au packaging d'apps](packaging_apps_start_fr)
+   * [Introduction technique au packaging d'apps](packaging_apps_fr)
    * [Déployer un environnement de développement avec VirtualBox](packaging_apps_virtualbox_fr)
    * [Manifest](packaging_apps_manifest_fr)
    * [Scripts](packaging_apps_scripts_fr)
@@ -22,14 +25,14 @@
        * [Niveaux des applications](packaging_apps_levels_fr)
        * [Intégration continue des apps](https://ci-apps.yunohost.org)
        * [Tableau de bord du CI des apps](https://dash.yunohost.org/appci/branch/stable)
-       * [Intégration continue pour packagers](/packaging_apps_ci)
+       * [Intégration continue pour packagers](packaging_apps_ci)
        * [YEP - YunoHost Enhancement Proposals](packaging_apps_guidelines_fr)
-* [Contribuer à la partie "core" de YunoHost](/dev_fr)
+* [Contribuer à la partie "core" de YunoHost](dev_fr)
    * [Déployer un environnement de dev avec ynh-dev](https://github.com/YunoHost/ynh-dev/blob/master/README.md)
    * [Construction des paquets debian](https://github.com/YunoHost/vinaigrette/blob/master/README.md)
    * [Feuilles de route du projet](https://github.com/YunoHost/issues/milestones?direction=asc&sort=title&state=open)
    * Construction des images
        * [x86 ISO](https://github.com/YunoHost/cd_build)
        * [Images Raspberry Pi](https://github.com/YunoHost/rpi-image)
        * [Autres images pour cartes ARM](https://github.com/YunoHost/arm-images)
-* [Utiliser l'API YunoHost en dehors de la webadmin](/admin_api_fr)
+* [Utiliser l'API YunoHost en dehors de la webadmin](admin_api_fr)
diff --git a/doc_markdown_guide.md b/doc_markdown_guide.md
@@ -0,0 +1 @@
+# Markdown Guide