-
-
-YunoHost comes installed by default with an instant messaging server Metronome which implements the [XMPP protocol](https://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (previously known as Jabber).
-
-This protocol is already used by millions of people around the world - it is an open protocol. All applications based on XMPP are compatible with each other: when using an XMPP client, you can interact with anybody who has an XMPP account.
-
-XMPP is an extensible protocol - this means users can configure "extensions" to chatrooms, to share messages and files, and to make voice and video calls using XMPP.
-
-## XMPP account
-
-To use an XMPP account you need a username, which takes the format: `user@domain.tld`, and a password.
-
-With YunoHost, an XMPP account is created for all YunoHost users automatically. The XMPP account credentials corresponds to the user's main email address and password.
-
-## Connecting to your YunoHost XMPP account
-
-You can connect to your YunoHost XMPP account in different ways.
-
-### Web clients
-
-- [Movim](https://movim.eu)
-- [ConverseJS](https://conversejs.org/)
-- [Libervia/Salut à Toi](https://salut-a-toi.org/)
-
-### Desktop clients
-
-- [Gajim](http://gajim.org/) (Linux,Windows)
-- [Dino](https://dino.im) (Linux)
-- [Thunderbird](https://www.thunderbird.net/fr/) (multiplatform)
-- [Beagle IM](https://beagle.im/) (Mac OS)
-- [Profanity](https://profanity-im.github.io/) (Linux)
-
-### Mobile clients
-
-- [Conversations](https://conversations.im/) (Android)
-- [Xabber](http://xabber.com) (Android)
-- [Movim under Android](https://movim.eu)
-- [Monal](https://monal.im/) (iOS)
-- [Siskin IM](https://siskin.im/) (iOS)
-- [Kaidan](https://www.kaidan.im/) (Ubuntu Touch / Plasma Mobile)
-
-Here is an exhaustive list of XMPP clients : https://xmpp.org/software/clients.html
-
-## Encrypt conversations with OMEMO
-
-XMPP chats can be made secure and private using [OMEMO] encryption (https://xmpp.org/extensions/xep-0384.html), for instance using Gajim:
-- Install `gajim` and the plugin `gajim-omemo`
-- Enable the plugin in `Tools > Plugins`
-- Enable it
-- Enable the encryption in the chat with somebody who also has OMEMO
-
-## Chatrooms
-
-To create a chatroom (multi-user chat) on your YunoHost server, use the identifier `chatroomname@muc.yourdomain.tld`.
-
-For this to work you need to [add the corresponding `muc.` DNS record](/dns_config) in the DNS configuration.
-
-## VoIP and videoconferences
-
-A practical tool to call an XMPP client, either with voice or voice+video, is to use the client [Jitsi](http://jitsi.org/).
diff --git a/admin.md b/admin.md
deleted file mode 100644
index 288471af..00000000
--- a/admin.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# Administrator web interface
-
-Yunohost has an administrator web interface. The other way to administrate your Yunohost install is through the [command line](/commandline).
-
-### Access
-
-You can access your administrator web interface at this address: https://example.org/yunohost/admin (replace 'example.org' with your own domain name)
-
-
-
-
-
Jappix
-
-Jappix is a web client for [XMPP](/XMPP).
diff --git a/app_jappix_fr.md b/app_jappix_fr.md
deleted file mode 100644
index aa044fe2..00000000
--- a/app_jappix_fr.md
+++ /dev/null
@@ -1,3 +0,0 @@
-#Jappix
-
-Jappix est un client web [XMPP](/XMPP).
diff --git a/app_limesurvey.md b/app_limesurvey.md
deleted file mode 100644
index dbc94cd7..00000000
--- a/app_limesurvey.md
+++ /dev/null
@@ -1,12 +0,0 @@
-#
LimeSurvey
-
-LimeSurvey is used to create advanced poll/form.
-
-### How to create a poll
-You need to access the admin interfaces.
-
-You can do it by adding /admin to the web address where the LimeSurvey is setup.
-
-For example, if it is install on : https://example.org/poll/ you can access it on https://example.org/poll/admin/
-
-* [LimeSurvey Website](https://www.limesurvey.org/)
diff --git a/app_limesurvey_fr.md b/app_limesurvey_fr.md
deleted file mode 100644
index 18f8e909..00000000
--- a/app_limesurvey_fr.md
+++ /dev/null
@@ -1,12 +0,0 @@
-#LimeSurvey
-
-LimeSurvey est un outil de création et diffusion de sondage/formulaire en ligne.
-
-### Comment créer un questionnaire
-Pour créer un questionnaire, il faut accéder à l'interface d'administration.
-
-Pour l'atteindre, il faut ajouter /admin à l'adresse web sur laquelle est installée le LimeSurvey.
-
-Par exemple, si le LimeSurvey est installé sur https://example.org/poll/ il est possible d'accéder à l'interface d'administration via https://example.org/poll/admin/
-
-* [LimeSurvey Website](https://www.limesurvey.org/)
diff --git a/app_mediawiki.md b/app_mediawiki.md
deleted file mode 100644
index ae080898..00000000
--- a/app_mediawiki.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# Mediawiki
-
-
-
-MediaWiki is a free and open source software wiki package written in PHP, originally for use on Wikipedia.
-
-## Overview
-
-
-
-## Link
-
-Mediawiki : https://www.mediawiki.org/
-FAQ : https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ
-Support Desk : https://www.mediawiki.org/wiki/Project:Support_desk
\ No newline at end of file
diff --git a/app_mediawiki_fr.md b/app_mediawiki_fr.md
deleted file mode 100644
index 93e9c0e0..00000000
--- a/app_mediawiki_fr.md
+++ /dev/null
@@ -1,15 +0,0 @@
-# Mediawiki
-
-
-
-MediaWiki est un ensemble wiki à base de logiciels libres Open source, développé à l’origine pour Wikipédia.
-
-## Aperçu
-
-
-
-## Liens
-
-Mediawiki : https://www.mediawiki.org/
-FAQ : https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ
-Support Desk : https://www.mediawiki.org/wiki/Project:Support_desk
\ No newline at end of file
diff --git a/app_minidlna.md b/app_minidlna.md
deleted file mode 100644
index cd17abcf..00000000
--- a/app_minidlna.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# Minidlna
-
-Minidlna is a lightweight [dlna](https://fr.wikipedia.org/wiki/Digital_Living_Network_Alliance) server.
-It allows to easily share multimedia files with any compatible devices present on the LAN.
-
-Minidlna does not have a graphical interface, but it does not require any special configuration.
-
-### What multimedia files are shared?
-Minidlna sharing the folder `/home/yunohost.multimedia/share`, which is common to each user in `/home/$USER/Multimedia/Share`.
-[More information about multimedia files here.](Https://github.com/maniackcrudelis/yunohost.multimedia)
-
-~~If [transmission](https://github.com/Kloadut/transmission_ynh) is installed, the downloaded media will be available in dlna.~~
-
-### How to view and play media files shared by minidlna?
-To view and play media files, all you need is a compatible client DLNA/UPNP.
-
-The majority of set-top boxes provided by ISPs are DLNA compatible, simply look for sources of external media.
-This is also true for the latest generation game consoles connected to internet.
-
-Some TV and blu-ray player is also DLNA compatible.
-
-In any case, it is generally sufficient to seek external sources, USB etc, to find the DLNA server, displayed under the name **YunoHost DLNA**.
-
-There are a multitude of DLNA client for all platforms, including the following [not exhaustive list](https://en.wikipedia.org/wiki/List_of_UPnP_AV_media_servers_and_clients#UPnP_AV_clients).
-In general, a DLNA client does not require any special configuration to access the media sharing.
diff --git a/app_minidlna_fr.md b/app_minidlna_fr.md
deleted file mode 100644
index da1dee36..00000000
--- a/app_minidlna_fr.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# Minidlna
-
-Minidlna est un serveur [dlna](https://fr.wikipedia.org/wiki/Digital_Living_Network_Alliance) ultra léger.
-Il permet de partager très simplement les fichiers multimédias avec tous les appareils compatibles présents sur le réseau local.
-
-Minidlna ne dispose pas d’une interface graphique, mais ne nécessite pas de configuration particulière.
-
-### Quels fichiers multimédias sont partagés ?
-Minidlna partage le dossier `/home/yunohost.multimedia/share`, qui est commun à chaque utilisateur dans le dossier `/home/$USER/Multimedia/Share`.
-[Plus d’informations sur les dossiers multimédias](https://github.com/maniackcrudelis/yunohost.multimedia).
-
-~~Si [transmission](https://github.com/Kloadut/transmission_ynh) est installé, les médias téléchargés seront disponibles en dlna.~~
-
-### Comment consulter et lire les fichiers multimédias partagés par minidlna ?
-Pour voir et lire les fichiers multimédias, il suffit de disposer d’un client compatible DLNA/UPNP.
-
-La majorité des décodeurs TV fournis par les FAI sont compatibles DLNA, il suffit de chercher les sources de médias externes.
-C’est le cas également pour les consoles de jeux dernière génération connectée à internet.
-
-Certaines TV et lecteur blu-ray sont également compatibles DLNA.
-
-Dans tous les cas, il suffit en général d’aller chercher les sources externes, USB etc., pour trouver le serveur DLNA, affiché sous le nom **YunoHost DLNA**.
-
-Il existe une multitude de clients DLNA pour toutes les plateformes, dont voici une [liste non exhaustive](https://en.wikipedia.org/wiki/List_of_UPnP_AV_media_servers_and_clients#UPnP_AV_clients).
-De manière générale, un client DLNA ne nécessite pas de configuration particulière pour accéder au partage de fichiers multimédias.
diff --git a/app_nextcloud_calendar.md b/app_nextcloud_calendar.md
deleted file mode 120000
index 7800f978..00000000
--- a/app_nextcloud_calendar.md
+++ /dev/null
@@ -1 +0,0 @@
-default.md
\ No newline at end of file
diff --git a/app_nextcloud_carnet.md b/app_nextcloud_carnet.md
deleted file mode 120000
index 7800f978..00000000
--- a/app_nextcloud_carnet.md
+++ /dev/null
@@ -1 +0,0 @@
-default.md
\ No newline at end of file
diff --git a/app_nextcloud_contact.md b/app_nextcloud_contact.md
deleted file mode 120000
index 7800f978..00000000
--- a/app_nextcloud_contact.md
+++ /dev/null
@@ -1 +0,0 @@
-default.md
\ No newline at end of file
diff --git a/app_peertube.md b/app_peertube.md
deleted file mode 100644
index 77984f62..00000000
--- a/app_peertube.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Peertube
-
-PeerTube is a federated (ActivityPub) video streaming platform using P2P (BitTorrent) directly in the web browser, using WebTorrent.
\ No newline at end of file
diff --git a/app_peertube_fr.md b/app_peertube_fr.md
deleted file mode 100644
index e45454cd..00000000
--- a/app_peertube_fr.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# 
PeerTube
-
-[](https://install-app.yunohost.org/?app=peertube)
-
-PeerTube est une plateforme de streaming vidéo fédérée (ActivityPub) utilisant P2P (BitTorrent) directement dans le navigateur web, en utilisant WebTorrent.
-
-## Découverte de l'environnement de PeerTube
-
-Pour comprendre en quoi PeerTube propose une alternative à youtube, vous êtes invité à regarder le clip réalisé par l'association Framasoft (ci-dessous). Elle est elle même hébergé sur [framatube.org](https://framatube.org)
-
-
-
-## Quelques liens utiles
-
- - Site officiel de PeerTube - [joinpeertube.org](https://joinpeertube.org/fr/)
- - Dépot application PeerTube Yunohost - [github.com/YunoHost-Apps/peertube_ynh](https://github.com/YunoHost-Apps/peertube_ynh)
diff --git a/app_pihole.md b/app_pihole.md
deleted file mode 100644
index 86ede826..00000000
--- a/app_pihole.md
+++ /dev/null
@@ -1,5 +0,0 @@
-===== Pihole =====
-
-Homepage: https://pi-hole.net
-
-**Pi-hole®** Network-wide ad blocking via your own DNS server, with nice Performance And Statistics web page.
diff --git a/app_pihole_fr.md b/app_pihole_fr.md
deleted file mode 100644
index 4d2dbc39..00000000
--- a/app_pihole_fr.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Pihole
-
-Page d'accueil : https://pi-hole.net
-
-**Pi-hole®** Blocage des publicités à l'échelle du réseau via votre propre serveur DNS, avec une belle page web Performance And Statistics.
\ No newline at end of file
diff --git a/app_piwigo.md b/app_piwigo.md
deleted file mode 100644
index 0ed09045..00000000
--- a/app_piwigo.md
+++ /dev/null
@@ -1,32 +0,0 @@
-## 
-
-
-
-
-[Piwigo](http://piwigo.org) is a photo gallery software for the web, built by an active community of users and developers.
-
-Extensions make Piwigo easily customizable. Icing on the cake, Piwigo is free and opensource.
-
-[](https://install-app.yunohost.org/?app=piwigo)
-
-
-
-## Features
-
-In addition to Piwigo [core features](http://piwigo.org/basics/features), the following are made available with
-this package:
-
- * Integrate with YunoHost users and SSO:
- * private mode: limit access to Yunohost users
- * public mode:
- * SSO for YunoHost users
- * allow other users management, and guest mode
- * Allow one YunoHost user to be the administrator (set at the installation)
-
-
-## Links
-
- * Report a bug: https://github.com/YunoHost-Apps/piwigo_ynh/issues
- * Piwigo website: http://piwigo.org/
-
-
diff --git a/app_piwigo_fr.md b/app_piwigo_fr.md
deleted file mode 100644
index 1c5b704a..00000000
--- a/app_piwigo_fr.md
+++ /dev/null
@@ -1,30 +0,0 @@
-##
-
-
-
-
-[Piwigo](http://piwigo.org) est un logiciel de galerie photo pour le web, bâti par une communauté active d'utilisateurs et de développeurs.
-
-Les extensions rendent Piwigo facilement personnalisable. Cerise sur le gâteau, Piwigo est libre et gratuit.
-
-[](https://install-app.yunohost.org/?app=piwigo)
-
-
-
-## Fonctionnalités
-
-En plus des [fonctionnalités principales](http://piwigo.org/basics/features) de Piwigo, ce paquet propose également:
-
- * une intégration avec le système de gestion des utilisateurs et le SSO de Yunohost :
- * installation privée : limitée aux utilisateurs de YunoHost
- * installation publique :
- * SSO pour les utilisateurs YunoHost
- * permet de gérer l'accès à d'autres utilisateurs, et mode invité possible
- * de permettre à un utilisateur d'être administrateur (réglage lors de l'installation)
-
-## Liens
-
- * Rapport de bug: https://github.com/YunoHost-Apps/piwigo_ynh/issues
- * Site web Piwigo : http://piwigo.org/
-
-
diff --git a/app_pleroma.md b/app_pleroma.md
deleted file mode 100644
index 595e2038..00000000
--- a/app_pleroma.md
+++ /dev/null
@@ -1 +0,0 @@
-Unfortunately, this page only exists [in french here](app_pleroma_fr) for now.
diff --git a/app_rainloop.md b/app_rainloop.md
deleted file mode 100644
index 1e33f67d..00000000
--- a/app_rainloop.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# Rainloop
-
-Rainloop is a lightweight webmail.
-
-To configure it, go to http://DOMAIN.TLD/rainloop/app/?admin
-
-- The default login is : admin
-- The default password is : Password chosen during install
-- If you lost the admin password, you can retrieve it using ``sudo yunohost app settings rainloop password``
-
-Each user can add a remote carddav server from their own parameters interface.
-
-- If you use baikal, the CardDav address is: https://DOMAIN.TLD/baikal/card.php/addressbooks/USER/default/
-- If you use NextCloud, the CardDav address is: https://DOMAIN.TLD/nextcloud/remote.php/carddav/addressbooks/USER/contacts
-
-Rainloop saves your PGP private keys in the browser storage. This means that you will loose your private keys if you clear your browser storage (e.g., private browsing, different computer...). This packages integrates [PGPback by chtixof](https://github.com/chtixof/pgpback_ynh) so you can store your PGP private keys on the server securely. Go to **http://DOMAIN.TLD/rainloop/pgpback** to backup your PGP keys on the server or restore them.
-
-To upgrade the app once a new rainloop version is available, simply run in a local shell via ssh or otherwise :
-``sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/rainloop_ynh rainloop``
diff --git a/app_rainloop_fr.md b/app_rainloop_fr.md
deleted file mode 100644
index 7229c4e6..00000000
--- a/app_rainloop_fr.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# Rainloop
-
-Rainloop est un webmail simple et léger.
-
-Pour le configurer après l'installation, veuillez vous rendre sur http://DOMAIN.TLD/rainloop/app/?admin
-
-- Le nom d'utilisateur admin par défaut est : admin
-- Le mot de passe admin par défaut est : Mot de passe choisi lors de l'installation
-- Si vous avez oublié votre mot de passe, vous pouvez le retrouver avec ``sudo yunohost app settings rainloop password``
-
-## Carnet d'adresses
-Rainloop intègre par défaut un carnet d'adresse avec les utilisateurs du serveur yunohost. Chaque utilisateur peut ajouter un carnet d'adresse distant CardDav via leurs propres paramètres.
-- Si vous utilisez Baikal, l'adresse à renseigner est du type : https://DOMAIN.TLD/baikal/card.php/addressbooks/UTILISATEUR/default/
-- Si vous utilisez NextCloud, l'adresse à renseigner est du type : https://DOMAIN.TLD/nextcloud/remote.php/carddav/addressbooks/USER/contacts
-
-## Gestion des domaines
-Les utilisateurs peuvent se servir de Rainloop pour accéder à d'autres boites mail que celle fournie par yunohost (par exemple gmail.com ou laposte.net). L'option est disponible par le bouton "compte -> ajouter un compte".
-L'administrateur doit pour cela autoriser la connexion à des domaines tiers, via une liste blanche dans l'interface administration.
-
-## Gestion des clés PGP
-Rainloop stocke les clés PGP privées dans le stockage de navigateur. Cela implique que vos clés seront perdues quand vous videz le stockage de navigateur (navigation incognito, changement d'ordinateur, ...). Ce paquet intègre donc [PGPback de chtixof](https://github.com/chtixof/pgpback_ynh) pour que vous puissiez stocker vos clés privées PGP de manière sécurisée sur le serveur. Rendez-vous à l'adresse **http://DOMAIN.TLD/rainloop/pgpback** pour stocker vos clés privées PGP sur le serveur ou les restaurer dans un nouveau navigateur.
-
-## Mise à jour
-Pour mettre à jour rainloop lorsqu'une nouvelle version est disponible, lancez en console locale (ssh ou autre) :
-``sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/rainloop_ynh rainloop``
diff --git a/app_roundcube.md b/app_roundcube.md
deleted file mode 100644
index c38ae010..00000000
--- a/app_roundcube.md
+++ /dev/null
@@ -1,19 +0,0 @@
-#
Roundcube - Webmail
-
-Roundcube is a web client for email messaging also called webmail.
-
-### Synchronize your contacts
-
-Roundcube offers you at the installation to synchronize your contacts with a CardDAV server, through a third party plugin. Using a CardDAV server like Baïkal or ownCloud's "Contacts" application, both available in YunoHost, allows you to centralize and manage your contacts.
-
-Similarly to IMAP that allows you to synchronize your emails with your mail server, CardDAV allows you to access your contacts through multiple clients, such as Roundcube. Thanks to CardDAV, you will not have to import your contacts in each of your devices.
-
-Note that addressbooks defined in Baïkal or ownCloud will be automatically added in Roundcube for each user if they are already installed.
-
-----
-
-In case you've installed ownCloud after, here is how to add your addressbooks:
-
-* Go to "Contacts" section of your owncloud application and click on the gear wheel icon located at the bottom left. Then, click on "CardDAV link" and copy the URL that appeared.
-
-* Go to Roundcube's CardDAV section and type in "ownCloud" in "Label" field, paste the previously copied URL and type your username and password. Your contacts are now synchronized!
diff --git a/app_roundcube_fr.md b/app_roundcube_fr.md
deleted file mode 100644
index 7ef08451..00000000
--- a/app_roundcube_fr.md
+++ /dev/null
@@ -1,19 +0,0 @@
-#Roundcube - Webmail libre
-
-Roundcube est un client web de courrier électronique libre ou aussi appelé un webmail.
-
-### Synchronisation des contacts
-
-Roundcube vous propose à l'installation, via un greffon tiers, de pouvoir synchroniser vos contacts avec un serveur CardDAV. Utiliser un serveur CardDAV comme Baïkal ou l’application « Contacts » d’ownCloud, tous deux disponibles pour YunoHost, a l’avantage de permettre une gestion centralisée de vos contacts.
-
-De la même façon que le protocole IMAP vous permet de synchroniser vos courriels avec votre serveur mail, CardDAV vous permet d’avoir accès à vos contacts depuis une multitude de clients, dont Roundcube. Avec CardDAV, nous n’aurez donc plus besoin d’importer vos contacts dans chaque client.
-
-Notez que si Baïkal ou ownCloud sont déjà installés, les carnets d'adresses qui y sont définis seront automatiquement ajoutés pour chaque utilisateur dans Roundcube.
-
-----
-
-Si vous avez installé ownCloud après, voici comment ajouter vos carnets d'adresses :
-
-* Rendez-vous dans la section « Contacts » de votre espace ownCloud et cliquez sur l’icône représentant une roue dentée en bas à gauche. Ensuite, cliquez sur l’icône « Lien CardDAV » et copiez l’URL qui s’affiche en dessous.
-
-* Rendez-vous ensuite dans la section CardDAV des paramètres de Roundcube et entrez « ownCloud » dans le champ « Label », collez l’URL que vous venez de copier et enfin entrez votre nom d’utilisateur et votre mot de passe. Vos contacts sont désormais synchronisés !
diff --git a/app_sogo.md b/app_sogo.md
deleted file mode 100644
index 09a46e5f..00000000
--- a/app_sogo.md
+++ /dev/null
@@ -1 +0,0 @@
-Unfortunately, this page only exists [in french here](app_sogo_fr) for now.
diff --git a/app_sogo_fr.md b/app_sogo_fr.md
deleted file mode 100644
index 2ae3e848..00000000
--- a/app_sogo_fr.md
+++ /dev/null
@@ -1,8 +0,0 @@
-#  SOGo
-
-SOGo est un service de webmail pour votre serveur email, c'est une alternative à [RoundCube](app_roundcube). Il permet aussi la gestion des agendas et contacts présents sur le serveur.
-
-## Quelques liens utiles
-
- + Site officiel de SOGo : [sogo.nu](https://sogo.nu/a)
- + Dépot de l'application pour Yunohost : [github.com/YunoHost-Apps/sogo_ynh](https://github.com/YunoHost-Apps/sogo_ynh)
diff --git a/app_ttrss.md b/app_ttrss.md
deleted file mode 100644
index 8ccedfa0..00000000
--- a/app_ttrss.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# 
Tiny Tiny RSS
-
-Tiny Tiny RSS is a news feed reader using RSS and atom protocols.
-
-### Exporting/importing feeds
-TTRSS allows you to save your feeds in opml format.
-In order to do so, go to Actions -> Configuration -> feed tab -> OPML section -> Export/Import OPML.
-
-### Android Client
-
-You can read your feeds on Android using ttrss-reader application:
-
-**[ttrss-reader](https://f-droid.org/packages/org.ttrssreader/)**
-
-To use it, you need to go to Actions -> Configuration, in TTRSS web interface and select "Activate API".
-Then, in your android ttrss-reader, fill the TTRSS server adress: "https://yourdomain.org/ttrss", username, password (no need to use HTTP authentification).
-
-**Note** : you may need to uninstall and reinstall the TTRSS application through the Yunohost admin panel in order to be able to connect.
-
-* [Tiny Tiny RSS Website](https://git.tt-rss.org/git/tt-rss/wiki)
diff --git a/app_ttrss_fr.md b/app_ttrss_fr.md
deleted file mode 100644
index be8b239c..00000000
--- a/app_ttrss_fr.md
+++ /dev/null
@@ -1,21 +0,0 @@
-# Tiny Tiny RSS
-
-Tiny Tiny RSS est un lecteur de flux d’actualité utilisant les protocoles RSS et atom.
-
-### Exportation/importation des flux
-Il est possible de faire une sauvegarde de ces flux d’actualité en format opml.
-
-Pour cela, il faut aller dans Actions -> Configuration -> onglet flux -> chapitre OPML -> Exporter/Importer en OPML.
-
-### Client Android
-
-Il est possible d’utiliser le client Android ttrss-reader pour consulter ces flux :
-
-**[ttrss-reader](https://f-droid.org/packages/org.ttrssreader/)**
-
-Sur l’interface web, dans Actions -> Configuration, cochez « Activer l’accès par API »
-puis dans ttrss-reader sur Android, l’adresse du serveur TTRSS : « https://votredomaine.org/ttrss », nom d’utilisateur, mot de passe. (pas besoin d’utiliser l’authentification HTTP)
-
-**Note** : vous pouvez avoir besoin de désinstaller, puis réinstaller entièrement l’app ttrss via l’administration de YunoHost pour que la connexion puisse se faire.
-
-* [Site de Tiny Tiny RSS](https://git.tt-rss.org/git/tt-rss/wiki)
diff --git a/app_update.md b/app_update.md
deleted file mode 100644
index da5a5b58..00000000
--- a/app_update.md
+++ /dev/null
@@ -1,38 +0,0 @@
-#Upgrade your applications
-
-Once you installed applications, you may need to upgrade them, sooner or later.
-
-** Caution: ** please be advised to backup your databases (using phpmyadmin application for example) and files before any upgrade.
-
-### Upgrade using the admin panel
-Go to Tools > Update system
-
-Once the applications packages list is retrieved, you will be able to update official applications that have a pending upgrade.
-
-### Upgrade using command line
-First, connect to your server through SSH and type in the following command (WordPress update):
-```bash
-yunohost app upgrade wordpress
-```
-** Note: ** in case you have multiple instances of the same type (ex: 2 wordpress) installed, you will need to specify the instance name (ex: wordpress or wordpress__2).
-
-#### Upgrade an unofficial application
-Specify the git repository containing the upgrade.
-
-For intance, to upgrade LimeSurvey:
-```bash
-yunohost app upgrade limesurvey -u https://github.com/zamentur/limesurvey_ynh
-```
-
-** Note: ** be cautious when installing unofficial applications and upgrades. Be sure that theses updates are stables and are not a step in the development process. There may be a good reason if an application is not listed in the official repository.
-
-** Caution: ** be sure to check the content of any update; installing or upgrading an unofficial application allows it to run scripts with the highest privileges.
-
-#### Command line options
-
-When upgrading apps from the command line, you can specify specific options to change the behaviour of the upgrade script.
-To set those options, set the corresponding variable before the upgrade command: `sudo OPTION_TO_SET=1 yunohost app upgrade wordpress`
-
-Available options are:
-- `NO_BACKUP_UPGRADE`: Do not perform the backup before the upgrade. Which means the upgrade will be operated without a security backup.
-- `YNH_FORCE_UPGRADE`: Force the upgrade of the app and the package, even if the app is already up to date.
diff --git a/app_update_fr.md b/app_update_fr.md
deleted file mode 100644
index ee35db0b..00000000
--- a/app_update_fr.md
+++ /dev/null
@@ -1,39 +0,0 @@
-#Mettre à jour ses applications
-
-Une fois que vous avez installé des applications, il est nécessaire de les mettre à jour. Plusieurs méthodes existent et sont détaillées ci-dessous.
-
-** Attention : ** il est recommandé de faire une sauvegarde de la base de données (par exemple via l’application [phpmyadmin](https://github.com/YunoHost-apps/phpmyadmin_ynh) ([installer](https://install-app.yunohost.org/?app=phpmyadmin))) ainsi que des fichiers avant une opération de mise à jour.
-
-### Mise à jour par l’interface web
-Pour cela, il faut aller dans l’onglet "Mettre à jour le système".
-
-Une fois la liste des paquets et des applications rafraîchie, il sera proposé de mettre à jour les applications et paquets qui peuvent l’être.
-
-
-### Mise à jour en ligne de commande
-Il faut d’abord se connecter sur le serveur en ssh, puis entrer la commande suivante (dans le cas d’une mise à jour WordPress) :
-```bash
-yunohost app upgrade wordpress
-```
-** Note : ** dans le cas où plusieurs applications du même type (ex : deux WordPress) sont installées sur le serveur, il est nécessaire de spécifier le nom d’instance (ex : wordpress ou wordpress__2).
-
-#### Mise à jour d’une application non officielle
-Il faut pour cela indiquer le dépôt git qui contient la mise à jour.
-
-Par exemple, pour mettre à jour LimeSurvey, entrer :
-```bash
-yunohost app upgrade limesurvey -u https://github.com/zamentur/limesurvey_ynh
-```
-
-** Note : ** faites attention aux applications/mises à jour non officielles que vous installez. Assurez-vous que ces mises à jour sont stables et ne constituent pas une étape de développement. Si une application ou une mise à jour n’est pas intégrée au dépôt officiel, il y a sûrement une raison.
-
-** Attention : ** assurez-vous du contenu de cette mise à jour ; l’installation ou la mise à jour d’une application non officielle permet à cette dernière d’exécuter des scripts avec les privilèges les plus élevés. Si le script est malicieux, il pourrait nuire à votre vie privée en communiquant à des tiers toute donnée présente sur le serveur, ou bien les détruire irrémédiablement.
-
-##### Options de ligne de commande
-
-Lorsque vous mettez à jour des applications à partir de la ligne de commande, vous pouvez spécifier des options spécifiques pour modifier le comportement du script d'upgrade.
-Pour définir ces options, définissez la variable correspondante avant la commande d'upgrade: `sudo OPTION_TO_SET=1 yunohost app upgrade wordpress`
-
-Les options disponibles sont:
-- `NO_BACKUP_UPGRADE`: Ne pas effectuer le backup avant la mise à jour. Ce qui veut dire que la mise à jour se fera sans sauvegarde de sécurité.
-- `YNH_FORCE_UPGRADE`: Force la mise à jour de l'application et du package, même si l'application est déjà à jour.
diff --git a/app_wallabag2.md b/app_wallabag2.md
deleted file mode 100644
index 823bcd06..00000000
--- a/app_wallabag2.md
+++ /dev/null
@@ -1,33 +0,0 @@
-## 
-
-[Wallabag](https://www.wallabag.org/) is a self hostable Read-It-Later application allowing
-you to not miss any content anymore. Click, save, read it when you can.
-It extracts content so that you can read it when you have time.
-
-[](https://install-app.yunohost.org/?app=wallabag2)
-
-It provides a web interface, browser (Firefox / Chrome / Opera) add-ons, mobile apps (Android / iOS / Windows Phone) and even on e-reader (PocketBook / Kobo)
-
-### Features
-
-In addition to Wallabag core features, the following are made available with
-this package:
-
- * Integrate with YunoHost users and SSO - i.e. logout button
- * Allow one user to be the administrator (set at the installation)
- * Asynchronous import using Redis (need to be enabled in the *Internal Settings*). RabbitMQ import not supported (yet ?)
-
-### Links
-
- * Report a bug: https://github.com/YunoHost-Apps/wallabag2_ynh/issues
- * Wallabag website: https://www.wallabag.org/
- * Wallabag documentation: https://doc.wallabag.org/ (fr/en/it/de)
- * [Video demo](https://vimeo.com/video/167435064)
-
-----
-
-### Upgrade from v1.x
-
-No automatic upgrade process is available. You need a manual (but simple) migration from [Wallabag v1](https://github.com/YunoHost-Apps/wallabag_ynh).
-Please take a look at the [official documentation](https://doc.wallabag.org/en/user/import/wallabagv1.html).
diff --git a/app_wallabag2_fr.md b/app_wallabag2_fr.md
deleted file mode 100644
index ba387f5c..00000000
--- a/app_wallabag2_fr.md
+++ /dev/null
@@ -1,30 +0,0 @@
-##
-
-
-[Wallabag](https://www.wallabag.org/) est une application de lecture différée : elle permet simplement d’archiver une page web en ne conservant que le contenu. Les éléments superflus (menus, publicités, etc.) sont supprimés.
-
-Sont disponibles: une interface web, des add-ons pour navigateurs (Firefox / Chrome / Opera), des applications pour mobile (Android / iOS / Windows Phone) et même sur liseuse (PocketBook / Kobo).
-
-[](https://install-app.yunohost.org/?app=wallabag2)
-
-### Fonctionnalités
-
-En plus des fonctionnalités principales de Wallabag, ce paquet propose également:
-
- * Une intégration avec le système de gestion des utilisateurs et le SSO de Yunohost - e.g. un bouton de déconnexion
- * De permettre à un utilisateur d'être administrateur (réglage lors de l'installation)
- * Un import asynchrone utilisant Redis (à activer dans les *Paramètres Internes*). L'import via RabbitMQ n'est pas (encore ?) supporté.
-
-### Liens
-
- * Rapport de bug: https://github.com/YunoHost-Apps/wallabag2_ynh/issues
- * Site web de Wallabag: https://www.wallabag.org/
- * Documentation de Wallabag: https://doc.wallabag.org/ (fr/en/it/de)
- * [Demo vidéo](https://player.vimeo.com/video/167435064)
-
- ----
-
- ### Mettre à niveau depuis la v1.x
-
-La mise à niveau depuis le paquet Yunohost de [Wallabag v1](https://github.com/YunoHost-Apps/wallabag_ynh) demande une opération manuelle, c'est pourquoi un nouveau paquet est fournit.
-Pour le processus de migration, merci de vous référer à [la documentation officiel de Wallabag](https://doc.wallabag.org/fr/user/import/wallabagv1.html).
diff --git a/app_yunofav.md b/app_yunofav.md
deleted file mode 100644
index 181abe8d..00000000
--- a/app_yunofav.md
+++ /dev/null
@@ -1,5 +0,0 @@
-#Yunofav : (unofficial) Page of favorite links for Yunohost
-
-homepage: https://github.com/YunoHost-Apps/yunofav_ynh
-
-Functionality: Creates a page for your favorite links, using the Yunohost tiles look and feel.
\ No newline at end of file
diff --git a/app_yunofav_fr.md b/app_yunofav_fr.md
deleted file mode 100644
index fd312736..00000000
--- a/app_yunofav_fr.md
+++ /dev/null
@@ -1,6 +0,0 @@
-# Yunofav : (non officiel) Page de liens favoris pour Yunohost
-
-page d'accueil : https://github.com/YunoHost-Apps/yunofav_ynh
-
-
-Fonctionnalité : Crée une page pour vos liens préférés, en utilisant le style et le fonctionnement des tuiles Yunohost.
\ No newline at end of file
diff --git a/apps.md b/apps.md
deleted file mode 100644
index 7b5ff79b..00000000
--- a/apps.md
+++ /dev/null
@@ -1,368 +0,0 @@
-# Application catalog
-
-
-This page requires Javascript enabled to display properly :s.
-
-
-
-* Select `Graphical install`
-
-* Select your language, your location and your keyboard layout
-
-* If a partitioning screen appears, confirm.
-
-
-
-
-* Sélectionnez `Graphical install`
-
-* Sélectionnez votre langue, votre localisation et votre agencement de clavier.
-
-* Si un écran de partitionnement apparaît, confirmez simplement.
-
- 
-
-
----
-
-## USB stick
-
-### With Etcher
-
-Download Etcher for your operating system and install it.
-
-
-
-Plug your USB stick, select your YunoHost ISO and click "Flash"
-
-### With UNetbootin
-
-Download UNetbootin for your operating system and install it.
-
-
-
-Put your USB stick on, select your YunoHost ISO and click "OK"
-
-### With `dd`
-
-If you know your way around command line, you may also flash your USB stick with
-`dd`. Assuming your USB stick is `/dev/sdz` (be careful !!), you may run :
-
-```bash
-dd if=/path/to/yunohost.iso of=/dev/sdz
-```
-
----
-
-## CD/DVD
-
-The software to use differs regarding your operating system.
-
-* On Windows, use [ImgBurn](http://www.imgburn.com/) to write the image file on the disc
-
-* On Mac OS, use [Disk Utility](http://support.apple.com/kb/ph7025)
-
-* On GNU/Linux, you have plenty of choices, like [Brasero](https://wiki.gnome.org/Apps/Brasero) or [K3b](http://www.k3b.org/)
diff --git a/burn_or_copy_iso_fr.md b/burn_or_copy_iso_fr.md
deleted file mode 100644
index c2849fbe..00000000
--- a/burn_or_copy_iso_fr.md
+++ /dev/null
@@ -1,48 +0,0 @@
-# Flasher l'ISO YunoHost sur une clef USB ou un CD/DVD
-
-Maintenant que vous avez téléchargé l’image ISO de YunoHost, vous devez la mettre sur un support physique. Classiquement, il s'agit d'une **Clé USB** mais pour certaines raisons vous pouvez aussi utiliser un **CD/DVD**.
-
-
-
-
----
-
-## Clé USB
-
-### Avec Etcher
-
-Téléchargez Etcher pour votre système d'exploitation et installez-le.
-
-
-
-Branchez votre clef USB, selectionnez l'ISO YunoHost puis cliquez sur 'Flash'
-
-### Avec UNetbootin
-
-Téléchargez UNetbootin pour votre système d'exploitation et installez-le.
-
-
-
-Branchez votre clef USB, selectionnez l'ISO YunoHost puis cliquez sur 'OK'
-
-### Avec `dd`
-
-Si vous êtes familier avec la ligne de commande, il est possible de flasher la
-clef USB avec `dd`. En supposant que votre clef USB soit `/dev/sdz` (faites
-attention !!), vous pouvez exécuter :
-
-```bash
-dd if=/chemin/de/yunohost.iso of=/dev/sdz
-```
-
----
-
-## CD/DVD
-
-Le logiciel à utiliser est différent suivant votre système d’exploitation.
-
-* Sur Windows, utilisez [ImgBurn](http://www.imgburn.com/) pour écrire l’image sur le disque
-
-* Sur Mac OS, utilisez [Disk Utility](http://support.apple.com/kb/ph7025)
-
-* Sur GNU/Linux, vous avez plusieurs choix, tels que [Brasero](https://wiki.gnome.org/Apps/Brasero) ou [K3b](http://www.k3b.org/)
diff --git a/certificate_custom.md b/certificate_custom.md
deleted file mode 100644
index 29b129cb..00000000
--- a/certificate_custom.md
+++ /dev/null
@@ -1 +0,0 @@
-Unfortunately, this page only exists [in french here](certificate_custom_fr) for now.
diff --git a/change_admin_password.md b/change_admin_password.md
deleted file mode 100644
index e1feb7f9..00000000
--- a/change_admin_password.md
+++ /dev/null
@@ -1,21 +0,0 @@
-#Change administration password
-
-For security reasons you may have to change your administration password. To achieve this, 2 different methods exists.
-
--YunoHost depends exclusively on the participation of people like you. -
- ---- - -In any case, please come chat with us on [the dev chatroom](/chat_rooms) :-)
- diff --git a/contribute_ar.md b/contribute_ar.md deleted file mode 100644 index 8ad74232..00000000 --- a/contribute_ar.md +++ /dev/null @@ -1,92 +0,0 @@ -#-إنّ مصير واي يونوهوست YunoHost يُقرّره أناس و أنتم مِن بين هؤلاء -
- ---- - -على أي حال تعالوا و انضموا إلى [غرفة المحادثة الخاصة بالمطوّرين](xmpp:dev@conference.yunohost.org?join) إن كنتم ترغبون في المساهمة :-)
- diff --git a/contribute_fr.md b/contribute_fr.md deleted file mode 100644 index dd785aaa..00000000 --- a/contribute_fr.md +++ /dev/null @@ -1,90 +0,0 @@ -# Contribuer - --YunoHost dépend entièrement de la participation de gens comme vous. -
- ---- - -Dans tous les cas, venez discuter avec nous sur [le salon de développement](/chat_rooms) :-)
- diff --git a/contributordoc.md b/contributordoc.md deleted file mode 100644 index 4570723d..00000000 --- a/contributordoc.md +++ /dev/null @@ -1,36 +0,0 @@ -# Contributor documentation - -* [General ways of contributing to YunoHost](/contribute) -* [Writing documentation](/write_documentation) -* [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) - * [How to use Git to package apps](/packaging_apps_git) - * [Setting up a dev environment with VirtualBox](/packaging_apps_virtualbox) - * [Manifest](packaging_apps_manifest) - * [Scripts](packaging_apps_scripts) - * [Arguments management](packaging_apps_arguments_management) - * [Nginx configuration](packaging_apps_nginx_conf) - * [Multi-instance](packaging_apps_multiinstance) - * [Helpers](packaging_apps_helpers) - * [Trap usage](/packaging_apps_trap) - * [Adding your app to the community list](https://github.com/YunoHost/Apps/#contributing) - * Quality tests - * [Package linter](https://github.com/YunoHost/package_linter) - * [Package check](https://github.com/YunoHost/package_check) - * [Applications levels](/packaging_apps_levels) - * [App Continuous Integration](https://ci-apps.yunohost.org) - * [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) -* [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) -* [A discussion about shell variable scope](shell_variables_scope) diff --git a/contributordoc_fr.md b/contributordoc_fr.md deleted file mode 100644 index 4c932803..00000000 --- a/contributordoc_fr.md +++ /dev/null @@ -1,37 +0,0 @@ -# Guide du contributeur - -* [Liste des façons de contribuer à YunoHost](/contribute) -* [Écrire de la documentation](/write_documentation) -* [Salons de discussion](/chat_rooms) -* Packaging d'application - * [Liste d'apps souhaitées par la communauté](/apps_wishlist) - * [Introduction générale au packaging d'apps](/packaging_apps_start) - * [Introduction technique au packaging d'apps](/packaging_apps) - * [Comment utiliser Git pour packager les applications](/packaging_apps_git) - * [Déployer un environnement de développement avec VirtualBox](/packaging_apps_virtualbox) - * [Manifest](/packaging_apps_manifest) - * [Scripts](/packaging_apps_scripts) - * [Gestion des arguments](/packaging_apps_arguments_management) - * [Configuration nginx](/packaging_apps_nginx_conf) - * [Multi-instance](/packaging_apps_multiinstance) - * [Fonctions utiles](/packaging_apps_helpers) - * [Utilisation de 'trap'](/packaging_apps_trap) - * [Ajouter son application à la liste community](https://github.com/YunoHost/Apps/#contributing) - * Tests de qualité - * [Package linter](https://github.com/YunoHost/package_linter) - * [Package check](https://github.com/YunoHost/package_check) - * [Niveaux des applications](/packaging_apps_levels) - * [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) - * [YEP - YunoHost Enhancement Proposals](/packaging_apps_guidelines) -* [Contribuer à la partie "core" de YunoHost](/dev) - * [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) -* [Une discussion sur la portée des variables en bash](shell_variables_scope) diff --git a/copy_image.md b/copy_image.md deleted file mode 100644 index 50d3e68b..00000000 --- a/copy_image.md +++ /dev/null @@ -1,47 +0,0 @@ -# Flashing an SD card - -Now that you download the YunoHost image, you have to copy its content to an SD -card. This step is also sometimes called 'flashing' the SD card. - -
-
-### With Etcher
-
-Download Etcher for your
-operating system and install it.
-
-
-
-Plug your SD card, select your YunoHost image and click "Flash"
-
-### With `dd`
-
-If you are on Linux / Mac and know your way around command line, you may also
-flash your SD card with `dd`. You can identify which device corresponds to your
-SD card with `fdisk -l` or `lsblk`. Assuming your SD card is `/dev/mmcblk0` (be
-careful !!), you may run :
-
-```bash
-dd if=/path/to/yunohost.img of=/dev/mmcblk0
-```
-
-## Expand the root partition (optional)
-
-
-
-Preview of the Gparted window
diff --git a/copy_image_es.md b/copy_image_es.md deleted file mode 100644 index c979e3e2..00000000 --- a/copy_image_es.md +++ /dev/null @@ -1,39 +0,0 @@ -# Flashear una tarjeta SD - -Ahora que has descargado la imagen de Yunohost, tienes que copiar su contenido en una tarjeta SD. Esta etapa también puede llamarse 'flashear' la tarjeta SD. - -
-
-### Con Etcher
-
-Descarga Etcher para tu sistema operativo, e instálalo.
-
-
-
-Conecta tu tarjeta SD, selecciona tu imagen Yunohost y luego haz clic en 'Flash'.
-
-### Con `dd`
-
-Si estás en Linux / Mac y que estás cómodo con la línea de comandos, también puedes flashear tu tarjeta SD con el comando `dd`. Empieza por identificar el periférico que corresponde a tu tarjeta SD con `fdisk -l` o
-`lsblk`. Suponiendo que tu tarjeta SD sea `/dev/mmcblk0` (¡ ten cuidado
-!), puedes iniciar :
-
-```bash
-dd if=/chemin/vers/yunohost.img of=/dev/mmcblk0
-```
-
-## Extiende la partición root (optionnel)
-
-
-
-Vistazo de la interfaz de Gparted
diff --git a/copy_image_fr.md b/copy_image_fr.md deleted file mode 100644 index 3e5ff1f1..00000000 --- a/copy_image_fr.md +++ /dev/null @@ -1,52 +0,0 @@ -# Flasher une carte SD - -Maintenant que vous avez téléchargé l'image de YunoHost, il vous faut copier son -contenu sur une carte SD. Cette étape est aussi souvent appelé 'flasher' la -carte SD. - -
-
-### Avec Etcher
-
-Télécharger Etcher pour votre
-système d'exploitation, et installez-le.
-
-
-
-Connectez votre carte SD, sélectionnez votre image YunoHost, puis cliquez sur
-'Flash'.
-
-### Avec `dd`
-
-Si vous êtes sous Linux / Mac et que vous êtes à l'aise avec la ligne de
-commande, vous pouvez aussi flasher votre carte SD avec `dd`. Commencez par
-identifier le périphérique correspondant à votre carte SD avec `fdisk -l` ou
-`lsblk`. En supposant que votre carte SD soit `/dev/mmcblk0` (faites attention
-!), vous pouvez lancer :
-
-```bash
-dd if=/chemin/vers/yunohost.img of=/dev/mmcblk0
-```
-
-## Étendre la partition root (optionnel)
-
-
-
-Aperçu de l’interface de Gparted
diff --git a/dev_fr.md b/dev_fr.md deleted file mode 100644 index 2251fbfe..00000000 --- a/dev_fr.md +++ /dev/null @@ -1,164 +0,0 @@ -## Contribuer au cœur de YunoHost - -Vous souhaitez ajouter une nouvelle fonctionnalité au cœur de YunoHost, mais ne -savez pas comment procéder ? Ce guide parcourt les étapes du développement et du -processus de contribution. - -Si vous cherchez quelque chose à implémenter ou un bug à réparer, le -bug tracker est [ici](https://github.com/yunohost/issues/issues) ! - -**Venez dire coucou sur le [salon de dev](/chat_rooms)** ! - -### Mettre en place un environnement de développement - -- **Utilisez [ynh-dev](https://github.com/YunoHost/ynh-dev)** (voir le README) - pour mettre en place un environnement de développement - en local sur une - machine virtuelle, ou bien sur un VPS. - Ceci installera une instance fonctionelle de YunoHost, en utilisant - directement les dépôts git à l'aide de liens symboliques. De cette façon, il - vous sera possible de modifier les fichiers, de tester les changements en - temps réel, et de commiter et push/pull directement depuis cet environnement. - -- **Implémentez et testez votre fonctionnalité**. Suivant ce sur quoi vous - voulez travailler : - - **Cœur Python/ligne de comande** : allez dans `/ynh-dev/yunohost/` - - **Interface d'administration web** : allez dans `/ynh-dev/yunohost-admin/` - - Vous pouvez aussi travailler sur les autres projets liés sur lesquels - s'appuie YunoHost (SSOwat, moulinette) de façon similaire. - -### Vue d'ensemble des 4 morceaux principaux de YunoHost - -##### Moulinette - -C'est un petit framework "fait maison". [Son rôle principal](https://moulinette.readthedocs.io/en/latest/actionsmap.html) -est de permettre de construire une API Web et une API en ligne de commande à partir d'un même code Python et d'un schéma YAML que nous appelons -[l'actionmap] (https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/actionsmap/yunohost.yml). - -Il prend en charge d'autres mécanismes tels que l'authentification, l'internationalisation et des petites fonctions utilitaires techniques (par ex. lecture/écriture de fichiers json). - -Moulinette dispose de sa propre documentation [ici](https://moulinette.readthedocs.io/en/latest/). - -##### YunoHost - -C'est le coeur même de YunoHost. Il contient : -- [le code Python](https://github.com/YunoHost/yunohost/tree/stretch-unstable/src/yunohost) qui gère les utilisateurs, domaines, applications, services et autres -- des [helpers bash](https://github.com/YunoHost/yunohost/tree/stretch-unstable/data/helpers.d) principalement utilisés par les packageurs d'applications dans les scripts de ces applications -- des [hooks](https://github.com/YunoHost/yunohost/tree/stretch-unstable/data/hooks) et [templates](https://github.com/YunoHost/yunohost/tree/stretch-unstable/data/templates) qui sont utilisés pour configurer les différents éléments de l'écosystème tels que nginx, postfix, .... -- des [chaînes internationalisées](https://github.com/YunoHost/yunohost/tree/stretch-unstable/locales) -- des [tests](https://github.com/YunoHost/yunohost/tree/stretch-unstable/src/yunohost/tests) - -##### SSOwat - -C'est le système de connexion unique (single sign-on) de YunoHost. Il contient principalement: -- [du code LUA](https://github.com/YunoHost/ssowat) interfacé directement avec nginx et qui gère tous les aspects "techniques" de l'authentification et de la gestion des accès aux ressources. -- le [portail web utilisateur](https://github.com/YunoHost/SSOwat/tree/stretch-unstable/portal) qui est l'interface finale visible par les utilisateurs de YunoHost - -SSOwat est configuré via `/etc/ssowat/conf.json` qui est généré par YunoHost. - -##### YunoHost-admin - -C'est une dépendance *optionnelle* de YunoHost et correspond à une interface pour l'API web créée par YunoHost et Moulinette (service `yunohost-api`). - -Il contient essentiellement : -- [des templates pour les vues](https://github.com/YunoHost/yunohost-admin/tree/stretch-unstable/src/views) -- les [contrôleurs JavaScript](https://github.com/YunoHost/yunohost-admin/tree/stretch-unstable/src/js/yunohost/controllers) correspondants, qui interagissent avec l'API YunoHost -- et ses [chaînes internationalisées](https://github.com/YunoHost/yunohost-admin/tree/stretch-unstable/src/locales) - -### Travailler sur le cœur Python / ligne de commande - -- Allez dans `/ynh-dev/yunohost/`. - -- Exécutez `cd /ynh-dev && ./ynh-dev use-git yunohost`. - -- Le fichier actionsmap (`data/actionsmap/yunohost.yml`) définit les différentes - catégories, actions et arguments de la ligne de commande YunoHost. Choisissez - comment vous voulez que les utilisateurs utilisent votre fonctionnalité, et - ajoutez/éditez les catégories, actions et arguments correspondants. Par - exemple, dans `yunohost domain add some.domain.tld`, la catégorie est - `domain`, l'action est `add` et `some.domain.tld` est un argument. - -- Moulinette va automatiquement faire le lien entre les commandes de - l'actionsmap et les fonctions Python (ainsi que leurs arguments) dans - `src/yunohost/`. Par exemple, `yunohost domain add some.domain.tld` - déclenchera un appel de `domain_add(domainName)` dans `domain.py`, avec l'argument - `domainName` qui vaudra `"some.domain.tld"`. - -##### Helpers / style de code - -- Pour gérer les exceptions, il existe un type `YunohostError()` - -- Pour aider avec l'internationalisation des messages, utilisez `m18n.n('some-message-id')` - et mettez le message correspondant dans `locales/en.json`. Vous pouvez aussi - utiliser des arguments pour construire les messages, avec `{{some-argument:s}}`. - Ne modifiez pas de fichiers de locales autres que en.json, la traduction sera - faite avec [Weblate](https://translate.yunohost.org/) ! - -- YunoHost essaye de suivre le style de code [PEP8](http://pep8.org/). Des - outils existent pour vérifier automatiquement la conformité du code. - -- Mettre un `_` devant les noms des fonctions "privées". - -### Travailler sur l'interface d'administration web - -- Allez dans `/ynh-dev/yunohost-admin/src/`. - -- Exécutez `cd /ynh-dev && ./ynh-dev use-git yunohost-admin`. Ceci lance gulp, de sorte - qu'à chaque fois que vous modifiez les sources, il recompilera le code - (JS) et vous pourrez voir les changements dans le navigateur web (Ctrl+F5). - Pour stopper la commande, faites simplement Ctrl+C. - -- L'interface web utilise une API pour communiquer avec YunoHost. Les - commandes/requêtes de l'API sont également définies dans l'actionsmap. Par - exemple, accéder à la page ```https://domain.tld/yunohost/api/users``` - correspond à une requête `GET /users` vers l'API YunoHost. Cette requête - est mappée sur `user_list()`. Accéder à cette URL devrait afficher le json - retourné par cette fonction. Les requêtes 'GET' sont typiquement destinées à - demander de l'information au serveur, tandis que les requêtes 'POST' sont - destinées à demander au serveur de modifier/changer des informations ou de - réaliser des actions. - -- `js/yunohost/controllers` contient les parties JavaScript, et définit quelles - requêtes faire à l'API pendant le chargement d'une page donnée de l'interface, - et comment traiter les données récupérées pour générer la page, en utilisant - des templates. - -- `views` contient les templates des pages de l'interface. Dans le template, - les données venant du JavaScript peuvent être utilisées avec la syntaxe - `{{some-variable}}`, qui sera remplacée pendant la construction de la page. - Il est également possible d'avoir des conditions avec la syntaxe - d'[handlebars.js](http://handlebarsjs.com) : ```{{#if - some-variable}}du HTML conditionnel ici !
{{/if}}``` - -- Pour l'internationalisation des messages, utilisez `y18n.t('some-string-code')` - dans le JavaScript, ou `{{t 'some-string-code'}}` dans le template HTML, et - mettez votre message dans `locales/en.json`. Ne modifiez pas de fichiers de - locales autres que en.json, la traduction sera faite avec - [Weblate](https://translate.yunohost.org/) ! - -##### N'oubliez pas - -- À chaque modification de l'actionsmap, il faut redémarrer l'API yunohost : - ```service yunohost-api restart``` - (Il faudra retaper le mot de passe administrateur dans l'interface web) - -- Il faudra peut-être régulièrement forcer le rafraîchissement du cache - navigateur pour propager correctement le JavaScript et/ou HTML (à chaque fois - que l'on change quelque chose dans `js` ou `views`, donc). - - -### Votre fonctionnalité est prête et vous souhaitez qu'elle soit intégrée dans YunoHost - -- Forkez le dépòt correspondant sur Github, et commitez vos changements dans - une nouvelle branche, Il est recommandé de nommer la branche avec la - convention suivante : - - Pour une nouvelle fonctionnalité ou amélioration : `enh-ISSUENUMBER-description-fonctionnalité` - - Pour une correction de bug : `fix-REDMINETICKET-description-correctif` - - `ISSUENUMBER` est optionnel et correspond au numéro du ticket sur le bug tracker - -- Une fois prêt, ouvrez une Pull Request (PR) sur Github. De préférence, inclure - `[fix]` ou `[enh]` au début du titre de la PR. - -- Après relecture, test et validation par les autres contributeurs, votre - branche sera mergée dans `unstable` ! - - diff --git a/diagnostic.md b/diagnostic.md deleted file mode 100644 index df76baee..00000000 --- a/diagnostic.md +++ /dev/null @@ -1,53 +0,0 @@ -# Diagnose YunoHost functioning - -If you have successfully [installed](/install) YunoHost and passed through the [post-installation](/postinstall), you probably have a **working server**. - -### 1. Test it - -In a web browser, access to your server via the domain name you just entered at the post-installation step. - -For example: `http://mydomain.com` - - --You can also redirect ports manually to your server's local IP address on the router's configuration interface. -
--Vous pouvez également rediriger les ports manuellement vers l’adresse IP locale de votre serveur grâce à l’interface de configuration de votre box/routeur. -
-
-
-- Desde la interfaz de administración de tu servidor Yunohost :
- en Herramientas > Estado del servidor > Red
-
-
-- O desde tu router o tu caja Internet, dependiendo de su modelo.
-
-## Configurar el DNS de la caja Internet o del router
-
-Vas a crear una redirección que estará activa en toda tu red local. El objetivo es crear una redirección DNS hacia el IP de tu servidor en tu caja Internet. Hay que acceder a la interfaz de configuración de tu caja y a los parámetros DNS, y luego crear una redirección local (por ejemplo, yunohost.local puede redigir hacia 192.168.21).
-
-## Configurar el archivo [hosts](https://es.wikipedia.org/wiki/Archivo_hosts) del ordenador cliente
-Sólo deberías modificar el archivo hosts si no puedes modificar el DNS de tu caja Internet / router, porque el archivo hosts únicamente afectará el ordenador en el cual el archivo esté modificado.
-
-- En Windows, encontrarás el archivo hosts aquí :
- `%SystemRoot%\system32\drivers\etc\`
- > Es preciso visualizar los archivos y sistemas escondidos para ver el archivo hosts.
-- En sistemas UNIX (GNU/Linux, Mac OS), lo encontrarás aquí :
- `/etc/hosts`
- > Necesitarás derechos root para modificar el archivo.
-
-Simplemente añade al final del archivo hosts una linea conteniendo la dirección IP privada del servidor y tu nombre de dominio
-
-```bash
-192.168.1.62 domain.tld
-```
diff --git a/dns_nohost_me.md b/dns_nohost_me.md
deleted file mode 100644
index 2452f9fc..00000000
--- a/dns_nohost_me.md
+++ /dev/null
@@ -1,73 +0,0 @@
-# Nohost.me domains
-
-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.
-
-The following (sub)domains are proposed:
-- `whateveryouwant.nohost.me`;
-- `whateveryouwant.noho.st`;
-- `whateveryouwant.ynh.fr`.
-
-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.
-
-#### Subdomains
-
-The `nohost.me`, `noho.st` and `ynh.fr` domain service does not allow the creation of
-subdomains.
-
-Even if YunoHost allows the installation of applications on subdomains (for
-example, having the Owncloud application accessible from the
-`cloud.mydomain.org` address), this feature is not allowed with the `nohost.me`
-and `noho.st` domains and it is not possible to have a subdomain such as `my
-application.mydomain.nohost.me`.
-
-To be able to enjoy applications that can only be installed at the root of a
-domain name, you must have your own domain name.
-
-### Adding a nohost.me, noho.st or ynh.fr domain after the post-installation
-
-If you already did the postinstall and want to add an automatic domain, you
-may do so from the "Domains" web interface, selecting the option "I don't have a domain name..."
-
-Alternatively, the following commands can be used.
-
-```bash
-# Add the domain
-yunohost domain add whateveryouwant.nohost.me
-
-# Subscribe/register to the dyndns service
-yunohost dyndns subscribe -d whateveryouwant.nohost.me
-
-# [ wait ~ 30 seconds ]
-
-# Update the DNS conf
-yunohost dyndns update
-
-# Set it as the main domain
-yunohost tools maindomain --new-domain whateveryouwant.nohost.me
-```
-
-#### Retrieve a nohost.me, noho.st or ynh.fr domain
-
-If you reinstall your server and want to use a domain already used previously,
-you must request a domain reset on the forum
-[in the dedicated thread](https://forum.yunohost.org/t/nohost-domain-recovery/442).
-
-
-#### Change a nohost.me, noho.st or ynh.fr domain
-
-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 doamin remove` 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`
-
-You may then add a new domain.
diff --git a/dns_resolver.md b/dns_resolver.md
deleted file mode 100644
index de33802b..00000000
--- a/dns_resolver.md
+++ /dev/null
@@ -1,30 +0,0 @@
-# YunoHost DNS Resolver
-
-+-YunoHost's documentation has 2 different sections: -
- -Including installation, server management and application management
-Which contains everything you have to know about us and the way we work
--دليل واي يونوهوست YunoHost يرتكز أساسًا على ثلاثة محاور : -
- -يتطرق إلى طريقة التنصيب و إدارة السيرفر و التطبيقات
-يحتوي على كافة المعلومات التي تخصنا و أسلوب عملنا و مساهمتنا
--Die YunoHost Dokumentation ist in 2 Bereiche aufgeteilt: -
- -Befasst sich mit den Installationsschritten und der Verwaltung von Server und Apps.
-Alles, was du über uns und unsere Art zu arbeiten wissen musst.
--La documentation de YunoHost s’articule autour de deux sections : -
- -Incluant l’installation, la gestion du serveur et des applications
-Qui contient tout ce que vous devez savoir à propos de nous et de notre manière de travailler
--La documentazione di YunoHost ha 2 differenti sezioni: -
- -Include l'installazione, la gestione del server e delle applicazioni
-Contiene tutto quello che devi sapere su di noi e su come lavoriamo
-
Configurer Mozilla Thunderbird
-
-Pour configurer manuellement un nouveau compte dans Thunderbird commencez par remplir les informations de base (Nom, adresse et mot de passe), cliquez sur Continuer puis Configuration Manuelle. Enlevez le `.` avant le nom de domaine. Sélectionnez le port 993 avec SSL/TLS pour IMAP, et le port 587 avec STARTTLS pour SMTP. Sélectionnez 'Mot de passe normal' pour l'authentification. Testez la configuration puis validez. (Il vous faudra ensuite possiblement accepter des certificats pour que tout fonctionne correctement.)
-
-
-
-
-* [Gérer les alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
-
-### 
Configurer K-9 Mail (sur Android)
-
-Suivez les instructions suivantes. (Comme pour Thunderbird, il vous faudra peut-être accepter des certificats à un moment)
-
-
-
-
-
-
-### 
Configure Dekko (on Ubuntu Touch)
-
-La première fois, vous pouvez simplement choisir "Ajouter un compte". Si vous avez déjà un compte configuré, appuyez sur le menu hamburger puis sur le rouage, choisissez Courrier, Comptes et appuyez sur le symbole " + ".
-
-Sélectionnez ensuite IMAP. Remplissez les champs et appuyez sur Suivant. Dekko va ensuite chercher la configuration. Vérifiez que tous les champs sont corrects. Assurez-vous d'avoir votre nom d'utilisateur yunohost, PAS votre adresse e-mail et choisissez "Autoriser les certificats non fiables". Faites ceci pour IMAP et SMTP et appuyez sur Suivant. Dekko va ensuite synchroniser le compte après quoi vous aurez terminé. Félicitations !
-
-
-
-
-
diff --git a/fail2ban.md b/fail2ban.md
deleted file mode 100644
index aa6acf5b..00000000
--- a/fail2ban.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# Fail2ban
-
-Fail2Ban is an intrusion prevention software that protects computer servers from brute-force attacks. It monitors some log files and will ban IP addresses that shows brute-force-like behavior.
-
-In particular, Fail2ban monitors SSH connection attempts. After 5 failed login attempts on SSH, Fail2ban will ban the corresponding IP address from connecting through SSH for 10 minutes. If this IP is found to recidive several times, it might get ban for a week.
-
-## Unban an IP
-
-To unban an IP from fail2ban, you first need to access your server by some mean (e.g. from another IP by the one being banned).
-
-Then look at fail2ban's log to identify in which jail the IP was put :
-
-```bash
-$ tail /var/log/fail2ban.log
-2019-01-07 16:24:47 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
-2019-01-07 16:24:49 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
-2019-01-07 16:24:51 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
-2019-01-07 16:24:54 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
-2019-01-07 16:24:57 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
-2019-01-07 16:24:57 fail2ban.actions [1837]: NOTICE [sshd] Ban 11.22.33.44
-2019-01-07 16:24:57 fail2ban.filter [1837]: NOTICE [recidive] Ban 11.22.33.44
-```
-
-Here, the IP `11.22.33.44` was banned in the `sshd` and `recidive` jails.
-
-Then unban the IP with the following commands :
-
-```bash
-$ fail2ban-client set sshd unbanip 11.22.33.44
-$ fail2ban-client set recidive unbanip 11.22.33.44
-```
-
diff --git a/fail2ban_fr.md b/fail2ban_fr.md
deleted file mode 100644
index cac68680..00000000
--- a/fail2ban_fr.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# Fail2ban
-
-Fail2Ban est un logiciel de prévention des intrusions qui protège les serveurs informatiques contre les attaques de brute-force. Il surveille certains journaux et bannira les adresses IP qui montrent un comportement de brute-forcing.
-
-En particulier, Fail2ban surveille les tentatives de connexion SSH. Après 5 tentatives de connexion échouées sur SSH, Fail2ban banniera l'IP de se connecter via SSH pendant 10 minutes. Si cette adresse récidive plusieurs fois, elle peut être bannie pendant une semaine.
-
-## Débannir une IP
-
-Pour débloquer une IP de fail2ban, vous devez d'abord accéder à votre serveur par un moyen quelconque (par exemple à partir d'une autre IP que celle bannie).
-
-Ensuite, regardez le journal de fail2ban pour identifier dans quelle 'prison' (jail) l'IP a été bannie :
-
-```bash
-$ tail /var/log/fail2ban.log
-2019-01-07 16:24:47 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
-2019-01-07 16:24:49 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
-2019-01-07 16:24:51 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
-2019-01-07 16:24:54 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
-2019-01-07 16:24:57 fail2ban.filter [1837]: INFO [sshd] Found 11.22.33.44
-2019-01-07 16:24:57 fail2ban.actions [1837]: NOTICE [sshd] Ban 11.22.33.44
-2019-01-07 16:24:57 fail2ban.filter [1837]: NOTICE [recidive] Ban 11.22.33.44
-```
-
-Ici, l'IP `11.22.33.44` a été bannie dans les jails `sshd` et `recidive`.
-
-Puis débanissez l'IP avec les commandes suivantes :
-
-```bash
-$ fail2ban-client set sshd unbanip 11.22.33.44
-$ fail2ban-client set recidive unbanip 11.22.33.44
-```
-
diff --git a/filezilla_fr.md b/filezilla_fr.md
deleted file mode 100644
index 1eb993e6..00000000
--- a/filezilla_fr.md
+++ /dev/null
@@ -1,87 +0,0 @@
-# Échanger des fichiers avec son serveur à l'aide d'une interface graphique
-
-Cette page explique comment échanger des fichiers (sauvegardes, musiques,
-photos, films, ...) avec son serveur à l'aide d'un outil graphique. C'est donc
-une méthode alternative au fait d'utiliser la commande `scp` qui peut être jugée
-technique et cryptique, ou de devoir installer Nextcloud.
-
-[FileZilla](https://filezilla-project.org/) permet d'accomplir cela. Il s'agit
-d'un logiciel libre disponible pour Windows, Linux et MacOS.
-
-## Télécharger et installer FileZilla
-
-Vous pouvez télécharger FileZilla depuis [cette page](https://filezilla-project.org/download.php?type=client).
-Le site devrait détecter automatiquement la version nécessaire pour votre ordinateur.
-Sinon, suivez les instructions pour [installer le client](https://wiki.filezilla-project.org/Client_Installation)
-
-Installez le programme et lancez *Filezilla*.
-
-## Configuration
-
-1. Cliquez sur l'icône *Gestionnaire de Sites* en haut à gauche de sorte à crééer une configuration utilisable ultérieurement.
-
- 
-
-2. Cliquez sur **Nouveau site** et donnez un nom au serveur que vous allez utiliser. Par exemple "Famille". Remplissez les paramètres comme sur la capture d'écran (en remplaçant l'adresse du serveur par la votre). Une fois terminé, cliquez sur **Connexion**. (N.B. : si vous souhaitez éditer les fichiers de l'application [custom webapp](https://github.com/YunoHost-Apps/my_webapp_ynh), il vous faudra utiliser un autre utilisateur que admin. Se référer à la documentation de custom webapp.)
-
- 
-
-3. Vous recevrez un avertissement. *Vous pouvez l'ignorer si il s'agit de la première connexion*.
-
- 
-
-4. Filezilla vous demande maintenant le mot de passe `admin` pour vous connecter à votre serveur
-
- 
-
-5. Une fois cette configuration créée, elle sera réutilisable les fois suivanteS.
-
- 
-
-
Demo server
-
-
-
-
-* A x86-compatible hardware dedicated to YunoHost: laptop, nettop, netbook, desktop.
-You can use any computer with **256MB RAM or more**.
-* Another computer to read this guide and access to your server.
-* A [reasonable ISP](/isp), preferably with a good and unlimited upstream bandwidth
-* A **USB stick** of at least 1GB capacity **OR** a standard **blank CD**
-* ***Particular case*** : If your server has no graphic card, [prepare iso for booting with serial port](https://github.com/luffah/debian-mkserialiso).
-
----
-
-## Installation steps
-
-
-0. Download the YunoHost ISO image
-
-1. Burn the ISO image on a USB stick
-
-2. Boot the machine and run the installation
-
-3. Proceed with the initial configuration (post-installation)
-
----
-
-To connect directly to your computer or with [SSH](/ssh) (only on local network:
-* User: **root**
-* Password: **yunohost**
-
diff --git a/install_iso_es.md b/install_iso_es.md
deleted file mode 100644
index 51b5889d..00000000
--- a/install_iso_es.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# Instalación en un ordenador
-
-*Encontrar otros medios de instalar Yunohost **[aquí](/install)**.*
-
-## Prerrequisitos
-
-
-
-
-
-* Un ordenador compatible x86 dedicado a YunoHost : portátil, netbook, ordenador de escritorio. Puedes reutilizar calquiera máquina con **256 Mo de RAM mínimo**
-* Otro ordenador para examinar esta guía y acceder a tu servidor
-* Un [proveedor de Internet ético](/isp), de preferencia con acceso de buena velocidad (ascendente)
-* Una **memoria USB** con capacidad mínima de 1Go **O** un **CD en blanco** estándar
-* ***Casos particulares*** : si tu servidor no tiene tarjeta gráfica, hay que preparar un iso que se inicie sobre el puerto de serie](https://github.com/luffah/debian-mkserialiso).
-
----
-
-## Etapas de instalación
-
-0. Descargar la imagen ISO
-
-1. Copiar la imagen ISO
-
-2. Encender e instalar
-
-3. Post-instalación
-
----
-
-Para conectarse directamente al ordenador (únicamente en local) :
-* Usuario : **root**
-* Contraseña : **yunohost**
-
-
-## Casos específicos / avanzados
-
-si el ordenador no tiene tarjeta gráfica pero sí tiene un puerto de serie : hay que modificar el ISO para un inicio con la consola de serie. Una solución es utilizar [un script que modifica las opciones de inicio](https://github.com/luffah/debian-mkserialiso).
diff --git a/install_iso_fr.md b/install_iso_fr.md
deleted file mode 100644
index 85bddef8..00000000
--- a/install_iso_fr.md
+++ /dev/null
@@ -1,38 +0,0 @@
-# Installation sur ordinateur
-
-*Trouvez d’autres moyens d’installer YunoHost **[ici](/install)**.*
-
-## Prérequis
-
-
-
-
-
-* Un matériel compatible x86 dédié à YunoHost : portable, netbook, ordinateur. Vous pouvez réutiliser n’importe quelle machine avec **256 Mo de RAM minimum**
-* Un autre ordinateur pour parcourir ce guide et accéder à votre serveur
-* Un [fournisseur d’accès correct](/isp), de préférence avec une bonne vitesse de téléversement (débit montant)
-* Une **clé USB** d’une capacité minimum d’1Go **OU** un **CD vierge** standard
-* ***Cas particulier*** : Si votre serveur n'a pas de carte graphique, il faut [préparer un iso qui démarre sur le port série](https://github.com/luffah/debian-mkserialiso).
-
----
-
-## Étapes d’installation
-
-0. Télécharger l'image ISO de YunoHost
-
-1. Flasher l’image ISO sur une clef USB
-
-2. Démarrer la machine et installer YunoHost
-
-3. Effectuer la configuration initiale (post-installation)
-
----
-
-Pour se connecter directement sur l’ordinateur (uniquement en local) :
-* Utilisateur : **root**
-* Mot de passe : **yunohost**
-
-
-## Cas spécifiques / avancés
-
-Si l'ordinateur n'a pas de carte graphique mais a un port série : il faut modifier l'ISO pour démarrer avec la console série. Une solution est d'utiliser [un script qui modifie les options de démarrage](https://github.com/luffah/debian-mkserialiso).
diff --git a/install_iso_it.md b/install_iso_it.md
deleted file mode 100644
index b16d068e..00000000
--- a/install_iso_it.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# Installazione in un computer
-
-*Altri modi per installare YunoHost **[Clicca qui](/install)**.*
-
-### Requisiti
-
-
-
-
-
-* Un computer con architettura x86: laptop, nettop, netbook, desktop.
-Puoi usare qualsiasi computer con minimo 256mb di ram**.
-* Un altro computer per leggere questa guida e per accedere al tuo server.
-* un [buon ISP](/isp), possibilmente con una banda illimitata.
-* una **chiavetta usb** da almeno 1gb **O** un classico **cd/dvd vuoto**
-* ***casi particolari*** : se il tuo server non ha una scheda video, [prepara l'iso per fare il boot con la porta seriale}(https://github.com/luffah/debian-mkserialiso).
-
----
-
-## Installazione
-
-
-0. Scarica l'ISO di YunoHost
-
-1. Scrivi l'immagine disco su una chiavetta usb
-
-2. Accendi il computer facendo il boot da usb
-
-3. Procedi con la prima configurazione (post-installation)
-
----
-
-To connect directly to your computer or with [SSH](/ssh) (only on local network:
-* User: **root**
-* Password: **yunohost**
-
-
diff --git a/install_it.md b/install_it.md
deleted file mode 100644
index 8fa8f550..00000000
--- a/install_it.md
+++ /dev/null
@@ -1,89 +0,0 @@
-# Guida all'installazione
-
-Ci sono diverse maniere per installare YunoHost. Il procedimento può essere leggermente diverso a seconda che si esegua a casa o su un server remoto, e dipende dall'hardware usato:
-**[Vedi i requisiti](/hardware)**
-
-Questa pagina elenca alcune guide all'installazione.
-
----
-
-Server demo
-
-
-
-
-
-
-
-
-An ARM box, a VPS, a dedicated server, a standard x86 computer, an old Macintosh, ...
-
-* with **Debian 9** (Stretch) installed (with kernel >= 3.12)
- * the Debian 9 ISO can be downloaded from [here](https://www.debian.org/releases/stretch/debian-installer/). Take the 'netinst CD image' for your architecture.
- * N.B. : having a graphical environment is *not* recommended! Servers are meant to be administrated remotely!
-* connected to the Internet
-* with a direct **root access** or via SSH
-
----
-
-## Installation steps
-
-1. Install manually
-
-2. Post-install
-
diff --git a/install_on_debian_ar.md b/install_on_debian_ar.md
deleted file mode 100644
index 455830f8..00000000
--- a/install_on_debian_ar.md
+++ /dev/null
@@ -1,23 +0,0 @@
-
-
-على منصة ARM أو على خادوم إفتراضي خاص أو على خادوم إستضافة أو على حاسوب x86 عادي أو على حاسوب ماكينطوش قديم … إلخ
-
-* على **ديبيان 8** (جيسي) قد تم تنصيبه مِن قبل
-* مُتصل بالإنترنت عبر كابل إيثرنت
-* مباشرة عبر **النفاذ بالمستخدم الجذري root** أو عبر الـ SSH
-
----
-
-## خطوات التنصيب
-
-1. التنصيب يدويًا
-
-2. ما بعد التنصيب
-
diff --git a/install_on_debian_fr.md b/install_on_debian_fr.md
deleted file mode 100644
index eaa21951..00000000
--- a/install_on_debian_fr.md
+++ /dev/null
@@ -1,24 +0,0 @@
-# Installation sur Debian
-
-*Trouvez d’autres moyens d’installer YunoHost **[ici](/install)**.*
-
-## Prérequis
-
-
-
-Sur une plateforme ARM, un VPS, un serveur dédié, un ordinateur x86 standard, un vieux Macintosh,...
-
-* avec **Debian 9** (Stretch) installé (avec un kernel >= 3.12)
- * l'ISO Debian 9 ISO peut être téléchargée depuis [cette page](https://www.debian.org/releases/stretch/debian-installer/). Prenez la 'netinst CD image' pour votre architecture
- * N.B. : Avoir un environnement graphique n'est *pas* recommandé ! Les serveurs sont généralement administrés à distance !
-* connecté à Internet
-* avec un **accès root** directement ou par SSH
-
----
-
-## Étapes d’installation
-
-1. Installer manuellement
-
-2. Post-installation
-
diff --git a/install_on_debian_it.md b/install_on_debian_it.md
deleted file mode 100644
index e306592d..00000000
--- a/install_on_debian_it.md
+++ /dev/null
@@ -1,23 +0,0 @@
-# Installazione su Debian
-
-*Altri sistemi per installare Debian **[qui](/install)**.*
-
-### Requisiti
-
-
-
-Su un computer ARM, un VPS, un server dedicato, un computer x86 standard, un vecchio Macintosh, ...
-
-* con **Debian 9** (Stretch) installato (con un kernel >= 3.12)
- * l'immagine ISO di Debian 9 può essere scaricata da [qui](https://www.debian.org/releases/stretch/debian-installer/). Scegli l'immagine 'netinst CD' per la tua architettura.
- * N.B.: l'uso di un'interfaccia grafica *non* è raccomandato! I server dovrebbero essere amministrati da remoto!
-* connesso ad Internet
-* con un **accesso root** diretto o via SSH
-
----
-
-## Passi per l'installazione
-
-1. Installazione manuale
-
-2. Post-installazione
\ No newline at end of file
diff --git a/install_on_raspberry.md b/install_on_raspberry.md
deleted file mode 100644
index fa204721..00000000
--- a/install_on_raspberry.md
+++ /dev/null
@@ -1,60 +0,0 @@
-# Install YunoHost on a Raspberry Pi
-
-*Find all the ways to install YunoHost **[here](/install)**.*
-
-
-
-
-
-
-
-
-
-
-
-* An x86 computer with VirtualBox installed and enough RAM capacity to be able to run a small virtual machine.
-* The latest stable **YunoHost ISO image**, available [here](/images).
-
-
-
-
-
-
-
-
-
-
-
-* Un ordenador x86 con VirtualBox instalado y bastante RAM disponible para iniciar una pequeña máquina virtual.
-* La última **imagen ISO YunoHost** estable, disponible [aquí](/images).
-
-
-
-
-
-
-
-
-
-
-
-* Un ordinateur x86 avec VirtualBox installé et assez de RAM disponible pour lancer une petite machine virtuelle.
-* La dernière **image ISO YunoHost** stable, disponible [ici](/images).
-
-
-
-
-
-
-
-
-
-
-
-* A dedicated or virtual private server
-* with at least **512MB** RAM
-* and **Debian 9.x (Stretch) 64bits** as operating system
-
----
-
-## Installation steps
-
-1. Install manually
-
-2. Proceed with the initial configuration (post-installation)
-
-
diff --git a/install_on_vps_es.md b/install_on_vps_es.md
deleted file mode 100644
index f6eb2eb7..00000000
--- a/install_on_vps_es.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# Instalación en un servidor dedicado
-
-*Encontrar otros medios de instalar Yunohost **[aquí](/install)**.*
-
-## Prerrequisitos
-
-
-
-* Un servidor dedicado o virtual
-* con al menos **512MB** RAM
-* y **Debian 9.x (Stretch) 64bits** como sistema operativo
-
----
-
-## Etapas de instalación
-
-1. Instalar manualmente
-
-2. Post-instalación
-
diff --git a/install_on_vps_fr.md b/install_on_vps_fr.md
deleted file mode 100644
index a0924cb8..00000000
--- a/install_on_vps_fr.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# Installation sur un serveur dédié
-
-*Trouvez d’autres moyens d’installer YunoHost **[ici](/install)**.*
-
-## Prérequis
-
-
-
-* Un serveur dédié ou virtuel
-* avec au moins **512MB** RAM
-* et **Debian 9.x (Stretch) 64bits** comme système d'exploitation
-
----
-
-## Étapes d’installation
-
-1. Installer manuellement
-
-2. Effectuer la configuration initiale (post-installation)
diff --git a/install_on_vps_it.md b/install_on_vps_it.md
deleted file mode 100644
index b10d9344..00000000
--- a/install_on_vps_it.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# Installa su un server dedicato
-
-*Scopri altri modi di installare YunoHost **[qui](/install)**.*
-
-### Pre-requisiti
-
-
-
-* Un server dedicato o un server privato virtuale (VPS)
-* con almeno **512MB** di RAM
-* e **Debian 9.x (Stretch) 64bits** come sistema operativo
-
----
-
-## Procedura di installazione
-
-1. Installa manualmente
-
-2. Post-installazione
-
diff --git a/isp_free.md b/isp_free.md
deleted file mode 100644
index e97c35fb..00000000
--- a/isp_free.md
+++ /dev/null
@@ -1 +0,0 @@
-Unfortunately, this page only exists [in french here](isp_free_fr) for now.
diff --git a/isp_orange.md b/isp_orange.md
deleted file mode 100644
index 87a29d12..00000000
--- a/isp_orange.md
+++ /dev/null
@@ -1,85 +0,0 @@
-# Orange
-*Find the list of other Internet service providers **[here](/isp)**.*
-
-#### Email
-
-The Orange box has port 25 closed so as to limit the amount of spam that could be sent from a compromised home connection.
-
-The remaining solution to host one own's email at home is to route it through the Orange SMTP servers.
-
-To that end, one has to edit the postfix configuration file with the following command:
-
-```bash
-sudo nano /etc/postfix/main.cf
-```
-
-then, add the SMTP Orange server as a relay on the associated line:
-
-```bash
-relayhost = smtp.orange.fr
-```
-
-restart Postfix :
-
-```bash
-sudo service postfix restart
-```
-
-##### Problems
-
-If you are having an "Authentication required" error, the solution is as follows (note: french website): **[source](http://viruslocker.free.fr/?page_id=1749)**.
-
-Edit the postfix configuration file
-
-```bash
-sudo nano /etc/postfix/main.cf
-```
-then, add the following lines:
-
-```bash
-smtp_sasl_password_maps = hash:/etc/postfix/sasl/mdp_fai.conf
-smtp_sasl_auth_enable = yes
-smtp_sasl_security_options = noanonymous
-relayhost = [smtp.orange.fr]:25
-```
-
-Create the `mdp_fai.conf` file :
-
-```bash
-sudo nano /etc/postfix/sasl/mdp_fai.conf
-```
-
-add
-
-```bash
-# mdp_fai.conf
-[smtp.orange.fr]:25 emailaddress@at.orange:my-own-password
-```
-with your Orange account password.
-
-Integrate the password into Postfix :
-
-```bash
-sudo postmap /etc/postfix/sasl/mdp_fai.conf
-sudo postconf -e smtp_sasl_password_maps=hash:/etc/postfix/sasl/mdp_fai.conf
-```
-
-If you are having an "(SASL authentication failed; cannot authenticate to server smtp-auth.nowhere.com[38.123.22.160]: no mechanism available)" error
-
-Check that `libsasl2-modules` and `sasl2-bin` are present :
-
-```bash
-apt search libsasl2-modules
-apt search sasl2-bin
-```
-
-If they are not present, do install them :
-
-```bash
-apt install libsasl2-modules sasl2-bin
-```
-
-It is possible that postfix does not immediately take into account your modifications. To force it to do so, run
-```bash
-systemctl restart postfix
-```
diff --git a/isp_sfr.md b/isp_sfr.md
deleted file mode 100644
index e5002600..00000000
--- a/isp_sfr.md
+++ /dev/null
@@ -1 +0,0 @@
-Unfortunately, this page only exists [in french here](isp_sfr_fr) for now.
diff --git a/noaccess.md b/noaccess.md
deleted file mode 100644
index a2ed2d20..00000000
--- a/noaccess.md
+++ /dev/null
@@ -1 +0,0 @@
-Unfortunately, this page only exists [in french here](noaccess_fr) for now.
diff --git a/orga/README.md b/orga/README.md
deleted file mode 120000
index aa9ff0cb..00000000
--- a/orga/README.md
+++ /dev/null
@@ -1 +0,0 @@
-yunohost_project_organization_fr.md
\ No newline at end of file
diff --git a/default_es.md b/orphaned/default.es.md
similarity index 97%
rename from default_es.md
rename to orphaned/default.es.md
index 6b8c21f5..41876311 100644
--- a/default_es.md
+++ b/orphaned/default.es.md
@@ -1,4 +1,4 @@
-#Nueva página
+# Nueva página
Esta página todavía no existe, puedes editarla tecleando ```
+ 
+ 
+ 
+
+ 
+ 
+ 
+ 
+ 
+
Configurar Mozilla Thunderbird (en un ordenador)
+
+###  Configurar Mozilla Thunderbird (en un ordenador)
Para configurar manualmente un nuevo cuenta en Thunderbird, añadir las informaciones de la cuenta, y después seleccionar el puerto 993 con SSL/TLS para IMAP, y puerto 587 con STARTTLS para SMTP. Después seleccionar 'Normal Password' para Autenticación y haz click en el botón 'Advanced Config'. Se puede que tendrás que aceptar los certificados para que todo funciona normalmente.
-
-
+
+
* [Gestionar un alias para una dirección de correo electrónico](https://support.mozilla.org/es/kb/configurar-un-alias-para-una-direccin-de-correo-el)
-### Configurar K-9 Mail (en Android)
+###  Configurar K-9 Mail (en Android)
Seguir los pasos a continuación. (Como para Thunderbird, se puede que tendrás que aceptar los certificados para que funciona normalmente.)
-
-
-
-
+
+
+
+
diff --git a/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.fr.md b/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.fr.md
new file mode 100644
index 00000000..cde298ef
--- /dev/null
+++ b/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.fr.md
@@ -0,0 +1,51 @@
+---
+title: Configurer un client email
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/email_configure_client'
+---
+
+Vous pouvez récupérer et envoyer des emails avec votre instance YunoHost grâce à des logiciels comme Mozilla Thunderbird, ou sur votre smartphone grâce à des applications comme K-9 Mail.
+
+Normalement, votre client email devrait recevoir la configuration automatiquement lorsque vous ajoutez un compte. Si cela ne fonctionne pas, il est possible de le faire manuellement en suivant les quelques étapes suivantes. (Cependant, cela devrait être compris comme étant un bug dans YunoHost, et le cas échéant, c'est cool si vous nous notifiez du problème pour que nous puissions tenter de reproduire et corriger le problème !)
+
+### Réglages génériques
+
+Voici les éléments que vous devrez entrer pour configurer manuellement votre client email (`domain.tld` fait référence à ce qui est après le @ dans votre adresse email, et `nom_dutilisateur` ce qui est avant @).
+
+| Protocole | Port | Chiffrement | Authentification | Login |
+| :--: | :-: | :--: | :--: | :--: |
+| IMAP | 993 | SSL/TLS | Mot de passe normal | `nom_dutilisateur` (sans `@domain.tld`) |
+| SMTP | 587 | STARTTLS | Mot de passe normal | `nom_dutilisateur` (sans `@domain.tld`) |
+
+
+###  Configurer Mozilla Thunderbird
+
+Pour configurer manuellement un nouveau compte dans Thunderbird commencez par remplir les informations de base (Nom, adresse et mot de passe), cliquez sur Continuer puis Configuration Manuelle. Enlevez le `.` avant le nom de domaine. Sélectionnez le port 993 avec SSL/TLS pour IMAP, et le port 587 avec STARTTLS pour SMTP. Sélectionnez 'Mot de passe normal' pour l'authentification. Testez la configuration puis validez. (Il vous faudra ensuite possiblement accepter des certificats pour que tout fonctionne correctement.)
+
+
+
+
+* [Gérer les alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
+
+###  Configurer K-9 Mail (sur Android)
+
+Suivez les instructions suivantes. (Comme pour Thunderbird, il vous faudra peut-être accepter des certificats à un moment)
+
+
+
+
+
+
+###  Configure Dekko (on Ubuntu Touch)
+
+La première fois, vous pouvez simplement choisir "Ajouter un compte". Si vous avez déjà un compte configuré, appuyez sur le menu hamburger puis sur le rouage, choisissez Courrier, Comptes et appuyez sur le symbole " + ".
+
+Sélectionnez ensuite IMAP. Remplissez les champs et appuyez sur Suivant. Dekko va ensuite chercher la configuration. Vérifiez que tous les champs sont corrects. Assurez-vous d'avoir votre nom d'utilisateur yunohost, PAS votre adresse email et choisissez "Autoriser les certificats non fiables". Faites ceci pour IMAP et SMTP et appuyez sur Suivant. Dekko va ensuite synchroniser le compte après quoi vous aurez terminé. Félicitations !
+
+
+
+
+
diff --git a/email_configure_client.md b/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.md
similarity index 66%
rename from email_configure_client.md
rename to pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.md
index a2511674..67388a3e 100644
--- a/email_configure_client.md
+++ b/pages/01.administrate/06.overview/08.emails/02.emailclients/email_configure_client.md
@@ -1,4 +1,11 @@
-## Configuring email client
+---
+title: Configuring email client
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/email_configure_client'
+---
You can fetch and send emails using your YunoHost instance from desktop email clients such as Mozilla Thunderbird or on your smartphone with applications like K-9 Mail.
@@ -13,31 +20,32 @@ Here are the element you should enter to manually configure your mail client (`d
| IMAP | 993 | SSL/TLS | Normal password | `username` (without the `@domain.tld`) |
| SMTP | 587 | STARTTLS | Normal password | `username` (without the `@domain.tld`) |
-### Configure Mozilla Thunderbird (on a desktop computer)
+###  Configure Mozilla Thunderbird (on a desktop computer)
To manually configure a new account in Thunderbird, add the account information, then select port 993 with SSL/TLS for IMAP, and port 587 with STARTTLS for SMTP. Afterwards select 'Normal Password' for Authentication and click on 'Advanced Config'. You may need to accept the certificate exceptions for fetching mails and after you send your first mail. Don't forget to remove the dot before the domain name.
-
-
+
+
* [Manage alias mails](https://support.mozilla.org/en-US/kb/configuring-email-aliases)
-### Configure K-9 Mail (on Android)
+###  Configure K-9 Mail (on Android)
Follow the following steps. (As for Thunderbird, you might need to accept certificates at some points)
-
-
-
-
+
+
+
+
-### Configure Dekko (on Ubuntu Touch)
+
+###  Configure Dekko (on Ubuntu Touch)
The first time you can simply choose "Add account". If you already have an account configured, tap the hamburger menu then tap the gear, choose Mail, Accounts and press the '+'-symbol.
Then you choose IMAP. Fill in the fields and press Next. Now Dekko will look for the configuration. Check that all fields are correct. Make sure you have your yunohost username, NOT your mailadress and choose "Allow untrusted certificates". Do this for IMAP and SMTP and press Next. Dekko will now synchronise the account after which you are done. Congratz!
-
-
-
-
+
+
+
+
diff --git a/pages/01.administrate/06.overview/08.emails/email.de.md b/pages/01.administrate/06.overview/08.emails/email.de.md
new file mode 100644
index 00000000..c6cd979f
--- /dev/null
+++ b/pages/01.administrate/06.overview/08.emails/email.de.md
@@ -0,0 +1,50 @@
+---
+title: E-Mails
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/email'
+---
+
+YunoHost wird mit einem kompletten Mail-Stack geliefert, der es Ihnen ermöglicht, Ihren eigenen E-Mail-Server zu hosten und somit Ihre eigenen E-Mail-Adressen in ```irgendjemand@deine.domain.tld``` zu haben.
+
+Der Mail-Stack enthält einen SMTP-Server (Postfix), einen IMAP-Server (Dovecot), einen Antispam-Server (rspamd) und eine DKIM-Konfiguration.
+
+## Sicherstellen dass Ihre Einrichtungen richtig sind
+
+E-Mail ist ein kompliziertes Ökosystem und eine ganze Reihe von Details können sein ordnungsgemäßes Funktionieren verhindern.
+
+Um Ihre Einstellungen zu validieren:
+
+- Wenn Sie zu Hause selbst hosten und kein VPN verwenden, stellen Sie sicher das [Ihr ISP den Port 25 nicht blockiert](https://yunohost.org/#/isp);
+- leiten Sie Ports weiter, wie in [dieser Dokumentation](https://yunohost.org/#/isp_box_config) beschrieben;
+- Mail-DNS-Einträge nach [dieser Dokumentation](https://yunohost.org/#/dns_config) sorgfältig konfigurieren;
+- testen Sie Ihre Konfiguration mit [Mail-tester.com](https://mail-tester.com/) (Vorsicht : nur 3 Tests pro Domain und Tag sind erlaubt) ;
+
+Eine Punktzahl von mindestens 8~9/10 ist ein angemessenes Ziel.
+
+## E-Mail-Programme
+
+Um mit dem E-Mail-Server zu interagieren (E-Mails lesen und senden), können Sie entweder einen Webclient wie Roundcube oder Rainloop auf Ihrem Server installieren - oder einen Desktop-/Mobil-Client, wie auf [dieser Seite](https://yunohost.org/#/email_configure_client) beschrieben, konfigurieren.
+
+Desktop- und Mobil-Clients haben den Vorteil, dass sie Ihre E-Mails auf das Gerät kopieren, was eine Offline-Anzeige und einen relativen Schutz gegen mögliche Hardware-Ausfälle Ihres Servers ermöglicht.
+
+## Konfigurieren von E-Mail-Aliasen und automatische Weiterleitungen
+
+Mail-Aliase und Weiterleitungen können für jeden Benutzer konfiguriert werden. Beispielsweise wird für den ersten, auf dem Server angelegten Benutzer automatisch ein Alias ```root@the.domain.tld``` konfiguriert. Das bedeutet das eine an diese Adresse gesendete E-Mail im Posteingang des ersten Benutzers endet. Automatische Weiterleitungen können konfiguriert werden, z.B. wenn ein Benutzer kein zusätzliches E-Mail-Konto einrichten möchte und nur E-Mails vom Server, z.B. auf seine E-Mail-Adresse, empfangen möchte.
+
+Eine weitere Funktion, die nur wenigen Leuten bekannt ist, ist die Verwendung von Suffixen, die mit "+" beginnen. Zum Beispiel landen E-Mails, die an ```johndoe+buchung@die.domain.tld``` gesendet werden, automatisch im Ordner ```buchung``` (Kleinbuchstaben) der Mailbox von John Doe oder im Posteingang von John Doe, wenn der Ordner ```buchung``` nicht existiert. Es ist eine praktische Technik, z.B. eine E-Mail-Adresse auf einer Website anzugeben und dann die von dieser Website kommende E-Mail einfach (über automatische Filter) zu sortieren.
+
+## Was passiert wenn mein Server nicht erreichbar ist?
+
+Wenn Ihr Server nicht mehr verfügbar ist, bleiben die an Ihren Server gesendeten E-Mails bis zu ~5 Tage lang in einer Warteschlange auf der Seite des Absenders. Der Hoster des Absenders wird regelmäßig versuchen, die E-Mail erneut zu senden, bis er sie verwirft, falls er sie nicht versenden konnte.
+
+## Formulare zum Entfernen seiner IP-Adresse von der schwarzen Liste
+
+Es ist möglich, dass die von Ihrer YunoHost-Instanz gesendeten E-Mails von den großen E-Mail-Diensten als Spam betrachtet werden. Ist es möglich, dass die IP-Adresse von Ihrem Server bereits früher zum Versenden von Spam verwendet wurde oder dass diese E-Mail-Dienste Ihren Server als Spam-Versender betrachten? Um sicherzustellen, dass die IP-Adresse Ihrer Server nicht in diese schwarzen Listen aufgenommen wird und um sie aus diesen zu entfernen, folgen Sie [diesem Link](https://yunohost.org/#/blacklist_forms).
+
+## Eine Migration von E-Mails von einem E-Mail-Provider zu einer YunoHost-Instanz
+
+Siehe [diese Seite](https://yunohost.org/#/email_migration).
+
diff --git a/email_es.md b/pages/01.administrate/06.overview/08.emails/email.es.md
similarity index 86%
rename from email_es.md
rename to pages/01.administrate/06.overview/08.emails/email.es.md
index 6bb8628f..7bbcc224 100644
--- a/email_es.md
+++ b/pages/01.administrate/06.overview/08.emails/email.es.md
@@ -1,12 +1,17 @@
-Emails
-======
+---
+title: Emails
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/email'
+---
YunoHost integra un ecosistema completo de servidor mail, permitiéndote de alojar tu propia mensajería electrónica, y pues de tener tus propias direcciones email en `algo@tu.dominio.tld`.
Este ecosistema comprende un servidor SMTP (postfix), un servidor IMAP (Dovecot), un antispam (rspamd) y una configuración DKIM.
-Asegurarse de que la configuración esté correcta
--------------------------------
+## Asegurarse de que la configuración esté correcta
Los emails son un ecosistema complicado y una multitud de detalles puedes impedir que funcionen correctamente.
@@ -18,27 +23,23 @@ Para validar que tu configuración es correcta :
Una nota de al menos 8~9/10 es un objetivo razonable.
-Clientes de mensajería
--------------
+## Clientes de mensajería
Para interactuar con el servidor de mail, o sea leer y mandar emails, puedes instalar un cliente web como Roundcube o Rainloop en tu servidor - o configurar un cliente de Desktop o móvil como descrito en [esta página][cette page](/email_configure_client).
Los clientes Desktop o móvil tienen la ventaja de copiar tu emails en el equipo, así permitiendo la consulta desconectada de tus mensajes, y cierta protección frente a la posibilidad de un servidor averiado.
-Configuration de los aliases de mensajeras y de las redirecciones automáticas
--------------------------------------------
+## Configuration de los aliases de mensajeras y de las redirecciones automáticas
Aliases de mensajeras y redirecciones pueden ser configurados por cada usuario. Por ejemplo, el primer usuario creado en el servidor automáticamente dispone de un alias `root@tu.dominio.tld` - lo que significa que un email mandado hacia esta dirección se encontrará en el buzón de entrada de este usuario. Las redirecciones automáticas pueden ser configuradas, por ejemplo si un usuario no quiere configurar una cuenta de correo adicional y simplemente desea recibir correos del servidor en - por ejemplo - su dirección gmail.
Otra función desconocida es el uso del sufijo "+". Por ejemplo, email mandados a `johndoe+sncf@tu.dominio.tld` llegarán en el directorio 'sncf' del buzón de correo de John Dos (o directamente en el buzón si este directorio no existe). Es una técnica práctica que permite proveer una dirección de mail a un sitio y automatizar la clasificación de los correos que te mandará este sitio.
-¿ Qué ocurre si mi servidor se pone indisponible ?
------------------------------------------------
+## ¿ Qué ocurre si mi servidor se pone indisponible ?
Si tu servidor se pone indisponible, los correos electrónicos mandados a tu servir se quedarán en una fila de espera por el lado del expedidor durante aproximadamente 5 días. El proveedor de hosting del expedidor intentará mandarte regularmente el correo, hasta que lo tire si no lo puede enviar.
-Más información
---------------------
+## Más información
-- Existe una página de documentación para [migrar sus emails desde un proveedor de mensajería hacia una instancia Yunohost](/email_migration).
+- Existe una página de documentación para [migrar sus emails desde un proveedor de mensajería hacia una instancia YunoHost](/email_migration).
- Para profundizar tu comprensión del correo electrónico y de sus protocolos, aquí tienes una [conferencia muy interesante](http://www.iletaitunefoisinternet.fr/lemail-par-benjamin-sonntag/index.html)(en francés).
diff --git a/email_fr.md b/pages/01.administrate/06.overview/08.emails/email.fr.md
similarity index 82%
rename from email_fr.md
rename to pages/01.administrate/06.overview/08.emails/email.fr.md
index eb5d0c81..75aca04c 100644
--- a/email_fr.md
+++ b/pages/01.administrate/06.overview/08.emails/email.fr.md
@@ -1,50 +1,52 @@
-Emails
-======
+---
+title: Emails
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/email'
+---
YunoHost est livré avec un écosystème complet de serveur mail, vous permettant d'héberger votre propre serveur de messagerie, et donc d'avoir vos propres adresses email dans `quelquechose@votre.domaine.tld`.
Cet écosystème comprend un serveur SMTP (postfix), un serveur IMAP (Dovecot), un antispam (rspamd) et une configuration DKIM.
-S'assurer que votre configuration est correcte
--------------------------------
+## S'assurer que votre configuration est correcte
Les emails sont un écosystème compliqué et un grand nombre de détails peuvent les empêcher de fonctionner correctement.
Pour valider que votre configuration est correcte :
-- si vous vous hébergez chez vous et n'utilisez pas de VPN, assurez-vous que [votre FAI ne bloque pas le port 25](isp) ;
-- routez les ports selon [cette documentation](isp_box_config) ;
-- configurez soigneusement les enregistrements DNS du courrier électronique selon [cette documentation](dns_config) ;
+- si vous vous hébergez chez vous et n'utilisez pas de VPN, assurez-vous que [votre FAI ne bloque pas le port 25](/isp) ;
+- routez les ports selon [cette documentation](/isp_box_config) ;
+- configurez soigneusement les enregistrements DNS du courrier électronique selon [cette documentation](/dns_config) ;
- Testez votre configuration en utilisant [Mail-tester.com](https://mail-tester.com) (attention : seuls 3 tests par domaine et par jour sont autorisés) ;
Un score d'au moins 8~9/10 est un but raisonnable.
-Clients de messagerie
--------------
+## Clients de messagerie
-Pour interagir avec le serveur de mail, c'est-à-dire lire et envoyer des emails, vous pouvez soit installer un client web comme Roundcube ou Rainloop sur votre serveur - ou configurer un client de bureau ou mobile comme décrit dans [cette page](email_configure_client).
+Pour interagir avec le serveur de mail, c'est-à-dire lire et envoyer des emails, vous pouvez soit installer un client web comme Roundcube ou Rainloop sur votre serveur - ou configurer un client de bureau ou mobile comme décrit dans [cette page](/email_configure_client).
Les clients de bureau ou mobile ont l'avantage de copier vos emails sur l'équipement permettant ainsi la consultation hors ligne et une protection relative face à d'éventuelles pannes matériel de votre serveur.
-Configuration des alias de messagerie et des redirections automatiques
--------------------------------------------
+## Configuration des alias de messagerie et des redirections automatiques
Des alias de messagerie et des redirections peuvent être configurés pour chaque utilisateur. Par exemple, le premier utilisateur créé sur le serveur dispose automatiquement d'un alias `root@votre.domaine.tld` - ce qui signifie qu'un email envoyé vers cette adresse se retrouvera dans la boîte de réception de cet utilisateur. Les redirections automatiques peuvent être configurées, par exemple si un utilisateur ne veut pas configurer un compte de messagerie supplémentaire et souhaite simplement recevoir des courriels du serveur sur, disons, son adresse gmail.
Une autre fonctionnalité méconnue est l'utilisation de suffixe commencant par "+". Par exemple, les emails envoyés à `johndoe+sncf@votre.domaine.tld` atteriront dans le dossier 'sncf' de la boîte mail de John Doe (ou bien directement dans la boîle mail si ce dossier n'existe pas). C'est une technique pratique pour par exemple fournir une adresse mail à un site puis facilement trier (via des filtres automatiques) les courriers venant de ce site.
-Que se passe-t-il si mon serveur devient indisponible ?
------------------------------------------------
+## Que se passe-t-il si mon serveur devient indisponible ?
Si votre serveur devient indisponible, les courriels envoyés à votre serveur resteront dans une file d'attente du côté de l'expéditeur pendant environ 5 jours. L'hébergeur de l'expéditeur tentera régulièrement de renvoyer le courrier, jusqu'à ce qu'il le jette s'il n'a pas pu l'envoyer.
## Formulaires pour enlever son adresse IP des listes noires
+
Il est possible que les emails envoyés depuis votre instance YunoHost soient considérés comme du spam par les grands services de mails.
Il est possible que l’adresse IP de votre serveur a autrefois été utilisé pour envoyé du spam ou que ces services de mails considèrent votre serveur comme émetteur de spams.
Pour s’assurer que l’adresse IP de votre serveur n’est pas dans ces listes et pour l’enlever dans le cas échéant suivez ce [lien](/blacklist_forms).
-Pour aller plus loin
---------------------
+## Pour aller plus loin
-- Il existe une page de documentation pour [migrer ses emails d'un fournisseur de messagerie vers une instance YunoHost](email_migration).
+- Il existe une page de documentation pour [migrer ses emails d'un fournisseur de messagerie vers une instance YunoHost](/email_migration).
- Pour approfondir votre compréhension du courriel et de ses protocoles, voici une [conférence éclairante](https://www.octopuce.fr/conference-lemail-vaste-sujet-par-benjamin-sonntag/)(en français).
diff --git a/email.md b/pages/01.administrate/06.overview/08.emails/email.md
similarity index 72%
rename from email.md
rename to pages/01.administrate/06.overview/08.emails/email.md
index 63525b4c..171955fc 100644
--- a/email.md
+++ b/pages/01.administrate/06.overview/08.emails/email.md
@@ -1,39 +1,41 @@
-Emails
-======
+---
+title: Emails
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/email'
+---
YunoHost comes with a complete mail stack allowing you to host your own email server, and therefore to have your own email addresses in `something@your.domain.tld`.
The mail stack includes a SMTP server (postfix), an IMAP server (Dovecot), an antispam (rspamd) and DKIM configuration.
-Making sure your setup is right
--------------------------------
+## Making sure your setup is right
Email is a complicated ecosystem and quite a few details can prevent it from working properly.
To validate your setup:
-- if you are self-hosting at home and not using a VPN, ensure [your ISP won't block port 25](isp) ;
-- route ports according to [this documentation](isp_box_config) ;
-- carefully configure mail DNS records according to [this documentation](dns_config) ;
+- if you are self-hosting at home and not using a VPN, ensure [your ISP won't block port 25](/isp) ;
+- route ports according to [this documentation](/isp_box_config) ;
+- carefully configure mail DNS records according to [this documentation](/dns_config) ;
- test your setup using [Mail-tester.com](https://mail-tester.com) (be careful : only 3 tests per domain per day are allowed) ;
A score of at least 8~9/10 is a reasonnable goal.
-Email clients
--------------
+## Email clients
-To interact with the email sever (read and send emails), you can either install a webclient such as Roundcube or Rainloop on your server - or configure a desktop/mobile client as described in [this page](email_configure_client).
+To interact with the email sever (read and send emails), you can either install a webclient such as Roundcube or Rainloop on your server - or configure a desktop/mobile client as described in [this page](/email_configure_client).
Desktop and mobile clients have the advantage of copying your emails to the device, allowing offline viewing and relative protection against possible hardware failures of your server.
-Configuring email aliases and auto-forwards
--------------------------------------------
+## Configuring email aliases and auto-forwards
Mail aliases and forwards can be configured for each users. For instance, the first user created on the server automatically has an alias `root@the.domain.tld` configured - meaning that an email sent to this adress will end in the inbox of the first user. Automatic forwards may be configured, for instance if an user doesn't want to configure an additional email account and just wants to receive emails from the server on, say, his/her gmail address.
-Another feature which few people know about is the use of suffixes beginning with "+". For example, emails sent to `johndoe+booking@votre.domaine.tld` will automatically land in the `booking` dir (lowercase) of John Doe's mailbox or in John Doe's inbox if `booking` directory doesn't exist . It is a practical technique for example to provide an e-mail address to a website, then easily sort (via automatic filters) the mail coming from this website.
+Another feature which few people know about is the use of suffixes beginning with "+". For example, emails sent to `johndoe+booking@the.domain.tld` will automatically land in the `booking` dir (lowercase) of John Doe's mailbox or in John Doe's inbox if `booking` directory doesn't exist . It is a practical technique for example to provide an e-mail address to a website, then easily sort (via automatic filters) the mail coming from this website.
-What happens if my server becomes unavailable ?
------------------------------------------------
+## What happens if my server becomes unavailable?
If your server becomes unavailable, emails sent to your server will stay in a pending queue on the sender's side for as long as ~5 days. The sender's hoster will regularly try to resend the email, until it drops it if it was unable to send it.
@@ -42,7 +44,10 @@ It is possible that the sent emails from your YunoHost instance are considered a
Is it possible that the IP address from your server have been previously been used to sent spam or that these email services consider your server as a spam sender.
To ensure that your servers’ IP address isn’t into this blacklists and to remove it from them, follow this [link](/blacklist_forms).
-Migrating email from an email provider to a YunoHost instance
--------------------------------------------------------------
+## Migrating email from an email provider to a YunoHost instance
-See [this page](email_migration).
+See [this page](/email_migration).
+
+## Configuring SMTP relay
+
+See [this page](/email_configure_relay).
\ No newline at end of file
diff --git a/XMPP_es.md b/pages/01.administrate/06.overview/09.xmpp/XMPP.es.md
similarity index 79%
rename from XMPP_es.md
rename to pages/01.administrate/06.overview/09.xmpp/XMPP.es.md
index af443fe1..69466c08 100644
--- a/XMPP_es.md
+++ b/pages/01.administrate/06.overview/09.xmpp/XMPP.es.md
@@ -1,6 +1,15 @@
-# Chat, VoIP y red local con
+---
+title: Chat, VoIP y red local con XMPP
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/XMPP'
+---
-Yunohost está instalado con un servidor de mensajería instantánea Metronome que implementa el [protocolo XMPP](https://es.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol).
+
+
+YunoHost está instalado con un servidor de mensajería instantánea Metronome que implementa el [protocolo XMPP](https://es.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol).
XMPP es un protocolo abierto y extensible que también permite crear salones de discusión, compartir status y datos, echar llamadas en VoIP y hacer videoconferencias.
@@ -8,7 +17,7 @@ Todas las aplicaciones basadas en XMPP son compatibles entre ellas : cuando util
## Cuenta XMPP/Jabber
-Una cuenta XMPP/Jabber está basada en un ID bajo la forma `usuario@dominio.tld`, así como una contraseña. La contraseña es la de la cuenta del usuario de Yunohost.
+Una cuenta XMPP/Jabber está basada en un ID bajo la forma `usuario@dominio.tld`, así como una contraseña. La contraseña es la de la cuenta del usuario de YunoHost.
## Conectarse a XMPP
@@ -21,12 +30,14 @@ También puedes utilizar un cliente Desktop como :
- [Gajim](https://gajim.org/es/) (Linux, Windows)
- [Dino](https://dino.im) (Linux)
- [Thunderbird](https://www.thunderbird.net/es-ES/) (multiplataformas)
+- [Beagle IM](https://beagle.im/) (macOS)
- [Profanity](https://profanity-im.github.io/) (Linux)
... o un cliente smartphone :
- [Conversations](https://conversations.im/) (Android)
- [Xabber](http://xabber.com) (Android)
-- [Movim sous Android](https://movim.eu)
+- [Movim](https://movim.eu) (Android)
+- [ChatSecure](https://chatsecure.org/) (iOS)
- [Siskin IM](https://siskin.im/) (iOS)
- [Monal](https://monal.im/) (iOS)
- [Kaidan](https://www.kaidan.im/) (Ubuntu Touch / Plasma Mobile)
@@ -42,7 +53,7 @@ Es posible cifrar tu conversaciones XMPP con la ayuda de [OMEMO](https://xmpp.or
### Salón de discusión
-Para crear un salón de discusión (Multi-user chat) en tu servidor Yunohost, utiliza el ID nombredelsalon@muc.dominio.tld (donde dominio.tld es el dominio principal de tu servidor).
+Para crear un salón de discusión (Multi-user chat) en tu servidor YunoHost, utiliza el ID nombredelsalon@muc.dominio.tld (donde dominio.tld es el dominio principal de tu servidor).
Si utilizas un nombre de dominio personal, es necesario [añadir una redirección de tipo CNAME para el subdominio `muc.`](/dns_config) en tu servidor DNS.
diff --git a/XMPP_fr.md b/pages/01.administrate/06.overview/09.xmpp/XMPP.fr.md
similarity index 82%
rename from XMPP_fr.md
rename to pages/01.administrate/06.overview/09.xmpp/XMPP.fr.md
index a5d4b0f7..56765e0b 100644
--- a/XMPP_fr.md
+++ b/pages/01.administrate/06.overview/09.xmpp/XMPP.fr.md
@@ -1,6 +1,15 @@
-#Chat, VoIP et réseau social avec
+---
+title: Chat, VoIP et réseau social avec XMPP
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/XMPP'
+---
-Yunohost est installé par défaut avec un serveur de messagerie instantanée Metronome qui implémente le [protocole XMPP](https://fr.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (anciennement connu sous le nom Jabber).
+
+
+YunoHost est installé par défaut avec un serveur de messagerie instantanée Metronome qui implémente le [protocole XMPP](https://fr.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (anciennement connu sous le nom Jabber).
Ce protocole est déjà utilisé par des millions de personnes dans le monde - c'est un protocole ouvert. Toutes les applications basées sur XMPP sont compatibles entre elles : lorsque vous utilisez un client XMPP, vous pouvez interagir avec quiconque possède un compte XMPP.
@@ -10,7 +19,7 @@ XMPP est un protocole extensible - cela signifie que les utilisateurs peuvent co
Pour utiliser XMPP, il est nécessaire de disposer d'un compte dont l'identifiant prends la forme `utilisateur@domaine.tld`, ainsi qu’un mot de passe.
-Sous Yunohost, un compte XMPP est créé automatiquement pour chaque utilisateur. Les identifiants XMPP sont simplement l’adresse courriel principale de l'utilisateur ainsi que son mot de passe.
+Sous YunoHost, un compte XMPP est créé automatiquement pour chaque utilisateur. Les identifiants XMPP sont simplement l’adresse courriel principale de l'utilisateur ainsi que son mot de passe.
## Se connecter à son compte XMPP YunoHost
@@ -24,18 +33,19 @@ Il existe différents types de clients pour se connecter à XMPP.
### Clients de bureau
-- [Gajim](http://gajim.org/fr/) (Linux,Windows)
+- [Gajim](http://gajim.org/fr/) (Linux, Windows)
- [Dino](https://dino.im) (Linux)
- [Thunderbird](https://www.thunderbird.net/) (multiplateforme)
-- [Beagle IM](https://beagle.im/) (Mac OS)
+- [Beagle IM](https://beagle.im/) (macOS)
- [Profanity](https://profanity-im.github.io/) (Linux)
### Clients sur mobile
- [Conversations](https://conversations.im/) (Android)
- [Xabber](http://xabber.com) (Android)
-- [Movim sous Android](https://movim.eu)
+- [Movim](https://movim.eu) (Android)
- [Monal](https://monal.im/) (iOS)
+- [ChatSecure](https://chatsecure.org/) (iOS)
- [Siskin IM](https://siskin.im/) (iOS)
- [Kaidan](https://www.kaidan.im/) (Ubuntu Touch / Plasma Mobile)
@@ -45,13 +55,12 @@ Voici une liste plus exhaustive des clients XMPP : https://fr.wikipedia.org/wik
Il est possible de rendre les conversations plus sécurisées et privées en les chiffrants à l'aide de [OMEMO](https://xmpp.org/extensions/xep-0384.html), notamment en utilisant Gajim :
- Installer `gajim` et le plugin `gajim-omemo`
-- Activez le plugins dans `Outils > Plugins`
-- L'activer
+- Activez le plugin dans `Outils > Plugins`
- Activez le chiffrement dans une conversation avec un contact disposant de OMEMO.
## Salon de discussion
-Pour créer un salon de discussion (Multi-user chat) sur votre serveur Yunohost utilisez l’identifiant nomsalon@muc.domaine.tld (où domaine.tld est le domaine principal de votre serveur).
+Pour créer un salon de discussion (Multi-user chat) sur votre serveur YunoHost utilisez l’identifiant nomsalon@muc.domaine.tld (où domaine.tld est le domaine principal de votre serveur).
Si vous utilisez un nom de domaine personnel, il est nécessaire d’[ajouter une redirection de type CNAME pour le sous domaine `muc.`](/dns_config) au niveau de votre serveur DNS.
diff --git a/pages/01.administrate/06.overview/09.xmpp/XMPP.md b/pages/01.administrate/06.overview/09.xmpp/XMPP.md
new file mode 100644
index 00000000..03767c82
--- /dev/null
+++ b/pages/01.administrate/06.overview/09.xmpp/XMPP.md
@@ -0,0 +1,71 @@
+---
+title: Chat, VoIP and social network with XMPP
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/XMPP'
+---
+
+
+
+By default, YunoHost comes installed with an instant messaging server called Metronome which implements the [XMPP protocol](https://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol) (previously known as Jabber).
+
+This protocol is already used by millions of people around the world—it is an open protocol.
+All applications based on XMPP are compatible with each other: When using an XMPP client, you can interact with anybody who has an XMPP account.
+
+XMPP is an extensible protocol—this means users can configure "extensions" to chatrooms, share messages and files, and make voice and video calls using XMPP.
+
+## XMPP account
+
+To use an XMPP account you need a username, in the format: `user@domain.tld`, and a password.
+
+With YunoHost, an XMPP account is created for all YunoHost users automatically.
+The XMPP account credentials corresponds to the user's main e-mail address and password.
+
+## Connecting to your YunoHost XMPP account
+
+You can connect to your YunoHost XMPP account in different ways.
+
+### Web clients
+
+- [Movim](https://movim.eu)
+- [ConverseJS](https://conversejs.org/)
+- [Libervia/Salut à Toi](https://salut-a-toi.org/)
+
+### Desktop clients
+
+- [Gajim](https://gajim.org/) (Linux, Windows)
+- [Dino](https://dino.im) (Linux)
+- [Thunderbird](https://www.thunderbird.net/fr/) (multiplatform)
+- [Beagle IM](https://beagle.im/) (macOS)
+- [Profanity](https://profanity-im.github.io/) (Linux)
+
+### Mobile clients
+
+- [Conversations](https://conversations.im/) (Android)
+- [Xabber](https://xabber.com) (Android)
+- [Movim](https://movim.eu) (Android)
+- [ChatSecure](https://chatsecure.org/) (iOS)
+- [Monal](https://monal.im/) (iOS)
+- [Siskin IM](https://siskin.im/) (iOS)
+- [Kaidan](https://www.kaidan.im/) (Ubuntu Touch / Plasma Mobile)
+
+Here is an exhaustive list of XMPP clients: https://xmpp.org/software/clients.html
+
+## Encrypt conversations with OMEMO
+
+XMPP chats can be made secure and private using [OMEMO encryption](https://xmpp.org/extensions/xep-0384.html), for instance using Gajim:
+- Install `gajim` and the plugin `gajim-omemo`.
+- Turn on the plugin in `Tools > Plugins`.
+- Turn on the encryption in the chat with somebody who also has OMEMO.
+
+## Chatrooms
+
+To create a chatroom (multi-user chat) on your YunoHost server, use the identifier `chatroomname@muc.yourdomain.tld`.
+
+For this to work you need to [add the corresponding `muc.` DNS record](/dns_config) in the DNS configuration.
+
+## VoIP and videoconferences
+
+A practical tool to call an XMPP client, either with voice or voice+video, is to use the [Jitsi](https://jitsi.org/) client.
diff --git a/backup_fr.md b/pages/01.administrate/06.overview/10.backups/backup.fr.md
similarity index 81%
rename from backup_fr.md
rename to pages/01.administrate/06.overview/10.backups/backup.fr.md
index 163d1301..7ffa29c7 100644
--- a/backup_fr.md
+++ b/pages/01.administrate/06.overview/10.backups/backup.fr.md
@@ -1,10 +1,15 @@
-Sauvegarder son serveur et ses apps
-===================================
+---
+title: Sauvegarder son serveur et ses apps
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/backup'
+---
-Dans le contexte de l'auto-hébergement, les sauvegardes (backup) sont un élément important pour pallier les événements inattendus (incendies, corruption de base de données, perte d'accès au serveur, serveur compromis, ...). La politique de sauvegardes à mettre en place dépend de l'importance des services et des données que vous gérez. Par exemple, sauvegarder un serveur de test aura peu d'intérêt, tandis que vous voudrez être très prudent si vous gérez des données critiques pour une association ou une entreprise - et dans ce genre de cas, vous souhaiterez stocker les sauvegardes *dans un endroit différent*.
+Dans le contexte de l'auto-hébergement, les sauvegardes (backup) sont un élément important pour pallier les événements inattendus (incendies, corruption de base de données, perte d'accès au serveur, serveur compromis...). La politique de sauvegardes à mettre en place dépend de l'importance des services et des données que vous gérez. Par exemple, sauvegarder un serveur de test aura peu d'intérêt, tandis que vous voudrez être très prudent si vous gérez des données critiques pour une association ou une entreprise - et dans ce genre de cas, vous souhaiterez stocker les sauvegardes *dans un endroit différent*.
-Les sauvegardes avec YunoHost
------------------------------
+## Les sauvegardes avec YunoHost
YunoHost contient un système de sauvegarde, qui permet de sauvegarder (et restaurer) les configurations du système, les données "système" (comme les mails) et les applications si elles le supportent.
@@ -12,18 +17,17 @@ Vous pouvez gérer vos sauvegardes via la ligne de commande (`yunohost backup --
La méthode de sauvegarde actuelle consiste à créer des archives `.tar.gz` qui contiennent les fichiers pertinents. Pour le futur, YunoHost envisage de supporter nativement [Borg](https://www.borgbackup.org/) qui est une solution plus flexible, performante et puissante pour gérer des sauvegardes.
-Créer des sauvegardes
----------------------
+## Créer des sauvegardes
#### Depuis la webadmin
Vous pouvez facilement créer des archives depuis la webadmin en allant dans Sauvegardes > Archives locales et en cliquant sur "Nouvelle sauvegarde". Vous pourrez ensuite sélectionner les éléments à sauvegarder (configuration, données "système", applications).
-
+
#### Depuis la ligne de commande
-Vous pouvez créer de nouvelles archives depuis la ligne de commande. Voici quelques exemples de commandes et leur comportement correspondant:
+Vous pouvez créer de nouvelles archives depuis la ligne de commande. Voici quelques exemples de commandes et leur comportement correspondant :
- Tout sauvegarder (système et apps)
```bash
@@ -59,8 +63,7 @@ Lors d'une mise à jour, les apps contenant une grande quantité de données eff
Pour désactiver manuellement la sauvegarde des données volumineuses, pour les applications qui implémentent cette fonctionnalité, vous pouvez définir la variable `BACKUP_CORE_ONLY`. Pour ce faire, la variable doit être définie avant la commande de backup : `sudo BACKUP_CORE_ONLY=1 yunohost backup create --apps nextcloud`. Soyez prudent : il vous faudra alors sauvegarder vous-même les données des utilisateurs de Nextcloud. Choisir ce type de sauvegarde vous permettra de mettre en place manuellement des sauvegardes incrémentielles ou différentielles (que YunoHost ne permet pas encore de faire automatiquement).
-Télécharger et téléverser des sauvegardes
------------------------------------------
+## Télécharger et téléverser des sauvegardes
Après avoir créé des sauvegardes, il est possible de les lister et de les inspecter grâce aux vues correspondantes dans la webadmin, ou via `yunohost backup list` et `yunohost backup info 
+
diff --git a/dns_dynamicip.md b/pages/01.administrate/07.specific_use_cases/01.domains/02.dns_dynamic_ip/dns_dynamicip.md
similarity index 59%
rename from dns_dynamicip.md
rename to pages/01.administrate/07.specific_use_cases/01.domains/02.dns_dynamic_ip/dns_dynamicip.md
index 9d4223a5..8e6924e5 100644
--- a/dns_dynamicip.md
+++ b/pages/01.administrate/07.specific_use_cases/01.domains/02.dns_dynamic_ip/dns_dynamicip.md
@@ -1,11 +1,29 @@
-# DNS with a dynamic IP
+---
+title: DNS with a dynamic IP
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/dns_dynamicip'
+---
-
+
You're good to go !
diff --git a/dns_subdomains_fr.md b/pages/01.administrate/07.specific_use_cases/01.domains/03.dns_subdomains/dns_subdomains.fr.md
similarity index 84%
rename from dns_subdomains_fr.md
rename to pages/01.administrate/07.specific_use_cases/01.domains/03.dns_subdomains/dns_subdomains.fr.md
index 132ffe18..53a070d6 100644
--- a/dns_subdomains_fr.md
+++ b/pages/01.administrate/07.specific_use_cases/01.domains/03.dns_subdomains/dns_subdomains.fr.md
@@ -1,4 +1,11 @@
-## DNS et sous-domaines pour les applications
+---
+title: DNS et sous-domaines pour les applications
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/dns_subdomains'
+---
### Sous-domaines
@@ -10,17 +17,17 @@ Dans la configuration de son DNS, on aura donc une entrée A avec l’adresse IP
Nom Type Valeur
```bash
@ A XYZ.XYZ.XYZ.XYZ
-@ AAAA 1234:1234:1234:FFAA:FFAA:FFAA:FFAA:AAFF
-* CNAME mondomaine.fr.
-agenda CNAME mondomaine.fr.
-blog CNAME mondomaine.fr.
-rss CNAME mondomaine.fr.
+@ AAAA 1234:1234:1234:FFAA:FFAA:FFAA:FFAA:AAFF
+* CNAME mondomaine.fr.
+agenda CNAME mondomaine.fr.
+blog CNAME mondomaine.fr.
+rss CNAME mondomaine.fr.
```
-permet d’avoir un `agenda.mondomaine.fr`, un `blog.mondomaine.fr` etc…
+permet d’avoir un `agenda.mondomaine.fr`, un `blog.mondomaine.fr` etc.
### Installer une application sur un sous-domaine
-Pour installer une application sur un sous-domaine, par exemple `blog.mondomaine.fr`, dans YunoHost, tout se fait via la partie administration. On ajoute tout d’abord le sous-domaine à la liste des domaines disponibles. La création d’un sous-domaine dans YunoHost créera les fichiers de configuration correspondants pour Nginx (le serveur web de YunoHost).
+Pour installer une application sur un sous-domaine, par exemple `blog.mondomaine.fr`, dans YunoHost, tout se fait via la partie administration. On ajoute tout d’abord le sous-domaine à la liste des domaines disponibles. La création d’un sous-domaine dans YunoHost créera les fichiers de configuration correspondants pour NGINX (le serveur web de YunoHost).
Puis dans la partie installation d’une application, on installe l’application de façon traditionnelle en choisissant ce sous-domaine comme domaine (par exemple `blog.mondomaine.fr`) et en indiquant comme chemin `/` (et non `/wordpress` qui est le chemin par défaut). On a alors un message d’avertissement indiquant qu’on ne pourra plus installer d’applications sur ce sous-domaine. On valide. Ça s’installe.
diff --git a/dns_subdomains.md b/pages/01.administrate/07.specific_use_cases/01.domains/03.dns_subdomains/dns_subdomains.md
similarity index 88%
rename from dns_subdomains.md
rename to pages/01.administrate/07.specific_use_cases/01.domains/03.dns_subdomains/dns_subdomains.md
index 8f0b5a35..c70a0291 100644
--- a/dns_subdomains.md
+++ b/pages/01.administrate/07.specific_use_cases/01.domains/03.dns_subdomains/dns_subdomains.md
@@ -1,4 +1,11 @@
-## DNS and subdomains for the applications
+---
+title: DNS and subdomains for the applications
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/dns_subdomains'
+---
### Subdomains
@@ -21,7 +28,7 @@ then you can access `agenda.mydomain.com`, `blog.mydomain.com` and `rss.mydomain
### Install an application on a subdomain
-To install an application on a subdomain in YunoHost, for example `blog.mydomain.com`, the configuration is done in the administration panel. One first add the subdomain to the available domains list. The creation of a subdomain in Yunohost will create the corresponding configuration files for Nginx (the web server used in YunoHost).
+To install an application on a subdomain in YunoHost, for example `blog.mydomain.com`, the configuration is done in the administration panel. One first add the subdomain to the available domains list. The creation of a subdomain in YunoHost will create the corresponding configuration files for NGINX (the web server used in YunoHost).
Then, in the applications>install panel, one follows the classic installation process by choosing the desired subdomain as domain (for example `blog.mydomain.com`). One needs to choose the path `/` (in place of `/wordpress` for example). A warning message will appear telling that it won't be possible to install other application to this subdomain. After validation, the installation starts.
diff --git a/pages/01.administrate/07.specific_use_cases/01.domains/04.dns_local_network/dns_local_network.es.md b/pages/01.administrate/07.specific_use_cases/01.domains/04.dns_local_network/dns_local_network.es.md
new file mode 100644
index 00000000..dcb362d7
--- /dev/null
+++ b/pages/01.administrate/07.specific_use_cases/01.domains/04.dns_local_network/dns_local_network.es.md
@@ -0,0 +1,41 @@
+---
+title: Local network access to your server
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/dns_local_network'
+---
+
+After completing your server installation, it is possible that your domain will not be accessible through the local network. This is an issue known as [hairpinning](http://en.wikipedia.org/wiki/Hairpinning) - a feature that is not well supported by some internet routers.
+
+To solve this issue you can:
+- configure your router's DNS
+- or alternatively - your /etc/hosts files on your clients workstation
+
+### Find the local IP address of your server
+
+First you need to find out the local IP of your server
+- either using the tricks lister [here](/finding_the_local_ip)
+- or if in the webadmin, in the Diagnosis section, under Internet Connectivity, IPv4, click on 'Details' and you should find an entry for 'Local IP'
+- or using the command line on the server : `hostname -I`
+
+## Configurar el DNS de la caja Internet o del router
+
+Vas a crear una redirección que estará activa en toda tu red local. El objetivo es crear una redirección DNS hacia el IP de tu servidor en tu caja Internet. Hay que acceder a la interfaz de configuración de tu caja y a los parámetros DNS, y luego crear una redirección local (por ejemplo, `yunohost.local` puede redigir hacia `192.168.1.21`).
+
+## Configurar el archivo [hosts](https://es.wikipedia.org/wiki/Archivo_hosts) del ordenador cliente
+Sólo deberías modificar el archivo hosts si no puedes modificar el DNS de tu caja Internet / router, porque el archivo hosts únicamente afectará el ordenador en el cual el archivo esté modificado.
+
+- En Windows, encontrarás el archivo hosts aquí :
+ `%SystemRoot%\system32\drivers\etc\`
+ > Es preciso visualizar los archivos y sistemas escondidos para ver el archivo hosts.
+- En sistemas UNIX (GNU/Linux, macOS), lo encontrarás aquí :
+ `/etc/hosts`
+ > Necesitarás derechos root para modificar el archivo.
+
+Simplemente añade al final del archivo hosts una linea conteniendo la dirección IP privada del servidor y tu nombre de dominio
+
+```bash
+192.168.1.62 domain.tld
+```
diff --git a/dns_local_network_fr.md b/pages/01.administrate/07.specific_use_cases/01.domains/04.dns_local_network/dns_local_network.fr.md
similarity index 55%
rename from dns_local_network_fr.md
rename to pages/01.administrate/07.specific_use_cases/01.domains/04.dns_local_network/dns_local_network.fr.md
index bcea9e28..312bbbe9 100644
--- a/dns_local_network_fr.md
+++ b/pages/01.administrate/07.specific_use_cases/01.domains/04.dns_local_network/dns_local_network.fr.md
@@ -1,27 +1,31 @@
-#Accéder à son serveur depuis le réseau local
+---
+title: Accéder à son serveur depuis le réseau local
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/dns_local_network'
+---
-Après installation de votre serveur, il est probable que votre nom de domaine ne soit pas accessible depuis le réseau local où se trouve le serveur. Ceci est un problème connu sous le nom de [hairpinning](http://fr.wikipedia.org/wiki/Hairpinning).
+Après installation de votre serveur, il est possible que votre nom de domaine ne soit pas accessible depuis le réseau local où se trouve le serveur. Ceci est un problème connu sous le nom de [hairpinning](http://fr.wikipedia.org/wiki/Hairpinning) - une fonctionnalité mal supportée par certaines box internet.
-Pour résoudre ce problème, il est nécessaire de configurer le DNS de votre routeur ou, à défaut, le ou les fichiers hosts de vos ordinateurs clients.
+Pour résoudre ce problème:
+- il est nécessaire de configurer le DNS de votre routeur
+- à défaut, il est possible de modifier le ou les fichiers /etc/hosts de vos ordinateurs clients.
-### Obtenir l’adresse IP locale du serveur
-Afin de configurer le DNS ou le fichier hosts, il vous faut connaître l’adresse IP privée de votre serveur. Cette adresse est utilisable uniquement sur le réseau local où se trouve le serveur et n’est pas liée à votre adresse publique utilisée sur Internet.
+### Trouver l’adresse IP locale du serveur
-Vous pouvez retrouver l’adresse privée de votre serveur de différentes manières :
-- Sur l’écran de connexion de YunoHost sur le serveur lui-même :
-
+Tout d'abord il vous faut trouver l'adresse IP locale du serveur
+- soit en utilisant l'une de astuces expliquées [ici](/finding_the_local_ip)
+- ou en utilisant la webadmin, dans l'écran Diagnostique, section Connection Internet, IPv4, cliquer sur 'Détails' et vous devriez trouver une entrée pour 'IP locale'.
+- ou en ligne de commande sur le serveur: `hostname -I`
-- Depuis l’interface d’administration de votre serveur YunoHost :
- dans Outils > État du serveur > Réseau
-
+## Configurer le DNS de la box
-- Ou depuis votre routeur ou votre box, selon son modèle.
-
-## Configurer le DNS de la box ou du routeur
-
-L'idée ici est de créer une redirection qui sera active sur tout votre réseau. Le but est de créer une redirection DNS vers l'ip de votre serveur YunoHost dans votre box. Il faut donc accéder à l'interface de configuration de votre box et aux paramétrages DNS, puis créer la redirection locale (par exemple, yunohost.local renvoi sur 192.168.21).
+L'idée ici est de créer une redirection qui sera active sur tout votre réseau. Le but est de créer une redirection DNS vers l'ip de votre serveur YunoHost dans votre box. Il faut donc accéder à l'interface de configuration de votre box et aux paramétrages DNS, puis créer la redirection locale (par exemple, `yunohost.local` renvoi sur `192.168.1.21`).
### Box SFR
+
Si vous ne disposez toujours pas de l’adresse IP privée de votre serveur, vous pouvez la trouver sur l’interface de votre box SFR :
Dans l’onglet Réseau puis Général
@@ -31,12 +35,13 @@ Rendez-vous dans l’onglet Réseau puis DNS pour ajouter votre nom de domaine a
## Configurer le fichier [hosts](http://fr.wikipedia.org/wiki/Hosts) de l’ordinateur client
+
La modification du fichier hosts devrait être effectuée seulement si vous ne pouvez pas modifier le DNS de votre box ou de votre routeur, car le fichier hosts impactera uniquement l’ordinateur sur lequel le fichier est modifié.
- Sous Windows, vous trouverez le fichier hosts ici :
`%SystemRoot%\system32\drivers\etc\`
> Il est nécessaire d’afficher les fichiers cachés et systèmes pour voir le fichier hosts.
-- Sous les systèmes UNIX (GNU/Linux, Mac OS), vous le trouverez ici :
+- Sous les systèmes UNIX (GNU/Linux, macOS), vous le trouverez ici :
`/etc/hosts`
> Les droits root sont nécessaires pour modifier le fichier.
diff --git a/dns_local_network.md b/pages/01.administrate/07.specific_use_cases/01.domains/04.dns_local_network/dns_local_network.md
similarity index 52%
rename from dns_local_network.md
rename to pages/01.administrate/07.specific_use_cases/01.domains/04.dns_local_network/dns_local_network.md
index b5653f4e..54385178 100644
--- a/dns_local_network.md
+++ b/pages/01.administrate/07.specific_use_cases/01.domains/04.dns_local_network/dns_local_network.md
@@ -1,25 +1,28 @@
-#Local network access to your server
+---
+title: Local network access to your server
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/dns_local_network'
+---
-After completing your server installation, it is most likely that your domain will not be accessible through the local network. This is a know issue known as [hairpinning](http://en.wikipedia.org/wiki/Hairpinning).
+After completing your server installation, it is possible that your domain will not be accessible through the local network. This is an issue known as [hairpinning](http://en.wikipedia.org/wiki/Hairpinning) - a feature that is not well supported by some internet routers.
-To resolve this issue, you need to configure your router dns or, failing, your hosts files on your clients workstation
+To solve this issue you can:
+- configure your router's DNS
+- or alternatively - your /etc/hosts files on your clients workstation
-### Get the server local IP adress
-In order to configure DNS or hosts file, you must know the private IP adress of your server. This adress is only working in the server local network and is not linked to your public IP adress.
+### Find the local IP address of your server
-You may retrieve your server private IP adress through different means:
-- Using the Yunohost connection screen on the server:
-
+First you need to find out the local IP of your server
+- either using the tricks lister [here](/finding_the_local_ip)
+- or if in the webadmin, in the Diagnosis section, under Internet Connectivity, IPv4, click on 'Details' and you should find an entry for 'Local IP'
+- or using the command line on the server : `hostname -I`
-- Using Yunohost administration panel:
- Go to Tools > State of the server > Network
-
+## Configure DNS on your Internet router
-- Or using your router or internet box, depending on model.
-
-## Configure DNS of Internet box or router
-
-The goal here is to create a network wide redirection handled by your router. The idea is to create a DNS redirection to your server's IP. You should access your router's configuration and look for DNS configuration, then add a redirection to your server's IP (e.g. redirect "yunohost.local" to 192.168.1.21).
+The goal here is to create a network wide redirection handled by your router. The idea is to create a DNS redirection to your server's IP. You should access your router's configuration and look for DNS configuration, then add a redirection to your server's IP (e.g. redirect `yunohost.local` to `192.168.1.21`).
### SFR Box
If you haven't found your server private IP, you may find it using the SFR box admin panel:
@@ -27,16 +30,18 @@ If you haven't found your server private IP, you may find it using the SFR box a
#### Configure SFR box's DNS
+
Go to Network tab > DNS and add your domain name to the box's DNS.
## Configure [hosts](https://en.wikipedia.org/wiki/Host_%28Unix%29) file on client workstation
+
Modifying hosts file should be done only if you cannot alter your box's DNS or router, because hosts file will only impact the workstation where the file was modified.
- Windows hosts file is located at:
`%SystemRoot%\system32\drivers\etc\`
> You MUST activate hidden and system file display to see the hosts file.
-- UNIX systems (GNU/Linux, Mac OS) hosts file is located at:
+- UNIX systems (GNU/Linux, macOS) hosts file is located at:
`/etc/hosts`
> You MUST have root privileges to modify the file.
diff --git a/OVH_fr.md b/pages/01.administrate/07.specific_use_cases/01.domains/05.OVH/OVH.fr.md
similarity index 59%
rename from OVH_fr.md
rename to pages/01.administrate/07.specific_use_cases/01.domains/05.OVH/OVH.fr.md
index 303626bd..1b17b7a3 100644
--- a/OVH_fr.md
+++ b/pages/01.administrate/07.specific_use_cases/01.domains/05.OVH/OVH.fr.md
@@ -1,19 +1,33 @@
-#Configuration DNS avec OVH
+---
+title: Configuration DNS avec OVH
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/OVH'
+---
Nous allons voir comment configurer le DNS avec [OVH](http://www.ovh.com).
-Après achat de votre nom de domaine, rendez vous dans l'espace client pour retrouver le panneau de configuration d'OVH, et cliquez sur votre domaine à gauche:
+Après achat de votre nom de domaine, rendez vous dans l'espace client pour retrouver le panneau de configuration d'OVH, et cliquez sur votre domaine à gauche :
-
+
-Cliquez sur l'onglet **Zone DNS**, puis sur **Ajouter une entrée**:
+Cliquez sur l'onglet **Zone DNS**, puis sur **Ajouter une entrée** :
-
+
-Il suffit maintenant d'ajouter les redirections DNS comme indiqué dans la [configuration DNS standard](/dns_config).
+Cliquer sur "Modifier en mode textuel", garder les 4 premières lignes :
+```bash
+$TTL 3600
+@ IN SOA dns104.ovh.net. tech.ovh.net. (2020083101 86400 3600 3600000 60)
+ IN NS dns104.ovh.net.
+ IN NS ns104.ovh.net.
+```
+puis effacer tout ce qu'il y a en-dessous, et le remplacer par la configuration donnée par votre serveur, comme indiqué dans la [configuration DNS standard](/dns_config).
-###IP dynamique
+### IP dynamique
[Tutoriel plus général sur l’IP dynamique](/dns_dynamicip).
diff --git a/OVH.md b/pages/01.administrate/07.specific_use_cases/01.domains/05.OVH/OVH.md
similarity index 56%
rename from OVH.md
rename to pages/01.administrate/07.specific_use_cases/01.domains/05.OVH/OVH.md
index 1edcfa70..9255877a 100644
--- a/OVH.md
+++ b/pages/01.administrate/07.specific_use_cases/01.domains/05.OVH/OVH.md
@@ -1,21 +1,37 @@
-#DNS Configuration with OVH
+---
+title: DNS Configuration with OVH
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/OVH'
+---
Let's see how to properly set the DNS redirections with [OVH](http://www.ovh.com).
Once you bought your domain name, got to the Web Control Panel, and click on you domain name on the left side:
-
+
Click on the **DNS Zone** tab, then on **Add an entry**:
-
+
Now you need to add the DNS redirections as specified by the [standard DNS zone configuration](/dns_config)
+Click on "Change in text format", keep the first four lines:
+```bash
+$TTL 3600
+@ IN SOA dns104.ovh.net. tech.ovh.net. (2020083101 86400 3600 3600000 60)
+ IN NS dns104.ovh.net.
+ IN NS ns104.ovh.net.
+```
+then erase everything below, and replace it with the configuration generated by YunoHost as explained in [this page](/dns_config).
-###Dynamic IP
-[General tutorial on dynamic IP](dns_dynamicip).
+### Dynamic IP
+
+[General tutorial on dynamic IP](/dns_dynamicip).
You should follow this part if you have a dynamic IP.
@@ -26,7 +42,7 @@ Let's create a DynHost id.
Follow [this tutorial](http://blog.developpez.com/brutus/p6316/ubuntu/configurer_dynhost_ovh_avec_ddclient) to install ddclient.
ddclient will take care of telling OVH that the IP has changed. Then OVH will update the IP.
-You need to add in the configuration file :
+You need to add in the configuration file:
* your login and password DynHost
* your domain name
diff --git a/isp_sfr_fr.md b/pages/01.administrate/07.specific_use_cases/02.isp/01.sfr/isp_sfr.fr.md
similarity index 72%
rename from isp_sfr_fr.md
rename to pages/01.administrate/07.specific_use_cases/02.isp/01.sfr/isp_sfr.fr.md
index 43c311fb..b5c0f6c8 100644
--- a/isp_sfr_fr.md
+++ b/pages/01.administrate/07.specific_use_cases/02.isp/01.sfr/isp_sfr.fr.md
@@ -1,14 +1,23 @@
-#SFR
+---
+title: SFR
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/isp_sfr'
+---
+
*Trouvez la liste d’autres fournisseurs d’accès Internet **[ici](/isp)**.*
+
#### Accès à l’administration de la box
* Allez à cette adresse : http://192.168.1.1.
* Authentifiez-vous, soit en appuyant sur le bouton de la box pendant 5 secondes soit avec les identifiants d’administration.
-
+
#### Courrier électronique
Pour pouvoir envoyer des mails, il faut désactiver le filtrage.
-
+
Source : https://assistance.sfr.fr/sfrmail-appli/sfrmail/envoyer-e-mail-serveur-smtp.html
diff --git a/isp_orange_fr.md b/pages/01.administrate/07.specific_use_cases/02.isp/02.orange/isp_orange.fr.md
similarity index 86%
rename from isp_orange_fr.md
rename to pages/01.administrate/07.specific_use_cases/02.isp/02.orange/isp_orange.fr.md
index ffde62c6..73c9430e 100644
--- a/isp_orange_fr.md
+++ b/pages/01.administrate/07.specific_use_cases/02.isp/02.orange/isp_orange.fr.md
@@ -1,4 +1,12 @@
-# Orange
+---
+title: Orange
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/isp_orange'
+---
+
*Trouvez la liste d’autres fournisseurs d’accès Internet **[ici](/isp)**.*
#### Le courrier électronique
@@ -7,6 +15,9 @@ La box d’Orange bloque le port 25 pour limiter l’envoi de spam.
La solution restante pour héberger son courrier chez soi consiste à le faire passer par les serveurs SMTP d’Orange.
+! YunoHost intègre depuis la version 4.1 une intégration de la configuration des relais SMTP
+! Cette section devrait donc être retravaillée (voire supprimée) au profit de [cette page](/email_configure_relay)
+
Pour cela, il faut éditer le fichier de configuration de postfix avec la commande :
```bash
diff --git a/isp_free_fr.md b/pages/01.administrate/07.specific_use_cases/02.isp/03.free/isp_free.fr.md
similarity index 96%
rename from isp_free_fr.md
rename to pages/01.administrate/07.specific_use_cases/02.isp/03.free/isp_free.fr.md
index 58ebb590..aa8a9387 100644
--- a/isp_free_fr.md
+++ b/pages/01.administrate/07.specific_use_cases/02.isp/03.free/isp_free.fr.md
@@ -1,4 +1,11 @@
-# Free
+---
+title: Free
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/isp_free'
+---
*Trouvez la liste d’autres fournisseurs d’accès Internet **[ici](/isp)**.*
diff --git a/isp_es.md b/pages/01.administrate/07.specific_use_cases/02.isp/isp.es.md
similarity index 89%
rename from isp_es.md
rename to pages/01.administrate/07.specific_use_cases/02.isp/isp.es.md
index fed12f76..bfb0afa3 100644
--- a/isp_es.md
+++ b/pages/01.administrate/07.specific_use_cases/02.isp/isp.es.md
@@ -1,6 +1,13 @@
-# Proveedores de acceso a Internet
+---
+title: Proveedores de acceso a Internet
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/isp'
+---
- Configuración general del router
+[div class="btn btn-lg btn-default"] [ Configuración general del router](/isp_box_config) [/div]
Aquí tienes una lista (no exhaustiva) de proveedores de acceso a Internet por país, con criterios de compatibilidad con el [self-hosting](/selfhosting).
@@ -10,7 +17,7 @@ Un « **no** » puede implicar problemas de utilización del servidor o puede
*Nota que algunos de estos proveedores como OVH y Orange también están presentes en España.*
-Todos los proveedores de acceso a Internet [miembros de la Federación French Data Network] (http://www.ffdn.org/fr/membres) tienen una política a favor del auto-alojamiento / self-hosting.
+Todos los proveedores de acceso a Internet [miembros de la Federación French Data Network](http://www.ffdn.org/fr/membres) tienen una política a favor del auto-alojamiento / self-hosting.
* ✔ : sí
* ✘ : no
@@ -44,4 +51,4 @@ Para obtener una lista más completa y precisa, refiérete a la muy buena docume
| :---: | :---: | :---: | :---: | :---: | :---: | :---: |
| **Orange** | Livebox2 | sí (activado) | no | **no** | **no** | **no** |
| **Moov** | | sí (activado) | | | | |
-| **MTN** | | sí (activado) | | | | |
\ No newline at end of file
+| **MTN** | | sí (activado) | | | | |
diff --git a/isp_fr.md b/pages/01.administrate/07.specific_use_cases/02.isp/isp.fr.md
similarity index 87%
rename from isp_fr.md
rename to pages/01.administrate/07.specific_use_cases/02.isp/isp.fr.md
index 35e6d8be..c8a60f1f 100644
--- a/isp_fr.md
+++ b/pages/01.administrate/07.specific_use_cases/02.isp/isp.fr.md
@@ -1,6 +1,13 @@
-# Fournisseurs d’accès à Internet
+---
+title: Fournisseurs d'accès à Internet
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/isp'
+---
- Configuration générale box
+[div class="btn btn-lg btn-default"] [ Configuration générale box](/isp_box_config) [/div]
Voici une liste non exhaustive des fournisseurs d’accès à Internet par pays, contenant les critères de tolérance à l’[auto-hébergement](/selfhosting).
@@ -18,8 +25,8 @@ Tous les fournisseurs d’accès à Internet [membres de la Fédération French
| **[UPnP](https://fr.wikipedia.org/wiki/Universal_Plug_and_Play)** | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| **[Port 25 ouvrable](/email)**
+
+
-
-
+
+
Nextcloud
+---
+title: Nextcloud
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_nextcloud'
+---
+
+
- [Découverte de l'environnement de Nextcloud](#EnvironnementNextcloud)
- [Logiciels Clients pour mobile et ordinateur](#LogicielsClients)
@@ -11,19 +20,19 @@ Nextcloud est un service d'hébergement de fichiers, de nombreuses applications
## Découverte de l'environnement de Nextcloud
-Du fait de la constitution de Nextcloud, une base avec des applications tiers à installer, ce chapitre 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 : [apps.nextcloud.com](https://apps.nextcloud.com).
+Du fait de la constitution de Nextcloud, une base avec des applications tiers à installer, ce chapitre 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 : [apps.nextcloud.com](https://apps.nextcloud.com).
Nextcloud est avant tout un service de cloud (comme Seafile et d'autres logiciels), il permet une synchronisation et le partage de fichiers sur internet et entre plusieurs terminaux (ordinateurs, smartphone) mais aussi avec plusieurs personnes.
## Logiciels Clients
-Il existe des logiciels clients pour de nombreux terminaux. Vous pouvez les retrouver sur le site de nextcloud : [nextcloud.com/install/#install-clients](https://nextcloud.com/install/#install-clients)
+Il existe des logiciels clients pour de nombreux terminaux. Vous pouvez les retrouver sur le site de Nextcloud : [nextcloud.com/install/#install-clients](https://nextcloud.com/install/#install-clients)
## Manipulations utiles & problèmes rencontrés
### Ajouter de l'espace à Nextcloud
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.
+La solution II. permet de déplacer l'espace de stockage principal de Nextcloud.
#### I. Ajouter un espace de stockage externe
@@ -41,7 +50,7 @@ Enfin cliquer sur la coche pour valider le dossier.
**Remarque** : Remplacez `nextcloud` par le nom de son instance, si vous avez plusieurs apps Nextcloud installées.
-Commencez par éteindre le serveur web avec la commande:
+Commencez par éteindre le serveur web avec la commande :
```bash
systemctl stop nginx
```
@@ -50,7 +59,7 @@ systemctl stop nginx
**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.
+Pour l'instant seul root peut y écrire dans `/media/stockage` ; ce qui signifie que NGINX et Nextcloud ne pourront donc pas l'utiliser.
```bash
chown -R nextcloud:nextcloud /media/stockage
@@ -77,7 +86,7 @@ Cas B : cp -ir /home/yunohost.app/nextcloud /media/stockage/nextcloud_data
```
L'option `i` permet de vous demander quoi faire en cas de conflit de fichier, notamment si vous écrasez un ancien dossier de données Owncloud ou Nextcloud.
-Pour vérifier que tout s'est bien passé, comparer ce qu'affichent ces deux commandes (le contenu doit être identique):
+Pour vérifier que tout s'est bien passé, comparer ce qu'affichent ces deux commandes (le contenu doit être identique) :
```bash
ls -la /home/yunohost.app/nextcloud
@@ -88,13 +97,13 @@ Cas B : ls -al /media/stockage/nextcloud_data/nextcloud
##### Configurer Nextcloud
-Pour informer Nextcloud de son nouveau répertoire, modifiez le fichier `/var/www/nextcloud/config/config.php` avec la commande:
+Pour informer Nextcloud de son nouveau répertoire, modifiez le fichier `/var/www/nextcloud/config/config.php` avec la commande :
```bash
nano /var/www/nextcloud/config/config.php
```
-Cherchez la ligne:
+Cherchez la ligne :
```bash
'datadirectory' => '/home/yunohost.app/nextcloud/data',
@@ -154,16 +163,48 @@ Les options à désactiver (Off) sont :
- Rocket Loader
- Email Obfuscation
-Sauvegarder et nettoyer vos caches (Cloudflare, navigateur, ...) et le tour est joué.
+Sauvegarder et nettoyer vos caches (Cloudflare, navigateur...) et le tour est joué.
-## Applications Tiers
+## À propos de Keeweb
- + [Calendrier](/app_nextcloud_calendar)
- + [contact](/app_nextcloud_contact)
- + [KeeWeb](/app_nextcloud_keeweb)
- + [Carnet](/app_nextcloud_carnet)
+L'application Keeweb sur le catalogue de nextcloud - [apps.nextcloud.com/keeweb](https://apps.nextcloud.com/apps/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,
+[une solution](https://github.com/jhass/nextcloud-keeweb/blob/master/README.md#mimetype-detection) existe.
+
+Se rendre dans le répertoire de configuration de Nextcloud :
+
+```bash
+cd /var/www/nextcloud/config/
+```
+
+S'il n'existe pas, créer le fichier *mimetypemapping.json* dont le propriétaire est l'utilisateur *nextcloud* :
+
+```bash
+sudo su nextcloud -c "nano mimetypemapping.json"
+```
+
+Puis ajouter dans ce fichier le texte suivent :
+
+```bash
+{
+ "kdbx": ["x-application/kdbx"]
+}
+```
+
+Enregistrer le fichier (**CTRL** + **o**) et quitter nano (**CTRL** + **c**).
+
+Ensuite lancer un scan en tant que root :
+
+```bash
+sudo -u nextcloud php /var/www/nextcloud/occ files:scan --all
+```
+
+À présent, le problème est corrigé.
## Quelques liens utiles
+ Site officiel : [nextcloud.com (en)](https://nextcloud.com/)
-+ Catalogue d'application pour nextcloud : [apps.nextcloud.com](https://apps.nextcloud.com/)
++ Catalogue d'application pour Nextcloud : [apps.nextcloud.com](https://apps.nextcloud.com/)
diff --git a/app_nextcloud.md b/pages/02.applications/02.docs/nextcloud/app_nextcloud.md
similarity index 74%
rename from app_nextcloud.md
rename to pages/02.applications/02.docs/nextcloud/app_nextcloud.md
index 4bd63778..ed92f8cb 100644
--- a/app_nextcloud.md
+++ b/pages/02.applications/02.docs/nextcloud/app_nextcloud.md
@@ -1,4 +1,13 @@
-# Nextcloud
+---
+title: Nextcloud
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_nextcloud'
+---
+
+
- [Discovering the Nextcloud environment](#EnvironmentNextcloud)
- [Mobile and computer client software](#ClientSoftware)
@@ -7,7 +16,7 @@
- [Third Party Applications](#AppsTiers)
- [Useful links](#UsefulLinks)
-Nextcloud is a file hosting service, many applications can be installed to offer it new features such as a calendar, a directory, notes and many others (you can find some applications in the [third-party applications](#AppsTiers) part but there are many others depending on your needs).
+Nextcloud is a file hosting service, many applications can be installed to offer it new features such as a calendar, a directory, notes and many others (you can find some applications in the [third-party applications](#AppsTiers) part but there are many others depending on your needs).
## Discovering the Nextcloud environment
@@ -23,7 +32,7 @@ There are client software for all platforms. You can find them on the official n
### Add storage space
Solution I. allows you to add a link to a local or remote folder.
-Solution II. allows to move the main storage space of nextcloud.
+Solution II. allows to move the main storage space of Nextcloud.
#### I. Add an external storage space
@@ -50,7 +59,7 @@ systemctl stop nginx
**Case A: Blank storage, exclusive to Nextcloud**
-For the moment only root can write to it in `/media/storage`, which means that nginx and nextcloud will not be able to use it.
+For the moment only root can write to it in `/media/storage`, which means that NGINX and Nextcloud will not be able to use it.
```bash
chown -R nextcloud:nextcloud /media/storage
@@ -135,35 +144,64 @@ It's over now. Now test if everything is fine, try connecting to your Nextcloud
### Nextcloud and Cloudflare
-If you use Cloudflare for your DNS, *which may be useful if you have a dynamic IP*, you will most likely have authentication problems with the Nextcloud application. On the Internet many people propose to create a rule that disables all options related to security and Cloudflare speed for the url pointing to your Nextcloud instance. Although it works, it is not the optimal solution. I propose, certainly to create a rule for the url pointing to your Nextcloud instance but to disable only 2 options. So here's how:
+If you use Cloudflare for your DNS, *which may be useful if you have a dynamic IP*, you will most likely have authentication problems with the Nextcloud application. On the Internet many people propose to create a rule that disables all options related to security and Cloudflare speed for the URL pointing to your Nextcloud instance. Although it works, it is not the optimal solution. I propose, certainly to create a rule for the URL pointing to your Nextcloud instance but to disable only 2 options. So here's how:
#### Cloudflare Page Rules
In the Cloudflare control panel select your domain and find Page Rules
-the url in your address bar will look like this: https://dash.cloudflare.com/*/domain.tld/page-rules
+the URL in your address bar will look like this: https://dash.cloudflare.com/*/domain.tld/page-rules
##### Add a rule
-The rule to be added must apply to the url of your Nextcloud instance either:
+The rule to be added must apply to the URL of your Nextcloud instance either:
- `https://nextcloud.domain.tld/**` if you use a subdomain
-- `https://domain.tld/nextcloud/*`` if you have deployed Nextcloud in a directory
+- `https://domain.tld/nextcloud/*` if you have deployed Nextcloud in a directory
The options to disable (Off) are:
- Rocket Loader
- Email Obfuscation
-Save and clean your caches (Cloudflare, browser,...) and that's it.
+Save and clean your caches (Cloudflare, browser...) and that's it.
-## Third Party Applications
+## About Keeweb
- - [Calendrier](app_nextcloud_calendar)
- - [contact](app_nextcloud_contact)
- - [KeeWeb](app_nextcloud_keeweb)
- - [Carnet](app_nextcloud_carnet)
+The KeeWeb application is a password manager integrated into Nextcloud. For example, it allows you to read a KeePass file (*.kdbx*) stored on your Nextcloud instance.
+But sometimes Nextcloud does not let the application support these files, which makes it impossible to read them from KeeWeb. To remedy this,
+[a solution](https://github.com/jhass/nextcloud-keeweb/blob/master/README.md#mimetype-detection) exists.
+
+Go to the Nextcloud configuration directory:
+
+```bash
+cd /var/www/nextcloud/config/
+```
+
+If it does not exist, create the *mimetypemapping.json* file whose owner is the user *nextcloud* :
+
+```bash
+sudo su nextcloud -c "nano mimetypemapping.json"
+```
+
+Then add in this file the following text:
+
+```bash
+{
+ "kdbx": ["x-application/kdbx"]
+}
+```
+
+Save the file (**CTRL** + **o**) and exit nano (**CTRL** + **c**).
+
+Then run a scan by executing next command as root:
+
+```bash
+sudo -u nextcloud php /var/www/nextcloud/occ files:scan --all
+```
+
+Now the problem is fixed.
## Useful links
- - Official website : [nextcloud.com](https://nextcloud.com/)
- - Application catalogue for nextcloud : [apps.nextcloud.com](https://apps.nextcloud.com/)
+ - Official website: [nextcloud.com](https://nextcloud.com/)
+ - Application catalogue for Nextcloud: [apps.nextcloud.com](https://apps.nextcloud.com/)
diff --git a/app_nextcloud_keeweb_fr.md b/pages/02.applications/02.docs/nextcloud_keeweb/app_nextcloud_keeweb.fr.md
similarity index 84%
rename from app_nextcloud_keeweb_fr.md
rename to pages/02.applications/02.docs/nextcloud_keeweb/app_nextcloud_keeweb.fr.md
index 9a99f973..68aa53bf 100644
--- a/app_nextcloud_keeweb_fr.md
+++ b/pages/02.applications/02.docs/nextcloud_keeweb/app_nextcloud_keeweb.fr.md
@@ -1,4 +1,11 @@
-# L'application KeeWeb pour NextCloud
+---
+title: KeeWeb pour Nextcloud
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_nextcloud_keeweb'
+---
L'application Keeweb sur le catalogue de nextcloud - [apps.nextcloud.com/keeweb](https://apps.nextcloud.com/apps/keeweb)
@@ -29,10 +36,10 @@ Puis ajouter dans ce fichier le texte suivent :
Enregistrer le fichier (**CTRL** + **o**) et quitter nano (**CTRL** + **c**).
-Ensuite lancer un scan en tant que root:
+Ensuite lancer un scan en tant que root :
```bash
sudo -u nextcloud php /var/www/nextcloud/occ files:scan --all
```
-A présent, le problème est corrigé.
+À présent, le problème est corrigé.
diff --git a/app_nextcloud_keeweb.md b/pages/02.applications/02.docs/nextcloud_keeweb/app_nextcloud_keeweb.md
similarity index 88%
rename from app_nextcloud_keeweb.md
rename to pages/02.applications/02.docs/nextcloud_keeweb/app_nextcloud_keeweb.md
index a6039426..5d50ce28 100644
--- a/app_nextcloud_keeweb.md
+++ b/pages/02.applications/02.docs/nextcloud_keeweb/app_nextcloud_keeweb.md
@@ -1,4 +1,11 @@
-# The KeeWeb application for NextCloud
+---
+title: KeeWeb for Nextcloud
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_nextcloud_keeweb'
+---
The KeeWeb application is a password manager integrated into Nextcloud. For example, it allows you to read a KeePass file (*.kdbx*) stored on your Nextcloud instance.
But sometimes Nextcloud does not let the application support these files, which makes it impossible to read them from KeeWeb. To remedy this,
diff --git a/app_noalyss_fr.md b/pages/02.applications/02.docs/noalyss/app_noalyss.fr.md
similarity index 73%
rename from app_noalyss_fr.md
rename to pages/02.applications/02.docs/noalyss/app_noalyss.fr.md
index eac70633..28ded15c 100644
--- a/app_noalyss_fr.md
+++ b/pages/02.applications/02.docs/noalyss/app_noalyss.fr.md
@@ -1,4 +1,11 @@
-# Noalyss
+---
+title: Noalyss
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_noalyss'
+---
Logiciel de comptabilité open source développé en PHP.
@@ -6,8 +13,8 @@ Toute les infos sur ce logiciel sont disponible sur le [site du projet](http://w
Pour apprendre à l'utiliser je vous invite à lire le [wiki du projet](http://www.noalyss.eu/?page_id=46&lang=fr_FR)
-Le github du module Yunohost est [ici](https://github.com/YunoHost-Apps/noalyss_ynh)
+Le github du module YunoHost est [ici](https://github.com/YunoHost-Apps/noalyss_ynh)
Vous pouvez essayer le projet [ici](http://demo.noalyss.eu/index.php) avec les identifiants : demo /demo
-Enfin pour ne pas galérer comme moi. Les identifiants et mot de passe administrateur lors de la première connexion sont : phpcompta / phpcompta
\ No newline at end of file
+Enfin pour ne pas galérer comme moi. Les identifiants et mot de passe administrateur lors de la première connexion sont : phpcompta / phpcompta
diff --git a/app_noalyss.md b/pages/02.applications/02.docs/noalyss/app_noalyss.md
similarity index 67%
rename from app_noalyss.md
rename to pages/02.applications/02.docs/noalyss/app_noalyss.md
index 8762bf51..8ae0d519 100644
--- a/app_noalyss.md
+++ b/pages/02.applications/02.docs/noalyss/app_noalyss.md
@@ -1,4 +1,11 @@
-# Noalyss
+---
+title: Noalyss
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_noalyss'
+---
Open source accounting software developed in PHP.
@@ -6,8 +13,8 @@ All the information on this software is available on the [project website](http:
To learn how to use it I invite you to read the [project wiki](http://www.noalyss.eu/?page_id=46&lang=fr_FR_id=46&lang=en_EN)
-The github of the Yunohost module is [here](https://github.com/YunoHost-Apps/noalyss_ynh_ynh)
+The github of the YunoHost module is [here](https://github.com/YunoHost-Apps/noalyss_ynh_ynh)
You can try the project [here](http://demo.noalyss.eu/index.php) with the identifiers: demo /demo
-I mean, not to have to struggle like me. The administrator IDs and passwords for the first login are: phpcompta / phpcompta
\ No newline at end of file
+I mean, not to have to struggle like me. The administrator IDs and passwords for the first login are: phpcompta / phpcompta
diff --git a/pages/02.applications/02.docs/onlyoffice/app_onlyoffice.fr.md b/pages/02.applications/02.docs/onlyoffice/app_onlyoffice.fr.md
new file mode 100644
index 00000000..3699f453
--- /dev/null
+++ b/pages/02.applications/02.docs/onlyoffice/app_onlyoffice.fr.md
@@ -0,0 +1,36 @@
+---
+title: OnlyOffice Server
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_onlyoffice'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=onlyoffice) [](https://dash.yunohost.org/appci/app/onlyoffice)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+- [Configurer OnlyOffice Server avec Nextcloud](#Configurer-OnlyOffice-Server-avec-Nextcloud)
+
+OnlyOffice Server est une suite bureautique collaborative en ligne gratuite comprenant des visualiseurs et des éditeurs de texte, de feuilles de calcul et de présentations, entièrement compatible avec les formats Office Open XML : .docx, .xlsx, .pptx et permettant l'édition collaborative en temps réel.
+
+## Configurer OnlyOffice Server avec Nextcloud
+
+1. Installer [OnlyOffice Server](https://github.com/YunoHost-Apps/onlyoffice_ynh) dans un domaine différent de celui utilisé par Nextcloud : `https://onlyoffice.domain.org` et `https://domain.org/nextcloud` (par exemple)
+
+2. Installer [ONLYOFFICE connector](https://apps.nextcloud.com/apps/onlyoffice) dans Nextcloud
+- Connectez-vous à Nextcloud en tant qu'administrateur et installer ONLYOFFICE Connector : -> Applications -> installez ONLYOFFICE. (Le numéro de version d'ONLYOFFICE Connector n'a pas besoin d'être le même que celui d'OnlyOffice Server).
+- Dans Paramètres (`https://domain.org/nextcloud/settings/admin/onlyoffice`), entrez l'adresse de votre serveur OnlyOffice Server (par exemple : `https://onlyoffice.domain.org`)
+
+OnlyOffice Server est maintenant connecté à Nextcloud.
+
+## Liens utiles
+
++ Site web : [www.onlyoffice.com](https://www.onlyoffice.com/)
++ ONLYOFFICE connector : [Nextcloud ONLYOFFICE Connector](https://apps.nextcloud.com/apps/onlyoffice)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/onlyoffice_ynh](https://github.com/YunoHost-Apps/onlyoffice_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/onlyoffice/issues](https://github.com/YunoHost-Apps/onlyoffice_ynh/issues)
diff --git a/pages/02.applications/02.docs/onlyoffice/app_onlyoffice.md b/pages/02.applications/02.docs/onlyoffice/app_onlyoffice.md
new file mode 100644
index 00000000..c0f907cc
--- /dev/null
+++ b/pages/02.applications/02.docs/onlyoffice/app_onlyoffice.md
@@ -0,0 +1,36 @@
+---
+title: OnlyOffice Server
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_onlyoffice'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=onlyoffice) [](https://dash.yunohost.org/appci/app/onlyoffice)
+
+### Index
+
+- [Useful links](#useful-links)
+- [Connect OnlyOffice Server with Nextcloud](#Connect-OnlyOffice-Server-with-Nextcloud)
+
+ONLYOFFICE Server is a free collaborative online office suite comprising viewers and editors for texts, spreadsheets and presentations, fully compatible with Office Open XML formats: .docx, .xlsx, .pptx and enabling collaborative editing in real time.
+
+## Connect OnlyOffice Server with Nextcloud
+
+1. Install [OnlyOffice Server](https://github.com/YunoHost-Apps/onlyoffice_ynh) in a different domain than the one used by Nextcloud: `https://onlyoffice.domain.org` and `https://domain.org/nextcloud` (for example)
+
+2. Install [ONLYOFFICE connector](https://apps.nextcloud.com/apps/onlyoffice) in Nextcloud
+- Connect to Nextcloud as admin and install ONLYOFFICE Connector: -> Applications -> install ONLYOFFICE. (ONLYOFFICE Connector doesn't need to match your OnlyOffice Server version number).
+- In Settings (`https://domain.org/nextcloud/settings/admin/onlyoffice`), enter your OnlyOffice Server address (for example: `https://onlyoffice.domain.org`)
+
+OnlyOffice Server is now connected to Nextcloud.
+
+## Useful links
+
++ Website: [www.onlyoffice.com](https://www.onlyoffice.com/)
++ ONLYOFFICE connector: [Nextcloud ONLYOFFICE Connector](https://apps.nextcloud.com/apps/onlyoffice)
++ Application software repository: [github.com - YunoHost-Apps/onlyoffice_ynh](https://github.com/YunoHost-Apps/onlyoffice_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/onlyoffice/issues](https://github.com/YunoHost-Apps/onlyoffice_ynh/issues)
diff --git a/pages/02.applications/02.docs/opensondage/app_opensondage.fr.md b/pages/02.applications/02.docs/opensondage/app_opensondage.fr.md
new file mode 100644
index 00000000..0869c92a
--- /dev/null
+++ b/pages/02.applications/02.docs/opensondage/app_opensondage.fr.md
@@ -0,0 +1,32 @@
+---
+title: Opensondage
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_opensondage'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=opensondage) [](https://dash.yunohost.org/appci/app/opensondage)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+Opensondage-Framadate est un service en ligne permettant de planifier un rendez-vous ou prendre des décisions rapidement et simplement. Aucune inscription préalable n’est nécessaire.
+Voici comment ça fonctionne :
+
+1. Créez un sondage
+2. Déterminez les dates ou les sujets à choisir
+3. Envoyez le lien du sondage à vos amis ou collègues
+4. Discutez et prenez votre décision
+
+## Liens utiles
+
++ Site web : [framadate.org](https://framadate.org)
++ Documentation officielle : [docs.framasoft.org/fr/framadate](https://docs.framasoft.org/fr/framadate)
++ Démonstration: [Démo](https://framadate.org)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/opensondage](https://github.com/YunoHost-Apps/opensondage_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/opensondage/issues](https://github.com/YunoHost-Apps/opensondage_ynh/issues)
diff --git a/pages/02.applications/02.docs/opensondage/app_opensondage.md b/pages/02.applications/02.docs/opensondage/app_opensondage.md
new file mode 100644
index 00000000..e3557f80
--- /dev/null
+++ b/pages/02.applications/02.docs/opensondage/app_opensondage.md
@@ -0,0 +1,32 @@
+---
+title: Opensondage
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_opensondage'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=opensondage) [](https://dash.yunohost.org/appci/app/opensondage)
+
+### Index
+
+- [Useful links](#useful-links)
+
+Opensondage-Framadate is an online service for planning an appointment or making a decision quickly and easily. No registration is required. It's a community free/libre software alternative to Doodle.
+Here is how it works:
+
+1. Create a poll
+2. Define dates or subjects to choose from
+3. Send the poll link to your friends or colleagues
+4. Discuss and make a decision
+
+## Useful links
+
++ Website: [framadate.org](https://framadate.org)
++ Official documentation: [docs.framasoft.org/fr/framadate](https://docs.framasoft.org/en/framadate)
++ Demonstration: [Demo](https://framadate.org)
++ Application software repository: [github.com - YunoHost-Apps/opensondage](https://github.com/YunoHost-Apps/opensondage_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/opensondage/issues](https://github.com/YunoHost-Apps/opensondage_ynh/issues)
diff --git a/pages/02.applications/02.docs/osticket/app_osticket.fr.md b/pages/02.applications/02.docs/osticket/app_osticket.fr.md
new file mode 100644
index 00000000..95ea9a4f
--- /dev/null
+++ b/pages/02.applications/02.docs/osticket/app_osticket.fr.md
@@ -0,0 +1,28 @@
+---
+title: osTicket
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_osticket'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=osticket) [](https://dash.yunohost.org/appci/app/osticket)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+osTicket est un système de tickets d'assistance open source largement utilisé. Il intègre de manière transparente les demandes créées par courrier électronique et les formulaires en ligne dans une interface web multi-utilisateurs simple et facile à utiliser. Gérez, organisez et archivez facilement toutes vos demandes d'assistance et vos réponses en un seul endroit tout en offrant à vos clients la responsabilité et la réactivité qu'ils méritent.
+
+osTicket est une alternative attrayante aux systèmes de support client plus coûteux et complexes ; simple, léger, fiable, open source, et facile à installer et à utiliser. Le meilleur, c'est qu'il est entièrement gratuit.
+
+## Liens utiles
+
++ Site web : [osticket.com](https://osticket.com/)
++ Documentation officielle : [docs.osticket.com](https://docs.osticket.com/)
++ Démonstration : [Démo](http://www.ostickethacks.com/demo/demo_info.php)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/osticket](https://github.com/YunoHost-Apps/osticket_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/osticket/issues](https://github.com/YunoHost-Apps/osticket_ynh/issues)
diff --git a/pages/02.applications/02.docs/osticket/app_osticket.md b/pages/02.applications/02.docs/osticket/app_osticket.md
new file mode 100644
index 00000000..88863f67
--- /dev/null
+++ b/pages/02.applications/02.docs/osticket/app_osticket.md
@@ -0,0 +1,28 @@
+---
+title: osTicket
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_osticket'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=osticket) [](https://dash.yunohost.org/appci/app/osticket)
+
+### Index
+
+- [Useful links](#useful-links)
+
+osTicket is a widely-used open source support ticket system. It seamlessly integrates inquiries created via email and web-based forms into a simple easy to use multi-user web interface. Easily manage, organize and archive all your support requests and responses in one place while providing your clients with accountability and responsiveness they deserve.
+
+osTicket is an attractive alternative to higher-cost and complex customer support systems; simple, lightweight, reliable, open source, and easy to setup and use. The best part is, it's completely free.
+
+## Useful links
+
++ Website : [osticket.com](https://osticket.com/)
++ Official documentation : [docs.osticket.com](https://docs.osticket.com/)
++ Demonstration : [Demo](http://www.ostickethacks.com/demo/demo_info.php)
++ Application software repository : [github.com - YunoHost-Apps/osticket](https://github.com/YunoHost-Apps/osticket_ynh)
++ Fix a bug or an improvement by creating a ticket (issue) : [github.com - YunoHost-Apps/osticket/issues](https://github.com/YunoHost-Apps/osticket_ynh/issues)
diff --git a/pages/02.applications/02.docs/peertube/app_peertube.fr.md b/pages/02.applications/02.docs/peertube/app_peertube.fr.md
new file mode 100644
index 00000000..fcf7ca6b
--- /dev/null
+++ b/pages/02.applications/02.docs/peertube/app_peertube.fr.md
@@ -0,0 +1,26 @@
+---
+title: PeerTube
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_peertube'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=peertube) [](https://dash.yunohost.org/appci/app/peertube)
+
+### Index
+x
+- [Liens utiles](#liens-utiles)
+
+PeerTube est un projet de logiciel d'hébergement vidéo. Il vous permet de regarder et de partager des vidéos avec d'autres personnes en utilisant votre propre serveur, qu'il s'agisse d'un simple PC à la maison ou dans un Datacenter. Vous n'avez pas besoin d'héberger des milliers de vidéos pour rendre votre instance intéressante pour une utilisation quotidienne. De manière fédérée, il dialoguera avec d'autres serveurs de votre choix pour agréger les références à leurs vidéos sans vraiment les héberger localement.
+
+
+## Liens utiles
+
++ Site web : [joinpeertube.org](https://joinpeertube.org)
++ Documentation officielle : [docs.joinpeertube.org](https://docs.joinpeertube.org)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/peertube](https://github.com/YunoHost-Apps/peertube_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/peertube/issues](https://github.com/YunoHost-Apps/peertube_ynh/issues)
diff --git a/pages/02.applications/02.docs/peertube/app_peertube.md b/pages/02.applications/02.docs/peertube/app_peertube.md
new file mode 100644
index 00000000..7c32126e
--- /dev/null
+++ b/pages/02.applications/02.docs/peertube/app_peertube.md
@@ -0,0 +1,26 @@
+---
+title: PeerTube
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_peertube'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=peertube) [](https://dash.yunohost.org/appci/app/peertube)
+
+### Index
+
+- [Useful links](#useful-links)
+
+PeerTube is a video hosting software project. It allows you to watch and share videos with others using your own server, be it a simple computer at home or in a datacenter. You don't need to host thousands of videos to make your instance interesting for daily use. In a federated fashion, it will talk with other servers of your choice to aggregate references to their videos without really hosting them locally.
+
+
+## Useful links
+
++ Website: [joinpeertube.org](https://joinpeertube.org)
++ Official documentation: [docs.joinpeertube.org](https://docs.joinpeertube.org)
++ Application software repository: [github.com - YunoHost-Apps/peertube](https://github.com/YunoHost-Apps/peertube_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/peertube/issues](https://github.com/YunoHost-Apps/peertube_ynh/issues)
diff --git a/pages/02.applications/02.docs/phpmyadmin/app_phpmyadmin.fr.md b/pages/02.applications/02.docs/phpmyadmin/app_phpmyadmin.fr.md
new file mode 100644
index 00000000..52301afb
--- /dev/null
+++ b/pages/02.applications/02.docs/phpmyadmin/app_phpmyadmin.fr.md
@@ -0,0 +1,25 @@
+---
+title: phpMyAdmin
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_phpmyadmin'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=phpmyadmin) [](https://dash.yunohost.org/appci/app/phpmyadmin)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+phpMyAdmin est un outil logiciel libre écrit en PHP, destiné à gérer l'administration de MySQL sur le Web. phpMyAdmin supporte un large éventail d'opérations sur MySQL et MariaDB. Les opérations fréquemment utilisées (gestion des bases de données, des tables, des colonnes, des relations, des index, des utilisateurs, des autorisations, etc.) peuvent être effectuées via l'interface utilisateur, tout en ayant la possibilité d'exécuter directement n'importe quelle instruction SQL.
+
+## Liens utiles
+
++ Site web : [www.phpmyadmin.net](https://www.phpmyadmin.net/)
++ Documentation officielle : [www.phpmyadmin.net/docs](https://www.phpmyadmin.net/docs/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/phpmyadmin](https://github.com/YunoHost-Apps/phpmyadmin_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/phpmyadmin/issues](https://github.com/YunoHost-Apps/phpmyadmin_ynh/issues)
diff --git a/pages/02.applications/02.docs/phpmyadmin/app_phpmyadmin.md b/pages/02.applications/02.docs/phpmyadmin/app_phpmyadmin.md
new file mode 100644
index 00000000..fff12f83
--- /dev/null
+++ b/pages/02.applications/02.docs/phpmyadmin/app_phpmyadmin.md
@@ -0,0 +1,25 @@
+---
+title: phpMyAdmin
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_phpmyadmin'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=phpmyadmin) [](https://dash.yunohost.org/appci/app/phpmyadmin)
+
+### Index
+
+- [Useful links](#useful-links)
+
+phpMyAdmin is a free software tool written in PHP, intended to handle the administration of MySQL over the Web. phpMyAdmin supports a wide range of operations on MySQL and MariaDB. Frequently used operations (managing databases, tables, columns, relations, indexes, users, permissions, etc.) can be performed via the user interface, while you still have the ability to directly execute any SQL statement.
+
+## Useful links
+
++ Website: [www.phpmyadmin.net](https://www.phpmyadmin.net/)
++ Official documentation: [www.phpmyadmin.net/docs](https://www.phpmyadmin.net/docs/)
++ Application software repository: [github.com - YunoHost-Apps/phpmyadmin](https://github.com/YunoHost-Apps/phpmyadmin_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/phpmyadmin/issues](https://github.com/YunoHost-Apps/phpmyadmin_ynh/issues)
diff --git a/pages/02.applications/02.docs/phpsysinfo/app_phpsysinfo.fr.md b/pages/02.applications/02.docs/phpsysinfo/app_phpsysinfo.fr.md
new file mode 100644
index 00000000..92aa48c3
--- /dev/null
+++ b/pages/02.applications/02.docs/phpsysinfo/app_phpsysinfo.fr.md
@@ -0,0 +1,23 @@
+---
+title: phpSysInfo
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_phpsysinfo'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=phpsysinfo) [](https://dash.yunohost.org/appci/app/phpsysinfo)
+
+### Index
+
+phpSysInfo est un script PHP personnalisable qui affiche bien les informations sur votre système (CPU, RAM, disques...).
+
+## Liens utiles
+
++ Site web : [phpsysinfo.github.io/phpsysinfo](https://phpsysinfo.github.io/phpsysinfo/)
++ Démonstration : [Démo](https://phpsysinfo.github.io/phpsysinfo/demos.html)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/phpsysinfo](https://github.com/YunoHost-Apps/phpsysinfo_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/phpsysinfo/issues](https://github.com/YunoHost-Apps/phpsysinfo_ynh/issues)
diff --git a/pages/02.applications/02.docs/phpsysinfo/app_phpsysinfo.md b/pages/02.applications/02.docs/phpsysinfo/app_phpsysinfo.md
new file mode 100644
index 00000000..bce139c9
--- /dev/null
+++ b/pages/02.applications/02.docs/phpsysinfo/app_phpsysinfo.md
@@ -0,0 +1,25 @@
+---
+title: phpSysInfo
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_phpsysinfo'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=phpsysinfo) [](https://dash.yunohost.org/appci/app/phpsysinfo)
+
+### Index
+
+- [Useful links](#useful-links)
+
+phpSysInfo is a customizable PHP script that displays information about your system (CPU, RAM, disks).
+
+## Useful links
+
++ Website: [phpsysinfo.github.io/phpsysinfo](https://phpsysinfo.github.io/phpsysinfo/)
++ Demonstration: [Demo](https://phpsysinfo.github.io/phpsysinfo/demos.html)
++ Application software repository: [github.com - YunoHost-Apps/phpsysinfo](https://github.com/YunoHost-Apps/phpsysinfo_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/phpsysinfo/issues](https://github.com/YunoHost-Apps/phpsysinfo_ynh/issues)
diff --git a/pages/02.applications/02.docs/pihole/app_pihole.fr.md b/pages/02.applications/02.docs/pihole/app_pihole.fr.md
new file mode 100644
index 00000000..d7150f78
--- /dev/null
+++ b/pages/02.applications/02.docs/pihole/app_pihole.fr.md
@@ -0,0 +1,82 @@
+---
+title: Pi-hole
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_pihole'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=pihole)[](https://dash.yunohost.org/appci/app/pihole)
+
+- [Utiliser Pi-Hole comme serveur DHCP](#utiliser-pi-hole-comme-serveur-dhcp)
+ - [Configurer Pi-Hole](#configurer-pi-hole)
+ - [Configurer mon routeur](#configurer-mon-routeur)
+ - [Restaurer le réseau](#restaurer-le-réseau)
+- [Liens utiles](#liens-utiles)
+
+Pi-hole est un bloqueur de publicité au niveau du réseau qui agit comme un DNS menteur et éventuellement un serveur DHCP3, destiné à être utilisé sur un réseau privé. Il est conçu pour être installé sur des périphériques intégrés dotés de capacités réseau, tels que le Raspberry Pi, mais il peut être utilisé sur d'autres machines exécutant GNU/Linux ou dans des environnements virtualisés.
+
+## Utiliser Pi-Hole comme serveur DHCP
+
+> **Attention, vous devez savoir que toucher à votre DHCP pourrait casser votre réseau.
+Dans le cas où votre serveur serait inaccessible, vous perdriez votre résolution dns et votre adresse IP.
+Ainsi, vous perdriez toute connexion à internet et même la connexion à votre routeur.**
+
+> **Si vous rencontrez ce genre de problèmes, merci de lire la section "Comment restaurer mon réseau".**
+
+### Configurer Pi-hole
+
+Il y a 2 manière de configurer Pi-hole pour qu'il soit utilisé comme votre serveur DHCP.
+- Soit vous pouvez choisir de l'utiliser lorsque vous installez l'application.
+- Soit vous pouvez activer le serveur DHCP par la suite dans l'onglet "Settings", partie "Pi-hole DHCP Server".
+Dans ce second cas, il peut être préférable de forcer l'ip du serveur à une adresse statique.
+
+### Configurer mon routeur
+
+Votre routeur ou celui de votre FAI dispose d'un serveur DHCP activé par défaut.
+Si vous gardez ce DHCP, en même temps que celui de Pi-hole, vous allez avoir des conflits transparents entre eux.
+Le premier serveur DHCP à répondre va distribuer ses propres ip et paramètres.
+Donc vous devez éteindre le serveur DHCP de votre routeur et laisser Pi-hole gérer votre réseau.
+
+#### Pourquoi je devrais utiliser le DHCP de Pi-hole ?
+
+En utilisant le DHCP de Pi-hole, vous lui permettez de donner sa configuration dns à chacun de vos clients. De cette manière, chaque requête sera filtrée par Pi-hole.
+
+Un autre cas d'usage du DHCP de Pi-hole est le cas où vous rencontrez des problèmes de hairpinning (Vous ne pouvez pas vous connecter à votre serveur parce que son ip est votre ip publique, et votre routeur n'autorise pas cela).
+Dans ce cas, utilisez le dns de Pi-hole va vous permettre de vous connecter à votre serveur par son adresse locale plutôt que son adresse publique.
+
+### Restaurer le réseau
+
+> Oups !
+Votre serveur Pi-hole est tombé, et vous n'avez plus de DHCP.
+Ne paniquez pas, on va surmonter ça \o/
+
+Utilisez votre terminal favori sur votre ordinateur de bureau.
+Et tout d'abord, récupérer votre interface réseau (Le plus souvent `eth0`).
+``` bash
+sudo ifconfig
+```
+
+Ensuite, changer votre ip pour une ip statique.
+``` bash
+sudo ifconfig eth0 192.168.1.100
+```
+
+Maintenant, vous pouvez vous connecter à votre routeur et rallumer son serveur DHCP pour l'utiliser à nouveau.
+Vous pouvez maintenant retirer votre ip statique et réobtenir une ip dynamique.
+``` bash
+sudo ifconfig eth0 0.0.0.0 && sudo dhclient eth0
+```
+
+> N'oubliez pas d'éteindre le DHCP de votre routeur si votre serveur fonctionne à nouveau.
+
+## Liens utiles
+
+ + Site web : [pi-hole.net (en)](https://pi-hole.net)
+ + Documentation officielle : [docs.pi-hole.net (en)](https://docs.pi-hole.net/)
+ + Dépôt logiciel de l'application : [github.com - YunoHost-Apps/pihole](https://github.com/YunoHost-Apps/pihole_ynh)
+ + Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/pihole/issues](https://github.com/YunoHost-Apps/pihole_ynh/issues)
+
diff --git a/pages/02.applications/02.docs/pihole/app_pihole.md b/pages/02.applications/02.docs/pihole/app_pihole.md
new file mode 100644
index 00000000..6138b73a
--- /dev/null
+++ b/pages/02.applications/02.docs/pihole/app_pihole.md
@@ -0,0 +1,83 @@
+---
+title: Pi-hole
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_pihole'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=pihole) [](https://dash.yunohost.org/appci/app/pihole)
+
+### Index
+
+- [Using Pi-Hole as a DHCP server](#using-pi-hole-as-a-dhcp-server)
+ - [Configure Pi-Hole](#configure-pi-hole)
+ - [Configure my router](#configure-my-router)
+ - [Restore Network](#restore-network)
+- [Useful links](#useful-links)
+
+Pi-hole is a network-level ad blocker that acts as a DNS layer and possibly a DHCP3 server for use on a private network. It is designed to be installed on embedded devices with network capabilities, such as the Raspberry Pi, but can be used on other machines running GNU/Linux or in virtualised environments.
+
+## Using Pi-Hole as a DHCP server
+
+> **Warning, you should be aware that touching your DHCP could break your network.
+In case your server is inaccessible, you will lose your dns resolution and IP address.
+Thus, you would lose any connection to the internet and even the connection to your router.**
+
+> If you encounter this kind of problem, please read the section "How to restore my network".
+
+### Configure Pi-Hole
+
+There are 2 ways to configure Pi-hole to be used as your DHCP server.
+- Either you can choose to use it when you install the application.
+- Or you can activate the DHCP server afterwards in the "Settings" tab, part "Pi-hole DHCP Server".
+In this second case, it may be preferable to force the server IP to a static address.
+
+### Configure my router
+
+Your router or your ISP's router has a DHCP server enabled by default.
+If you keep this DHCP, along with Pi-hole's, you will have transparent conflicts between them.
+The first DHCP server to respond will distribute its own IP and settings.
+So you need to turn off your router's DHCP server and let Pi-hole manage your network.
+
+#### Why should I use Pi-hole's DHCP?
+
+By using Pi-hole's DHCP, you allow Pi-hole to give its dns configuration to each of your clients. This way, every request will be filtered by Pi-hole.
+
+Another case of using Pi-hole DHCP is if you have hairpinning problems (you can't connect to your server because its IP is your public IP, and your router doesn't allow this).
+In this case, using Pi-hole's dns will allow you to connect to your server by its local address rather than its public address.
+
+### Restore network
+
+> Oops!
+Your Pi-hole server has crashed, and you don't have DHCP anymore.
+Don't panic. We'll get through this.
+
+Use your favorite device on your desktop computer.
+And first, get your network interface (usually `eth0`).
+```bash
+sudo ifconfig
+```
+
+Then change your IP to a static one.
+```bash
+sudo ifconfig eth0 192.168.1.100
+```
+
+Now you can connect to your router and reboot its DHCP server to use it again.
+You can now remove your static IP and get a dynamic IP again.
+```bash
+sudo ifconfig eth0 0.0.0 && sudo dhclient eth0
+```
+
+> Remember to turn off your router's DHCP if your server is running again.
+
+## Useful links
+
++ Website: [pi-hole.net](https://pi-hole.net)
++ Official documentation: [docs.pi-hole.net](https://docs.pi-hole.net/)
++ Application software repository: [github.com - YunoHost-Apps/pihole](https://github.com/YunoHost-Apps/pihole_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/pihole/issues](https://github.com/YunoHost-Apps/pihole_ynh/issues)
diff --git a/pages/02.applications/02.docs/piwigo/app_piwigo.fr.md b/pages/02.applications/02.docs/piwigo/app_piwigo.fr.md
new file mode 100644
index 00000000..c219aa00
--- /dev/null
+++ b/pages/02.applications/02.docs/piwigo/app_piwigo.fr.md
@@ -0,0 +1,50 @@
+---
+title: Piwigo
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_piwigo'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=piwigo) [](https://dash.yunohost.org/appci/app/piwigo)
+
+### Index
+
+- [Fonctionnalités](#fonctionnalités)
+- [Applications clientes](#applications-clientes)
+- [Liens utiles](#liens-utiles)
+
+**[Piwigo](https://fr.piwigo.org)** est un logiciel de galerie photos pour le Web, bâti par une communauté active d'utilisateurs et de développeurs.
+
+Les extensions rendent Piwigo facilement personnalisable. Cerise sur le gâteau, Piwigo est libre et gratuit.
+
+## Fonctionnalités
+
+En plus des [fonctionnalités principales](https://fr.piwigo.org/fonctionnalites) de Piwigo, ce paquet propose également :
+
+* une intégration avec le système de gestion des utilisateurs et le SSO de YunoHost :
+ * installation privée : limitée aux utilisateurs de YunoHost
+ * installation publique :
+ * SSO pour les utilisateurs YunoHost
+ * permet de gérer l'accès à d'autres utilisateurs, et mode invité possible
+* de permettre à un utilisateur d'être administrateur (réglage lors de l'installation)
+
+
+
+## Applications clientes
+
+| Nom de l'application | Plateforme | Multi-comptes | Play Store | F-Droid | Apple Store | Autre |
+|-----------------------|------------|---------------|------------|---------|-------------|---------|
+| Piwigo | Android / iOS | ? | [Playstore - Piwigo](https://play.google.com/store/apps/details?id=org.piwigo.android&hl=fr) | [Piwigo - F-Droid](https://f-droid.org/packages/org.piwigo.android/)| [App Store - Piwigo](https://apps.apple.com/fr/app/piwigo/id472225196) | |
+| digiKam | GNU/Linux / macOS / Windows | ? | | | | [digiKam Download](https://www.digikam.org/download/) |
+| Shotwell | GNU/Linux | ? | | | | [Install Shotwell](https://wiki.gnome.org/Apps/Shotwell/BuildingAndInstalling) |
+
+## Liens utiles
+
++ Site web : [Site Piwigo](https://fr.piwigo.org)
++ Documentation officielle : [Documentation](https://piwigo.org/doc/doku.php)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/piwigo](https://github.com/YunoHost-Apps/piwigo_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/piwigo/issues](https://github.com/YunoHost-Apps/piwigo_ynh/issues)
diff --git a/pages/02.applications/02.docs/piwigo/app_piwigo.md b/pages/02.applications/02.docs/piwigo/app_piwigo.md
new file mode 100644
index 00000000..1da388bb
--- /dev/null
+++ b/pages/02.applications/02.docs/piwigo/app_piwigo.md
@@ -0,0 +1,50 @@
+---
+title: Piwigo
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_piwigo'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=piwigo) [](https://dash.yunohost.org/appci/app/piwigo)
+
+### Index
+
+- [Features](#features)
+- [Customer Applications](#customer-applications)
+- [Useful links](#useful-links)
+
+[Piwigo](http://piwigo.org) is a photo gallery software for the Web, built by an active community of users and developers.
+
+Extensions make Piwigo easily customizable. Icing on the cake, Piwigo is free and opensource.
+
+
+
+## Features
+
+In addition to Piwigo [core features](http://piwigo.org/basics/features), the following are made available with
+this package:
+
+ * Integrate with YunoHost users and SSO:
+ * private mode: limit access to YunoHost users
+ * public mode:
+ * SSO for YunoHost users
+ * allow other users management, and guest mode
+ * Allow one YunoHost user to be the administrator (set at the installation)
+
+## Customer Applications
+| Application name | Platform | Multi-account | Play Store | F-Droid | Apple Store | *Other* |
+|------------------|----------|---------------|------------|---------|-------------|---------|
+| Piwigo | Android / iOS | ? | [Playstore - Piwigo](https://play.google.com/store/apps/details?id=org.piwigo.android&hl=en) | [Piwigo - F-Droid](https://f-droid.org/packages/org.piwigo.android/)| [App Store - Piwigo](https://apps.apple.com/fr/app/piwigo/id472225196) | |
+| digiKam | GNU/Linux / macOS / Windows | ? | | | | [digiKam Download](https://www.digikam.org/download/) |
+| Shotwell | GNU/Linux | ? | | | | [Install Shotwell](https://wiki.gnome.org/Apps/Shotwell/BuildingAndInstalling) |
+
+## Useful links
+
++ Website: [Piwigo](http://piwigo.org/)
++ Official documentation: [Documentation](https://piwigo.org/doc/doku.php)
++ Application software repository: [github.com - YunoHost-Apps/piwigo](https://github.com/YunoHost-Apps/piwigo_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/piwigo/issues](https://github.com/YunoHost-Apps/piwigo_ynh/issues)
diff --git a/app_pleroma_fr.md b/pages/02.applications/02.docs/pleroma/app_pleroma.fr.md
similarity index 63%
rename from app_pleroma_fr.md
rename to pages/02.applications/02.docs/pleroma/app_pleroma.fr.md
index 44a4cdb1..2b09e298 100644
--- a/app_pleroma_fr.md
+++ b/pages/02.applications/02.docs/pleroma/app_pleroma.fr.md
@@ -1,4 +1,13 @@
-# 
Pleroma
+---
+title: Pleroma
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_pleroma'
+---
+
+
- [Découverte de l'interface de Pleroma](#d%C3%A9couverte-de-linterface-de-pleroma)
- [Logiciels Clients pour mobile et ordinateur](#applications-clients)
@@ -12,18 +21,18 @@ Pour celles et ceux qui n'ont pas ou peu l'habitude des réseaux sociaux, voici
### Accueil de l'interface
-
+
1. Barre de menu
- + 
Le bouton à gauche portant le nom de l'instance - dans la capture ci-dessus *Meta - Pleroma* - renvoie vers la page d'accueil de l'instance. Dans le cas où vous êtes connecté⋅e cela vous renverra vers la visualisation de votre *journal*, si ce n'est pas le cas vers *Le réseau connu*.
- + 
Si vous êtes connecté⋅e vous aurez trois boutons, si vous ne l'êtes pas il n'y en aura que deux. Dans l'ordre, de gauche à droite :
- + 
Permet d'ajouter de nouveaux utilisateurs et nouvelles utilisatrices afin de les suivre et ainsi vous abonner à leurs publications. Il est possible de rechercher un·e utilisateur·trice avec seulement son pseudonyme (par exemple : *yunohost*) ou alors sous la forme @pseudonyme@instance.domaine (par exemple : *@yunohost@mastodon.social*)
- + 
Permet d'accéder aux paramétres d'affichages de votre session.
+ +  Le bouton à gauche portant le nom de l'instance - dans la capture ci-dessus *Meta - Pleroma* - renvoie vers la page d'accueil de l'instance. Dans le cas où vous êtes connecté⋅e cela vous renverra vers la visualisation de votre *journal*, si ce n'est pas le cas vers *Le réseau connu*.
+ +  Si vous êtes connecté⋅e vous aurez trois boutons, si vous ne l'êtes pas il n'y en aura que deux. Dans l'ordre, de gauche à droite :
+ +  Permet d'ajouter de nouveaux utilisateurs et nouvelles utilisatrices afin de les suivre et ainsi vous abonner à leurs publications. Il est possible de rechercher un·e utilisateur·trice avec seulement son pseudonyme (par exemple : *yunohost*) ou alors sous la forme @pseudonyme@instance.domaine (par exemple : *@yunohost@mastodon.social*)
+ +  Permet d'accéder aux paramétres d'affichages de votre session.
/!\ Si vous n'êtes pas connecté·e les modifications effectuées ne seront valables qu'un temps (jusqu'à ce que les cookies de fonctionnement soient effacés).
- + 
Permet de se déconnecter de l'instance. Si vous n'êtes pas sur votre ordinateur personnel pensez-y !
+ +  Permet de se déconnecter de l'instance. Si vous n'êtes pas sur votre ordinateur personnel pensez-y !
2. Espace de Publications / Fenêtre de connexion
-
Si vous êtes connecté·e cet espace vous permet de publier vos messages et d'y joindre un média (images, GIF, vidéos, etc). Vous êtes limité⋅e dans le nombre de caractères, avec Pleroma la limitation est définie par l'administrateur·trice de l'instance. Si vous avez des questions envoyez lui un message.
+ Si vous êtes connecté·e cet espace vous permet de publier vos messages et d'y joindre un média (images, GIF, vidéos, etc). Vous êtes limité⋅e dans le nombre de caractères, avec Pleroma la limitation est définie par l'administrateur·trice de l'instance. Si vous avez des questions envoyez lui un message.
3. Fenêtre de visualisations
C'est ici le centre ~~du monde~~ de Pleroma, vous pourrez y voir les différentes publications de vos contacts ou qui circulent sur l'instance ainsi que les re-toots et qui a publié.
diff --git a/pages/02.applications/02.docs/pleroma/app_pleroma.md b/pages/02.applications/02.docs/pleroma/app_pleroma.md
new file mode 100644
index 00000000..5885a7b2
--- /dev/null
+++ b/pages/02.applications/02.docs/pleroma/app_pleroma.md
@@ -0,0 +1,10 @@
+---
+title: Pleroma
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_pleroma'
+---
+
+Unfortunately, this page only exists in french for now.
diff --git a/pages/02.applications/02.docs/plume/app_plume.fr.md b/pages/02.applications/02.docs/plume/app_plume.fr.md
new file mode 100644
index 00000000..01671ae0
--- /dev/null
+++ b/pages/02.applications/02.docs/plume/app_plume.fr.md
@@ -0,0 +1,29 @@
+---
+title: Plume
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_plume'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=plume) [](https://dash.yunohost.org/appci/app/plume)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+Plume est un moteur de blog décentralisé et fédéré en cours de développement.
+
+* Décentralisé : Chaque instance peut suivre une ou plusieurs autres instances Plume afin de permettre à ses utilisateur·rices de visionner les vidéos de celles-ci.
+* Fédéré : Via le protocole ActivityPub, Plume peut interagir avec d'autres logiciels qui font partie du Fediverse, comme Mastodon ou PixelFed par exemple.
+
+## Liens utiles
+
++ Site web : [joinplu.me](https://joinplu.me/)
++ Documentation officielle : [docs.joinplu.me](https://docs.joinplu.me/)
++ Démonstration : [Démo](https://joinplu.me/#instances)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/plume](https://github.com/YunoHost-Apps/plume_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/plume/issues](https://github.com/YunoHost-Apps/plume_ynh/issues)
diff --git a/pages/02.applications/02.docs/plume/app_plume.md b/pages/02.applications/02.docs/plume/app_plume.md
new file mode 100644
index 00000000..7dd1aa11
--- /dev/null
+++ b/pages/02.applications/02.docs/plume/app_plume.md
@@ -0,0 +1,30 @@
+---
+title: Plume
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_plume'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=plume) [](https://dash.yunohost.org/appci/app/plume)
+
+### Index
+
+- [Useful links](#useful-links)
+
+Plume is a decentralized and federated blog engine under development.
+
+* Decentralized: Each instance can follow one or more other Plume instances in order to allow its rice-users to view their videos.
+* Federated: Via the ActivityPub protocol, Plume can interact with other software that are part of the Fediverse, such as Mastodon or PixelFed for example.
+
+
+## Useful links
+
++ Website : [joinplu.me](https://joinplu.me/)
++ Official documentation : [docs.joinplu.me](https://docs.joinplu.me/)
++ Demonstration : [Demo](https://joinplu.me/#instances)
++ Application software repository : [github.com - YunoHost-Apps/plume](https://github.com/YunoHost-Apps/plume_ynh)
++ Fix a bug or an improvement by creating a ticket (issue) : [github.com - YunoHost-Apps/plume/issues](https://github.com/YunoHost-Apps/plume_ynh/issues)
diff --git a/app_pluxml_fr.md b/pages/02.applications/02.docs/pluxml/app_pluxml.fr.md
similarity index 72%
rename from app_pluxml_fr.md
rename to pages/02.applications/02.docs/pluxml/app_pluxml.fr.md
index 4cd94e10..569d0e48 100644
--- a/app_pluxml_fr.md
+++ b/pages/02.applications/02.docs/pluxml/app_pluxml.fr.md
@@ -1,12 +1,19 @@
-# PluXml
+---
+title: PluXml
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_pluxml'
+---
-
+
PluXml est un moteur de blog/CMS stockant ces données en XML et ne nécessitant pas de base de données SQL.
## Aperçu
-
+
## Plugins et thèmes
@@ -20,4 +27,4 @@ Pour sauvegarder votre blog, il est nécessaire de réaliser une copie du dossie
PluXml : https://www.pluxml.org/
Documentation : https://wiki.pluxml.org/
-Forum : https://forum.pluxml.org/
\ No newline at end of file
+Forum : https://forum.pluxml.org/
diff --git a/app_pluxml.md b/pages/02.applications/02.docs/pluxml/app_pluxml.md
similarity index 57%
rename from app_pluxml.md
rename to pages/02.applications/02.docs/pluxml/app_pluxml.md
index 66bc1056..4fe7d8fb 100644
--- a/app_pluxml.md
+++ b/pages/02.applications/02.docs/pluxml/app_pluxml.md
@@ -1,16 +1,23 @@
-# PluXml
+---
+title: PluXml
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_pluxml'
+---
-
+
PluXml is a blog/CMS storing data in XML and not in a SQL database.
## Overview
-
+
## Plugins and themes
-Plugins and themes should respectively be installed in the following folders : `/var/www/pluxml/plugins`, `/var/www/pluxml/themes`.
+Plugins and themes should respectively be installed in the following folders: `/var/www/pluxml/plugins`, `/var/www/pluxml/themes`.
## Backup
@@ -20,4 +27,4 @@ To restore your blog, you should keep a copy of the folder `/var/www/pluxml/data
PluXml : https://www.pluxml.org/
Documentation : https://wiki.pluxml.org/
-Forum : https://forum.pluxml.org/
\ No newline at end of file
+Forum : https://forum.pluxml.org/
diff --git a/pages/02.applications/02.docs/privatebin/app_privatebin.fr.md b/pages/02.applications/02.docs/privatebin/app_privatebin.fr.md
new file mode 100644
index 00000000..d385ae73
--- /dev/null
+++ b/pages/02.applications/02.docs/privatebin/app_privatebin.fr.md
@@ -0,0 +1,26 @@
+---
+title: PrivateBin
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_privatebin'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=privatebin) [](https://dash.yunohost.org/appci/app/privatebin)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+PrivateBin est un service web permettant de stocker temporairement et de partager du texte simple de manière chiffrée, sans stockage lisible sur le serveur. La clef de chiffrement/déchiffrement n'est pas stockée sur le serveur mais dans l'URL transmise. Ainsi vous pouvez partager des informations sensibles (mots de passe, codes d'accès, et même une discussion) de manière confidentielle en communiquant à vos interlocuteurs l'adresse spécifique de votre contenu. De plus ce contenu a une valeur limitée dans le temps et est détruit passé un délai personnalisable.
+
+## Liens utiles
+
++ Site web : [privatebin.info](https://privatebin.info/)
++ Documentation officielle : [github.com/PrivateBin/PrivateBin/wiki](https://github.com/PrivateBin/PrivateBin/wiki)
++ Démonstration : [Démo](https://privatebin.net/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/privatebin](https://github.com/YunoHost-Apps/privatebin_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/privatebin/issues](https://github.com/YunoHost-Apps/privatebin_ynh/issues)
diff --git a/pages/02.applications/02.docs/privatebin/app_privatebin.md b/pages/02.applications/02.docs/privatebin/app_privatebin.md
new file mode 100644
index 00000000..5d585cf4
--- /dev/null
+++ b/pages/02.applications/02.docs/privatebin/app_privatebin.md
@@ -0,0 +1,26 @@
+---
+title: PrivateBin
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_privatebin'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=privatebin) [](https://dash.yunohost.org/appci/app/privatebin)
+
+### Index
+
+- [Useful links](#useful-links)
+
+PrivateBin is a web service for temporarily storing and sharing plain text in encrypted form without readable storage on the server. The encryption/decryption key is not stored on the server but in the transmitted URL. Thus you can share sensitive information (passwords, access codes, and even a discussion) in a confidential way by communicating to your interlocutors the specific address of your content. Moreover this content has a limited value in time and is destroyed after a customizable delay.
+
+## Useful links
+
++ Website : [privatebin.info](https://privatebin.info/)
++ Official documentation : [github.com/PrivateBin/PrivateBin/wiki](https://github.com/PrivateBin/PrivateBin/wiki)
++ Demonstration : [Demo](https://privatebin.net/)
++ Application software repository : [github.com - YunoHost-Apps/privatebin](https://github.com/YunoHost-Apps/privatebin_ynh)
++ Fix a bug or an improvement by creating a ticket (issue) : [github.com - YunoHost-Apps/privatebin/issues](https://github.com/YunoHost-Apps/privatebin_ynh/issues)
diff --git a/app_radicale_fr.md b/pages/02.applications/02.docs/radicale/app_radicale.fr.md
similarity index 92%
rename from app_radicale_fr.md
rename to pages/02.applications/02.docs/radicale/app_radicale.fr.md
index 27650239..6dfd034a 100644
--- a/app_radicale_fr.md
+++ b/pages/02.applications/02.docs/radicale/app_radicale.fr.md
@@ -1,4 +1,11 @@
-# Radicale
+---
+title: Radicale
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_radicale'
+---
Radicale est un serveur de calendrier et de contact CalDAV/CardDAV. Il ne dispose pas d’interface graphique d’administration.
@@ -19,7 +26,7 @@ Pour connecter un autre client au serveur radicale, il faut renseigner ces adres
- Exemple : https://example.org/radicale/moi/AddressBook.vcf/
### Créer un nouveau calendrier ou un nouveau carnet d’adresses
-Créer un nouveau calendrier ou un nouveau carnet d’adresses est très simple avec radicale, il suffit d’y accéder! Radicale créera tout nouveau calendrier ou carnet d’adresses inexistant si vous tentez d’y accéder.
+Créer un nouveau calendrier ou un nouveau carnet d’adresses est très simple avec radicale, il suffit d’y accéder ! Radicale créera tout nouveau calendrier ou carnet d’adresses inexistant si vous tentez d’y accéder.
Il suffit donc de se connecter (comme précédemment) à un calendrier ou un carnet d’adresses inexistant pour le créer.
Cela peut être fait simplement avec un navigateur, pour le voir apparaître dans une collection déjà connectée à un client.
@@ -50,7 +57,7 @@ collection: calendrier, carnet ou collection concernée.
permission: permission, r (lecture), w (écriture) ou rw (lecture/écriture)
```
Le fichier *rights* contient plusieurs exemples pouvant être exploités.
-Pour valider les modifications apportées au fichier */etc/radicale/rights*, radicale doit être rechargé via le service uwsgi.
+Pour valider les modifications apportées au fichier */etc/radicale/rights*, radicale doit être rechargé via le service uWSGI.
```bash
sudo service uwsgi restart
```
@@ -72,7 +79,7 @@ Dans les deux cas, le partage ne fonctionnera qu’en utilisant l’adresse comp
Cette limitation peut s’avérer bloquante pour des clients gérant une seule collection, tel que InfCloud. Pour ce cas particulier, une solution permet de contourner ce problème.
#### Partager des ressources directement dans la collection d’un utilisateur
-> Cette solution est fonctionnelle, mais reste du bidouillage…
+> Cette solution est fonctionnelle, mais reste du bidouillage...
Pour permettre à un partage d’apparaître directement dans la collection d’un utilisateur, il faut exploiter l’usage des fichiers sous Radicale.
En créant simplement un lien symbolique de la ressource à partager.
@@ -86,7 +93,7 @@ En revanche, sans avoir recours à des règles pour chaque ressource de la colle
### Rendre le log de Radicale plus loquace
Par défaut, le log de Radicale est réglé sur INFO. Ce mode épargne le disque dur mais ne permet pas de débugger Radicale en cas de problème.
-Pour passer Radicale en mode DEBUG, il faut éditer le fichier */etc/radicale/logging* et passer INFO à DEBUG dans les sections *[logger_root]* et *[handler_file]* puis recharger le service uwsgi.
+Pour passer Radicale en mode DEBUG, il faut éditer le fichier */etc/radicale/logging* et passer INFO à DEBUG dans les sections *[logger_root]* et *[handler_file]* puis recharger le service uWSGI.
Dès lors, le log affiche toutes les requêtes qui sont faites à Radicale ainsi que l’analyse du fichier *rights*.
Il est toutefois déconseillé de rester sur ce mode, car le log se remplie très rapidement.
diff --git a/app_radicale.md b/pages/02.applications/02.docs/radicale/app_radicale.md
similarity index 87%
rename from app_radicale.md
rename to pages/02.applications/02.docs/radicale/app_radicale.md
index 4a41b02d..59a35ee0 100644
--- a/app_radicale.md
+++ b/pages/02.applications/02.docs/radicale/app_radicale.md
@@ -1,8 +1,15 @@
-# Radicale
+---
+title: Radicale
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_radicale'
+---
-Radical is a calendar and contact server CalDAV/CardDAV. It does not have a graphical administration interface.
+Radicale is a calendar and contact server CalDAV/CardDAV. It does not have a graphical administration interface.
-Radical is installed by default with the web client InfCloud that will view and edit your calendars and address books.
+Radicale is installed by default with the web client InfCloud that will view and edit your calendars and address books.
To connect another client to radical, we must inform these addresses:
@@ -19,8 +26,7 @@ To connect another client to radical, we must inform these addresses:
- Exemple: https://example.org/radicale/me/AddressBook.vcf/
### Create a new schedule or a new address book
-Create a new schedule or a new address book is very simple with radical, just go there! Radical create all new calendar or notebook to nonexistent addresses if you try to access it.
-
+Create a new schedule or a new address book is very simple with Radicale, just go there! Radicale creates all new calendar or notebook to nonexistent addresses if you try to access it.
So just log on (as before) to a calendar or a nonexistent address book to create it.
This can be done simply with a browser, to appear in a collection already connected to a client.
@@ -50,7 +56,7 @@ collection: calendar, book or collection concerned.
permission: permission, r (read), w (write) or rw (read/write)
```
*Rights* file contains several examples that can be exploited.
-To validate changes to the */etc/radicale/rights* file, radical must be recharged via uwsgi service.
+To validate changes to the */etc/radicale/rights* file, radical must be recharged via uWSGI service.
```bash
sudo service uwsgi restart
```
@@ -72,7 +78,7 @@ In both cases, the sharing works only using the full address of the calendar or
This limitation may be blocking for clients managing a single collection, as InfCloud. In this particular case, a solution overcomes this problem.
#### Share resources directly in the collection of a user
-> This solution is functional, but is an hack ...
+> This solution is functional, but is an hack...
To enable sharing to occur directly in the collection of a user, it must exploit the use of files in Radicale.
By simply creating a symbolic link to the resource sharing.
@@ -86,7 +92,7 @@ However, without recourse to the rules for each resource in the collection of us
### Making Radical log more verbose
By default, the Radical log is set to INFO. This method savings the hard drive but does not debug Radicale in case of problems.
-To pass Radicale in DEBUG mode, edit the */etc/radicale/logging* and change INFO to DEBUG in sections *[logger_root]* and *[handler_file]*. Then reload the uwsgi service.
+To pass Radicale in DEBUG mode, edit the */etc/radicale/logging* and change INFO to DEBUG in sections *[logger_root]* and *[handler_file]*. Then reload the uWSGI service.
Now, the log displays all requests that are made to Radicale and analysis of *rights* file.
However, do not stay on this mode because the log is filled very quickly.
diff --git a/pages/02.applications/02.docs/rainloop/app_rainloop.fr.md b/pages/02.applications/02.docs/rainloop/app_rainloop.fr.md
new file mode 100644
index 00000000..a722efad
--- /dev/null
+++ b/pages/02.applications/02.docs/rainloop/app_rainloop.fr.md
@@ -0,0 +1,51 @@
+---
+title: Rainloop
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_rainloop'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=rainloop) [](https://dash.yunohost.org/appci/app/rainloop)
+
+### Index
+
+- [Configuration](#Configuration)
+- [Liens utiles](#liens-utiles)
+
+Rainloop est un webmail simple et léger.
+
+## Configuration
+
+Pour le configurer après l'installation, veuillez vous rendre sur http://DOMAIN.TLD/rainloop/app/?admin
+
+- Le nom d'utilisateur admin par défaut est : admin
+- Le mot de passe admin par défaut est : Mot de passe choisi lors de l'installation
+- Si vous avez oublié votre mot de passe, vous pouvez le retrouver avec `sudo yunohost app setting rainloop password`
+
+### Carnet d'adresses
+Rainloop intègre par défaut un carnet d'adresse avec les utilisateurs du serveur YunoHost. Chaque utilisateur peut ajouter un carnet d'adresse distant CardDAV via leurs propres paramètres.
+- Si vous utilisez Baïkal, l'adresse à renseigner est du type : https://DOMAIN.TLD/baikal/card.php/addressbooks/UTILISATEUR/default/
+- Si vous utilisez Nextcloud, l'adresse à renseigner est du type : https://DOMAIN.TLD/nextcloud/remote.php/carddav/addressbooks/USER/contacts
+
+### Gestion des domaines
+Les utilisateurs peuvent se servir de Rainloop pour accéder à d'autres boites mail que celle fournie par YunoHost (par exemple gmail.com ou laposte.net). L'option est disponible par le bouton "compte -> ajouter un compte".
+L'administrateur doit pour cela autoriser la connexion à des domaines tiers, via une liste blanche dans l'interface administration.
+
+### Gestion des clés PGP
+Rainloop stocke les clés PGP privées dans le stockage de navigateur. Cela implique que vos clés seront perdues quand vous videz le stockage de navigateur (navigation incognito, changement d'ordinateur, ...). Ce paquet intègre donc [PGPback de chtixof](https://github.com/chtixof/pgpback_ynh) pour que vous puissiez stocker vos clés privées PGP de manière sécurisée sur le serveur. Rendez-vous à l'adresse **http://DOMAIN.TLD/rainloop/pgpback** pour stocker vos clés privées PGP sur le serveur ou les restaurer dans un nouveau navigateur.
+
+### Mise à jour
+Pour mettre à jour Rainloop lorsqu'une nouvelle version est disponible, lancez en console locale (SSH ou autre) :
+`sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/rainloop_ynh rainloop`
+
+## Liens utiles
+
++ Site web : [www.rainloop.net](https://www.rainloop.net/)
++ Documentation officielle : [www.rainloop.net/docs/configuration](https://www.rainloop.net/docs/configuration/)
++ Démonstration : [Démo](https://mail.rainloop.net/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/rainloop](https://github.com/YunoHost-Apps/rainloop_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/rainloop/issues](https://github.com/YunoHost-Apps/rainloop_ynh/issues)
diff --git a/pages/02.applications/02.docs/rainloop/app_rainloop.md b/pages/02.applications/02.docs/rainloop/app_rainloop.md
new file mode 100644
index 00000000..d605bda3
--- /dev/null
+++ b/pages/02.applications/02.docs/rainloop/app_rainloop.md
@@ -0,0 +1,52 @@
+---
+title: Rainloop
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_rainloop'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=rainloop) [](https://dash.yunohost.org/appci/app/rainloop)
+
+### Index
+
+- [Configuration](#Configuration)
+- [Useful links](#useful-links)
+
+Rainloop is a lightweight webmail.
+
+## Configuration
+
+To configure it, go to http://DOMAIN.TLD/rainloop/app/?admin
+
+- The default login is: admin
+- The default password is: Password chosen during install
+- If you lost the admin password, you can retrieve it using `sudo yunohost app setting rainloop password`
+
+### CardDAV
+Each user can add a remote cardDAV server from their own parameters interface.
+
+- If you use Baïkal, the CardDAV address is: https://DOMAIN.TLD/baikal/card.php/addressbooks/USER/default/
+- If you use Nextcloud, the CardDAV address is: https://DOMAIN.TLD/nextcloud/remote.php/carddav/addressbooks/USER/contacts
+
+### Domains
+Users can use Rainloop to access mailboxes other than the one provided by YunoHost (e.g. gmail.com or live.com). The option is available through the "account -> add an account" button.
+The administrator must authorize the connection to third party domains, via a white list in the administration interface.
+
+### PGP Keys
+Rainloop saves your PGP private keys in the browser storage. This means that you will loose your private keys if you clear your browser storage (e.g., private browsing, different computer...). This packages integrates [PGPback by chtixof](https://github.com/chtixof/pgpback_ynh) so you can store your PGP private keys on the server securely. Go to **http://DOMAIN.TLD/rainloop/pgpback** to backup your PGP keys on the server or restore them.
+
+### Upgrade
+To upgrade the app once a new rainloop version is available, simply run in a local shell via ssh or otherwise:
+`sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/rainloop_ynh rainloop`
+
+## Useful links
+
++ Website : [www.rainloop.net](https://www.rainloop.net/)
++ Official documentation : [www.rainloop.net/docs/configuration](https://www.rainloop.net/docs/configuration/)
++ Demonstration : [Demo](https://mail.rainloop.net/)
++ Application software repository : [github.com - YunoHost-Apps/rainloop](https://github.com/YunoHost-Apps/rainloop_ynh)
++ Fix a bug or an improvement by creating a ticket (issue) : [github.com - YunoHost-Apps/rainloop/issues](https://github.com/YunoHost-Apps/rainloop_ynh/issues)
diff --git a/pages/02.applications/02.docs/roundcube/app_roundcube.fr.md b/pages/02.applications/02.docs/roundcube/app_roundcube.fr.md
new file mode 100644
index 00000000..45aa9ba4
--- /dev/null
+++ b/pages/02.applications/02.docs/roundcube/app_roundcube.fr.md
@@ -0,0 +1,41 @@
+---
+title: Roundcube
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_roundcube'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=roundcube) [](https://dash.yunohost.org/appci/app/roundcube)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+Roundcube est un client web de courrier électronique libre ou aussi appelé un webmail.
+
+### Synchronisation des contacts
+
+Roundcube vous propose à l'installation, via un greffon tiers, de pouvoir synchroniser vos contacts avec un serveur CardDAV. Utiliser un serveur CardDAV comme Baïkal ou l’application « Contacts » de Nextcloud, tous deux disponibles pour YunoHost, a l’avantage de permettre une gestion centralisée de vos contacts.
+
+De la même façon que le protocole IMAP vous permet de synchroniser vos courriels avec votre serveur mail, CardDAV vous permet d’avoir accès à vos contacts depuis une multitude de clients, dont Roundcube. Avec CardDAV, nous n’aurez donc plus besoin d’importer vos contacts dans chaque client.
+
+Notez que si Baïkal ou Nextcloud sont déjà installés, les carnets d'adresses qui y sont définis seront automatiquement ajoutés pour chaque utilisateur dans Roundcube.
+
+----
+
+Si vous avez installé Nextcloud après, voici comment ajouter vos carnets d'adresses :
+
+* Rendez-vous dans la section « Contacts » de votre espace Nextcloud et cliquez sur l’icône représentant une roue dentée en bas à gauche. Ensuite, cliquez sur l’icône « Lien CardDAV » et copiez l’URL qui s’affiche en dessous.
+* Rendez-vous ensuite dans la section CardDAV des paramètres de Roundcube et entrez « nextcloud » dans le champ « Label », collez l’URL que vous venez de copier et enfin entrez votre nom d’utilisateur et votre mot de passe. Vos contacts sont désormais synchronisés !
+
+## Liens utiles
+
++ Site web : [roundcube.net](https://roundcube.net/)
++ Documentation officielle : [github.com/roundcube/roundcubemail/wiki](https://github.com/roundcube/roundcubemail/wiki)
++ Démonstration : [Démo](https://demo.yunohost.org/webmail/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/roundcube](https://github.com/YunoHost-Apps/roundcube_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/roundcube/issues](https://github.com/YunoHost-Apps/roundcube_ynh/issues)
diff --git a/pages/02.applications/02.docs/roundcube/app_roundcube.md b/pages/02.applications/02.docs/roundcube/app_roundcube.md
new file mode 100644
index 00000000..261c1a61
--- /dev/null
+++ b/pages/02.applications/02.docs/roundcube/app_roundcube.md
@@ -0,0 +1,41 @@
+---
+title: Roundcube
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_roundcube'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=roundcube) [](https://dash.yunohost.org/appci/app/roundcube)
+
+### Index
+
+- [Useful links](#useful-links)
+
+Roundcube is a web client for email messaging also called webmail.
+
+### Synchronize your contacts
+
+Roundcube offers you at the installation to synchronize your contacts with a CardDAV server, through a third party plugin. Using a CardDAV server like Baïkal or Nextcloud's "Contacts" application, both available in YunoHost, allows you to centralize and manage your contacts.
+
+Similarly to IMAP that allows you to synchronize your emails with your mail server, CardDAV allows you to access your contacts through multiple clients, such as Roundcube. Thanks to CardDAV, you will not have to import your contacts in each of your devices.
+
+Note that addressbooks defined in Baïkal or Nextcloud will be automatically added in Roundcube for each user if they are already installed.
+
+----
+
+In case you've installed Nextcloud after, here is how to add your addressbooks:
+
+* Go to "Contacts" section of your Nextcloud application and click on the gear wheel icon located at the bottom left. Then, click on "CardDAV link" and copy the URL that appeared.
+* Go to Roundcube's CardDAV section and type in "nextcloud" in "Label" field, paste the previously copied URL and type your username and password. Your contacts are now synchronized!
+
+## Useful links
+
++ Website : [roundcube.net](https://roundcube.net/)
++ Official documentation : [github.com/roundcube/roundcubemail/wiki](https://github.com/roundcube/roundcubemail/wiki)
++ Demonstration : [Demo](https://demo.yunohost.org/webmail/)
++ Application software repository : [github.com - YunoHost-Apps/roundcube](https://github.com/YunoHost-Apps/roundcube_ynh)
++ Fix a bug or an improvement by creating a ticket (issue) : [github.com - YunoHost-Apps/roundcube/issues](https://github.com/YunoHost-Apps/roundcube_ynh/issues)
diff --git a/pages/02.applications/02.docs/searx/app_searx.fr.md b/pages/02.applications/02.docs/searx/app_searx.fr.md
new file mode 100644
index 00000000..82251b98
--- /dev/null
+++ b/pages/02.applications/02.docs/searx/app_searx.fr.md
@@ -0,0 +1,28 @@
+---
+title: Searx
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_searx'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=searx) [](https://dash.yunohost.org/appci/app/searx)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+Searx est un métamoteur de recherche libre et décentralisé. Les requêtes effectuées ne sont pas enregistrées par Searx afin de protéger la vie privée des utilisateur·rice·s.
+En tant que métamoteur, searx collecte et affiche les résultats issus de plusieurs dizaines de moteurs de recherche. Les moteurs utilisés (ou non) sont paramétrables dans les préférences.
+En tant que logiciel décentralisé, searx est installé sur différentes instances (différents serveurs). En France, des associations comme Framasoft, Aquilenet ou La Quadrature du Net l'ont installé sur leurs serveurs.
+
+## Liens utiles
+
++ Site web : [searx.me](https://searx.me/)
++ Documentation officielle : [asciimoo.github.io/searx](https://asciimoo.github.io/searx/)
++ Démonstration : [Démo](https://demo.yunohost.org/searx/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/searx](https://github.com/YunoHost-Apps/searx_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/searx/issues](https://github.com/YunoHost-Apps/searx_ynh/issues)
diff --git a/pages/02.applications/02.docs/searx/app_searx.md b/pages/02.applications/02.docs/searx/app_searx.md
new file mode 100644
index 00000000..108a9ebc
--- /dev/null
+++ b/pages/02.applications/02.docs/searx/app_searx.md
@@ -0,0 +1,27 @@
+---
+title: Searx
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_searx'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=searx) [](https://dash.yunohost.org/appci/app/searx)
+
+### Index
+
+- [Useful links](#useful-links)
+
+Searx is a free and decentralized meta-search engine. The queries made are not saved by Searx in order to protect the privacy of the user. As a metasearch engine, searx collects and displays results from dozens of search engines. The search engines used (or not) can be configured in the preferences.
+As a decentralized software, searx is installed on different instances (different servers). In France, associations such as Framasoft, Aquilenet or La Quadrature du Net have installed it on their servers.
+
+## Useful links
+
++ Website: [searx.me](https://searx.me/)
++ Official documentation: [asciimoo.github.io/searx](https://asciimoo.github.io/searx/)
++ Demonstration: [Demo](https://demo.yunohost.org/searx/)
++ Application software repository: [github.com - YunoHost-Apps/searx](https://github.com/YunoHost-Apps/searx_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/searx/issues](https://github.com/YunoHost-Apps/searx_ynh/issues)
diff --git a/pages/02.applications/02.docs/shaarli/app_shaarli.fr.md b/pages/02.applications/02.docs/shaarli/app_shaarli.fr.md
new file mode 100644
index 00000000..b272dffa
--- /dev/null
+++ b/pages/02.applications/02.docs/shaarli/app_shaarli.fr.md
@@ -0,0 +1,24 @@
+---
+title: Shaarli
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_shaarli'
+---
+
+## Présentation
+
+Shaarli est un clone libre de feu del.icio.us : il s'agit d'une application légère permettant d'archiver et de partager des marque-pages, étiquetés à l'aide de tags. Chaque marque-page peut être "public" ou "privé", et peut recevoir une note descriptive.
+
+Le moteur de recherche intégré à l'application interroge les tags, le titre des pages archivées, ainsi que le contenu de l'éventuelle note associée. Il est ainsi très aisé de retrouver une marque-page, même plusieurs années après son enregistrement.
+
+L'enregistrement d'une page peut s'effectuer de plusieurs façons : grâce à un bookmarklet, depuis l'application elle-même, ou depuis une application Android.
+
+Shaarli est intéressant pour toutes celles et tous ceux qui souhaitent conserver la trace de pages Web et y accéder depuis partout, et ce sans surcharger les marque-pages (ou "favoris") de leur navigateur.
+
+## Liens utiles
+
+- [Page officielle](https://sebsauvage.net/wiki/doku.php?id=php:shaarli) de Shaarli
+- [Application Shaarlier](https://f-droid.org/fr/packages/com.dimtion.shaarlier/) sur Android
+- [Fil de discussion](https://forum.yunohost.org/t/shaarli-version-0-10-4/2200) concernant Shaarli sur le forum
diff --git a/pages/02.applications/02.docs/shaarli/app_shaarli.md b/pages/02.applications/02.docs/shaarli/app_shaarli.md
new file mode 100644
index 00000000..cdf6c315
--- /dev/null
+++ b/pages/02.applications/02.docs/shaarli/app_shaarli.md
@@ -0,0 +1,10 @@
+---
+title: Shaarli
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_shaarli'
+---
+
+(This page only exists in french for now)
diff --git a/pages/02.applications/02.docs/shellinabox/app_shellinabox.fr.md b/pages/02.applications/02.docs/shellinabox/app_shellinabox.fr.md
new file mode 100644
index 00000000..3b0a4311
--- /dev/null
+++ b/pages/02.applications/02.docs/shellinabox/app_shellinabox.fr.md
@@ -0,0 +1,25 @@
+---
+title: Shellinabox
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_shellinabox'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=shellinabox) [](https://dash.yunohost.org/appci/app/shellinabox)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+Shellinabox met en œuvre un serveur web qui peut saisir des lignes de commande arbitraires vers un émulateur de terminal. Cet émulateur est accessible à tout navigateur Web compatible JavaScript et CSS et ne nécessite pas de plugins supplémentaires à votre navigateur Internet.
+
+## Liens utiles
+
++ Site web : [github.com/shellinabox/shellinabox](https://github.com/shellinabox/shellinabox)
++ Documentation officielle : [github.com/shellinabox/shellinabox/wiki/shellinaboxd_man](https://github.com/shellinabox/shellinabox/wiki/shellinaboxd_man)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/shellinabox](https://github.com/YunoHost-Apps/shellinabox_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/shellinabox/issues](https://github.com/YunoHost-Apps/shellinabox_ynh/issues)
diff --git a/pages/02.applications/02.docs/shellinabox/app_shellinabox.md b/pages/02.applications/02.docs/shellinabox/app_shellinabox.md
new file mode 100644
index 00000000..70a09274
--- /dev/null
+++ b/pages/02.applications/02.docs/shellinabox/app_shellinabox.md
@@ -0,0 +1,25 @@
+---
+title: Shellinabox
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_shellinabox'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=shellinabox) [](https://dash.yunohost.org/appci/app/shellinabox)
+
+### Index
+
+- [Useful links](#useful-links)
+
+Shellinabox implements a web server that can export arbitrary command line tools to a web based terminal emulator. This emulator is accessible to any JavaScript and CSS enabled web browser and does not require any additional browser plugins.
+
+## Useful links
+
++ Website: [github.com/shellinabox/shellinabox](https://github.com/shellinabox/shellinabox)
++ Official documentation: [github.com/shellinabox/shellinabox/wiki/shellinaboxd_man](https://github.com/shellinabox/shellinabox/wiki/shellinaboxd_man)
++ Application software repository: [github.com - YunoHost-Apps/shellinabox](https://github.com/YunoHost-Apps/shellinabox_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/shellinabox/issues](https://github.com/YunoHost-Apps/shellinabox_ynh/issues)
diff --git a/pages/02.applications/02.docs/simple-torrent/app_simple-torrent.fr.md b/pages/02.applications/02.docs/simple-torrent/app_simple-torrent.fr.md
new file mode 100644
index 00000000..de351cec
--- /dev/null
+++ b/pages/02.applications/02.docs/simple-torrent/app_simple-torrent.fr.md
@@ -0,0 +1,24 @@
+---
+title: Simple Torrent
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_simple-torrent'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=simple-torrent) [](https://dash.yunohost.org/appci/app/simple-torrent)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+Simple Torrent est un client torrent distant auto-hébergé, écrit en Go (golang). Démarrez des torrents à distance, téléchargez des ensembles de fichiers sur le disque local du serveur, qui sont ensuite récupérables ou diffusables via HTTP.
+
+## Liens utiles
+
+ + Documentation officielle : [wiki](https://github.com/boypt/simple-torrent/wiki)
+ + Dépôt logiciel de l'application : [github.com - YunoHost-Apps/simple-torrent](https://github.com/YunoHost-Apps/simple-torrent_ynh)
+ + Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/simple-torrent/issues](https://github.com/YunoHost-Apps/simple-torrent_ynh/issues)
diff --git a/pages/02.applications/02.docs/simple-torrent/app_simple-torrent.md b/pages/02.applications/02.docs/simple-torrent/app_simple-torrent.md
new file mode 100644
index 00000000..f9abb112
--- /dev/null
+++ b/pages/02.applications/02.docs/simple-torrent/app_simple-torrent.md
@@ -0,0 +1,24 @@
+---
+title: Simple Torrent
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_simple-torrent'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=simple-torrent) [](https://dash.yunohost.org/appci/app/simple-torrent)
+
+### Index
+
+- [Useful links](#useful-links)
+
+Simple Torrent is a a self-hosted remote torrent client, written in Go (golang). Started torrents remotely, download sets of files on the local disk of the server, which are then retrievable or streamable via HTTP.
+
+## Useful links
+
++ Official documentation: [wiki](https://github.com/boypt/simple-torrent/wiki)
++ Application software repository: [github.com - YunoHost-Apps/simple-torrent](https://github.com/YunoHost-Apps/simple-torrent_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/simple-torrent/issues](https://github.com/YunoHost-Apps/simple-torrent_ynh/issues)
diff --git a/pages/02.applications/02.docs/slingcode/app_slingcode.fr.md b/pages/02.applications/02.docs/slingcode/app_slingcode.fr.md
new file mode 100644
index 00000000..f6ddcd28
--- /dev/null
+++ b/pages/02.applications/02.docs/slingcode/app_slingcode.fr.md
@@ -0,0 +1,24 @@
+---
+title: Slingcode
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_slingcode'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=slingcode) [](https://dash.yunohost.org/appci/app/slingcode)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+Slingcode est un éditeur de code contenu dans un unique fichier HTML. Il n'a pas de composant serveur, ce qui signifie que toutes vos données sont stockées dans le cache de votre navigateur. Cependant, il est toujours possible de créer des applications Web, de les exécuter, de les exporter et même de les partager en peer-to-peer.
+
+## Liens utiles
+
++ Site web : [slingcode.net (en)](https://slingcode.net/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/slingcode](https://github.com/chr15m/slingcode)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/slingcode/issues](https://github.com/YunoHost-Apps/slingcode_ynh/issues)
diff --git a/pages/02.applications/02.docs/slingcode/app_slingcode.md b/pages/02.applications/02.docs/slingcode/app_slingcode.md
new file mode 100644
index 00000000..f7167e86
--- /dev/null
+++ b/pages/02.applications/02.docs/slingcode/app_slingcode.md
@@ -0,0 +1,24 @@
+---
+title: Slingcode
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_slingcode'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=slingcode) [](https://dash.yunohost.org/appci/app/slingcode)
+
+### Index
+
+- [Useful links](#useful-links)
+
+Slingcode is a code editor contained in a single HTML file. Therefore, it has no server component, so all of your data is stored in your browser's cache. However, it is still possible to make web apps, run them, export them, and even share them using peer-to-peer.
+
+## Useful links
+
++ Website: [slingcode.net](https://slingcode.net/)
++ Application software repository: [github.com - YunoHost-Apps/slingcode](https://github.com/chr15m/slingcode)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/slingcode/issues](https://github.com/YunoHost-Apps/slingcode_ynh/issues)
diff --git a/pages/02.applications/02.docs/sogo/app_sogo.fr.md b/pages/02.applications/02.docs/sogo/app_sogo.fr.md
new file mode 100644
index 00000000..ee7de8c9
--- /dev/null
+++ b/pages/02.applications/02.docs/sogo/app_sogo.fr.md
@@ -0,0 +1,23 @@
+---
+title: SOGo
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_sogo'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=sogo) [](https://dash.yunohost.org/appci/app/sogo)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+SOGo est un service de webmail pour votre serveur email, c'est une alternative à [RoundCube](/app_roundcube). Il permet aussi la gestion des agendas et contacts présents sur le serveur.
+
+## Quelques liens utiles
+
+ + Site officiel de SOGo : [sogo.nu](https://sogo.nu)
+ + Dépot de l'application pour YunoHost : [github.com/YunoHost-Apps/sogo_ynh](https://github.com/YunoHost-Apps/sogo_ynh)
diff --git a/pages/02.applications/02.docs/sogo/app_sogo.md b/pages/02.applications/02.docs/sogo/app_sogo.md
new file mode 100644
index 00000000..441920f7
--- /dev/null
+++ b/pages/02.applications/02.docs/sogo/app_sogo.md
@@ -0,0 +1,23 @@
+---
+title: SOGo
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_sogo'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=sogo) [](https://dash.yunohost.org/appci/app/sogo)
+
+### Index
+
+- [Useful links](#useful-links)
+
+SOGo is an opensource groupware solution which has Webmail, a global address book, calender and contacts which can be synced via CalDAV or CardDAV.
+
+## Useful links
+
++ Application software repository: [sogo.nu](https://sogo.nu)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com/YunoHost-Apps/sogo_ynh](https://github.com/YunoHost-Apps/sogo_ynh)
diff --git a/app_spip_fr.md b/pages/02.applications/02.docs/spip/app_spip.fr.md
similarity index 87%
rename from app_spip_fr.md
rename to pages/02.applications/02.docs/spip/app_spip.fr.md
index 78310855..b9470359 100644
--- a/app_spip_fr.md
+++ b/pages/02.applications/02.docs/spip/app_spip.fr.md
@@ -1,4 +1,11 @@
-# SPIP for YunoHost
+---
+title: SPIP
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_spip'
+---
### SPIP c'est quoi ?
@@ -6,7 +13,7 @@ SPIP est un système de publication pour l’Internet qui s’attache particuli
Source : [spip.net](https://www.spip.net/fr_rubrique91.html)
-### Fonctionnalité de l'application pour Yunohost
+### Fonctionnalité de l'application pour YunoHost
* Installation de la base sans passer par le système d'installation
* Support multilingue
diff --git a/app_spip.md b/pages/02.applications/02.docs/spip/app_spip.md
similarity index 87%
rename from app_spip.md
rename to pages/02.applications/02.docs/spip/app_spip.md
index 880b41e6..9fd0ecec 100644
--- a/app_spip.md
+++ b/pages/02.applications/02.docs/spip/app_spip.md
@@ -1,4 +1,11 @@
-# SPIP for YunoHost
+---
+title: SPIP
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_spip'
+---
#### SPIP is what?
@@ -6,7 +13,7 @@ SPIP is an Internet publishing system that focuses on collective functioning, mu
Source:[spip.net](https://www.spip.net/fr_rubrique91.html_rubrique91.html)
-#### Application functionality for Yunohost
+#### Application functionality for YunoHost
* Installation of the base without going through the installation system
* Multilingual support
diff --git a/pages/02.applications/02.docs/strut/app_strut.fr.md b/pages/02.applications/02.docs/strut/app_strut.fr.md
new file mode 100644
index 00000000..6d048d14
--- /dev/null
+++ b/pages/02.applications/02.docs/strut/app_strut.fr.md
@@ -0,0 +1,25 @@
+---
+title: Strut
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_strut'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=strut) [](https://dash.yunohost.org/appci/app/strut)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+Strut est un logiciel de création en ligne de diaporamas. Il permet de créer des diapositives simples en incluant textes, images, formes, sites web ou vidéos, ainsi que la disposition des diapos. Il utilise la librairie Impress.js et vous permet de sauvegarder votre projet en local ou de l'exporter en ZIP contenant les fichiers sources et le HTML.
+
+## Liens utiles
+
++ Site web : [strut.io](http://strut.io)
++ Démonstration: [Démo](http://strut.io/dist/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/strut](https://github.com/YunoHost-Apps/strut_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/strut/issues](https://github.com/YunoHost-Apps/strut_ynh/issues)
diff --git a/pages/02.applications/02.docs/strut/app_strut.md b/pages/02.applications/02.docs/strut/app_strut.md
new file mode 100644
index 00000000..bd8a08c3
--- /dev/null
+++ b/pages/02.applications/02.docs/strut/app_strut.md
@@ -0,0 +1,26 @@
+---
+title: Strut
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_strut'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=strut) [](https://dash.yunohost.org/appci/app/strut)
+
+### Index
+
+- [Useful links](#useful-links)
+
+Strut is an online slideshow creation software. It allows you to create simple slides by including text, images, shapes, websites or videos, as well as the layout of the slides. It uses the Impress.js library and
+allows you to save your project locally or export it as a ZIP file containing the source files and HTML.
+
+## Useful links
+
++ Website: [strut.io](http://strut.io)
++ Demonstration: [Demo](http://strut.io/dist/)
++ Application software repository: [github.com - YunoHost-Apps/strut](https://github.com/YunoHost-Apps/strut_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/strut/issues](https://github.com/YunoHost-Apps/strut_ynh/issues)
diff --git a/app_transmission_fr.md b/pages/02.applications/02.docs/transmission/app_transmission.fr.md
similarity index 90%
rename from app_transmission_fr.md
rename to pages/02.applications/02.docs/transmission/app_transmission.fr.md
index df00ad3d..936d0a35 100644
--- a/app_transmission_fr.md
+++ b/pages/02.applications/02.docs/transmission/app_transmission.fr.md
@@ -1,4 +1,13 @@
-# 
Transmission
+---
+title: Transmission
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_transmission'
+---
+
+ Transmission
### C’est quoi Transmission ?
Transmission est un logiciel de téléchargement et de partage de fichiers basé sur le protocole BitTorrent.
@@ -39,4 +48,4 @@ Pour plus de détails sur le transfert de fichier avec *scp* voir ici : http://
Si vous rencontrez des problèmes de droits `Permission denied` après l’ajout de fichiers à seeder, changez l’utilisateur qui possède les droits sur ces fichiers :
```bash
chown -R debian-transmission: /home/yunohost.transmission/completed/*
-```
\ No newline at end of file
+```
diff --git a/app_transmission.md b/pages/02.applications/02.docs/transmission/app_transmission.md
similarity index 75%
rename from app_transmission.md
rename to pages/02.applications/02.docs/transmission/app_transmission.md
index 854a2bda..6e1ed3a9 100644
--- a/app_transmission.md
+++ b/pages/02.applications/02.docs/transmission/app_transmission.md
@@ -1,6 +1,15 @@
-# Transmission
+---
+title: Transmission
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_transmission'
+---
-### What is Transmission?
+
+
+### What is Transmission?
Transmission is a share software based on BitTorrent protocol.
* [Transmission web site](http://transmissionbt.com/)
@@ -30,10 +39,10 @@ scp (-r) /your/file/ root@your-domain.org:/home/yunohost.transmission/completed
```
##### How to download a complete folder?
-Once connected to your server, using [SSH](ssh), move to the download folder and zip it :
+Once connected to your server, using [SSH](/ssh), move to the download folder and ZIP it:
```bash
cd /home/yunohost.transmission/completed
zip -r your_archive.zip [dossier]
```
-More informations about file transfer using *scp*: http://doc.ubuntu-fr.org/ssh#transfert_-_copie_de_fichiers (french, need english documentation)
+More informations about file transfer using *scp*: http://doc.ubuntu-fr.org/ssh#transfert_-_copie_de_fichiers (French, need English documentation)
diff --git a/pages/02.applications/02.docs/ttrss/app_ttrss.fr.md b/pages/02.applications/02.docs/ttrss/app_ttrss.fr.md
new file mode 100644
index 00000000..0808cbb9
--- /dev/null
+++ b/pages/02.applications/02.docs/ttrss/app_ttrss.fr.md
@@ -0,0 +1,40 @@
+---
+title: Tiny Tiny RSS
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_ttrss'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=ttrss) [](https://dash.yunohost.org/appci/app/ttrss)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+Tiny Tiny RSS est un lecteur de flux d’actualité utilisant les protocoles RSS et Atom.
+
+### Exportation/importation des flux
+
+Il est possible de faire une sauvegarde de ces flux d’actualité en format opml.
+
+Pour cela, il faut aller dans Actions -> Configuration -> onglet flux -> chapitre OPML -> Exporter/Importer en OPML.
+
+### Client Android
+
+Il est possible d’utiliser le client Android ttrss-reader pour consulter ces flux : **[ttrss-reader](https://f-droid.org/packages/org.ttrssreader/)**
+
+Sur l’interface web, dans Actions -> Configuration, cochez « Activer l’accès par API »
+puis dans ttrss-reader sur Android, l’adresse du serveur Tiny Tiny RSS : https://votredomaine.org/ttrss, nom d’utilisateur, mot de passe. (pas besoin d’utiliser l’authentification HTTP)
+
+**Note** : vous pouvez avoir besoin de désinstaller, puis réinstaller entièrement l'application Tiny Tiny RSS via l’administration de YunoHost pour que la connexion puisse se faire.
+
+## Liens utiles
+
+ + Site web : [git.tt-rss.org/git/tt-rss/wiki](https://git.tt-rss.org/git/tt-rss/wiki)
+ + Site de démonstration (login : `demo`, `demo`): [srv.tt-rss.org/tt-rss/](https://srv.tt-rss.org/tt-rss/)
+ + Dépôt logiciel de Tiny Tiny RSS : [github.com - YunoHost-Apps/ttrss](https://github.com/YunoHost-Apps/ttrss_ynh)
+ + Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/ttrss/issues](https://github.com/YunoHost-Apps/ttrss_ynh/issues)
diff --git a/pages/02.applications/02.docs/ttrss/app_ttrss.md b/pages/02.applications/02.docs/ttrss/app_ttrss.md
new file mode 100644
index 00000000..61c7c0c8
--- /dev/null
+++ b/pages/02.applications/02.docs/ttrss/app_ttrss.md
@@ -0,0 +1,38 @@
+---
+title: Tiny Tiny RSS
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_ttrss'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=ttrss) [](https://dash.yunohost.org/appci/app/ttrss)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+Tiny Tiny RSS is a news feed reader using RSS and Atom protocols.
+
+### Exporting/importing feeds
+Tiny Tiny RSS allows you to save your feeds in opml format.
+In order to do so, go to Actions -> Configuration -> feed tab -> OPML section -> Export/Import OPML.
+
+### Android Client
+
+You can read your feeds on Android using ttrss-reader application: **[ttrss-reader](https://f-droid.org/packages/org.ttrssreader/)**
+
+To use it, you need to go to Actions -> Configuration, in Tiny Tiny RSS web interface and select "Activate API".
+Then, in your android ttrss-reader, fill the Tiny Tiny RSS server adress: https://yourdomain.org/ttrss, username, password (no need to use HTTP authentification).
+
+**Note**: you may need to uninstall and reinstall the Tiny Tiny RSS application through the YunoHost admin panel in order to be able to connect.
+
+## Useful links
+
+ + Website: [git.tt-rss.org/git/tt-rss/wiki](https://git.tt-rss.org/git/tt-rss/wiki)
+ + Official documentation: (login as `demo`, `demo`): [srv.tt-rss.org/tt-rss/](https://srv.tt-rss.org/tt-rss/)
+ + Application software repository: [github.com - YunoHost-Apps/ttrss](https://github.com/YunoHost-Apps/ttrss_ynh)
+ + Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/ttrss/issues](https://github.com/YunoHost-Apps/ttrss_ynh/issues)
diff --git a/pages/02.applications/02.docs/unattended_upgrades/app_unattended_upgrades.fr.md b/pages/02.applications/02.docs/unattended_upgrades/app_unattended_upgrades.fr.md
new file mode 100644
index 00000000..063a4231
--- /dev/null
+++ b/pages/02.applications/02.docs/unattended_upgrades/app_unattended_upgrades.fr.md
@@ -0,0 +1,25 @@
+---
+title: Unattented upgrades
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_unattended_upgrades'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=unattended_upgrades) [](https://dash.yunohost.org/appci/app/unattended_upgrades)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+Unattended_upgrades est un outil qui permet de télécharger et installer les mises à jour de sécurité automatiquement et sans surveillance, en prenant soin de n'installer que les paquets provenant de la source APT configurée, et en vérifiant les invites dpkg concernant les modifications du fichier de configuration.
+Apticron est un simple script qui envoie des courriels sur les mises à jour de paquets en attente comme les mises à jour de sécurité, en gérant correctement les paquets en attente.
+
+## Liens utiles
+
++ Documentation officielle : [wiki.debian.org/UnattendedUpgrades](https://wiki.debian.org/UnattendedUpgrades)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/unattended_upgrades](https://github.com/YunoHost-Apps/unattended_upgrades_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/unattended_upgrades/issues](https://github.com/YunoHost-Apps/unattended_upgrades_ynh/issues)
diff --git a/pages/02.applications/02.docs/unattended_upgrades/app_unattended_upgrades.md b/pages/02.applications/02.docs/unattended_upgrades/app_unattended_upgrades.md
new file mode 100644
index 00000000..cfb5bbc0
--- /dev/null
+++ b/pages/02.applications/02.docs/unattended_upgrades/app_unattended_upgrades.md
@@ -0,0 +1,25 @@
+---
+title: Unattended upgrades
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_unattended_upgrades'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=unattended_upgrades) [](https://dash.yunohost.org/appci/app/unattended_upgrades)
+
+### Index
+
+- [Useful links](#useful-links)
+
+Unattended-upgrades can download and install security upgrades automatically and unattended, taking care to only install packages from the configured APT source, and checking for dpkg prompts about configuration file changes.
+Apticron is a simple script which sends emails about pending package updates such as security updates, properly handling packages on hold both by dselect and aptitude.
+
+## Useful links
+
++ Official documentation: [wiki.debian.org/UnattendedUpgrades](https://wiki.debian.org/UnattendedUpgrades)
++ Application software repository: [github.com - YunoHost-Apps/unattended_upgrades](https://github.com/YunoHost-Apps/unattended_upgrades_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/unattended_upgrades/issues](https://github.com/YunoHost-Apps/unattended_upgrades_ynh/issues)
diff --git a/pages/02.applications/02.docs/wallabag2/app_wallabag2.fr.md b/pages/02.applications/02.docs/wallabag2/app_wallabag2.fr.md
new file mode 100644
index 00000000..8c4e7544
--- /dev/null
+++ b/pages/02.applications/02.docs/wallabag2/app_wallabag2.fr.md
@@ -0,0 +1,41 @@
+---
+title: Wallabag2
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_wallabag2'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=wallabag2) [](https://dash.yunohost.org/appci/app/wallabag2)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+Wallabag est une application de lecture différée : elle permet simplement d’archiver une page web en ne conservant que le contenu. Les éléments superflus (menus, publicités, etc.) sont supprimés. Sont disponibles : une interface web, des add-ons pour navigateurs (Firefox / Chrome / Opera), des applications pour mobile (Android / iOS / Windows Phone) et même sur liseuse (PocketBook / Kobo).
+
+### Fonctionnalités
+
+En plus des fonctionnalités principales de Wallabag, ce paquet propose également :
+
+* Une intégration avec le système de gestion des utilisateurs et le SSO de YunoHost - e.g. un bouton de déconnexion
+* De permettre à un utilisateur d'être administrateur (réglage lors de l'installation)
+* Un import asynchrone utilisant Redis (à activer dans les *Paramètres Internes*). L'import via RabbitMQ n'est pas (encore ?) supporté.
+
+## Liens utiles
+
++ Site web : [www.wallabag.org](https://www.wallabag.org/)
++ Documentation officielle : [doc.wallabag.org](https://doc.wallabag.org/)
++ Démonstration : [Démo](https://vimeo.com/video/167435064)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/wallabag2](https://github.com/YunoHost-Apps/wallabag2_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/wallabag2/issues](https://github.com/YunoHost-Apps/wallabag2_ynh/issues)
+
+----
+
+### Mettre à niveau depuis la v1.x
+
+La mise à niveau depuis le paquet YunoHost de Wallabag v1 demande une opération manuelle, c'est pourquoi un nouveau paquet est fourni. Pour le processus de migration, merci de vous référer à [la documentation officielle
+de Wallabag](https://doc.wallabag.org/fr/user/import/wallabagv1.html).
diff --git a/pages/02.applications/02.docs/wallabag2/app_wallabag2.md b/pages/02.applications/02.docs/wallabag2/app_wallabag2.md
new file mode 100644
index 00000000..d919d84b
--- /dev/null
+++ b/pages/02.applications/02.docs/wallabag2/app_wallabag2.md
@@ -0,0 +1,42 @@
+---
+title: Wallabag2
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_wallabag2'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=wallabag2) [](https://dash.yunohost.org/appci/app/wallabag2)
+
+### Index
+
+- [Useful links](#useful-links)
+
+Wallabag is a self hostable Read-It-Later application allowing you to not miss any content anymore. Click, save, read it when you can.
+It extracts content so that you can read it when you have time.
+
+### Features
+
+In addition to Wallabag core features, the following are made available with this package:
+
+ * Integrate with YunoHost users and SSO - i.e. logout button
+ * Allow one user to be the administrator (set at the installation)
+ * Asynchronous import using Redis (need to be enabled in the *Internal Settings*). RabbitMQ import not supported (yet ?)
+
+## Useful links
+
++ Website : [www.wallabag.org](https://www.wallabag.org/)
++ Official documentation : [doc.wallabag.org](https://doc.wallabag.org/)
++ Demonstration : [Demo](https://vimeo.com/video/167435064)
++ Application software repository : [github.com - YunoHost-Apps/wallabag2](https://github.com/YunoHost-Apps/wallabag2_ynh)
++ Fix a bug or an improvement by creating a ticket (issue) : [github.com - YunoHost-Apps/wallabag2/issues](https://github.com/YunoHost-Apps/wallabag2_ynh/issues)
+
+----
+
+### Upgrade from v1.x
+
+No automatic upgrade process is available. You need a manual (but simple) migration from Wallabag v1.
+Please take a look at the [official documentation](https://doc.wallabag.org/en/user/import/wallabagv1.html).
diff --git a/pages/02.applications/02.docs/weblate/app_weblate.fr.md b/pages/02.applications/02.docs/weblate/app_weblate.fr.md
new file mode 100644
index 00000000..b150ac0a
--- /dev/null
+++ b/pages/02.applications/02.docs/weblate/app_weblate.fr.md
@@ -0,0 +1,29 @@
+---
+title: Weblate
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_weblate'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=weblate) [](https://dash.yunohost.org/appci/app/weblate)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+Weblate est un outil de traduction en mode web fortement lié aux systèmes de contrôle de versions. A travers une interface utilisateur claire et simple, Weblate permet la propagation de traductions entre sous-projets, peut vérifier la qualité des traductions et est automatiquement lié aux fichiers sources.
+Weblate fonctionne très bien avec un serveur GitLab, GitHub, Bitbucket. Il est possible d'importer les traductions déjà existantes d'un projet, de permettre à tout le monde de contribuer à la traduction d'un projet via son interface Web, et ensuite pousser les traductions sur le repository.
+Il y a un système de revue, de suggestions, de commentaires sur une traduction.
+On peut installer une authentification tiers, par exemple on peut se connecter avec son compte GitHub. Notre compte permet ensuite de garder un historique.
+
+## Liens utiles
+
++ Site web : [weblate.org](https://weblate.org/)
++ Documentation officielle : [docs.weblate.org](https://docs.weblate.org/)
++ Démonstration: [Démo](https://docs.weblate.org/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/weblate](https://github.com/YunoHost-Apps/weblate_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/weblate/issues](https://github.com/YunoHost-Apps/weblate_ynh/issues)
diff --git a/pages/02.applications/02.docs/weblate/app_weblate.md b/pages/02.applications/02.docs/weblate/app_weblate.md
new file mode 100644
index 00000000..0b1d993e
--- /dev/null
+++ b/pages/02.applications/02.docs/weblate/app_weblate.md
@@ -0,0 +1,31 @@
+---
+title: Weblate
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_weblate'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=weblate) [](https://dash.yunohost.org/appci/app/weblate)
+
+### Index
+
+- [Useful links](#useful-links)
+
+Weblate is a web-based translation tool strongly linked to version control systems. Through a clear and simple user interface, Weblate allows the propagation of translations between sub-projects, can check the
+quality of the translations and is automatically linked to the source files.
+Weblate works very well with a GitLab, GitHub, Bitbucket server. It is possible to import already existing translations of a project, allowing everyone to contribute to the translation of a project via its web interface,
+and then push the translations to the repository.
+There is a system for reviewing, suggesting, commenting on a translation.
+You can install a third party authentication, for example you can log in with your GitHub account. Our account then allows us to keep a history.
+
+## Useful links
+
++ Website: [weblate.org](https://weblate.org/)
++ Official documentation: [docs.weblate.org](https://docs.weblate.org/)
++ Demonstration: [Demo](https://docs.weblate.org/)
++ Application software repository: [github.com - YunoHost-Apps/weblate](https://github.com/YunoHost-Apps/weblate_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/weblate/issues](https://github.com/YunoHost-Apps/weblate_ynh/issues)
diff --git a/app_webtrees_fr.md b/pages/02.applications/02.docs/webtrees/app_webtrees.fr.md
similarity index 75%
rename from app_webtrees_fr.md
rename to pages/02.applications/02.docs/webtrees/app_webtrees.fr.md
index ca030140..fca91947 100644
--- a/app_webtrees_fr.md
+++ b/pages/02.applications/02.docs/webtrees/app_webtrees.fr.md
@@ -1,7 +1,14 @@
-#Webtrees
+---
+title: Webtrees
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_webtrees'
+---
webtrees est le chef de file sur le Web des logiciels de généalogie conversationnels en ligne. C'est un logiciel Open Source et il coûte zéro $ - oui, totalement GRATUIT !
Vous n'avez besoin que d'un serveur web avec PHP et MySQL.
-Il exploite les fichiers de généalogie au format GEDCOM standard, par conséquent, il est compatible avec toutes les applications de bureau majeures; il vise à être efficient et efficace en utilisant la bonne combinaison d'outils tiers, des techniques de conception et des normes d'ouverture standards.
\ No newline at end of file
+Il exploite les fichiers de généalogie au format GEDCOM standard, par conséquent, il est compatible avec toutes les applications de bureau majeures; il vise à être efficient et efficace en utilisant la bonne combinaison d'outils tiers, des techniques de conception et des normes d'ouverture standards.
diff --git a/app_webtrees.md b/pages/02.applications/02.docs/webtrees/app_webtrees.md
similarity index 83%
rename from app_webtrees.md
rename to pages/02.applications/02.docs/webtrees/app_webtrees.md
index d3c9e776..603a3d74 100644
--- a/app_webtrees.md
+++ b/pages/02.applications/02.docs/webtrees/app_webtrees.md
@@ -1,8 +1,15 @@
-#Webtrees
+---
+title: Webtrees
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_webtrees'
+---
webtrees is the web's leading online collaborative genealogy application.
* It works from standard GEDCOM files, and is therefore compatible with every major desktop application.
* It aims to to be efficient and effective by using the right combination of third-party tools, design techniques and open standards.
-webtrees allows you to view and edit your genealogy on your website. It has full editing capabilities, full privacy functions, and supports imedia such as photos and document images. As an online program, it fosters extended family participation and good ancestral recording habits, as it simplifies the process of collaborating with others working on your family lines. Your latest information is always on your web site and available for others to see, defined by viewing rules you set.
\ No newline at end of file
+webtrees allows you to view and edit your genealogy on your website. It has full editing capabilities, full privacy functions, and supports imedia such as photos and document images. As an online program, it fosters extended family participation and good ancestral recording habits, as it simplifies the process of collaborating with others working on your family lines. Your latest information is always on your web site and available for others to see, defined by viewing rules you set.
diff --git a/pages/02.applications/02.docs/wekan/app_wekan.fr.md b/pages/02.applications/02.docs/wekan/app_wekan.fr.md
new file mode 100644
index 00000000..34348259
--- /dev/null
+++ b/pages/02.applications/02.docs/wekan/app_wekan.fr.md
@@ -0,0 +1,26 @@
+---
+title: Wekan
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_wekan'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=wekan) [](https://dash.yunohost.org/appci/app/wekan)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+Wekan est un gestionnaire de tâches collaboratif en ligne. Il facilite la gestion de projets par l'élaboration de todo listes.
+Wekan propose une grande diversité de fonctionnalités, ce qui en fait un service très complet et adapté à des projets complexes. Si vous cherchez un outil kanban plus simple, vous pouvez utiliser [Kanboard](/app_kanboard).
+
+## Liens utiles
+
++ Site web : [wekan.github.io](https://wekan.github.io/)
++ Documentation officielle : [github.com/wekan/wekan/wiki](https://github.com/wekan/wekan/wiki)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/wekan](https://github.com/YunoHost-Apps/wekan_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/wekan/issues](https://github.com/YunoHost-Apps/wekan_ynh/issues)
diff --git a/pages/02.applications/02.docs/wekan/app_wekan.md b/pages/02.applications/02.docs/wekan/app_wekan.md
new file mode 100644
index 00000000..b0d7a4e8
--- /dev/null
+++ b/pages/02.applications/02.docs/wekan/app_wekan.md
@@ -0,0 +1,26 @@
+---
+title: Wekan
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_wekan'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=wekan) [](https://dash.yunohost.org/appci/app/wekan)
+
+### Index
+
+- [Useful links](#useful-links)
+
+Wekan is an online collaborative task manager. It facilitates the management of projects through the development of todo lists.
+Wekan offers a wide range of features, making it a very complete service adapted to complex projects. If you are looking for a simpler kanban tool, you can use [Kanboard](/app_kanboard)
+
+## Useful links
+
++ Website: [wekan.github.io](https://wekan.github.io/)
++ Official documentation: [github.com/wekan/wekan/wiki](https://github.com/wekan/wekan/wiki)
++ Application software repository: [github.com - YunoHost-Apps/wekan](https://github.com/YunoHost-Apps/wekan_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/wekan/issues](https://github.com/YunoHost-Apps/wekan_ynh/issues)
diff --git a/pages/02.applications/02.docs/wikijs/app_wikijs.fr.md b/pages/02.applications/02.docs/wikijs/app_wikijs.fr.md
new file mode 100644
index 00000000..828eb0bf
--- /dev/null
+++ b/pages/02.applications/02.docs/wikijs/app_wikijs.fr.md
@@ -0,0 +1,30 @@
+---
+title: Wiki.js
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_wikijs'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=wikijs) [](https://dash.yunohost.org/appci/app/wikijs)
+
+### Index
+
+- [Configuration](#configuration)
+- [Liens utiles](#liens-utiles)
+
+Wiki.js est un wiki libre, moderne et rapide basé sur Node.js, Git et Markdown.
+
+## Configuration
+
+Wiki.js nécessite un domaine racine dédié, par exemple `wikijs.domaine.tld`.
+
+## Liens utiles
+
+ + Site web : [wiki.js.org (en)](https://wiki.js.org/)
+ + Documentation officielle : [docs.requarks.io (en)](https://docs.requarks.io/)
+ + Dépôt logiciel de l'application : [github.com - YunoHost-Apps/wikijs](https://github.com/YunoHost-Apps/wikijs_ynh)
+ + Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/wikijs/issues](https://github.com/YunoHost-Apps/wikijs_ynh/issues)
diff --git a/pages/02.applications/02.docs/wikijs/app_wikijs.md b/pages/02.applications/02.docs/wikijs/app_wikijs.md
new file mode 100644
index 00000000..66d32837
--- /dev/null
+++ b/pages/02.applications/02.docs/wikijs/app_wikijs.md
@@ -0,0 +1,30 @@
+---
+title: Wiki.js
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_wikijs'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=wikijs) [](https://dash.yunohost.org/appci/app/wikijs)
+
+### Index
+
+- [Configuration](#configuration)
+- [Useful links](#useful-links)
+
+Wiki.js is a free, modern and fast wiki based on Node.js, Git and Markdown.
+
+## Configuration
+
+Wiki.js requires a dedicated root domain, e.g. `wikijs.domain.tld`
+
+## Useful links
+
++ Website: [wiki.js.org](https://wiki.js.org/)
++ Official documentation: [docs.requarks.io](https://docs.requarks.io/)
++ Application software repository: [github.com - YunoHost-Apps/wikijs](https://github.com/YunoHost-Apps/wikijs_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/wikijs/issues](https://github.com/YunoHost-Apps/wikijs_ynh/issues)
diff --git a/pages/02.applications/02.docs/wordpress/app_wordpress.fr.md b/pages/02.applications/02.docs/wordpress/app_wordpress.fr.md
new file mode 100644
index 00000000..0d058dda
--- /dev/null
+++ b/pages/02.applications/02.docs/wordpress/app_wordpress.fr.md
@@ -0,0 +1,38 @@
+---
+title: WordPress
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_wordpress'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=wordpress) [](https://dash.yunohost.org/appci/app/wordpress)
+
+### Index
+
+- [Limitations avec YunoHost](#limitations-avec-yunohost)
+- [Liens utiles](#liens-utiles)
+
+WordPress est un système de gestion de contenu (SGC ou content management system (CMS) en anglais) gratuit, libre et open-source. Ce logiciel écrit en PHP repose sur une base de données MySQL et est distribué par l'entreprise américaine Automattic. Les fonctionnalités de WordPress lui permettent de créer et gérer différents types de sites Web : site vitrine, site de vente en ligne, site applicatif, blogue, ou encore portfolio. Il est distribué selon les termes de la licence GNU GPL version 2.[¹](#sources)
+
+## Limitations avec YunoHost
+
+Le multisite est uniquement disponible sur des sous-répertoires.
+
+Comme le plugin de mise à jour automatique ne fonctionne pas comme prévu, faites attention à garder wordpress à jour depuis le panneau d'administration de WordPress, et pas seulement depuis le panneau d'administration de YunoHost. Pour des raisons de sécurité, contrôler que toutes les mises à jour sont régulièrement appliquées dans le panneau d'administration de WordPress ainsi que dans le panneau d'administration de YunoHost.
+
+## Liens utiles
+
++ Site web : [wordpress.org](https://fr.wordpress.org/)
++ Documentation officielle : [codex.wordpress.org (en)](https://codex.wordpress.org/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/wordpress](https://github.com/YunoHost-Apps/wordpress_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/wordpress/issues](https://github.com/YunoHost-Apps/wordpress_ynh/issues)
+
+-----------
+
+### Sources
+
+¹ [wikipedia.org - WordPress](https://fr.wikipedia.org/wiki/WordPress)
diff --git a/pages/02.applications/02.docs/wordpress/app_wordpress.md b/pages/02.applications/02.docs/wordpress/app_wordpress.md
new file mode 100644
index 00000000..c1aefbba
--- /dev/null
+++ b/pages/02.applications/02.docs/wordpress/app_wordpress.md
@@ -0,0 +1,38 @@
+---
+title: WordPress
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_wordpress'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=wordpress) [](https://dash.yunohost.org/appci/app/wordpress)
+
+### Index
+
+- [Limitations with YunoHost](#limitations-with-yunohost)
+- [Useful links](#useful-links)
+
+WordPress is a free, open-source, open source content management system (CMS). This software written in PHP is based on a MySQL database and is distributed by the American company Automattic. WordPress' functionalities allow it to create and manage different types of websites: showcase site, online store site, application site, blog, or portfolio. It is distributed under the terms of the GNU GPL version 2 license.[¹](#sources)
+
+## Limitations with YunoHost
+
+Multisite is only available on subdirectories.
+
+As the auto-update plugin does not work as expected, be careful to keep wordpress up to date from the WordPress admin panel, not just from the YunoHost admin panel. For security reasons, make sure that all updates are regularly applied in the WordPress Control Panel as well as in the YunoHost Control Panel.
+
+## Useful links
+
++ Website: [wordpress.org](https://wordpress.org/)
++ Official documentation: [codex.wordpress.org](https://codex.wordpress.org/)
++ Application software repository: [github.com - YunoHost-Apps/wordpress](https://github.com/YunoHost-Apps/wordpress_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com -YunoHost-Apps/wordpress/issues](https://github.com/YunoHost-Apps/wordpress_ynh/issues)
+
+-----------
+
+### Sources
+
+¹ [wikipedia.org - WordPress (fr)](https://fr.wikipedia.org/wiki/WordPress)
diff --git a/pages/02.applications/02.docs/writing_guide/app_writing_guide.fr.md b/pages/02.applications/02.docs/writing_guide/app_writing_guide.fr.md
new file mode 100644
index 00000000..08a456b4
--- /dev/null
+++ b/pages/02.applications/02.docs/writing_guide/app_writing_guide.fr.md
@@ -0,0 +1,42 @@
+---
+title: Canevas pour la documentation des apps
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_writing_guide'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=APPLICATION) [](https://dash.yunohost.org/appci/app/APPLICATION)
+
+### Index
+
+- [Configuration](#configuration)
+- [Limitations avec YunoHost](#limitations-avec-yunohost)
+- [Applications clientes](#applications-clientes)
+- [Liens utiles](#liens-utiles)
+
+**Présentation générale de l'application.** *Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce rutrum sodales mauris eu viverra. Sed dapibus, tellus sit amet interdum condimentum, enim eros faucibus ligula, sed suscipit orci velit at felis. Etiam quam lacus, vulputate eu scelerisque ac, sollicitudin rutrum orci. Cras eu ante porttitor, laoreet odio sed, hendrerit tellus. Nulla luctus sem in arcu scelerisque cursus. Nulla ut tellus at leo porttitor tincidunt. Morbi vitae purus convallis, elementum lectus non, dignissim orci. Integer eget egestas mauris. Nunc nunc dolor, cursus in quam mollis, rutrum fermentum nibh. Aliquam molestie velit a nulla porttitor, sit amet tincidunt erat laoreet.*
+
+## Configuration
+
+**Si la configuration de l'application ne se fait pas avec le panel admin de YunoHost.** *Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce rutrum sodales mauris eu viverra. Sed dapibus, tellus sit amet interdum condimentum, enim eros faucibus ligula, sed suscipit orci velit at felis. Etiam quam lacus, vulputate eu scelerisque ac, sollicitudin rutrum orci. Cras eu ante porttitor, laoreet odio sed, hendrerit tellus. Nulla luctus sem in arcu scelerisque cursus. Nulla ut tellus at leo porttitor tincidunt. Morbi vitae purus convallis, elementum lectus non, dignissim orci. Integer eget egestas mauris. Nunc nunc dolor, cursus in quam mollis, rutrum fermentum nibh. Aliquam molestie velit a nulla porttitor, sit amet tincidunt erat laoreet.*
+
+## Limitations avec YunoHost
+
+**Explication des limitations actuelles en utilisation de l'application avec YunoHost.** *Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce rutrum sodales mauris eu viverra. Sed dapibus, tellus sit amet interdum condimentum, enim eros faucibus ligula, sed suscipit orci velit at felis. Etiam quam lacus, vulputate eu scelerisque ac, sollicitudin rutrum orci. Cras eu ante porttitor, laoreet odio sed, hendrerit tellus. Nulla luctus sem in arcu scelerisque cursus. Nulla ut tellus at leo porttitor tincidunt. Morbi vitae purus convallis, elementum lectus non, dignissim orci. Integer eget egestas mauris. Nunc nunc dolor, cursus in quam mollis, rutrum fermentum nibh. Aliquam molestie velit a nulla porttitor, sit amet tincidunt erat laoreet.*
+
+## Applications clientes
+
+| Nom de l'application | Plateforme | Multi-comptes | Autres réseaux supportés | Play Store | F-Droid | Apple Store | *Autres* |
+|-----------------------|------------|---------------|-------------------------|------------|---------|-------------|----------|
+| | | | | | | | |
+
+## Liens utiles
+
+ + Site web : [SITE WEB](#)
+ + Documentation officielle : [DOCUMENTATION](#)
+ + Dépôt logiciel de l'application : [github.com - YunoHost-Apps/APPLICATION](https://github.com/YunoHost-Apps/APPLICATION_ynh)
+ + Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/APPLICATION/issues](https://github.com/YunoHost-Apps/APPLICATION_ynh/issues)
diff --git a/pages/02.applications/02.docs/writing_guide/app_writing_guide.md b/pages/02.applications/02.docs/writing_guide/app_writing_guide.md
new file mode 100644
index 00000000..90b46e0f
--- /dev/null
+++ b/pages/02.applications/02.docs/writing_guide/app_writing_guide.md
@@ -0,0 +1,42 @@
+---
+title: Template for app documentation
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_writing_guide'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=APPLICATION) [](https://dash.yunohost.org/appci/app/APPLICATION)
+
+### Index
+
+- [Configuration](#configuration)
+- [Limitations of YunoHost](#limitations-with-yunohost)
+- [Customer Applications](#customer-applications)
+- [Useful links](#useful-links)
+
+**General presentation of the application.** *Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce rutrum sodales mauris eu viverra. Sed dapibus, tellus sit amet interdum condimentum, enim eros faucibus ligula, sed suscipit orci velit at felis. Etiam quam lacus, vulputate eu scelerisque ac, sollicitudin rutrum orci. Cras eu ante porttitor, laoreet odio sed, hendrerit tellus. Nulla luctus sem in arcu scelerisque cursus. Nulla ut tellus at leo porttitor tincidunt. Morbi vitae purus convallis, elementum lectus non, dignissim orci. Integer eget egestas mauris. Nunc nunc dolor, cursus in quam mollis, rutrum fermentum nibh. Aliquam molestie velit a nulla porttitor, sit amet tincidunt erat laoreet.*
+
+## Configuration
+
+**If the configuration of the application is not done with the admin panel of YunoHost.** *Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce rutrum sodales mauris eu viverra. Sed dapibus, tellus sit amet interdum condimentum, enim eros faucibus ligula, sed suscipit orci velit at felis. Etiam quam lacus, vulputate eu scelerisque ac, sollicitudin rutrum orci. Cras eu ante porttitor, laoreet odio sed, hendrerit tellus. Nulla luctus sem in arcu scelerisque cursus. Nulla ut tellus at leo porttitor tincidunt. Morbi vitae purus convallis, elementum lectus non, dignissim orci. Integer eget egestas mauris. Nunc nunc dolor, cursus in quam mollis, rutrum fermentum nibh. Aliquam molestie velit a nulla porttitor, sit amet tincidunt erat laoreet.*
+
+## Limitations with YunoHost
+
+**Explanation of the current limitations in using the application with YunoHost.** *Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce rutrum sodales mauris eu viverra. Sed dapibus, tellus sit amet interdum condimentum, enim eros faucibus ligula, sed suscipit orci velit at felis. Etiam quam lacus, vulputate eu scelerisque ac, sollicitudin rutrum orci. Cras eu ante porttitor, laoreet odio sed, hendrerit tellus. Nulla luctus sem in arcu scelerisque cursus. Nulla ut tellus at leo porttitor tincidunt. Morbi vitae purus convallis, elementum lectus non, dignissim orci. Integer eget egestas mauris. Nunc nunc dolor, cursus in quam mollis, rutrum fermentum nibh. Aliquam molestie velit a nulla porttitor, sit amet tincidunt erat laoreet.*
+
+## Customer applications
+
+| Application name | Platform | Multi-account | Other supported networks | Play Store | F-Droid | Apple Store | *Other* |
+|------------------|----------|---------------|--------------------------|------------|---------|-------------|---------|
+| | | | | | | | |
+
+## Useful links
+
++ Website: [WEBSITE](#)
++ Official documentation: [DOCUMENTATION](#)
++ Application software repository: [github.com - YunoHost-Apps/APPLICATION](https://github.com/YunoHost-Apps/APPLICATION_ynh)
++ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/APPLICATION/issues](https://github.com/YunoHost-Apps/APPLICATION_ynh/issues)
diff --git a/pages/02.applications/02.docs/yunofav/app_yunofav.fr.md b/pages/02.applications/02.docs/yunofav/app_yunofav.fr.md
new file mode 100644
index 00000000..101f42c0
--- /dev/null
+++ b/pages/02.applications/02.docs/yunofav/app_yunofav.fr.md
@@ -0,0 +1,15 @@
+---
+title: Yunofav
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_yunofav'
+---
+
+### Page de liens favoris pour YunoHost
+
+page d'accueil : https://github.com/YunoHost-Apps/yunofav_ynh
+
+
+Fonctionnalité : Crée une page pour vos liens préférés, en utilisant le style et le fonctionnement des tuiles YunoHost.
diff --git a/pages/02.applications/02.docs/yunofav/app_yunofav.md b/pages/02.applications/02.docs/yunofav/app_yunofav.md
new file mode 100644
index 00000000..9a7b7fe5
--- /dev/null
+++ b/pages/02.applications/02.docs/yunofav/app_yunofav.md
@@ -0,0 +1,14 @@
+---
+title: Yunofav
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_yunofav'
+---
+
+### Page of favorite links for YunoHost
+
+homepage: https://github.com/YunoHost-Apps/yunofav_ynh
+
+Functionality: Creates a page for your favorite links, using the YunoHost tiles look and feel.
diff --git a/pages/02.applications/02.docs/zerobin/app_zerobin.fr.md b/pages/02.applications/02.docs/zerobin/app_zerobin.fr.md
new file mode 100644
index 00000000..d1ecd41a
--- /dev/null
+++ b/pages/02.applications/02.docs/zerobin/app_zerobin.fr.md
@@ -0,0 +1,26 @@
+---
+title: Zerobin
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_zerobin'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=zerobin) [](https://dash.yunohost.org/appci/app/zerobin)
+
+### Index
+
+- [Liens utiles](#liens-utiles)
+
+Zerobin est un service web permettant de stocker temporairement et de partager du texte simple de manière chiffrée, sans stockage lisible sur le serveur. La clef de chiffrement/déchiffrement n'est pas stockée sur le serveur mais dans l'URL transmise. Ainsi vous pouvez partager des informations sensibles (mots de passe, codes d'accès, et même une discussion) de manière confidentielle en communiquant à vos interlocuteurs l'adresse spécifique de votre contenu. De plus ce contenu a une valeur limitée dans le temps et est détruit passé un délai personnalisable.
+
+## Liens utiles
+
++ Site web : [privatebin.info](https://privatebin.info/)
++ Documentation officielle : [github.com/PrivateBin/PrivateBin/wiki](https://github.com/PrivateBin/PrivateBin/wiki)
++ Démonstration : [Démo](https://privatebin.net/)
++ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/zerobin](https://github.com/YunoHost-Apps/zerobin_ynh)
++ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/zerobin/issues](https://github.com/YunoHost-Apps/zerobin_ynh/issues)
diff --git a/pages/02.applications/02.docs/zerobin/app_zerobin.md b/pages/02.applications/02.docs/zerobin/app_zerobin.md
new file mode 100644
index 00000000..4a276fc8
--- /dev/null
+++ b/pages/02.applications/02.docs/zerobin/app_zerobin.md
@@ -0,0 +1,26 @@
+---
+title: Zerobin
+template: docs
+taxonomy:
+ category: docs, apps
+routes:
+ default: '/app_zerobin'
+---
+
+
+
+[](https://install-app.yunohost.org/?app=zerobin) [](https://dash.yunohost.org/appci/app/zerobin)
+
+### Index
+
+- [Useful links](#useful-links)
+
+Zerobin is a web service for temporarily storing and sharing plain text in encrypted form without readable storage on the server. The encryption/decryption key is not stored on the server but in the transmitted URL. Thus you can share sensitive information (passwords, access codes, and even a discussion) in a confidential way by communicating to your interlocutors the specific address of your content. Moreover this content has a limited value in time and is destroyed after a customizable delay.
+
+## Useful links
+
++ Website : [privatebin.info](https://privatebin.info/)
++ Official documentation : [github.com/PrivateBin/PrivateBin/wiki](https://github.com/PrivateBin/PrivateBin/wiki)
++ Demonstration : [Demo](https://privatebin.net/)
++ Application software repository : [github.com - YunoHost-Apps/zerobin](https://github.com/YunoHost-Apps/zerobin_ynh)
++ Fix a bug or an improvement by creating a ticket (issue) : [github.com - YunoHost-Apps/zerobin/issues](https://github.com/YunoHost-Apps/zerobin_ynh/issues)
diff --git a/pages/02.applications/03.framasoft/apps_framasoft.fr.md b/pages/02.applications/03.framasoft/apps_framasoft.fr.md
new file mode 100644
index 00000000..5391bc14
--- /dev/null
+++ b/pages/02.applications/03.framasoft/apps_framasoft.fr.md
@@ -0,0 +1,55 @@
+---
+title: Équivalence avec les applications Framasoft
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/apps_framasoft'
+---
+
+| App Framasoft | Équivalent | Package |
+| :---: | :---: | :---: |
+| Framabag | Wallabag | [[fa=git /]](https://github.com/YunoHost-Apps/wallabag2_ynh)   |
+| Framabee | Searx | [[fa=git /]](https://github.com/YunoHost-Apps/searx_ynh)   |
+| Framabin | PrivateBin | [[fa=git /]](https://github.com/YunoHost-apps/zerobin_ynh)   |
+| Framaboard | Kanboard | [[fa=git /]](https://github.com/YunoHost-Apps/kanboard_ynh)   |
+| Framabookin | BicBucStriim | [[fa=git /]](https://github.com/YunoHost-Apps/bicbucstriim_ynh)   |
+| Framacalc | Ethercalc | [[fa=git /]](https://github.com/YunoHost-Apps/ethercalc_ynh)   |
+| Framacarte | uMap | [[fa=git /]](https://github.com/YunoHost-Apps/umap_ynh)   |
+| Framaclic | Matomo | [[fa=git /]](https://github.com/YunoHost-Apps/matomo_ynh)   |
+| Framadate | OpenSondage | [[fa=git /]](https://github.com/YunoHost-Apps/opensondage_ynh)   |
+| Framadrive | Nextcloud | [[fa=git /]](https://github.com/YunoHost-apps/nextcloud_ynh)   |
+| Framadrop | Lufi | [[fa=git /]](https://github.com/YunoHost-Apps/lufi_ynh)   |
+| Framaestro | Framaestro | [[fa=git /]](https://github.com/YunoHost-Apps/framaestro_ynh)   |
+| Framaforms | Framaforms | [[fa=git /]](https://github.com/YunoHost-Apps/framaforms_ynh)   |
+| Framagames | Framagames | [[fa=git /]](https://github.com/YunoHost-Apps/framagames_ynh)   |
+| Framagenda | (Agenda Nextcloud) | c.f. Nextcloud |
+| Framagit | GitLab | [[fa=git /]](https://github.com/YunoHost-Apps/gitlab_ynh)   |
+| | Gogs | [[fa=git /]](https://github.com/YunoHost-Apps/gogs_ynh)   |
+| Frama.link | Lstu | [[fa=git /]](https://github.com/YunoHost-Apps/lstu_ynh)   |
+| Framalistes | Mailman | [[fa=git /]](https://github.com/YunoHost-Apps/mailman_ynh)   |
+| | Sympa | [[fa=git /]](https://github.com/alexAubin/sympa_ynh)   |
+| Framanews | TinyTinyRSS | [[fa=git /]](https://github.com/YunoHost-apps/ttrss_ynh)   |
+| Framanotes | Turtl | [[fa=git /]](https://github.com/YunoHost-Apps/turtl_ynh)   |
+| Framapad | Etherpad + mypads | [[fa=git /]](https://github.com/YunoHost-Apps/etherpad_mypads_ynh)   |
+| Framapiaf | Mastodon | [[fa=git /]](https://github.com/YunoHost-Apps/mastodon_ynh)   |
+| Framapic | Lutim | [[fa=git /]](https://github.com/YunoHost-Apps/lutim_ynh)   |
+| Framasites | Grav | [[fa=git /]](https://github.com/YunoHost-Apps/grav_ynh)   |
+| Framaslides | Strut | [[fa=git /]](https://github.com/YunoHost-Apps/strut_ynh)   |
+| Framasphère | Diaspora | [[fa=git /]](https://github.com/aymhce/diaspora_ynh)   |
+| Framatalk | Jitsi Meet | [[fa=git /]](https://github.com/YunoHost-Apps/jitsi_ynh)   |
+| Framateam | Mattermost | [[fa=git /]](https://github.com/YunoHost-Apps/mattermost_ynh)   |
+| Framatrad | ? | Non packagé |
+| Framatube | Peertube | [[fa=git /]](https://github.com/YunoHost-Apps/peertube_ynh)   |
+| Framavectoriel | SVG-Edit | [[fa=git /]](https://github.com/YunoHost-Apps/svgedit_ynh)   |
+| Framavox | Loomio | Non packagé |
+| Framemo | Scrumblr | [[fa=git /]](https://github.com/YunoHost-Apps/scrumblr_ynh)   |
+| Framindmap | Wisemapping | [[fa=git /]](https://github.com/YunoHost-Apps/wisemapping_ynh)   |
+| Framinetest | Minetest | [[fa=git /]](https://github.com/YunoHost-Apps/minetest_ynh)   |
+| MyFrama | Shaarli | [[fa=git /]](https://github.com/YunoHost-Apps/shaarli_ynh)   |
+
+### Voir aussi
+
+- [Liste complète des applications packagées](/apps)
+- [La roadmap 'Dégooglisons'](https://github.com/YunoHost/issues/milestone/13)
+
diff --git a/pages/02.applications/04.wishlist/apps_wishlist.md b/pages/02.applications/04.wishlist/apps_wishlist.md
new file mode 100644
index 00000000..7d0dcfd2
--- /dev/null
+++ b/pages/02.applications/04.wishlist/apps_wishlist.md
@@ -0,0 +1,335 @@
+---
+title: Apps wishlist
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/apps_wishlist'
+---
+
+The following list is a compiled wishlist of applications that would be nice-to-have.
+
+You can [contribute to this list by adding something you'd like to be packaged](/write_documentation), or learn more on [how to package applications](/packaging_apps) to create a new package or improve a package draft.
+
+Es hat sich herausgestellt, dass das Packen für YunoHost einen leicht anderen Zweck erfüllt als das Erstellen klassischer Pakete wie .deb. Debian Pakete haben nur den Anspruch Dateien, Befehle, Programme und Dienste auf dem System zu installieren. Es bleibt oft an Ihnen diese richtig zu konfigurieren, weil es einfach keinen standardisierte Server-Konfiguration gibt. Typischerweise erfordern Web-Apps einen sehr hohen Konfigurationsaufwand, weil sie auf dem Webserver und einer Datenbank (und dem single sign-on) aufbauen.
-YunoHost richtet Konzepte auf höchster Ebene ein (Apps, Domain-Namen, Benutzer, ...) und definiert eine standardmäßige Einrichtung (Nginx, Postfix, Metronome, SSOwat, ...) und kann deshalb die Konfiguration für den Anwender übernehmen.
+YunoHost richtet Konzepte auf höchster Ebene ein (Apps, Domain-Namen, Benutzer...) und definiert eine standardmäßige Einrichtung (NGINX, Postfix, Metronome, SSOwat...) und kann deshalb die Konfiguration für den Anwender übernehmen.
Wer trotzdem glaubt, man könne deb Pakete dazu bringen, all dies zu leisten, möge sich die vorherige Antwort anschauen.
Il se trouve que l’objectif des paquets d’application YunoHost est subtilement différent de celui des paquets traditionnels (comme les .deb de Debian) qui remplissent le rôle d’installer des éléments bas-niveau tels que des fichiers, commandes, programmes ou services sur le système. Il est à la charge de l’administrateur de les configurer ensuite proprement, simplement parce qu’il n’existe pas d’environnement standard. Typiquement, les applications web requièrent beaucoup de configuration car elles ont besoin de s’interfacer avec un serveur web et une base de données (et le système de connexion unique / SSO).
-YunoHost manipule des abstractions haut-niveau (apps, domaines, utilisateurs…) et définit un environnement standard (Nginx, Postfix, Metronome, SSOwat…) et, grâce à cela, peut gérer la configuration à la place de l’administrateur.
+YunoHost manipule des abstractions haut-niveau (apps, domaines, utilisateurs…) et définit un environnement standard (NGINX, Postfix, Metronome, SSOwat...) et, grâce à cela, peut gérer la configuration à la place de l’administrateur.
Si vous restez persuadé que l’on peut néanmoins bricoler les paquets .deb pour gérer tout cela, voir les réponses précédentes.
diff --git a/faq.md b/pages/03.community/04.faq/faq.md similarity index 66% rename from faq.md rename to pages/03.community/04.faq/faq.md index 48517168..49bf873c 100644 --- a/faq.md +++ b/pages/03.community/04.faq/faq.md @@ -1,5 +1,11 @@ -# Frequently Asked Questions - +--- +title: Frequently Asked Questions +template: docs +taxonomy: + category: docs +routes: + default: '/faq' +--- #### Under which license is YunoHost distributed? @@ -12,38 +18,24 @@ Applications and applications packages have their own licenses. #### What's YunoHost goal? -We believe that decentralizing the Internet, and empowering people to take control and -responsibility back over their own data and services, is a crucial issue to guarantee -a free and democratic society. +We believe that decentralizing the Internet, and empowering people to take control and responsibility back over their own data and services, is a crucial issue to guarantee a free and democratic society. The YunoHost project aims to democratize self-hosting. -It provides a software that aims to make it easy for people to run and -administrate their own server, with minimal knowledge and required time. +It provides a software that aims to make it easy for people to run and administrate their own server, with minimal knowledge and required time. #### But what does YunoHost exactly *do*? -YunoHost may be called a distribution or an operating system, but it's actually -"just" a simple layer added over the top of Debian, which does most of the hard -work for you. +YunoHost may be called a distribution or an operating system, but it's actually "just" a simple layer added over the top of Debian, which does most of the hard work for you. -For instance, if you wanted to install Wordpress, you would need to type a bunch -of commands to create some users, setup a web server, setup a SQL server, -download the Wordpress archive, uncompress it, configure the web server, -configure the SQL database, and finally configure Wordpress. YunoHost handles -the technical details and "types all these commands for you", so that you can focus -on what really matters. +For instance, if you wanted to install WordPress, you would need to type a bunch of commands to create some users, setup a web server, setup a SQL server, download the WordPress archive, uncompress it, configure the web server, configure the SQL database, and finally configure WordPress. YunoHost handles the technical details and "types all these commands for you", so that you can focus on what really matters. -More info on [this page](whatsyunohost) ! +More info on [this page](/whatsyunohost)! #### Can I host my own personal website with YunoHost? -Yes! Have a look at the [Custom Web app](https://github.com/YunoHost-Apps/my_webapp_ynh). -It provides an "empty shell" : after installing it, just upload your files -(via SSH/SCP or SFTP) to the right location. You can have PHP and a SQL database -if you need. - +Yes! Have a look at the [Custom Web app](https://github.com/YunoHost-Apps/my_webapp_ynh). It provides an "empty shell" : after installing it, just upload your files (via SSH/SCP or SFTP) to the right location. You can have PHP and a SQL database if you need. #### Can I host many independent websites with different domain names? @@ -57,45 +49,34 @@ The [SSO](https://github.com/Kloadut/SSOwat/) (single sign-on) cannot properly a #### What's YunoHost's business model? -At the moment, YunoHost is maintained only by volunteers working in their free -time. Basically no money is involved in the project (apart from server fees -or stickers :P). +At the moment, YunoHost is maintained only by volunteers working in their free time. Basically no money is involved in the project (apart from server fees or stickers :P). -Considering that a few contributors are investing a large amount of time in the -project, we are thinking about ways to make the project sustainable. +Considering that a few contributors are investing a large amount of time in the project, we are thinking about ways to make the project sustainable. -This could be achieved via donations, grants, and a few contributors -have professional activities related to YunoHost. +This could be achieved via donations, grants, and a few contributors have professional activities related to YunoHost. #### Can I donate to the project? -Yes, you can! YunoHost needs money to pay servers and domain names. We would -also like contributors to be able to continue contributing rather than look for -jobs elsewhere. +Yes, you can! YunoHost needs money to pay servers and domain names. We would also like contributors to be able to continue contributing rather than look for jobs elsewhere. You can donate using [our donation interface](https://donate.yunohost.org) -If you can, you can also make in-kind contributions, like servers (some of our -infrastructure relies on servers from a few associations). +If you can, you can also make in-kind contributions, like servers (some of our infrastructure relies on servers from a few associations). #### How can I contribute to the project? -There are [many ways to contribute](contribute) :). +There are [many ways to contribute](/contribute) :). Don't hesitate to come talk to us about your ideas! -A common misconception for newcomers in free software projects is to think that -they are "not skilled enough". In practice, nobody is "skilled" :). What really -matter is : [liking what you do](https://www.youtube.com/watch?v=zIbR5TAz2xQ&t=113s), -being friendly with other human beings, being patient and stubborn with machines, -and having some free time. Other than that, just doing what you can is already awesome! +A common misconception for newcomers in free software projects is to think that they are "not skilled enough". In practice, nobody is "skilled" :). What really matter is: [liking what you do](https://www.youtube.com/watch?v=zIbR5TAz2xQ&t=113s), being friendly with other human beings, being patient and stubborn with machines, and having some free time. Other than that, just doing what you can is already awesome! #### What's YunoHost's political model? -It is described in [this document](project_organization) :). +It is described in [this document](/project_organization) :). #### Will you port YunoHost to [insert favorite distro]? @@ -112,7 +93,7 @@ Short answer: No. We don't have the energy for it and this is irrelevant. -#### I checked how apps packaging work. Why are you reinventing [insert favorite package format] ? +#### I checked how apps packaging work. Why are you reinventing [insert favorite package format]? Short answer: We are not. @@ -125,7 +106,7 @@ Medium answer: Apps were packaged in .deb in the past. It was a nightmare. We'reTurns out, YunoHost apps packaging holds a subtly different purpose than traditional packaging like .deb. Debian packages fulfill the low-level purpose of installing files, commands, programs and services on the system. It is often your duty to configure them properly, simply because there is no standard server setup. Typically, web apps requires a lot of configuration because they rely on a web server and a database (and the single sign-on).
-YunoHost manipulates high-level abstractions (apps, domains, users, ...) and defines a standard setup (Nginx, Postfix, Metronome, SSOwat, ...) and, because of this, can handle the configuration for the user.
+YunoHost manipulates high-level abstractions (apps, domains, users...) and defines a standard setup (NGINX, Postfix, Metronome, SSOwat...) and, because of this, can handle the configuration for the user.
If you still think it's possible to handle everything by fiddling with .deb packages, see previous answers.
diff --git a/orga/yunohost_project_organization_fr.md b/pages/03.community/05.project_organization/yunohost_project_organization.fr.md similarity index 92% rename from orga/yunohost_project_organization_fr.md rename to pages/03.community/05.project_organization/yunohost_project_organization.fr.md index d9622c97..c867617c 100644 --- a/orga/yunohost_project_organization_fr.md +++ b/pages/03.community/05.project_organization/yunohost_project_organization.fr.md @@ -1,6 +1,18 @@ -# Organisation du projet YunoHost +--- +title: Organisation du projet +template: docs +taxonomy: + category: docs +routes: + default: '/yunohost_project_organization' + aliases: + - '/project_organization' +--- + +! This page is outdated and should be reworked ## Objectif du document + Ce document a pour objectif de permettre aux contributeurs de se sentir légitimes d’effectuer une contribution dans le projet YunoHost avec un avis collectif. Il vise également à renforcer le projet en le structurant autour de groupes de travail autonomes pouvant résister au départ ou à l'absence de certains contributeurs. Le projet étant communautaire, les décisions prises hâtivement et discrètement par un groupe restreint de contributeurs peuvent entraîner des frustrations postérieures. Pour pallier ce problème, la solution proposée ici est de faire en sorte que les décisions soient prises collectivement, qu’elles soient suffisamment réfléchies, et qu'elles soient documentées ou rendues publiques. @@ -15,7 +27,7 @@ Le but de YunoHost est de rendre accessibles au plus grand nombre l’installati #### Un logiciel libre et communautaire -YunoHost est un logiciel sous licence libre, entièrement communautaire, et reposant sur des applications elles-mêmes communautaires et souvent libres (roundcube, baikal, etc...). +YunoHost est un logiciel sous licence libre, entièrement communautaire, et reposant sur des applications elles-mêmes communautaires et souvent libres (Roundcube, Baïkal, etc.). #### Que chacun peut s'approprier @@ -51,7 +63,7 @@ La constitution de groupes part du constat que YunoHost compte beaucoup de sous- - ##### Groupe Infra/Adminsys - Infrastructure - - Site web (wiki, forum, salon de discussion, redmine, mumble) + - Site web (wiki, forum, salon de discussion, Redmine, Mumble) - Démo - Services - [ip.yunohost.org](https://ip.yunohost.org/) et ip6.yunohost.org @@ -90,7 +102,7 @@ Le Conseil est indépendant des groupes et réunit les contributeurs souhaitant Le choix d'un outil de communication est laissé au Conseil, ses décisions doivent néanmoins être consultables par l'ensemble de la communauté de contributeurs. Pour participer aux votes du Conseil, il faut avoir contribué au projet et avoir obtenu un droit de vote (ou d'entrée) au sein du Conseil. Ce droit est délivré par le Conseil (éventuellement sur demande). Le Conseil est libre à tout moment de modifier le processus de décision. -Être membre du Conseil n'implique pas forcément d'avoir l'ensemble des accès (infrastructure, dépôt etc...). +Être membre du Conseil n'implique pas forcément d'avoir l'ensemble des accès (infrastructure, dépôt etc.). ### Processus de validation des pull requests @@ -100,9 +112,9 @@ Si un consensus ne peut être trouvé au sein d'un groupe en suivant le processu #### 1. Proposition -N'importe quel contributeur peut proposer une pull request (abrégée PR dans la suite) dans les divers dépôts liés au projet YunoHost (core, apps, infra, ...). +N'importe quel contributeur peut proposer une pull request (abrégée PR dans la suite) dans les divers dépôts liés au projet YunoHost (core, apps, infra...). -L'auteur est vivement encouragé à décrire sa proposition en donnant le maximum des informations +L'auteur est vivement encouragé à décrire sa proposition en donnant le maximum des informations pertinentes. Le groupe peut, à cette fin, proposer un modèle des informations à inclure, comme par exemple : - status actuel de la PR (ex. : non terminé, en attente de revues, choix techniques à faire...) @@ -112,17 +124,17 @@ inclure, comme par exemple : L'auteur est vivement encouragé à respecter les bonnes pratiques suivantes : - une PR doit concerner exclusivement un sujet précis. Par exemple, elle ne doit pas à la fois résoudre un bug et ajouter une fonctionnalité (à moins que l'un implique l'autre) ; -- avant de débuter l'implémentation d'une fonctionnalité qui fait intervenir des choix de conception (nom et format de commande ou d'option, nouvelle API, interface utilisateur, ...), discuter en amont de manière informelle avec le groupe pour s'assurer que l'implémentation imaginée convienne au plus grand nombre et reste dans l'esprit du projet ; +- avant de débuter l'implémentation d'une fonctionnalité qui fait intervenir des choix de conception (nom et format de commande ou d'option, nouvelle API, interface utilisateur...), discuter en amont de manière informelle avec le groupe pour s'assurer que l'implémentation imaginée convienne au plus grand nombre et reste dans l'esprit du projet ; - nommer sa PR avec un titre explicite, et la branche associée avec un nom explicite ; -- donner les références vers d'autres éléments liés à la PR (rapport de bug sur le bugtracker, message sur le forum, ...) +- donner les références vers d'autres éléments liés à la PR (rapport de bug sur le bugtracker, message sur le forum...) Une PR peut être créée même si son auteur juge qu'elle n'est pas encore terminée. Dans ce cas, il doit déclarer explicitement dans le fil de discussion de la PR lorsqu'il juge la PR prête. Cela n'empêche pas les autres contributeurs d'émettre des avis sur la PR pendant ce temps. Il appartient aussi à l'auteur de la PR de juger de son importance. (Ce jugement pourra cependant être contesté par les autres membres du groupe concerné par la PR.) Les niveaux d'importance utilisés sont les suivants : - **micro** : concerne uniquement un détail de forme et/ou qui ne nécessite pas d'être débattue et testée. Elle doit être facilement réversible. -- **mineure** : impacte de manière légère le projet (e.g. refactoring d'une petite partie de code, réparation d'un bug, ...) -- **moyenne** : impacte de manière significative l'architecture d'une partie du code (e.g. refactoring de tout un aspect ou de tout un fichier, ajout d'une fonctionnalité importante, sortie d'une version testing, ...) -- **majeure** : impacte lourdement l'ensemble du projet (e.g. migration d'une dépendance critique, changement de version de Debian, sortie d'une version stable, ...) +- **mineure** : impacte de manière légère le projet (e.g. refactoring d'une petite partie de code, réparation d'un bug...) +- **moyenne** : impacte de manière significative l'architecture d'une partie du code (e.g. refactoring de tout un aspect ou de tout un fichier, ajout d'une fonctionnalité importante, sortie d'une version testing...) +- **majeure** : impacte lourdement l'ensemble du projet (e.g. migration d'une dépendance critique, changement de version de Debian, sortie d'une version stable...) #### 2. Revue et validation collective @@ -131,7 +143,7 @@ Il appartient aussi à l'auteur de la PR de juger de son importance. (Ce jugemen Une fois la PR déclarée comme terminée, les contributeurs sont invités à donner leurs avis, relire et tester les changements proposés pour les valider. Lorsque des bugs ou des implémentations mauvaises ou incomplètes sont trouvées, les relecteurs rapportent cordialement le problème à l'auteur de la PR sur le fil de discussion. Si le problème trouvé est simple à corriger (e.g. typo ou détail de forme), le relecteur est encouragé à amender la PR pour corriger le problème lui-même. Sinon, l'auteur fait de son mieux pour corriger les problèmes soulevés. -Les relecteurs rapportent également le degré de relecture et de tests effectués (c.f. liste ci-dessous). Selon l'importance de la PR (mineure, moyenne ou majeure), différents quotas de tests et approbations sont à remplir pour que celle-ci soit validée. Les relecteurs peuvent valider une fois chaque type de relecture/test nécessaire (par exemple, un relecteur peut donner un point d'accord sur le principe, un autre point de relecture en diagonale, et un autre point de test dans des cas simples.). L'auteur de la PR ne compte pas dans ces quotas de validation. La proposition doit aussi passer les tests automatiques disponibles dans le groupe (CI, tests unitaires/fonctionnels, linter, ...). +Les relecteurs rapportent également le degré de relecture et de tests effectués (c.f. liste ci-dessous). Selon l'importance de la PR (mineure, moyenne ou majeure), différents quotas de tests et approbations sont à remplir pour que celle-ci soit validée. Les relecteurs peuvent valider une fois chaque type de relecture/test nécessaire (par exemple, un relecteur peut donner un point d'accord sur le principe, un autre point de relecture en diagonale, et un autre point de test dans des cas simples.). L'auteur de la PR ne compte pas dans ces quotas de validation. La proposition doit aussi passer les tests automatiques disponibles dans le groupe (CI, tests unitaires/fonctionnels, linter...). | | **Mineure** | **Moyenne** | **Majeure** | |-----------------------------------|-------------|--------------|-------------| @@ -148,7 +160,7 @@ Si l'auteur ne fait pas parti du groupe concerné par la PR, tous ces quotas son Une fois les quotas de relecture remplis, et si aucun refus n'a été prononcé et qu'aucune demande de changement n'est en attente, n'importe quel membre du groupe peut alors déclarer et marquer la PR comme "prête à être mergée". -Pendant une durée de 3 jours suivant cette déclaration, les membres du groupe peuvent encore relire, demander des changements ou émettre un refus vis-à-vis de la PR. Dans ce cas, le merge est interrompu et le processus retourne à la partie 2). Pour les PRs moyennes et majeures, la durée est augmentée jusqu'à ce qu'il se soit écoulé au moins une semaine par rapport au moment où la PR a été déclarée comme prête par son auteur. +Pendant une durée de 3 jours suivant cette déclaration, les membres du groupe peuvent encore relire, demander des changements ou émettre un refus vis-à-vis de la PR. Dans ce cas, le merge est interrompu et le processus retourne à la partie 2. Pour les PRs moyennes et majeures, la durée est augmentée jusqu'à ce qu'il se soit écoulé au moins une semaine par rapport au moment où la PR a été déclarée comme prête par son auteur. À l'issue de cette durée, n'importe quel membre du groupe peut merger la PR. Lorsque celle-ci comporte plusieurs commits, il est recommandé d'utiliser la fonction "squash and merge" pour garder l'historique de commit propre. @@ -170,7 +182,7 @@ Une PR peut être développée par plusieurs personnes. Chacun est invité à y Si ces commits sont conséquents, dans ce cas on peut prendre **partiellement** en compte l'avis des auteurs dans les quotas de relectures et de tests. -Exemple: si une PR est écrite par A et B (50/50), A et B pourront relire le code de l'autre. Dans ce cas, on pourra par exemple compter une relecture pour ces 2 relectures partielles. +Exemple : si une PR est écrite par A et B (50/50), A et B pourront relire le code de l'autre. Dans ce cas, on pourra par exemple compter une relecture pour ces 2 relectures partielles. ##### Validation "allégé" en cas de manque de relecteurs @@ -255,14 +267,14 @@ Cette partie liste les kits de droits d’administration pour les différents gr ## Décisions à venir pour les groupes ### Conseil -- Faut-il élire les membres du Conseil plutôt que de les coopter ? Risque de se transformer en "campagne politique"! +- Faut-il élire les membres du Conseil plutôt que de les coopter ? Risque de se transformer en "campagne politique" ! - Faut-il limiter l'ouverture des groupes d'intérêts par cooptation comme pour le Conseil ? - Proposition de changer Conseil en Collégiale -- Migrer le serveur d’infrastructure du projet sous YunoHost. (avec apps déjà packagées pad, gogs, mumble?) +- Migrer le serveur d’infrastructure du projet sous YunoHost. (avec apps déjà packagées pad, Gogs, Mumble?) - Nouveau système pour la documentation - Amélioration de la documentation - Migration du serveur XMPP -- Hébergement de notre forge git +- Hébergement de notre forge Git - Revoir système de build : stable <— testing <— branches - Gel de nohost.me et question de l'abandon des services @@ -271,7 +283,7 @@ Cette partie liste les kits de droits d’administration pour les différents gr - Chaque ticket fait l'objet d'une branche et d'un ticket, tu fais une pull/merge request, la communauté vérifie que ça fonctionne, une décision est prise d'intégrer. ### Groupe Apps - - Pour les apps communautaires, les issues sont bien sur Github, les discussions sur le forum + - Pour les apps communautaires, les issues sont bien sur GitHub, les discussions sur le forum ### Groupe Communication - Rapport de bug à partir du forum @@ -294,7 +306,6 @@ Cette partie liste les kits de droits d’administration pour les différents gr - Rencontres à des évènements. - Réunions hebdomadaires Mumble. - [Forum](https://forum.yunohost.org). -- Listes de diffusion : [contrib](https://list.yunohost.org/cgi-bin/mailman/listinfo/contrib) et [apps](https://list.yunohost.org/cgi-bin/mailman/listinfo/apps) - [Bugtracker Redmine](https://dev.yunohost.org). -- Forge git pour la review de code : [YunoHost](https://github.com/YunoHost) [YunoHost-Apps](https://github.com/YunoHost-Apps). +- Forge Git pour la review de code : [YunoHost](https://github.com/YunoHost) [YunoHost-Apps](https://github.com/YunoHost-Apps). - [Salons de discussions XMPP](https://yunohost.org/#/chat_rooms_fr) diff --git a/orga/yunohost_project_organization.md b/pages/03.community/05.project_organization/yunohost_project_organization.md similarity index 98% rename from orga/yunohost_project_organization.md rename to pages/03.community/05.project_organization/yunohost_project_organization.md index 4fdfe208..89b046e7 100644 --- a/orga/yunohost_project_organization.md +++ b/pages/03.community/05.project_organization/yunohost_project_organization.md @@ -1,4 +1,15 @@ -# YunoHost project organisation +--- +title: Project organisation +template: docs +taxonomy: + category: docs +routes: + default: '/yunohost_project_organization' + aliases: + - '/project_organization' +--- + +! This page is outdated and should be reworked ## Document objective @@ -17,7 +28,7 @@ The goal of YunoHost is to make accessible to the largest number of people, the #### A free and community-based software -YunoHost is a software under free licence, fully community-based and based on applications which are themselves community-based and often free (roundcube, baikal, etc.) +YunoHost is a software under free licence, fully community-based and based on applications which are themselves community-based and often free (Roundcube, baïkal, etc.) #### That everyone can appropriate @@ -52,7 +63,7 @@ Groups are structured as a result of the fact that YunoHost counts many sub-proj - ##### Infra/Sysadmin Group - Infrastructure - - Website (wiki, forum, chat room, redmine, mumble) + - Website (wiki, forum, chat room, redmine, Mumble) - Demo - Services - [ip.yunohost.org](https://ip.yunohost.org/) and ip6.yunohost.org @@ -62,8 +73,7 @@ Groups are structured as a result of the fact that YunoHost counts many sub-proj - [yunopaste](http://paste.yunohost.org/) - ##### Apps Group - - Official apps - - Community-based apps + - apps.json list - App development tools (package_checker, package linter) - ##### Communication Group @@ -319,7 +329,6 @@ This part list administration rights for differents groups of YunoHost project: - Get-togethers at events - Weekly Mumble meetings - [Forum](https://forum.yunohost.org). -- Mailing lists: [contrib](https://list.yunohost.org/cgi-bin/mailman/listinfo/contrib) and [apps](https://list.yunohost.org/cgi-bin/mailman/listinfo/apps) - [Bugtracker Redmine](https://dev.yunohost.org). - Git Forge for code reviews: [YunoHost](https://github.com/YunoHost) [YunoHost-Apps](https://github.com/YunoHost-Apps). - [XMPP chat rooms](https://yunohost.org/#/chat_rooms) diff --git a/pages/03.community/06.project_sponsors/sponsors_partners.fr.md b/pages/03.community/06.project_sponsors/sponsors_partners.fr.md new file mode 100644 index 00000000..ec7d13ad --- /dev/null +++ b/pages/03.community/06.project_sponsors/sponsors_partners.fr.md @@ -0,0 +1,22 @@ +--- +title: Mécénes et partenaires +template: docs +taxonomy: + category: docs +routes: + default: '/sponsors_partners' +--- + +Afin d'avancer et de faire fonctionner le projet, en plus du travail des bénévoles et des dons, YunoHost bénéficie du soutien de mécènes et de partenaires. + +Une liste des mécènes de YunoHost, fournissant l'infrastructure et des services aux projets : +- [GITOYEN](https://gitoyen.net) : association regroupant plusieurs entreprises et associations intervenant comme fournisseur d’infrastructure d’hébergement et d’accès à Internet. +- [GLOBENET](http://www.globenet.org) : association militante, au service de la liberté d’expression, proposant des services Internet. +- [LDN-NET](https://ldn-fai.net/) : association pour la défense d’un Internet libre, neutre et décentralisé dont le moyen d’action principale est d’être un fournisseur d’accès Internet (FAI) assocatif et local. +- [NBS System](https://www.nbs-system.com/): société spécialisée dans l’hébergement, la sécurisation des Clouds, l’infogérance (Systèmes d’information, Applications SaaS, Plateformes web) et les services managés. +- [NLNET](https://nlnet.nl/) : La Fondation NLnet soutient les organisations et les personnes qui contribuent à une société de l'information ouverte. +- [TETANEUTRAL-NET](https://tetaneutral.net/) : fournisseur d'accès à Internet associatif opérant actuellement un réseau radio sur Toulouse et ses environs et un hébergeur. + +Une liste des partenaires de YunoHost : +- [FFDN](https://www.ffdn.org/) : La fédération FDN regroupe des Fournisseurs d'Accès à Internet associatifs se reconnaissant dans des valeurs communes : bénévolat, solidarité, fonctionnement démocratique et à but non lucratif ; défense et promotion de la neutralité du Net. +- [Framasoft](https://framasoft.org/) : association d’éducation populaire, un groupe d’ami·es convaincu·es qu’un monde numérique émancipateur est possible, persuadé·es qu’il adviendra grâce à des actions concrètes sur le terrain et en ligne avec vous et pour vous ! diff --git a/pages/03.community/06.project_sponsors/sponsors_partners.md b/pages/03.community/06.project_sponsors/sponsors_partners.md new file mode 100644 index 00000000..7cb0e06e --- /dev/null +++ b/pages/03.community/06.project_sponsors/sponsors_partners.md @@ -0,0 +1,22 @@ +--- +title: Sponsors and partners +template: docs +taxonomy: + category: docs +routes: + default: '/sponsors_partners' +--- + +In order to advance and make the project works, in addition to the work of volunteers and donations, YunoHost benefits from the support of sponsors and partners. + +Here is a list of YunoHost sponsors, providing infrastructure and services to the project: +- [GITOYEN](https://gitoyen.net): association bringing together several companies and associations acting as a provider of hosting infrastructure and Internet access. +- [GLOBENET](http://www.globenet.org): activist association, at the service of freedom of expression, offering internet services. +- [LDN-NET](https://ldn-fai.net/) : association for the defense of a free, neutral and decentralized Internet whose main means of action is to be an Internet access provider associative and local. +- [NBS System](https://www.nbs-system.com/): company specialized in hosting, securing Clouds, outsourcing (Information Systems, SaaS Applications, Web Platforms) and managed services. +- [NLNET](https://nlnet.nl/): The NLnet Foundation supports organizations and people that contribute to an open information society. +- [TETANEUTRAL-NET](https://tetaneutral.net/): associative Internet access provider currently operating a radio network in Toulouse and its surroundings and a hoster. + +Here is a list of YunoHost partners: +- [FFDN](https://www.ffdn.org/): The FDN federation gathers associative Internet Access Providers who recognize themselves in common values: volunteering, solidarity, democratic functioning and non-profit; defense and promotion of net neutrality. +- [Framasoft](https://framasoft.org/) : popular education association, a group of friends convinced that an emancipatory digital world is possible, convinced that it will happen thanks to concrete actions on the ground and online with you and for you! diff --git a/pages/03.community/07.project_budget/project_budget.fr.md b/pages/03.community/07.project_budget/project_budget.fr.md new file mode 100644 index 00000000..b2b5a3c6 --- /dev/null +++ b/pages/03.community/07.project_budget/project_budget.fr.md @@ -0,0 +1,42 @@ +--- +title: Budget du projet +template: docs +taxonomy: + category: docs +routes: + default: '/project_budget' +--- + +# Budget prévisionnel pour 2019/2020 + +## Revenus attendus + +* Dons via Liberapay : 3000€ +* Subvention de NLNet : 20K€ + +## Dépenses prévues + +* Developpement : 20K€ +* Location Serveur : ~500 € + * VPS Scaleway: 20.33*12: 243.96€/year + * VPS Digital O. (forum): 172.80€/year +* Noms de domaine : ~150 € + * nohost.me : 11.99 €HT/ans + * ynh.fr : 6.99 €HT/ans (doit être confirmé avec frju ?) + * noho.st : ~35 €TTC/ans + * yunohost.org : 13.99 €HT/ans + * yunohost.com : 9.99 €HT/ans + * labriqueinter.net : 12.49 €Ht/ans + * internetcu.be : 17.99 €HT/ans +* Communication : ~400 € + * Stickers : 100€ + * Tracts : 100€ + * T-shirt : 200€ +* Déplacements (ex. : aller aux conférences) : ~700 € + * AG FFDN 2020 : 225€ (en tout) + * Event colibris : 150€ + * FOSDEM ou autre conf : 300€ +* Compte bancaire fees : 7×12 € soit ~100 € +* Brique Camp : 500€ + +**Balance 2020-2021** : +650 € diff --git a/pages/03.community/07.project_budget/project_budget.md b/pages/03.community/07.project_budget/project_budget.md new file mode 100644 index 00000000..19f4e059 --- /dev/null +++ b/pages/03.community/07.project_budget/project_budget.md @@ -0,0 +1,39 @@ +--- +title: Project budget +template: docs +taxonomy: + category: docs +routes: + default: '/project_budget' +--- + +# Estimated budget for 2020/2021 + +## Expected revenues + +* Donations: 3000€/year +* Grant from NLNet: 20K€ + +## Expected expenses + +* Development: 20K€ +* Server renting: 500€ + * VPS Scaleway: 20.33*12: 243.96€/year + * VPS Digital O. (forum): 172.80€/year +* Domain names: ~150€ + * nohost.me: 11.99€HT/year + * ynh.fr: 6.99€HT/year (to be confirmed with frju?) + * noho.st: ~35€ TTC/year + * YunoHost.org: 13.99€HT/year + * YunoHost.com: 9.99€HT/year + * labriqueinter.net: 12.49€HT/year + * internetcu.be: 17.99€HT/year +* Communication: ~400€ +* Travel (e.g. to go to conferences): ~700€ + * AG FFDN 2020: 225€ (en tout) + * Event colibris: 150€ + * FOSDEM ou autre conf: 300€ +* Bank account fees: 7x12€ => ~100€ +* Brique Camp: 500€ + +**Balance 2020-2021**: +650€ diff --git a/communication.md b/pages/03.community/08.project_press/communication.md similarity index 88% rename from communication.md rename to pages/03.community/08.project_press/communication.md index 168ac856..93e0ce5e 100644 --- a/communication.md +++ b/pages/03.community/08.project_press/communication.md @@ -1,4 +1,11 @@ -# Communication +--- +title: Communication +template: docs +taxonomy: + category: docs +routes: + default: '/communication' +--- ## Talks / conf @@ -6,7 +13,7 @@ * (EN) [FOSDEM 2019 - The operating system to build the decentralized Internet](https://cinema.yunohost.support/videos/watch/1eb49594-0283-4a01-8691-3817a3cb31e6) ([slides](https://github.com/YunoHost/yunohost-fosdem-2019)) * (FR) [Capitole du libre 2018 - YunoHost: un des chemins vers la décentralisation - Bram](https://www.youtube.com/watch?v=OEXEStoOYpw) ([slides](https://psycojoker.github.io/yunohost-cdl-2018/)) * (FR) [Journées du logiciel libre 2018 - YunoHost : vers l’auto-hébergement et au-delà - Bram](https://www.videos-libr.es/videos/watch/45b48b1e-1b10-4e09-b29a-a404bd42c5d0) ([slides](https://psycojoker.github.io/yunohost-jdll-2018/)) -* (FR) Ubuntu Party Novembre 2017 - De Framasoft à Yunohost, réapproprions nous le cloud ([slides](https://blog.genma.fr/?De-Framasoft-a-Yunohost-reapproprions-nous-le-cloud)) +* (FR) Ubuntu Party Novembre 2017 - De Framasoft à YunoHost, réapproprions nous le cloud ([slides](https://blog.genma.fr/?De-Framasoft-a-Yunohost-reapproprions-nous-le-cloud)) * (FR) [Capitole du libre 2017 - YunoHost : vers l'auto-hébergement et au-delà - JimboJoe](https://2017.capitoledulibre.org/programme/#yunohost-vers-lauto-hebergement-et-au-dela) ([slides](https://github.com/YunoHost/yunohost-cdl-2017/raw/master/YunoHost-CDL2017.pdf)) * (FR) [PSES 2017 – Construire l’Internet du Futur avec YunoHost – Aleks, ljf](https://data.passageenseine.org/2017/aleks-ljf_internet-futur-yunohost.webm) ([slides](https://data.passageenseine.org/2017/aleks-ljf_internet-futur-yunohost.pdf)) * (FR) [Université de technologie de compiègne 2017 – Agir pour un internet éthique – LJF](http://webtv.utc.fr/watch_video.php?v=O34AA7RBR1AH) @@ -21,10 +28,9 @@ ## Articles / Press review -
-
-
-
+[](https://linuxfr.org/news/yunohost-2-0-l-auto-hebergement-a-portee-de-clic)
+[](https://www.linux-pratique.com/2016/07/et-si-vous-passiez-a-lauto-hebergement/)
+[](https://www.linux-magazine.com/Issues/2018/208/YunoHost)
* LinuxFr (french):
- [YunoHost 2.0 : self hosting at click range](https://linuxfr.org/news/yunohost-2-0-l-auto-hebergement-a-portee-de-clic)
- [Internet cube and YunoHost projects evolutions](https://linuxfr.org/news/evolutions-des-projets-la-brique-internet-et-yunohost-des-versions-2-2-2-4-et-2-5)
@@ -34,9 +40,9 @@
- (FR) [Duhaz.fr: Devenir votre propre hébergeur](https://www.duhaz.fr/blog/devenir-votre-propre-h%C3%A9bergeur/)
- (FR) [Faimaison.net: au revoir Google, bonjour liberté!](https://www.faimaison.net/actualites/chatons-leprette-mai2019.html)
- (FR) [Tineternet.net: Reprendre la main sur ses données avec l'auto-hébergement](https://www.tinternet.net/article/2019/05/dossier-reprendre-la-main-sur-ses-donnees-avec-lauto-hebergement)
-- (DE) [Yunohost Serverinstallation auf Laptop](https://www.giammi.com/2019/04/19/yunohost-serverinstallation-auf-laptop/)
-- (FR) [Cenabumix: Retour d’expérience Yunohost sur Raspberry](https://wiki.cenabumix.org/wordpress/2018/03/17/retour-dexperience-yunohost-sur-raspberry/)
-- (FR) [Geber.ga: Yunohost, ou l'auto-hébergement à portée de main...](https://www.geber.ga/yunohost-ou-l-auto-hebergement-a-portee-de-main/)
+- (DE) [YunoHost Serverinstallation auf Laptop](https://www.giammi.com/2019/04/19/yunohost-serverinstallation-auf-laptop/)
+- (FR) [Cenabumix: Retour d’expérience YunoHost sur Raspberry](https://wiki.cenabumix.org/wordpress/2018/03/17/retour-dexperience-yunohost-sur-raspberry/)
+- (FR) [Geber.ga: YunoHost, ou l'auto-hébergement à portée de main...](https://www.geber.ga/yunohost-ou-l-auto-hebergement-a-portee-de-main/)
- (EN) [Nequalsonelifestyle.com: Self Hosting Without Self Owning](https://www.nequalsonelifestyle.com/2019/05/04/self-hosting-without-self-owning/)
- (EN) [Skysilk.com: How to Install YunoHost On a Debian VPS](https://www.skysilk.com/blog/2019/how-to-install-yunohost-on-a-debian-vps/)
- (FR) [Alternativelibertaire.org: Auto-hébergement](https://www.alternativelibertaire.org/?Auto-hebergement-1-Un-serveur-a-mon-seul-service)
diff --git a/security_team_fr.md b/pages/03.community/09.security_team/security_team.fr.md
similarity index 85%
rename from security_team_fr.md
rename to pages/03.community/09.security_team/security_team.fr.md
index a3ae1720..3186cffb 100644
--- a/security_team_fr.md
+++ b/pages/03.community/09.security_team/security_team.fr.md
@@ -1,4 +1,11 @@
-# Équipe sécurité
+---
+title: Équipe sécurité
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/security_team'
+---
Contactez l'équipe sécurité par email : `security@yunohost.org`.
diff --git a/security_team.md b/pages/03.community/09.security_team/security_team.md
similarity index 80%
rename from security_team.md
rename to pages/03.community/09.security_team/security_team.md
index a0e1686f..fd97120b 100644
--- a/security_team.md
+++ b/pages/03.community/09.security_team/security_team.md
@@ -1,4 +1,11 @@
-# Security team
+---
+title: Security team
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/security_team'
+---
Contact the security team by mail: `security@yunohost.org`.
@@ -12,4 +19,4 @@ uid YunoHost Security 
+---
+title: Packaging d'applications
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/packaging_apps'
+---
+
+
Ce document a pour but de vous apprendre à packager une application pour YunoHost.
+! This page is outdated and should be reworked
+
### Prérequis
Pour packager une application, voici les prérequis :
-* Un compte sur un serveur git comme [GitHub](https://github.com/) pour pouvoir ensuite publier l’application ;
-* Maîtriser un minimum [git](/packaging_apps_git), le Shell et d’autres notions de programmation ;
+* Un compte sur un serveur Git comme [GitHub](https://github.com/) pour pouvoir ensuite publier l’application ;
+* Maîtriser un minimum [Git](/packaging_apps_git), le Shell et d’autres notions de programmation ;
* Une [machine virtuelle ou sur un serveur distant](/install) ou un environnement de développement, [ynh-dev](https://github.com/yunohost/ynh-dev) ou [VirtualBox](/packaging_apps_virtualbox), pour packager et tester son paquet.
@@ -20,60 +31,30 @@ Un paquet YunoHost est composé :
* d’un fichier `LICENSE` contenant la licence du paquet
* d’une page de présentation du paquet contenu dans un fichier `README.md`
-Paquet de base n’hésitez pas à vous en servir comme base de travail.
+[div class="btn btn-lg btn-default"] [Paquet de base](https://github.com/YunoHost/example_ynh) [/div] n’hésitez pas à vous en servir comme base de travail.
## Manifeste
-Manifeste
+[div class="btn btn-lg btn-default"] [Manifeste](/packaging_apps_manifest) [/div]
## Les scripts
-Scripts
+[div class="btn btn-lg btn-default"] [Scripts](/packaging_apps_scripts) [/div]
### Architecture et arguments
Comme les instances de YunoHost possèdent une architecture unifiée, vous serez capable de deviner la plupart des réglages nécessaires. Mais si vous avez besoin de réglages spécifiques, comme le nom de domaine ou un chemin web pour configurer l’application, vous devrez les demander aux administrateurs lors de l’installation (voir la section `arguments` dans le § **Manifeste** ci-dessus).
-Gestion des arguments
+[div class="btn btn-lg btn-default"] [Gestion des arguments](/packaging_apps_arguments_management) [/div]
-### Configuration Nginx
-Configuration Nginx
+### Configuration NGINX
+[div class="btn btn-lg btn-default"] [Configuration NGINX](/packaging_apps_nginx_conf) [/div]
### Multi-instance
-Multi-instance
+[div class="btn btn-lg btn-default"] [Multi-instance](/packaging_apps_multiinstance) [/div]
### Hooks
-Hooks
+[div class="btn btn-lg btn-default"] [Hooks](/packaging_apps_hooks) [/div]
### Commandes pratiques
-Commandes pratiques
-
-### Référencement des logs
-Dans de nombreuses situations, vous pouvez vouloir indexer un fichier de log pour qu'il soit affiché dans la webadmin. Pour indexer un log, il faut créer un fichier d'indexation dans `/var/log/yunohost/categories/app/APPNAME.yml`.
-
-Il est possible de spécifier la date de début en commençant le nom de fichier par la date `YYYYMMDD-HHMMSS`.
-
-Exemple de fichier de log d'indexation:
-```bash
-log_path: /chemin/vers/le/fichier.log
-```
-
-Il est possible d'afficher des infos complémentaires, la variable env sera affichée dans la partie "Contexte" :
-```bash
-extra:
- env:
- args1: value1
- args2: value2
- args3: value3
-```
-
-Il est possible de rattacher le log à une application précise et/ou un service, un nom de domaine, une personne :
-```bash
-related_to:
- - ['app', 'APPNAME']
- - ['service', 'SERVICE1']
- - ['service', 'SERVICE2']
- - ['domain', 'DOMAIN.TLD']
-```
-
-Ces informations seront utilisées pour permettre de filtrer les logs en relation avec une de ces entités application, service, domaine, personne.
+[div class="btn btn-lg btn-default"] [Commandes pratiques](/packaging_apps_helpers) [/div]
### Améliorer la qualité du paquet d’installation
@@ -83,13 +64,13 @@ Vous trouverez ci-dessous une liste des points à vérifier concernant la qualit
* Votre script d’installation utilise une méthode d’installation en ligne de commande plutôt qu’un appel curl via un formulaire web d’installation ;
* Votre script d’installation enregistre les réponses de l’utilisateur ;
* Vous avez vérifié les sources de l’application avec une somme de contrôle (sha256, sha1 ou md5) ou une signature PGP ;
-* Vos scripts ont été testés sur Debian Stretch 32 bits, 64 bits et ARM ;
+* Vos scripts ont été testés sur Debian Buster 32 bits, 64 bits et ARM ;
* Les scripts backup et restore sont présents et fonctionnels.
Pour mesurer la qualité d'un paquet, celui-ci obtiendra un [niveau](/packaging_apps_levels), déterminé en fonction de divers critères d'installation et selon le respect des [règles de packaging](/packaging_apps_guidelines).
### Script de vérification du paquet
-Vérificateur de paquets
+[div class="btn btn-lg btn-default"] [Vérificateur de paquets](https://github.com/YunoHost/package_checker) [/div]
Il s’agit d’un script Python qui vérifie :
* que le paquet est à jour concernant les dernières spécifications
@@ -100,11 +81,11 @@ Il s’agit d’un script Python qui vérifie :
### Intégration continue
Un serveur d'intégration continue est a disposition des packagers désirant tester leurs applications.
-Intégration continue
+[div class="btn btn-lg btn-default"] [Intégration continue](packaging_apps_ci) [/div]
### Publiez et demandez des tests de votre application
-* Demandez des tests et des retours sur votre application en publiant un [post sur le Forum](https://forum.yunohost.org/) dans la [catégorie `App integration`](https://forum.yunohost.org/c/app-integration).
+* Demandez des tests et des retours sur votre application en publiant un [post sur le Forum](https://forum.yunohost.org/) dans la [catégorie `Discussion > Apps`](https://forum.yunohost.org/c/discuss/discuss-apps/).
* Si votre paquet et l'application qu'il contient sont sous licence libre, faites une demande d’ajout de votre application dans le [dépôt des applications](https://github.com/YunoHost/apps) (voir aussi [la liste des apps](/apps)). Vous pouvez ajouter une application même si celle-ci n'est pour le moment pas fonctionelle : l'état d'avancement peut être `notworking`, `inprogress` ou `working`.
@@ -114,4 +95,4 @@ Un serveur d'intégration continue est a disposition des packagers désirant tes
**!! Section obsolète au 08/03/19** - Le fonctionnement du projet est en cours d'évolution sur ce point.
-Pour qu’une application devienne officielle, elle doit être suffisamment testée, stable et fonctionner sous Debian Stretch 64 bits, 32 bits et ARM. Si ces conditions vous paraissent réunies, demandez l’[intégration officielle](https://github.com/YunoHost/apps) de votre application.
+Pour qu’une application devienne officielle, elle doit être suffisamment testée, stable et fonctionner sous Debian Buster 64 bits, 32 bits et ARM. Si ces conditions vous paraissent réunies, demandez l’[intégration officielle](https://github.com/YunoHost/apps) de votre application.
diff --git a/packaging_apps.md b/pages/04.contribute/04.packaging_apps/02.technical_intro/packaging_apps.md
similarity index 60%
rename from packaging_apps.md
rename to pages/04.contribute/04.packaging_apps/02.technical_intro/packaging_apps.md
index bf2c2601..33da1b70 100644
--- a/packaging_apps.md
+++ b/pages/04.contribute/04.packaging_apps/02.technical_intro/packaging_apps.md
@@ -1,12 +1,23 @@
-# App packaging
+---
+title: App packaging
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/packaging_apps'
+---
+
+
The purpose of this document is to teach you how to package an application for YunoHost.
+! This page is outdated and should be reworked
+
### Requirements
To package an application, here are the requirements:
-* An account on a git server (e.g. [GitHub](https://github.com/)) to publish the application;
-* Basic knowledge of [git](/packaging_apps_git), bash shell and other programming stuff;
-* A testing [virtual machine or a distant server](/install), or a development environement, [ynh-dev](https://github.com/yunohost/ynh-dev) or [VirtualBox](/packaging_apps_virtualbox), to package and test the package.
+* An account on a Git server (e.g. [GitHub](https://github.com/)) to publish the application;
+* Basic knowledge of [Git](/packaging_apps_git), bash shell and other programming stuff;
+* A testing [virtual machine or a distant server](/install) or [VirtualBox](/packaging_apps_virtualbox), to package and test the package. Alternatively you can also use [ynh-dev](https://github.com/yunohost/ynh-dev), it is meant for the core but can totally be used for developping apps, but be aware that for now the documentation on this part is lacking.
### Content
A YunoHost package is composed of:
@@ -17,25 +28,25 @@ A YunoHost package is composed of:
* A `LICENSE` file containing the license of the package
* A presentation page of your package in a `README.md` file
- A basic package
+[div class="btn btn-lg btn-default"] [ A basic package](https://github.com/YunoHost/example_ynh) [/div]
feel free to use it as a framework.
## Manifest
-Manifest
+[div class="btn btn-lg btn-default"] [Manifest](/packaging_apps_manifest) [/div]
## Scripts
-Scripts
+[div class="btn btn-lg btn-default"] [Scripts](/packaging_apps_scripts) [/div]
### Architecture and arguments
Since YunoHost has a unified architecture, you will be able to guess most of the settings you need. But if you need variable ones, like the domain or web path, you will have to ask the administrator at installation (see `arguments` section in the manifest above).
-Arguments management
+[div class="btn btn-lg btn-default"] [Arguments management](/packaging_apps_arguments_management) [/div]
-### Nginx configuration
-Nginx configuration
+### NGINX configuration
+[div class="btn btn-lg btn-default"] [NGINX configuration](/packaging_apps_nginx_conf) [/div]
### Multi-instance
-Multi-instance
+[div class="btn btn-lg btn-default"] [Multi-instance](/packaging_apps_multiinstance) [/div]
### Hooks
YunoHost provides a hook system, which is accessible via the packager's script callbacks in command line.
@@ -46,38 +57,7 @@ The scripts have to be placed in the `hooks` repository at the root of the YunoH
Take a look at the [Nextcloud package](https://github.com/YunoHost-Apps/nextcloud_ynh/) for a working example.
### Helpers
-Helpers
-
-### Registering a log file
-
-In a lot of case, you might want to register a log file created by your app, to make it available in the webadmin. To register a log, you can create a reference file `/var/log/yunohost/categories/app/APPNAME.yml`.
-
-You can specify a start date by starting the file name with the date formatted as `YYYYMMDD-HHMMSS`.
-
-Example of yml metadata log file:
-```bash
-log_path: /path/to/your/log/file.log
-```
-
-If you want display some context info, you can add:
-```bash
-extra:
- env:
- args1: value1
- args2: value2
- args3: value3
-```
-
-You can attach the log to an app, domain, service or user like this :
-```bash
-related_to:
- - ['app', 'APPNAME']
- - ['service', 'SERVICE1']
- - ['service', 'SERVICE2']
- - ['domain', 'DOMAIN.TLD']
-```
-
-This will be used to filter logs and display all log related to an entity like a user, a domain, an app or a service.
+[div class="btn btn-lg btn-default"] [Helpers](/packaging_apps_helpers) [/div]
### Test it!
In order to test your package, you can execute your script standalone as `admin` (do not forget to append required arguments):
@@ -101,13 +81,13 @@ Here is a list of best practices for application install scripts:
* install script should use the command-line method instead of calls to curl through web install form;
* install script should save install answers;
* application sources should be checked with a control sum (sha256, sha1 or md5) or a PGP signature;
-* scripts should be tested on Debian Stretch 32 bits, 64 bits and ARM architectures;
+* scripts should be tested on Debian Buster 32 bits, 64 bits and ARM architectures;
* backup and restore scripts should be present and functional.
-To be define the quality of a package, it'll obtained a [level](/packaging_apps_levels), determined according to somes criteria of installation and according to respect to [package guidelines](packaging_apps_guidelines).
+To be define the quality of a package, it'll obtained a [level](/packaging_apps_levels), determined according to somes criteria of installation and according to respect to [package guidelines](/packaging_apps_guidelines).
### Package script checker
-Package checker
+[div class="btn btn-lg btn-default"] [Package checker](https://github.com/YunoHost/package_checker) [/div]
This Python script checks:
* that the package is up to date wich last specifications
@@ -118,11 +98,11 @@ This Python script checks:
### Continuous integration
A continuous integration server is available for packagers who want to test their apps.
-Continuous integration
+[div class="btn btn-lg btn-default"] [Continuous integration](packaging_apps_ci) [/div]
### Publish and ask for testing your application
-* Publishing a [post on the Forum](https://forum.yunohost.org/) with the [`App integration` category](https://forum.yunohost.org/c/app-integration), to ask for testing and feedback on your application.
+* Publishing a [post on the Forum](https://forum.yunohost.org/) in the [`Discuss > Apps` category](https://forum.yunohost.org/c/discuss/discuss-apps/), to ask for testing and feedback on your application.
* If your application is released under a free software license, you may ask the YunoHost app team to integrate your application to the [app repository](https://github.com/YunoHost/apps) (c.f. also the [app list](/apps)). You can add your application even if it is not stable or working yet : the current state can be specified to `notworking`, `inprogress`, or `working`.
@@ -132,4 +112,4 @@ A continuous integration server is available for packagers who want to test thei
**!! This section is obsolete as of 08/03/19** - The project's organization regarging this point is to be changed.
-To become an official application, it must be tested well enough, be stable and should work on Debian Stretch 64 bits, 32 bits and ARM architectures. If you think those conditions are met, ask for [official integration](https://github.com/YunoHost/apps) of your application.
+To become an official application, it must be tested well enough, be stable and should work on Debian Buster 64 bits, 32 bits and ARM architectures. If you think those conditions are met, ask for [official integration](https://github.com/YunoHost/apps) of your application.
diff --git a/packaging_apps_git_fr.md b/pages/04.contribute/04.packaging_apps/03.git/packaging_apps_git.fr.md
similarity index 97%
rename from packaging_apps_git_fr.md
rename to pages/04.contribute/04.packaging_apps/03.git/packaging_apps_git.fr.md
index 95172258..c2ed3187 100644
--- a/packaging_apps_git_fr.md
+++ b/pages/04.contribute/04.packaging_apps/03.git/packaging_apps_git.fr.md
@@ -1,4 +1,11 @@
-# Comment utiliser Git pour packager les applications
+---
+title: Utiliser Git pour packager les applications
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/packaging_apps_git'
+---
Git... Notre cher Git bien-aimé, que l'on peut aussi décrire comme "Goddamn Idiotic Truckload of sh*t" (Un stupide putain gros tas de m\*rde), selon Linus.
Si vous ne connaissez pas encore Git, soyez sûr que vous serez bientôt d'accord avec cette description.
@@ -23,14 +30,14 @@ La branche master est la branche qui contient la version de l'application que le
La bonne habitude à prendre est de travailler à partir de la branche testing, et lorsque tout est réglé et testé, vous pouvez fusionner la branche testing dans master, afin que les utilisateurs puissent profiter de la nouvelle version de votre package.
Pour voir et modifier la branche actuelle, utilisez ce bouton :
-
+
#### Modifier un fichier
Maintenant que vous êtes sur la bonne branche, voyons comment éditer un fichier sur GitHub.
Vous pouvez éditer n'importe quel fichier en utilisant l'icône du petit crayon :
-
+
Si vous n'avez pas la permission d'écrire sur le dépôt, vous verrez (comme sur l'image) que vous allez créer un fork (nous verrons plus loin ce qu'est un fork).
Si vous avez la permission d'écrire, vous allez simplement modifier le fichier, sans forker.
@@ -39,7 +46,7 @@ Si vous avez la permission d'écrire, vous allez simplement modifier le fichier,
Lorsque vous avez fini de modifier le fichier, vous pouvez faire un commit de vos modifications.
Derrière ce mot, l'idée est assez simple, vous allez juste enregistrer vos modifications...
-
+
Le premier champ est le nom de votre commit, une phrase très courte pour expliquer pourquoi vous avez fait cette modification.
Le deuxième champ est un champ plus grand pour une explication plus complète, si vous en avez besoin.
@@ -67,7 +74,7 @@ Il se peut que vous deviez tout de même forker sur votre propre compte pour pou
Après avoir effectué vos commits, que ce soit sur une branche ou un fork, vous souhaitez proposer vos modifications pour qu'elles soient intégrées dans le dépôt principal, ou dans la branche d'origine.
Pour ce faire, vous allez créer une pull request. GitHub vous demande généralement directement si vous souhaitez le faire.
Sinon, vous trouverez le bouton de création d'une pull request juste ici :
-
+
Lors de la création d'une pull request à partir d'un fork, pour faciliter le travail de révision du code, **ne jamais** décocher la case *Allow edits from maintainers*. Cette option permet simplement aux mainteneurs du dépôt d'origine de modifier directement votre travail.
@@ -75,7 +82,7 @@ Lors de la création d'une pull request à partir d'un fork, pour faciliter le t
Conformément à la [YEP 1.7](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines.md#yep-17), votre application doit être intégrée à l'organisation YunoHost-Apps, mais si vous n'avez jamais contribué à une application auparavant ou si vous n'avez jamais eu d'application dans cette organisation, vous n'en aurez peut-être pas l'autorisation.
-Tout d'abord, vous devez avoir la permission d'écrire dans l'organisation, pour ce faire, demandez au groupe Apps sur le salon xmpp Apps.
+Tout d'abord, vous devez avoir la permission d'écrire dans l'organisation, pour ce faire, demandez au groupe Apps sur le salon XMPP Apps.
Pour transférer votre application sur l'organisation YunoHost-Apps, allez dans votre dépôt et dans l'onglet *Settings*.
En bas de la page, vous trouverez *Transfer ownership*.
@@ -116,7 +123,7 @@ Dans le contexte d'un nouveau package, vous devrez également créer un dépôt
Ce qui n'est pas plus compliqué qu'un gros bouton vert *New*.
Ne vous embêtez pas avec des README, .gitignore ou licence. Créez simplement le dépôt lui-même.
vous pouvez maintenant cloner ce nouveau dépôt avec Git.
-
+
Vous disposez maintenant de 2 dépôts clonés sur votre ordinateur.
Copiez tous les fichiers de l'application example_ynh, **excepté le répertoire .git** (vous voulez juste les fichiers eux-mêmes) dans votre nouveau package.
diff --git a/packaging_apps_git.md b/pages/04.contribute/04.packaging_apps/03.git/packaging_apps_git.md
similarity index 96%
rename from packaging_apps_git.md
rename to pages/04.contribute/04.packaging_apps/03.git/packaging_apps_git.md
index 1ddb6ff2..58062371 100644
--- a/packaging_apps_git.md
+++ b/pages/04.contribute/04.packaging_apps/03.git/packaging_apps_git.md
@@ -1,4 +1,11 @@
-# How to use Git to package apps
+---
+title: Use Git to package apps
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/packaging_apps_git'
+---
Git... Our dear beloved Git, which can be described also as "Goddamn Idiotic Truckload of sh*t", according to Linus.
Be sure if you don't know Git yet that you will soon agree with that description.
@@ -23,14 +30,14 @@ The master branch is the branch that contains the version of the app users will
The usual thing to do is to work from the testing branch, and when everything is settled and tested, you can merge the testing branch in master, so users will enjoy the new release of your package.
To see and change the current branch, use this button:
-
+
#### Edit a file
Now that you're on the right branch, let's see how to edit a file on GitHub.
You can edit any file by using the small pencil icon:
-
+
If you don't have the permission to write on the repository, you will see (as on the picture) that you're going to create a fork (we'll see below what a fork is).
If you have the permission to write, you will just edit the file, without forking.
@@ -39,7 +46,7 @@ If you have the permission to write, you will just edit the file, without forkin
When you're done with your modification on the file, you can commit your changes.
Behind that word, the idea is quite simple, you're just going to save your changes...
-
+
The first field is the name of your commit, a very short sentence to explain why you did this modification.
The second field is a large one for a more complete explanation, if you need it.
@@ -67,7 +74,7 @@ You may still need to fork on your own account to be able to save your modificat
After you have committed your changes, whether on a branch or a fork, you want to propose your modifications to be integrated into the main repository, or the original branch.
To do so, you're going to *create a pull request*. GitHub usually ask you directly if you want to do so.
Otherwise, you'll find the button to create a pull request just here:
-
+
When creating a pull request from a fork, to ease the work of the reviewers, **do never** uncheck the checkbox *Allow edits from maintainers*. That option simply allow the maintainers of the original repository to edit directly your work.
@@ -75,7 +82,7 @@ When creating a pull request from a fork, to ease the work of the reviewers, **d
Following the [YEP 1.7](https://github.com/YunoHost/doc/blob/master/packaging_apps_guidelines.md#yep-17), your app has to be into the YunoHost-Apps organization, but if you have never contributed to an app before or never had any app into this organization you may not have the permission.
-First, you need the permission to write into the organization, to do so, ask to the Apps group on the Apps xmpp room.
+First, you need the permission to write into the organization, to do so, ask to the Apps group on the Apps XMPP room.
To transfer your app to the YunoHost-Apps organization, go to your repository and to *Settings* tab.
At the bottom of the page, you will find *Transfer ownership*.
@@ -116,7 +123,7 @@ In the context of a new package, you will also need to create a repository on Gi
Which is as simple as a big green *New* button.
Don't bother with README, .gitignore or license. Just create the repository itself.
you can now git clone that new repository.
-
+
You now have 2 repositories cloned on your computer.
Copy all the files from the example_ynh app, **except the .git directory** (You just want the files themselves) to your new package.
diff --git a/packaging_apps_virtualbox_fr.md b/pages/04.contribute/04.packaging_apps/04.virtualbox/packaging_apps_virtualbox.fr.md
similarity index 91%
rename from packaging_apps_virtualbox_fr.md
rename to pages/04.contribute/04.packaging_apps/04.virtualbox/packaging_apps_virtualbox.fr.md
index baaa0f5c..7911e92d 100644
--- a/packaging_apps_virtualbox_fr.md
+++ b/pages/04.contribute/04.packaging_apps/04.virtualbox/packaging_apps_virtualbox.fr.md
@@ -1,4 +1,11 @@
-# Créer un environnement de développement avec VirtualBox
+---
+title: Créer un environnement de développement avec VirtualBox
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/packaging_apps_virtualbox'
+---
Cette page de documentation va vous expliquer comment mettre en place un serveur YunoHost virtuel, avec VirtualBox, pour travailler sur le packaging d'application.
@@ -13,7 +20,7 @@ Nous parlerons ici de VirtualBox, pour son approche graphique facile à utiliser
## Installer VirtualBox
-Depuis un système GNU Linux, installer simplement le paquet `virtualbox-qt`.
+Depuis un système GNU/Linux, installer simplement le paquet `virtualbox-qt`.
Depuis un système Windows ou macOS, il faudra se référer à la page de [téléchargement de VirtualBox](https://www.virtualbox.org/wiki/Downloads) pour récupérer le fichier d'installation adéquat. Le paquet virtualbox est déprécié depuis debian 9, un fichier d'installation .deb est disponible sur la même page.
Quel que soit votre système, il ne devrait pas être nécessaire d'installer l'extension pack ou les additions invités.
@@ -40,14 +47,14 @@ Avant de commencer à jouer avec la machine virtuelle, il convient de faire un p
Arrêtez la machine virtuelle avant tout.
La gestion des instantanés se fait dans l'onglet "Instantanés"
-
+
Et on crée un premier instantané
-
+
À présent on peut commencer à travailler sur la machine virtuelle et créer autant d'instantanés que souhaité pour jalonner le travail.
-
+
Dans cet exemple, on pourra facilement revenir en arrière, après avoir testé la suppression du package par exemple et restaurer la machine virtuelle dans l'état précédent avec le package encore installé avec succès.
Et lorsque le package sera pleinement fonctionnel, il suffira de supprimer les instantanés liés à ce package pour revenir à l'état initial de la machine virtuelle.
@@ -57,14 +64,14 @@ Nous disposerons ainsi d'un serveur YunoHost vierge de toute installation d'appl
En plus de l'usage d'instantanés successifs, il est également possible de dériver un nouvel état actuel et de nouveaux instantanés depuis un instantané plus ancien que le dernier.
-
+
Dans cet exemple, j'ai dérivé deux branches depuis mon installation réussie du package, pour tester indépendamment la suppression simple de l'application, l'upgrade et le backup/restore.
Finalement je suis reparti de la base de la machine virtuelle pour démarrer un nouveau test sur un autre package, sans pour autant abandonner le précédent test.
À tout moment, il est possible de revenir sur un instantané précédent en le restaurant.
La machine démarrera toujours sur l'"État actuel".
-
+
> Il est toujours possible de créer un nouvel instantané, que la machine soit à l'arrêt ou non.
Mais pour restaurer un instantané, la machine ne doit pas être en cours d'exécution.
@@ -87,6 +94,6 @@ ssh admin@11.22.33.44
Pour copier facilement les fichiers du package ou utiliser un éditeur de texte graphique, on peut également se connecter en sftp avec un explorateur de fichier.
Il suffit de se connecter à l'adresse `sftp://admin@mon.domain/` avec l'explorateur.
-
+
> Sur Windows ou macOS, l'explorateur de fichier ne supporte pas nativement le protocole sftp…
diff --git a/packaging_apps_virtualbox.md b/pages/04.contribute/04.packaging_apps/04.virtualbox/packaging_apps_virtualbox.md
similarity index 87%
rename from packaging_apps_virtualbox.md
rename to pages/04.contribute/04.packaging_apps/04.virtualbox/packaging_apps_virtualbox.md
index 49e87483..0a3b6c9a 100644
--- a/packaging_apps_virtualbox.md
+++ b/pages/04.contribute/04.packaging_apps/04.virtualbox/packaging_apps_virtualbox.md
@@ -1,19 +1,26 @@
-# Create a development environment with VirtualBox
+---
+title: Create a development environment with VirtualBox
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/packaging_apps_virtualbox'
+---
-This documentation page aims at explaining how to setup a Yunohost virtual server, using VirtualBox, to work on application packaging.
+This documentation page aims at explaining how to setup a YunoHost virtual server, using VirtualBox, to work on application packaging.
-## Why use VirtualBox rather than an actual YunoHost production server to package an application ?
+## Why use VirtualBox rather than an actual YunoHost production server to package an application?
-There are mostly two reasons why one should prefer a virtual server rather than their own server :
+There are mostly two reasons why one should prefer a virtual server rather than their own server:
-- You can freely torture a virtual server without any risk of breaking it, since you can always restore it to a former working state. It would really be a pity to break your own real server !
+- You can freely torture a virtual server without any risk of breaking it, since you can always restore it to a former working state. It would really be a pity to break your own real server!
- In a typical workflow, a virtual server state would be restored from a known snapshot before starting any work on it, so as to always keep a clean system, without any residues of a former installation. This allows to always be as close a possible to a user first installation.
We will discuss VirtualBox in this guide, as it comes with an easy to use GUI. If you prefer a pure commandline approach to handling your virtual machine, you should use [ynh-dev](/dev) instead.
## Installing VirtualBox
-From a GNU Linux system, simply install the `virtualbox-qt` package.
+From a GNU/Linux system, simply install the `virtualbox-qt` package.
From a Windows or macOS machine, you'd have to refer to the [VirtualBox download page](https://www.virtualbox.org/wiki/Downloads) to fetch the appropriate installation package. The virtualbox package is deprecated since Debian 9, a `.deb` installation package is available on the abovementioned referenced page.
Whatever your system, there should be no need to install the extension pack or the guest addons.
@@ -40,14 +47,14 @@ Before starting to play with the virtual machine, now is a good time to take a f
First, stop the virtual machine.
Managing snapshots is done in the 'Snapshots' tab
-
+
Here, we're creating a first snapshot
-
+
We can now start to work on the virtual machine and create as many snapshots as desired for each milestone of our modifications.
-
+
In this example, after having validated our particular package removal works fine, we can easily get back in time by restoring the virtual machine to its previous state with the package still installed.
Once the package will be fully functional, it will just be a matter of deleting the snaphots associated with this package work to get the virtual machine back to its initial state.
@@ -57,14 +64,14 @@ For our next test, we will then be back to a freshly installed YunoHost serveur,
In addition to successive snapshots, it is also possible to create a new machine state and additional snapshots from an older machine snapshot/state.
-
+
In this example, I have created two branches since my successful package installation, so as to independently test just the application removal, upgrade and backup/restore steps.
I eventually got back to the virtual machine base state to start a new test on another package, without dropping my former test whatsoever.
At any time, it is possible to get back to a previous snapshot simply by restoring it.
The machine always start on the "Current state" state.
-
+
> It is always possible to create a new snapshot, whether the machine is stopped or not. To restore a snapshot however, the machine cannot be running.
@@ -86,6 +93,6 @@ We can now work on the virtual machine using the commandline.
To easily copy the package files or use a graphical text editor, one can also connect via `sftp` using a file explorer.
It's a simple matter of using the `sftp://admin@my.domain/` address.
-
+
-> Note: on Windows or macOS, the file explorer does not natively support the `sftp` protocol…
+> Note: on Windows or macOS, the file explorer does not natively support the `sftp` protocol...
diff --git a/packaging_apps_manifest_fr.md b/pages/04.contribute/04.packaging_apps/05.manifest/packaging_apps_manifest.fr.md
similarity index 90%
rename from packaging_apps_manifest_fr.md
rename to pages/04.contribute/04.packaging_apps/05.manifest/packaging_apps_manifest.fr.md
index 50a9c611..f76bfe74 100644
--- a/packaging_apps_manifest_fr.md
+++ b/pages/04.contribute/04.packaging_apps/05.manifest/packaging_apps_manifest.fr.md
@@ -1,4 +1,11 @@
-Packaging d’application
+---
+title: Packaging d'application
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/packaging_apps_manifest'
+---
## Manifeste
Le fichier `manifest.json` définit les constantes de l’application, un ensemble de valeurs dont YunoHost a besoin pour identifier l’application et l’installer correctement. Voici un exemple :
@@ -78,9 +85,9 @@ Le fichier `manifest.json` définit les constantes de l’application, un ensemb
* **arguments** :
* **install** : paramètres à demander à l’administrateur lors de l’installation.
* **name** : identifiant du paramètre
- * **type** : (optionnel) type de paramètre parmis `domain`, `path`, `user`, `app`, `boolean`, `string` et `password`. Le champ sera caché dans le cas d’un mot de passe.
+ * **type** : (optionnel) type de paramètre parmi `domain`, `path`, `user`, `app`, `boolean`, `string` et `password`. Le champ sera caché dans le cas d’un mot de passe.
* **choices** : (optionnel) restreint les réponses possibles à plusieurs choix.
- * **optional** : (optionnel) champs qui indique si ce paramètre est optionnel. Il peut avoir les valeurs `true` ou `false`.
+ * **optional** : (optionnel) champ qui indique si ce paramètre est optionnel. Il peut avoir les valeurs `true` ou `false`.
* **ask** : question posée (au minimum en anglais – `en`) que vous pouvez traduire dans plusieurs langues.
* **example** : (optionnel) valeur d’exemple pour aider l’administrateur à remplir le formulaire d’installation.
* **default** : (optionnel) valeur par défaut.
diff --git a/packaging_apps_manifest.md b/pages/04.contribute/04.packaging_apps/05.manifest/packaging_apps_manifest.md
similarity index 96%
rename from packaging_apps_manifest.md
rename to pages/04.contribute/04.packaging_apps/05.manifest/packaging_apps_manifest.md
index f4407aa1..e01a0e97 100644
--- a/packaging_apps_manifest.md
+++ b/pages/04.contribute/04.packaging_apps/05.manifest/packaging_apps_manifest.md
@@ -1,4 +1,11 @@
-Application packaging
+---
+title: Application packaging
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/packaging_apps_manifest'
+---
## Manifest
The `manifest.json` file defines the app's constants, a bunch of values that YunoHost needs to identify the app and install it correctly. It looks like this:
diff --git a/packaging_apps_scripts_fr.md b/pages/04.contribute/04.packaging_apps/06.scripts/packaging_apps_scripts.fr.md
similarity index 88%
rename from packaging_apps_scripts_fr.md
rename to pages/04.contribute/04.packaging_apps/06.scripts/packaging_apps_scripts.fr.md
index 8854f287..7a37129a 100644
--- a/packaging_apps_scripts_fr.md
+++ b/pages/04.contribute/04.packaging_apps/06.scripts/packaging_apps_scripts.fr.md
@@ -1,6 +1,11 @@
-Packaging d’application
-
-## Les scripts
+---
+title: Scripts
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/packaging_apps_scripts'
+---
Un paquet YunoHost doit contenir cinq scripts Shell : `install`, `remove`, `upgrade`, `backup` et `restore`. Un 6ème script `change_url` peut aussi être ajouté de façon optionnelle.
Ces scripts seront exécutés en tant que `root` sur les serveurs YunoHost.
@@ -17,15 +22,15 @@ Il est possible d'utiliser des helpers et d'importer une librairie de fonction p
Cette variable contient le chemin du répertoire de travail courant du contexte d'exécution du script. Elle peut être utile pour retrouver le chemin initial si on s'est déplacé pendant l'exécution du script. Elle est utilisée par certains helpers pour être sûr d'utiliser le bon.
#### YNH_APP_ID
-Contient l'identifiant de l'application sans le numéro d'instance
+Contient l'identifiant de l'application sans le numéro d'instance.
Exemple: strut
#### YNH_APP_INSTANCE_NAME
-Contient le nom d'instance qui sera utilisé dans de nombreuses situation pour pouvoir gérer l'installation multiple d'une même app.
+Contient le nom d'instance qui sera utilisé dans de nombreuses situations pour pouvoir gérer l'installation multiple d'une même app.
Exemple: strut__3
#### YNH_APP_INSTANCE_NUMBER
-Contient le numéro de l'instance. Attention il ne s'agit pas forcément du nombre d'instance toujours installée, car une ancienne application peut avoir été désinstallée.
+Contient le numéro de l'instance. Attention il ne s'agit pas forcément du nombre d'instances toujours installées, car une ancienne application peut avoir été désinstallée.
Exemple: 3
@@ -47,7 +52,7 @@ Par exemple, si dans le manifest nous avons une question de cette forme
}
```
-Le nom de la question `domain` donc dans le script on peut accéder à cette variable via $YNH_APP_ARG_DOMAIN. L'usage est de créer une variable plus courte comme ceci:
+Le nom de la question `domain` donc dans le script on peut accéder à cette variable via $YNH_APP_ARG_DOMAIN. L'usage est de créer une variable plus courte comme ceci :
```bash
domain=$YNH_APP_ARG_DOMAIN
diff --git a/packaging_apps_scripts.md b/pages/04.contribute/04.packaging_apps/06.scripts/packaging_apps_scripts.md
similarity index 95%
rename from packaging_apps_scripts.md
rename to pages/04.contribute/04.packaging_apps/06.scripts/packaging_apps_scripts.md
index 7d5c4a88..28862b55 100644
--- a/packaging_apps_scripts.md
+++ b/pages/04.contribute/04.packaging_apps/06.scripts/packaging_apps_scripts.md
@@ -1,6 +1,11 @@
-Application packaging
-
-## Scripts
+---
+title: Scripts
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/packaging_apps_scripts'
+---
For now, a YunoHost package must contain five Shell scripts: `install`, `remove`, `upgrade`, `backup` and `restore`. A 6th script `change_url` can also be added optionally.
These scripts will be executed as `root` on the YunoHost instances.
@@ -45,7 +50,7 @@ For example, if in the manifest we have a question like this
"de": "Wählen Sie bitte einen Domain für OpenSondage"
},
"example": "domain.org"
-},
+}
```
The name of the question is `domain` so in the script we can access it with YNH_APP_ARG_DOMAIN. The usage is to create a shorter name in the script like this:
diff --git a/pages/04.contribute/04.packaging_apps/07.arguments/01.arguments_format/packaging_apps_arguments_format.md b/pages/04.contribute/04.packaging_apps/07.arguments/01.arguments_format/packaging_apps_arguments_format.md
new file mode 100644
index 00000000..010748c8
--- /dev/null
+++ b/pages/04.contribute/04.packaging_apps/07.arguments/01.arguments_format/packaging_apps_arguments_format.md
@@ -0,0 +1,338 @@
+---
+title: YunoHost Arguments Format
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/packaging_apps_arguments_format'
+---
+
+In YunoHost application developpement there are several places where you end up
+writting questions for your user like in the `manifest.json/toml`, the
+`config_panel.json/toml` or `actions.json/toml`.
+
+This page documents this format and all available kind of questions you can ask
+your user. Unless it's stated otherwise, this format applies to everyplace it's
+usable (for now: installation arguments in `manifest.json/toml`,
+`config_panel.json/toml` and `actions.json/toml`)
+
+## YunoHost arguments general format
+
+The general format for an argument looks like this in toml:
+
+```toml
+[maybe.some.stuff.before.the_name]
+type = "one_of_the_available_type"
+ask.en = "the question in english"
+ask.fr = "the question in french"
+help.en = "some help text in english" # optional
+help.fr = "some help text in french" # optional
+example = "an example value" # optional
+default = "some stuff" # optional, not available for all types
+optional = true # optional, will skip if not answered
+```
+
+And in json:
+
+```javascript
+{
+ "name": "the_name",
+ "type": "one_of_the_available_type", // "sting" is not specified
+ "ask": {
+ "en": "the question in english",
+ "fr": "the question in french"
+ },
+ "help": {
+ "en": "some help text in english",
+ "fr": "some help text in french"
+ },
+ "example": "an example value", // optional
+ "default", "some stuff", // optional, not available for all types
+ "optional": true // optional, will skip if not answered
+},
+```
+
+## All avaiable types
+
+### string
+
+This one is the simpliest one and is the default type if you don't specify one.
+
+Example in toml:
+
+```toml
+[maybe.some.stuff.before.the_name]
+type = "string" # optional
+ask.en = "the question in english"
+ask.fr = "the question in french"
+example = "an example value" # optional
+default = "some stuff" # optional
+```
+
+And in json:
+
+```javascript
+{
+ "name": "the_name",
+ "type": "string", // optional
+ "ask": {
+ "en": "the question in english",
+ "fr": "the question in french"
+ },
+ "default": "some stuff", // optional
+ "example": "an example value"
+},
+```
+
+### string with choices
+
+Like string except the user needs to chose in a list of specifics strings.
+
+Example in toml:
+
+```toml
+[maybe.some.stuff.before.the_name]
+type = "string"
+ask.en = "the question in english"
+ask.fr = "la question en français"
+example = "an example value" # optional
+choices = ["fr", "en"]
+default = "en" # optional
+```
+
+And in json:
+
+```javascript
+{
+ "name": "the_name",
+ "type": "string",
+ "ask": {
+ "en": "the question in english",
+ "fr": "the question in french"
+ },
+ "example": "an example value",
+ "choices": ["fr", "en"],
+ "default": "en" // optional
+},
+```
+
+### domain
+
+This type will ask the user to chose one of the domains of their YunoHost instance.
+
+Example in toml:
+
+```toml
+[maybe.some.stuff.before.the_name]
+type = "domain"
+ask.en = "the question in english"
+ask.fr = "the question in french"
+```
+
+And in json:
+
+```javascript
+{
+ "name": "the_name",
+ "type": "domain",
+ "ask": {
+ "en": "the question in english",
+ "fr": "the question in french"
+ }
+},
+```
+
+### Path
+
+This type will ask the user to chose an URL path (generally to happen it to a
+domain) like "/path/to/my/app"
+
+Example in toml:
+
+```toml
+[maybe.some.stuff.before.the_name]
+type = "path"
+ask.en = "the question in english"
+ask.fr = "the question in french"
+default = "/my_app"
+```
+
+And in json:
+
+```javascript
+{
+ "name": "the_name",
+ "type": "path",
+ "ask": {
+ "en": "the question in english",
+ "fr": "the question in french"
+ },
+ "default": "/my_app"
+},
+```
+
+### User
+
+This type will ask the user to select a user in the list of users in their
+YunoHost installation. Generally this is used to select who is going to be the
+admin or who is going to have access to this application.
+
+Example in toml:
+
+```toml
+[maybe.some.stuff.before.the_name]
+type = "user"
+ask.en = "the question in english"
+ask.fr = "the question in french"
+```
+
+And in json:
+
+```javascript
+{
+ "name": "the_name",
+ "type": "user",
+ "ask": {
+ "en": "the question in english",
+ "fr": "the question in french"
+ }
+},
+```
+
+### Password
+
+This type will ask the user to input a password. This is generally used to
+input the password for creating an account on the application.
+
+In CLI it will behave like any password query and won't print any character on
+type (not "\*\*\*...") for security reasons.
+
+Example in toml:
+
+```toml
+[maybe.some.stuff.before.the_name]
+type = "password"
+ask.en = "the question in english"
+ask.fr = "the question in french"
+```
+
+And in json:
+
+```javascript
+{
+ "name": "the_name",
+ "type": "password",
+ "ask": {
+ "en": "the question in english",
+ "fr": "the question in french"
+ }
+},
+```
+
+### Boolean
+
+This type will ask the user to answer true or false to a question.
+
+Example in toml:
+
+```toml
+[maybe.some.stuff.before.the_name]
+type = "boolean"
+ask.en = "the question in english"
+ask.fr = "the question in french"
+default = true
+```
+
+And in json:
+
+```javascript
+{
+ "name": "the_name",
+ "type": "boolean",
+ "ask": {
+ "en": "the question in english",
+ "fr": "the question in french"
+ },
+ "default": true
+},
+```
+
+### Number
+
+Like string except the user needs to enter a number
+
+Example in toml:
+
+```toml
+[maybe.some.stuff.before.the_name]
+type = "number"
+ask.en = "the question in english"
+ask.fr = "the question in french"
+default = 0
+```
+
+And in json:
+
+```javascript
+{
+ "name": "the_name",
+ "type": "number",
+ "ask": {
+ "en": "the question in english",
+ "fr": "the question in french"
+ },
+ "default": 0
+},
+```
+
+### App
+
+This type will ask the user to select an application in the list of installed
+application on their YunoHost.
+
+Example in toml:
+
+```toml
+[maybe.some.stuff.before.the_name]
+type = "app"
+ask.en = "the question in english"
+ask.fr = "the question in french"
+```
+
+And in json:
+
+```javascript
+{
+ "name": "the_name",
+ "type": "app",
+ "ask": {
+ "en": "the question in english",
+ "fr": "the question in french"
+ }
+},
+```
+
+### display_text
+
+This is a special type that allows the application packager to write some text
+that will be simply displayed. This is useful to provide more context.
+
+```toml
+[maybe.some.stuff.before.the_name]
+type = "display_text"
+ask.en = "the text in english"
+ask.fr = "the text in french"
+```
+
+And in json:
+
+```javascript
+{
+ "name": "the_name",
+ "type": "display_text",
+ "ask": {
+ "en": "the text in english",
+ "fr": "the text in french"
+ }
+},
+```
diff --git a/packaging_apps_arguments_management_fr.md b/pages/04.contribute/04.packaging_apps/07.arguments/packaging_apps_arguments_management.fr.md
similarity index 78%
rename from packaging_apps_arguments_management_fr.md
rename to pages/04.contribute/04.packaging_apps/07.arguments/packaging_apps_arguments_management.fr.md
index 5d66e707..729ea1b8 100644
--- a/packaging_apps_arguments_management_fr.md
+++ b/pages/04.contribute/04.packaging_apps/07.arguments/packaging_apps_arguments_management.fr.md
@@ -1,6 +1,12 @@
-Packaging d’application
+---
+title: Gestion des arguments
+template: docs
+taxonomy:
+ category: docs
+routes:
+ default: '/packaging_apps_arguments_management'
+---
-## Gestion des arguments
#### Récupérer les arguments du manifeste dans le script d’installation
Les arguments sont passés au script d’installation dans l’ordre du manifeste. Par exemple pour Roundcube, les arguments `domain` et `path` seront respectivement récupérés via les variables d’environnement ou les paramètres `$1` et `$2` dans le script d’installation.
@@ -16,13 +22,13 @@ Les scripts remove, upgrade, backup et restore peuvent avoir besoin de ces argum
Pour cela, YunoHost peut sauvegarder les arguments avec cette commande :
```bash
# Store config on YunoHost instance
-ynh_app_setting_set "$app" domain "$domain"
+ynh_app_setting_set --app="$app" --key="domain" --value="$domain"
```
Elle est généralement utilisée dans le script d’installation.
Ensuite, le script peut récupérer les arguments sauvegardés avec cette commande :
```bash
-domain=$(ynh_app_setting_get $app domain)
+domain=$(ynh_app_setting_get --app "$app" --key=domain)
```
Ces données sont sauvegardées dans `/etc/yunohost/apps/du HTML conditionnel ici !
{{/if}}` + +- Pour l'internationalisation des messages, utilisez `y18n.t('some-string-code')` dans le JavaScript, ou `{{t 'some-string-code'}}` dans le template HTML, et mettez votre message dans `locales/en.json`. Ne modifiez pas de fichiers de locales autres que `en.json`, la traduction sera faite avec [Weblate](https://translate.yunohost.org/) ! + +##### N'oubliez pas + +- À chaque modification de l'actionsmap, il faut redémarrer l'API YunoHost : `service yunohost-api restart` (Il faudra retaper le mot de passe administrateur dans l'interface web) + +- Il faudra peut-être régulièrement forcer le rafraîchissement du cache navigateur pour propager correctement le JavaScript et/ou HTML (à chaque fois que l'on change quelque chose dans `js` ou `views`, donc). + + +### Votre fonctionnalité est prête et vous souhaitez qu'elle soit intégrée dans YunoHost + +- Forkez le dépôt correspondant sur GitHub, et commitez vos changements dans une nouvelle branche. Il est recommandé de nommer la branche avec la convention suivante : + - Pour une nouvelle fonctionnalité ou amélioration : `enh-ISSUENUMBER-description-fonctionnalité` + - Pour une correction de bug : `fix-REDMINETICKET-description-correctif` + - `ISSUENUMBER` est optionnel et correspond au numéro du ticket sur le bug tracker + +- Une fois prêt, ouvrez une Pull Request (PR) sur Github. De préférence, inclure `[fix]` ou `[enh]` au début du titre de la PR. + +- Après relecture, test et validation par les autres contributeurs, votre branche sera mergée dans `unstable` ! diff --git a/dev.md b/pages/04.contribute/05.dev/dev.md similarity index 76% rename from dev.md rename to pages/04.contribute/05.dev/dev.md index 45015d78..8158ac28 100644 --- a/dev.md +++ b/pages/04.contribute/05.dev/dev.md @@ -1,28 +1,35 @@ -## Contributing to the YunoHost core +--- +title: Contributing to the YunoHost core +template: docs +taxonomy: + category: docs +routes: + default: '/dev' +--- You wish to add a new feature in the YunoHost core, but don't know how to proceed? This guide takes you through the various steps of the development and contribution process. If you're looking for stuff to implement or fix, the bug-tracker is -[here](https://github.com/YunoHost/issues/issues) ! +[here](https://github.com/YunoHost/issues/issues)! -**Come say hi to us in the [dev chatroom](/chat_rooms)** ! +**Come say hi to us in the [dev chat room](/chat_rooms)**! ### Setting up a development environment - **Use [ynh-dev](https://github.com/YunoHost/ynh-dev)** (see the README) to setup a development environment - locally in a virtual machine, or on a VPS. - This will setup a working YunoHost instance, using directly the git repositories + This will setup a working YunoHost instance, using directly the Git repositories (with symlinks). That way, you will be able to edit files, test your changes in real time, commit stuff and push/pull directly from your development environment. - **Implement and test your feature**. Depending on what you want to develop, you - will want to : - - **Python/CLI core** : work in `/ynh-dev/yunohost/` - - **Web administration interface** : work in `/ynh-dev/yunohost-admin/` + will want to: + - **Python/CLI core**: work in `/ynh-dev/yunohost/` + - **Web administration interface**: work in `/ynh-dev/yunohost-admin/` - You can also work on the other projects on which YunoHost is built - (SSOwat, moulinette) in similar ways + (SSOwat, Moulinette) in similar ways ### Overview of the 4 main pieces of YunoHost @@ -30,38 +37,38 @@ If you're looking for stuff to implement or fix, the bug-tracker is It is a small "homemade" framework. [Its major role](https://moulinette.readthedocs.io/en/latest/actionsmap.html) is to allow us to build both a web API and a command-line API from the same -Python code thanks to a YAML schema which we call +Python code thanks to a YAML schema which we call [the actionmap](https://github.com/YunoHost/yunohost/blob/stretch-unstable/data/actionsmap/yunohost.yml). It handles other mechanisms like authentication, internationalization and -small technical utilitary functions (e.g. reading/writing json). +small technical utilitary functions (e.g. reading/writing JSON). Moulinette has its own documentation available [here](https://moulinette.readthedocs.io/en/latest/). -#### Yunohost +#### YunoHost This piece is the very core of YunoHost. It contains: -- [the python code](https://github.com/YunoHost/yunohost/tree/stretch-unstable/src/yunohost) that manages users, domains, apps, services and other things +- [the Python code](https://github.com/YunoHost/yunohost/tree/stretch-unstable/src/yunohost) that manages users, domains, apps, services and other things - [bash helpers](https://github.com/YunoHost/yunohost/tree/stretch-unstable/data/helpers.d) mainly used by application packagers to package applications -- [hooks](https://github.com/YunoHost/yunohost/tree/stretch-unstable/data/hooks) and [templates](https://github.com/YunoHost/yunohost/tree/stretch-unstable/data/templates) that are used to configure the various pieces of the ecosystem such as nginx, postfix, ... +- [hooks](https://github.com/YunoHost/yunohost/tree/stretch-unstable/data/hooks) and [templates](https://github.com/YunoHost/yunohost/tree/stretch-unstable/data/templates) that are used to configure the various pieces of the ecosystem such as NGINX, Postfix... - [internationalized strings](https://github.com/YunoHost/yunohost/tree/stretch-unstable/locales) - [tests](https://github.com/YunoHost/yunohost/tree/stretch-unstable/src/yunohost/tests) #### SSOwat This is the single sign-on system of YunoHost. It both contains: -- [Lua scripts](https://github.com/YunoHost/ssowat) that are directly interfaced with nginx and handle all the "technical" aspects of authentication and route accesses +- [Lua scripts](https://github.com/YunoHost/ssowat) that are directly interfaced with NGINX and handle all the "technical" aspects of authentication and route accesses - the web [user portal](https://github.com/YunoHost/SSOwat/tree/stretch-unstable/portal) which is the interface used by YunoHost's end users to log in and browse installed apps SSOwat is configured through `/etc/ssowat/conf.json` which is generated by YunoHost. -#### Yunohost-admin +#### YunoHost-admin It is an *optional* dependency of YunoHost and corresponds to an interface for the web API created by YunoHost and Moulinette (c.f. the `yunohost-api` service). It essentially contains: - [view templates](https://github.com/YunoHost/yunohost-admin/tree/stretch-unstable/src/views) -- corresponding [javascript controllers](https://github.com/YunoHost/yunohost-admin/tree/stretch-unstable/src/js/yunohost/controllers) that interact with the Yunohost API +- corresponding [JavaScript controllers](https://github.com/YunoHost/yunohost-admin/tree/stretch-unstable/src/js/yunohost/controllers) that interact with the YunoHost API - and [internationalized strings](https://github.com/YunoHost/yunohost-admin/tree/stretch-unstable/src/locales) ### Working on the YunoHost Python/CLI core @@ -77,7 +84,7 @@ It essentially contains: category is `domain`, the action is `add`, and `some.domain.tld` is an argument. -- Moulinette will automatically map commands in the actionsmap to python +- Moulinette will automatically map commands in the actionsmap to Python functions (and their arguments) located in `src/yunohost/`. For example, typing `yunohost domain add some.domain.tld` will call the function `domain_add(domainName)` in `domain.py`, with the argument `domainName` equal @@ -107,50 +114,50 @@ It essentially contains: - The web interface uses the API to interact with YunoHost. The API commands/requests are also defined via the actionsmap. For instance, accessing - the page ```https://domain.tld/yunohost/api/users``` corresponds to a `GET + the page `https://domain.tld/yunohost/api/users` corresponds to a `GET /users` requests on the YunoHost API. It is mapped to the function - `user_list()`. Accessing the URL should display the json returned by this + `user_list()`. Accessing the URL should display the JSON returned by this function. 'GET' requests are typically meant to ask information to the server. 'POST' requests are meant to ask the server to edit/change some information, or to execute some actions. -- `js/yunohost/controllers` contains the javascript parts, +- `js/yunohost/controllers` contains the JavaScript parts, and define which requests to make to the API when loading a specific page of the interface, and how to process the data to generate the page, using templates. - `views` contains the various templates for the pages of the interface. In the - template, data coming from the javascript part can be used with the syntax + template, data coming from the JavaScript part can be used with the syntax `{{some-variable}}`, which will be replaced when building/accessing the page. It is also possible to have conditions using the - [handlebars.js](http://handlebarsjs.com) syntax : ```{{#if - some-variable}}Some conditional HTML code here !
{{/if}}``` + [handlebars.js](http://handlebarsjs.com) syntax: `{{#if + some-variable}}Some conditional HTML code here !
{{/if}}` - For internationalized strings, use `y18n.t('some-string-code')` in the - javascript, or `{{t 'some-string-code'}}` in the HTML template, and put your + JavaScript, or `{{t 'some-string-code'}}` in the HTML template, and put your string in `locales/en.json`. Don't edit other locales files, - this will be done using [weblate](https://translate.yunohost.org/) ! + this will be done using [Weblate](https://translate.yunohost.org/)! ##### Don't forget -- Each time you edit the actionsmap or the python code, you should restart the yunohost-api : - ```systemctl restart yunohost-api``` - (You'll need to retype your admin password in the web interface) +- Each time you edit the actionsmap or the Python code, you should restart the YunoHost api: + `systemctl restart yunohost-api` + (You'll need to retype your admin and password in the web interface) - You might need to force-clear the cache of your browser sometimes to refresh - the javascript and/or html (so each time you edit something in `js` or `views`). + the JavaScript and/or HTML (so each time you edit something in `js` or `views`). ### Your feature is ready and you want it to be integrated in YunoHost -- Fork the relevant repo on Github, and commit stuff to a new branch. We recommend - to name the branch with the following convention : - - For an enhancement or new feature : `enh-ISSUENUMBER-name-of-feature` +- Fork the relevant repo on GitHub, and commit stuff to a new branch. We recommend + to name the branch with the following convention: + - For an enhancement or new feature: `enh-ISSUENUMBER-name-of-feature` - For a bugfix `fix-ISSUENUMBER-description-of-fix` - `ISSUENUMBER` is optional and is the id of a corresponding ticket on the bug tracker. -- Once you're ready, open a Pull Request (PR) on Github. Please include `[fix]` or +- Once you're ready, open a Pull Request (PR) on GitHub. Please include `[fix]` or `[enh]` at the beginning of the title of your PR. - After reviewing, testing and validation by other contributors, your branch -should be merged in `unstable` ! +should be merged in `unstable`! diff --git a/pages/04.contribute/contributordoc.de.md b/pages/04.contribute/contributordoc.de.md new file mode 100644 index 00000000..d26d9ee1 --- /dev/null +++ b/pages/04.contribute/contributordoc.de.md @@ -0,0 +1,126 @@ +--- +title: Beteilige dich! +template: docs +taxonomy: + category: docs +routes: + default: '/contributordoc' + aliases: + - '/contribute' +--- + ++YunoHost hängt ausschließlich von der Beteiligung von Leuten wie dir ab. +
+ ++YunoHost dépend entièrement de la participation de gens comme vous. +
+ + ++YunoHost depends exclusively on the participation of people like you. +
+ +
-
-*Write down the `IP address` field visible on the screen: It is your server's **local IP address**.*
-
-
-
--*Nota el valor `IP` visible en la pantalla : esto es **la dirección IP local** de tu servidor.* -
- -
-
-
-*Notez la valeur `IP` affichée à l’écran : c’est **l’adresse IP locale** de votre serveur.*
-
-
-
diff --git a/port_forwarding_es.md b/port_forwarding_es.md
deleted file mode 100644
index 3ff93dc3..00000000
--- a/port_forwarding_es.md
+++ /dev/null
@@ -1,5 +0,0 @@
-# Redirección de puertos
-
-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.
-
-
diff --git a/port_forwarding_fr.md b/port_forwarding_fr.md
deleted file mode 100644
index 1793b27b..00000000
--- a/port_forwarding_fr.md
+++ /dev/null
@@ -1,6 +0,0 @@
-# Redirection de ports
-
-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.
-
-
diff --git a/postinstall.md b/postinstall.md
deleted file mode 100644
index bc4078da..00000000
--- a/postinstall.md
+++ /dev/null
@@ -1,67 +0,0 @@
-# Post-Installation
-
-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.
-
-### From the web interface
-
-You can perform the post-installation with the web interface by entering in your browser :
-* **the local IP address of your server** if it is on your local network (e.g. at home !). The address typically looks like `192.168.x.y` (see 'Find your IP' on [the page about SSH](/ssh))
-* **the public IP address of your server** if your server is not on your local network. Typically, if you own a VPS, your VPS provider should have given you the IP of the server.
-
-During the first visit, you will very likely encounter a security warning related to the certificate used by the server. For now, your server uses a self-signed certificate. You will later be able to add a certificate automatically recognized by web browsers as described in the [certificate documentation](/certificate). For now, you should add a security exception to accept the current certificate.
-
-You should then land on this page :
-
-
-
-Preview of the Web post-installation
- -### From the command line - -You can also perform the postinstallation with the command `yunohost tools postinstall` directly on the server, or [via SSH](/ssh). - -
-
-Preview of the command-line post-installation
- -
-
-*Vistazo de la post-instalación Web
* - -### Vía la interfaz de línea de comando - -También puedes acceder a la post-instalación entrando el comando `yunohost tools postinstall` directamente en el servidor o [en SSH](/ssh). - -
-
-*Vistazo de la post-instalación con línea de comando
* - -## Informaciones solicitadas - -### Dominio principal - -Es el nombre de dominio que permitirá el acceso a tu servidor así como al portal de autenticación de los usuarios. Entonces estará **visible por todo el mundo** : elígelo en consecuencia. - -* YunoHost te propone un DNS dinámico, proveando nombres de dominio del tipo *midominio.nohost.me*, *midominio.noho.st* o *midominio.ynh.fr*. Si no posees un nombre de dominio y/o que quieres aprovechar de este servicio, elige un dominio terminando con `.nohost.me`, `.noho.st` o `.ynh.fr`. Si no está utlizado ya, el dominio automáticamente estará vinculado a tu servidor Yunohost, y no tendrás más etapas de configuración. - -* Si, en cambio, dominas la noción de **DNS**, puedes utilizar tu propio nombre de dominio. En este caso, refiérete a la página [yunohost.org/dns](/dns) por más información. - -* Si no tienes nombre de dominio y que no quieres uno que acabe con *.nohost.me*, *.noho.st* ou *.ynh.fr*, puedes utilizar un dominio local. Más información sobre cómo [acceder a tu servidor desde la red local](/dns_local_network). - - -### Contraseña de administración - -Es la contraseña que permitirá acceder a la [interfaz de administración](/admin) de tu servidor. También podrás utilizarla para conectarte remotamente vía **SSH**, o vía **SFTP** para transferir archivos. - -De manera general, ésta es la **llave de entrada en tu sistema**, pues piensa en **[elegirla atentamente](https://es.wikihow.com/escoger-una-contrase%C3%B1a-segura)**. - -
-
-*Aperçu de la post-installation Web
* - -### Via la ligne de commande - -Vous pouvez aussi y accéder en entrant la commande `yunohost tools postinstall` directement sur le serveur ou [en SSH](/ssh). - -
-
-*Aperçu de la post-installation en ligne de commande
* - -## Informations demandées - -### Domaine principal - -C’est le nom de domaine qui permettra l’accès à votre serveur ainsi qu’au portail d’authentification des utilisateurs. Il sera donc **visible par tout le monde**, choisissez-le en conséquence. - -* YunoHost propose un service de DNS dynamique fournissant des noms de domaine de type *mondomaine.nohost.me*, *mondomaine.noho.st* ou *mondomaine.ynh.fr*. Si vous ne possédez pas de nom de domaine et/ou que vous souhaitez profiter de ce service, choisissez un domaine se terminant en `.nohost.me`, `.noho.st` ou `.ynh.fr`. S'il n'est pas déjà utilisé, le domaine sera automatiquement rattaché à votre serveur YunoHost, et vous n’aurez pas d’étape de configuration supplémentaire. - -* Si en revanche vous maîtrisez la notion de **DNS**, vous pouvez utiliser votre propre nom de domaine. Dans ce cas, référez-vous à la page [yunohost.org/dns](/dns) pour plus d’informations. - -* Si vous n'avez pas de nom de domaine et que vous n'en voulez pas en *mondomaine.nohost.me*, *mondomaine.noho.st* ou *mondomaine.ynh.fr*, vous pouvez utilisez un domaine local. Plus d'infos sur comment [accéder à son serveur depuis le réseau local](/dns_local_network). - - -### Mot de passe d’administration - -C’est le mot de passe qui vous permettra d’accéder à l’[interface d’administration](/admin) de votre serveur. Vous pourrez également l’utiliser pour vous connecter à distance via **SSH**, ou en **SFTP** pour transférer des fichiers. - -De manière générale, c’est la **clé d’entrée à votre système**, pensez donc à la **[choisir attentivement](http://www.commentcamarche.net/faq/8275-choisir-un-bon-mot-de-passe)**. - -
