Fix errors

app_collaboradocker.md

@@ -0,0 +1,28 @@
+# Install Collabora with Nextcloud, using Docker
+**Note :** This walkthrough is based on a Debian 8 instance, and has not been tested since version 3 upgrade of Yunohost. As a prerequisite, you must have configured your domains and sub-domains in the DNS, in compliance with : [DNS](/dns), [Sub-domain install of an app](/dns_subdomains), [DNS settings](/dns_config) and [noho.st / nohost.me / ynh.fr domains](/dns_nohost_me)).
+
+### 0. Install Nextcloud
+
+If Nextcloud is not already installed on your Yunohost instance, you may do so with this link : [Install Nextcloud](https://install-app.yunohost.org/?app=nextcloud)
+
+### 1. Install Collabora app within yunohost
+**In the admin interface :**
+
+Applications > Install > at the bottom _Install a custom application_ > enter this url « https://github.com/aymhce/collaboradocker_ynh  » > Enter the domain/subdomain name you wish for the Collabora application.
+
+### 2. Configuration within Nextcloud
+
+ **Add the Collabora Online application in Nextcloud :**
+
+Click on the user icon (top right) >  Applications  >  Desktop & Text > Under the « Collabora Online » tile, click on  `Activate` .
+
+**Setup Collabora in Nextcloud :**
+
+Click on the user icon (top right) > Parametres > Under _Administration_, _Collabora Online_ .
+Specify the  « Online Collabora server » with the domain name chosen during the collabora install in Yunohost (full with « https:// »).
+
+### 3. Reboot
+To allow all the pieces to work, system must be reboot. You can do so through the admin interface (Tools > Stop/reboot > `Reboot`) or via the command line interface : ``sudo reboot now``.
+
+## Debugging
+Following some system, Yunohost or app updates, Collabora may display an error message such as "It's embarrassing...". To put things back in order, you just have to restart the docker machine, with the command ``systemctl restart docker``.

app_collaboradocker_fr.md

@@ -0,0 +1,31 @@
+# Installer Collabora avec Nextcloud via Docker
+
+**Note :** la marche à suivre detaillée est réalisée ici à partir d’une instance Yunohost sur Debian 8 (celle-ci n'a pas été testée suite à la migration vers la version 3 de Yunohost). Ces instructions ont pour pré-requis que les domaines/sous-domaines sont correctement configurés au niveau des DNS et de votre instance Yunohost (voir [DNS](/dns), [DNS et installation d’une application sur un sous-domaine](/dns_subdomains), [Configurer les enregistrements DNS](/dns_config) et [Nom de domaine en noho.st / nohost.me / ynh.fr](/dns_nohost_me)).
+
+### 0. Installer Nextcloud
+
+Si l'application Nexcloud n'est pas déja installée sur votre instance Yunohost, vous pouvez l’installer depuis le lien suivant : [Installer Nextcloud](https://install-app.yunohost.org/?app=nextcloud)
+
+
+### 1. Installer l'application Collabora dans yunohost
+**dans l'interface d'administration :**
+
+Applications > Installer > En bas de la page _Installer une application personnalisée_ > Renseigner l’url « https://github.com/aymhce/collaboradocker_ynh  » > Définir le nom de domaine secondaire/sous-domaine dédié à l'application Collabora.
+
+
+### 2. Configuration dans Nextcloud
+
+ **Ajouter l'application Collabora Online à Nextcloud :**
+
+Cliquer sur l'icône de l'utilisateur en haut à droite >  Applications  >  Bureautique & texte > Sous « Collabora Online » cliquer sur  `Activer` .
+
+**Configurer Collabora sur Nextcloud :**
+
+ Cliquer sur l'icone de l'utilisateur en haut à droite >  Paramètres > Sous _Administration_, _Collabora en ligne_ .
+ Renseigner le « Serveur Collabora en ligne » par le nom de domaine choisi lors de l’installation de collabora dans yunohost (précédé de « https:// »).
+
+### 3. Reboot
+Pour permettre la mise en marche du lien collabora-Nextcloud, le système doit être rebooté. Faisable depuis l'interface d'administration : Outils > Arrêter/redémarrer > `Redémarrer`. Ou depuis la ligne de commande : ``sudo reboot now``.
+
+## Débug
+Suite à certaines mises à jour du système, de yunohost ou des applications, Collabora peut afficher un message d'erreur du type "c'est embarrassant...". Pour remettre les choses en marche, il suffit de redémarrer la machine docker, avec la commande ``systemctl restart docker``.

app_jappix.md

@@ -0,0 +1,3 @@
+#<img src="/images/jappix.png">Jappix
+
+Jappix is a web client for [XMPP](/XMPP).

app_jappix_fr.md

@@ -0,0 +1,3 @@
+#<img src="/images/jappix.png">Jappix
+
+Jappix est un client web [XMPP](/XMPP).

app_limesurvey.md

@@ -0,0 +1,12 @@
+#<img src="/images/limesurvey.png">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/)

app_limesurvey_fr.md

@@ -0,0 +1,12 @@
+#<img src="/images/limesurvey.png">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/)

app_mediawiki.md

@@ -0,0 +1,15 @@
+# Mediawiki
+
+![Mediawiki](images/Mediawiki_logo.png)
+
+MediaWiki is a free and open source software wiki package written in PHP, originally for use on Wikipedia.
+
+## Overview
+
+![Mediawiki_screenshot](images/Mediawiki_screenshot.png)
+
+## 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

app_mediawiki_fr.md

@@ -0,0 +1,15 @@
+# Mediawiki
+
+![Mediawiki](images/Mediawiki_logo.png)
+
+MediaWiki est un ensemble wiki à base de logiciels libres Open source, développé à l’origine pour Wikipédia.
+
+## Aperçu
+
+![Mediawiki_screenshot](images/Mediawiki_screenshot.png)
+
+## 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

app_minidlna.md

@@ -0,0 +1,25 @@
+# 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.

app_minidlna_fr.md

@@ -0,0 +1,25 @@
+# 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.

app_my_webapp.md

@@ -0,0 +1,20 @@
+# Documentation My_webapp
+
+In addition to the application's Readme.md, here are some useful tips.
+
+## Automatic update of the site content
+
+The application creates a new user with limited rights: it can connect (with a password) through SFTP to access the `/var/www/my_webapp` directory (or `/var/www/my_webapp__<number>` if there are several installations of this application).
+
+This configuration requires updating the site content manually, with a password connection.
+
+If you want to automate things, you need to be able to connect without typing a password (i.e. "non-interactive"). Here are the steps to follow to get there:
+- Enable public key connection, in `/etc/ssh/ssh/sshd_config`, on the server
+- Create a public/private key pair for your script on the "writing" computer - without a protective passphrase.
+- Copy the public key to the server, in `/var/www/my_webapp(__#)/.ssh/authorized_keys`
+- Set the user `webapp#` as owner of the file and directory
+- You can now connect without a password, with `sftp -b`, `lftp` or other SFTP clients.
+
+NB: The port number to use for the SFTP connection is the one used for the SSH, and configured in `/etc/ssh/sshd_config`.
+
+This tip allows you to automatically update your site. For example, the makefile of the Pelican tool allows you to use `make ftp_upload`.

app_my_webapp_fr.md

@@ -0,0 +1,20 @@
+# Documentation My_webapp
+
+En complément du Readme.md de l'application, voici des astuces utiles.
+
+## Mise à jour automatique du contenu du site.
+
+L'application créée un nouvel utilisateur avec des droits limités : il peut se connecter (avec un mot de passe) en SFTP pour accéder au dossier `/var/www/my_webapp` (ou `/var/www/my_webapp__<numero>` s'il y a plusieurs installations de cette appli).
+
+Cette configuration oblige à mettre à jour le contenu du site à la main, avec une connexion à mot de passe.
+
+Si vous souhaitez automatiser des choses, il vous faut une possibilité de connexion sans mot de passe à taper (dite "non-interactive"). Voici les étapes à suivre pour y arriver :
+- Activer la connexion par clé publique, dans `/etc/ssh/sshd_config`, sur le serveur
+- Créer une paire clé publique/privée pour votre script, sur l'ordinateur "de rédaction" - sans mettre de phrase de passe de protection.
+- Copier la clé publique sur le serveur, dans `/var/www/my_webapp(__#)/.ssh/authorized_keys`
+- Rentre l'utilisateur `webapp#` propriétaire du fichier et du dossier
+- Vous pouvez maintenant vous connecter sans mot de passe, avec `sftp -b`, `lftp` ou bien d'autres clients SFTP.
+
+NB : Le numéro de port à utiliser pour la connection SFTP est celui utilisé pour le SSH, et configuré dans `/etc/ssh/sshd_config`.
+
+Cette asctuce vous permet de mettre à jour automatiquement votre site. Par exemple, le makefile de l'outil Pelican vous permet d'utiliser `make ftp_upload`.

app_netdata.md

@@ -0,0 +1,262 @@
+## NetData
+
+[NetData](http://my-netdata.io/) is a system for **distributed real-time performance and health monitoring**.
+It provides **unparalleled insights, in real-time**, of everything happening on the
+system it runs (including applications such as web and database servers), using
+**modern interactive web dashboards**.
+
+_netdata is **fast** and **efficient**, designed to permanently run on all systems
+(**physical** & **virtual** servers, **containers**, **IoT** devices), without
+disrupting their core function._
+
+[![Install Piwigo with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=piwigo)
+
+**Customization brought by the package:**
+
+* grant MySQL statistics access via a `netdata` user
+* nginx root log statistics via putting `netdata` user in the `adm` group
+* Dovecot statistics via giving access to Dovecot stats stocket to `netdata` user (works only with Dovecot 2.2.16+)
+
+**Further recommendations:**
+We don't allow YunoHost packages to make sensible changes to system files. So here are further customizations you can make to allow more monitoring:
+
+* Nginx: 
+  * requests/connections: follow [these recommandations](https://github.com/firehol/netdata/tree/master/python.d#nginx) to enable `/stab_status` (for example by putting the `location` section in `/etc/nginx/conf.d/yunohost_admin.conf`
+  * weblogs: you can monitor all your nginx weblogs for errors; follow [these recommendations](https://github.com/firehol/netdata/tree/master/python.d#nginx_log)
+* phpfpm: follow [these recommandations](https://github.com/firehol/netdata/tree/master/python.d#phpfpm)
+
+## Features
+
+<p align="center">
+<img src="https://cloud.githubusercontent.com/assets/2662304/19168687/f6a567be-8c19-11e6-8561-ce8d589e8346.gif"/>
+</p>
+
+ - **Stunning interactive bootstrap dashboards**<br/>
+   mouse and touch friendly, in 2 themes: dark, light
+
+ - **Amazingly fast**<br/>
+   responds to all queries in less than 0.5 ms per metric,
+   even on low-end hardware
+
+ - **Highly efficient**<br/>
+   collects thousands of metrics per server per second,
+   with just 1% CPU utilization of a single core, a few MB of RAM and no disk I/O at all
+
+ - **Sophisticated alarming**<br/>
+   hundreds of alarms, **out of the box**!<br/>
+   supports dynamic thresholds, hysteresis, alarm templates,
+   multiple role-based notification methods (such as email, slack.com,
+   pushover.net, pushbullet.com, telegram.org, twilio.com, messagebird.com)
+
+ - **Extensible**<br/>
+   you can monitor anything you can get a metric for,
+   using its Plugin API (anything can be a netdata plugin,
+   BASH, python, perl, node.js, java, Go, ruby, etc)
+
+ - **Embeddable**<br/>
+   it can run anywhere a Linux kernel runs (even IoT)
+   and its charts can be embedded on your web pages too
+
+ - **Customizable**<br/>
+   custom dashboards can be built using simple HTML (no javascript necessary)
+
+ - **Zero configuration**<br/>
+   auto-detects everything, it can collect up to 5000 metrics
+   per server out of the box
+
+ - **Zero dependencies**<br/>
+   it is even its own web server, for its static web files and its web API
+
+ - **Zero maintenance**<br/>
+   you just run it, it does the rest
+
+ - **scales to infinity**<br/>
+   requiring minimal central resources
+
+ - **several operating modes**<br/>
+   autonomous host monitoring, headless data collector, forwarding proxy, store and forward proxy, central multi-host monitoring, in all possible configurations.
+   Each node may have different metrics retention policy and run with or without health monitoring.
+
+ - **time-series back-ends supported**<br/>
+   can archive its metrics on `graphite`, `opentsdb`, `prometheus`, json document DBs, in the same or lower detail
+   (lower: to prevent it from congesting these servers due to the amount of data collected)
+
+![netdata](https://cloud.githubusercontent.com/assets/2662304/14092712/93b039ea-f551-11e5-822c-beadbf2b2a2e.gif)
+
+---
+
+## What does it monitor?
+
+netdata collects several thousands of metrics per device.
+All these metrics are collected and visualized in real-time.
+
+> _Almost all metrics are auto-detected, without any configuration._
+
+This is a list of what it currently monitors:
+
+- **CPU**<br/>
+  usage, interrupts, softirqs, frequency, total and per core, CPU states
+
+- **Memory**<br/>
+  RAM, swap and kernel memory usage, KSM (Kernel Samepage Merging), NUMA
+
+- **Disks**<br/>
+  per disk: I/O, operations, backlog, utilization, space, software RAID (md)
+
+   ![sda](https://cloud.githubusercontent.com/assets/2662304/14093195/c882bbf4-f554-11e5-8863-1788d643d2c0.gif)
+
+- **Network interfaces**<br/>
+  per interface: bandwidth, packets, errors, drops
+
+   ![dsl0](https://cloud.githubusercontent.com/assets/2662304/14093128/4d566494-f554-11e5-8ee4-5392e0ac51f0.gif)
+
+- **IPv4 networking**<br/>
+  bandwidth, packets, errors, fragments,
+  tcp: connections, packets, errors, handshake,
+  udp: packets, errors,
+  broadcast: bandwidth, packets,
+  multicast: bandwidth, packets
+
+- **IPv6 networking**<br/>
+  bandwidth, packets, errors, fragments, ECT,
+  udp: packets, errors,
+  udplite: packets, errors,
+  broadcast: bandwidth,
+  multicast: bandwidth, packets,
+  icmp: messages, errors, echos, router, neighbor, MLDv2, group membership,
+  break down by type
+
+- **Interprocess Communication - IPC**<br/>
+  such as semaphores and semaphores arrays
+
+- **netfilter / iptables Linux firewall**<br/>
+  connections, connection tracker events, errors
+
+- **Linux DDoS protection**<br/>
+  SYNPROXY metrics
+
+- **fping** latencies</br>
+  for any number of hosts, showing latency, packets and packet loss
+
+   ![image](https://cloud.githubusercontent.com/assets/2662304/20464811/9517d2b4-af57-11e6-8361-f6cc57541cd7.png)
+
+
+- **Processes**<br/>
+  running, blocked, forks, active
+
+- **Entropy**<br/>
+  random numbers pool, using in cryptography
+
+- **NFS file servers and clients**<br/>
+  NFS v2, v3, v4: I/O, cache, read ahead, RPC calls
+
+- **Network QoS**<br/>
+  the only tool that visualizes network `tc` classes in realtime
+
+   ![qos-tc-classes](https://cloud.githubusercontent.com/assets/2662304/14093004/68966020-f553-11e5-98fe-ffee2086fafd.gif)
+
+- **Linux Control Groups**<br/>
+  containers: systemd, lxc, docker
+
+- **Applications**<br/>
+  by grouping the process tree and reporting CPU, memory, disk reads,
+  disk writes, swap, threads, pipes, sockets - per group
+
+   ![apps](https://cloud.githubusercontent.com/assets/2662304/14093565/67c4002c-f557-11e5-86bd-0154f5135def.gif)
+
+- **Users and User Groups resource usage**<br/>
+  by summarizing the process tree per user and group,
+  reporting: CPU, memory, disk reads, disk writes, swap, threads, pipes, sockets
+
+- **Apache and lighttpd web servers**<br/>
+   `mod-status` (v2.2, v2.4) and cache log statistics, for multiple servers
+
+- **Nginx web servers**<br/>
+  `stub-status`, for multiple servers
+
+- **Tomcat**<br/>
+  accesses, threads, free memory, volume
+
+- **web server log files**<br/>
+  extracting in real-time, web server performance metrics and applying several health checks
+
+- **mySQL databases**<br/>
+  multiple servers, each showing: bandwidth, queries/s, handlers, locks, issues,
+  tmp operations, connections, binlog metrics, threads, innodb metrics, and more
+
+- **Postgres databases**<br/>
+  multiple servers, each showing: per database statistics (connections, tuples
+  read - written - returned, transactions, locks), backend processes, indexes,
+  tables, write ahead, background writer and more
+
+- **Redis databases**<br/>
+  multiple servers, each showing: operations, hit rate, memory, keys, clients, slaves
+
+- **mongodb**<br/>
+  operations, clients, transactions, cursors, connections, asserts, locks, etc
+
+- **memcached databases**<br/>
+  multiple servers, each showing: bandwidth, connections, items
+
+- **elasticsearch**<br/>
+  search and index performance, latency, timings, cluster statistics, threads statistics, etc
+
+- **ISC Bind name servers**<br/>
+  multiple servers, each showing: clients, requests, queries, updates, failures and several per view metrics
+
+- **NSD name servers**<br/>
+  queries, zones, protocols, query types, transfers, etc.
+
+- **Postfix email servers**<br/>
+  message queue (entries, size)
+
+- **exim email servers**<br/>
+  message queue (emails queued)
+
+- **Dovecot** POP3/IMAP servers<br/>
+
+- **ISC dhcpd**<br/>
+  pools utilization, leases, etc.
+
+- **IPFS**<br/>
+  bandwidth, peers
+
+- **Squid proxy servers**<br/>
+  multiple servers, each showing: clients bandwidth and requests, servers bandwidth and requests
+
+- **HAproxy**<br/>
+  bandwidth, sessions, backends, etc
+
+- **varnish**<br/>
+  threads, sessions, hits, objects, backends, etc
+
+- **OpenVPN**<br/>
+  status per tunnel
+
+- **Hardware sensors**<br/>
+  `lm_sensors` and `IPMI`: temperature, voltage, fans, power, humidity
+
+- **NUT and APC UPSes**<br/>
+  load, charge, battery voltage, temperature, utility metrics, output metrics
+
+- **PHP-FPM**<br/>
+  multiple instances, each reporting connections, requests, performance
+
+- **hddtemp**<br/>
+  disk temperatures
+
+- **smartd**<br/>
+  disk S.M.A.R.T. values
+
+- **SNMP devices**<br/>
+  can be monitored too (although you will need to configure these)
+
+- **statsd**<br/>
+  [netdata is a fully featured statsd server](https://github.com/firehol/netdata/wiki/statsd)
+
+And you can extend it, by writing plugins that collect data from any source, using any computer language.
+
+## Links
+
+ * Report a bug: https://github.com/YunoHost-Apps/netdata_ynh/issues
+ * NetData website: http://my-netdata.io/

app_nextcloud.md

@@ -0,0 +1,169 @@
+# <img src="/images/nextcloud_logo.png" alt="logo de Nextcloud"> Nextcloud  
+
+ - [Discovering the Nextcloud environment](#EnvironmentNextcloud)  
+ - [Mobile and computer client software](#ClientSoftware)  
+ - [Useful Manipulations & Problems Encountered](#UtileManipulations)  
+    - [Add space to Nextcloud](#AddSpace)  
+ - [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).
+
+## Discovering the Nextcloud environment <a name="EnvironmentNextcloud" href=""></a>
+
+Due to the creation of Nextcloud, a database with third-party applications to install, this chapter will only concern the nextcloud database without added applications. More information on applications in the dedicated section or in the nextcloud application catalogue: [apps.nextcloud.com](https://apps.nextcloud.com).  
+Nextcloud is before a cloud service (like Seafile and others), it allows synchronization and file sharing on the Internet and between several terminals (computers, smartphone) but also with several people. 
+
+## Mobile and computer client software <a name="ClientSoftware" href=""></a>
+
+There are client software for all platforms. You can find them on the official nextcloud website: https://nextcloud.com/install/#install-clients
+
+## Useful Manipulations & Problems Encountered <a name="UtileManipulations" href=""></a>
+
+### Add storage space <a name="AddSpace" href=""></a>
+
+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.
+
+#### I. Add an external storage space
+
+Parameter =>[Administration] External storage.
+
+At the bottom of the list you can add a folder (It is possible to define a subfolder using the `folder/subfolder` convention.)  
+Select a storage type and specify the requested connection information.  
+You can restrict this folder to one or more nextcloud users with the column `Available for`.  
+With the gear you can allow or prohibit previewing and file sharing.  
+Finally click on the check mark to validate the folder.
+
+#### II. Migrate Nextcloud data to a larger partition
+
+**Note**: The following assumes that you have a hard disk mounted on `/media/storage`. Refer to[this article](/external_storage) to prepare your system.
+
+**Note**: Replace `nextcloud` with the name of its instance, if you have several Nextcloud apps installed.
+
+First turn off the web server with the command:
+```bash
+systemctl stop nginx  
+```
+
+##### Choice of location
+
+**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.
+
+```bash
+chown -R nextcloud:nextcloud /media/storage
+chmod 775 -R /media/storage
+```
+
+**Case B: Shared storage, data already present, Nextcloud data in a subfolder**
+
+If you want to use this disk for other applications, you can create a subfolder belonging to Nextcloud.
+
+```bash
+mkdir -p /media/storage/nextcloud_data
+chown -R nextcloud /media/storage/nextcloud_data
+chmod 775 -R /media/storage/nextcloud_data
+```
+
+##### Migrate data
+
+Migrate your data to the new disk. To do this *(be patient, it can take a long time)*:
+
+```bash
+Case A: cp -ia /home/yunohost.app/nextcloud /media/storage
+Case B: cp -ia /home/yunohost.app/nextcloud /media/storage/nextcloud_data
+```
+
+The `i` option allows you to ask yourself what to do if there is a file conflict, especially if you overwrite an old Owncloud or Nextcloud data folder.  
+To check that everything went well, compare what these two commands display (the content must be identical):
+
+```bash
+ls -la /home/yunohost.app/nextcloud
+
+Case A: ls -al /media/storage
+Case B: ls -al /media/storage/nextcloud_data/nextcloud
+```
+
+##### Configure Nextcloud
+
+To inform Nextcloud of its new directory, modify the `/var/www/nextcloud/config/config.php` file with the command:
+
+```bash
+nano /var/www/nextcloud/config/config.php
+```
+
+Look for the line:
+
+```bash
+'datadirectory' => '/home/yunohost.app/nextcloud/data',
+```
+
+That you modify:
+
+```bash
+CASE A:'datadirectory' =>'/media/storage',
+CASE B:'datadirectory' =>'/media/storage/nextcloud_data/nextcloud/data',
+```
+
+Back up with `ctrl+x` then `y` or `o` (depending on your server locale).
+
+Restart the web server:
+
+```bash
+systemctl start nginx
+```
+
+Add the.ocdata file
+```bash
+CASE A: nano /media/storage/.ocdata
+CASE B: nano /media/storage/nextcloud_data/nextcloud/data/.ocdata
+```
+Add a space to the file to be able to save it
+
+Back up with `ctrl+x` then `y` or `o` (depending on your server locale).
+
+Run a scan of the new directory by Nextcloud:
+
+```bash
+cd /var/www/nextcloud
+sudo -u nextcloud php occ files:scan --all
+```
+
+It's over now. Now test if everything is fine, try connecting to your Nextcloud instance, upload a file, check its proper synchronization.
+
+### 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:
+
+#### 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  
+
+##### Add a rule
+
+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
+
+The options to disable (Off) are:
+
+- Rocket Loader
+- Email Obfuscation
+
+Save and clean your caches (Cloudflare, browser,...) and that's it.
+
+## Third Party Applications <a name="AppsTiers" href=""></a>
+
+ - [Calendrier](app_nextcloud_calendar)
+ - [contact](app_nextcloud_contact)
+ - [KeeWeb](app_nextcloud_keeweb)
+ - [Carnet](app_nextcloud_carnet)
+
+## Useful links <a name="UsefulLinks" href=""></a>
+
+ - Official website : [nextcloud.com](https://nextcloud.com/)  
+ - Application catalogue for nextcloud : [apps.nextcloud.com](https://apps.nextcloud.com/)  

app_nextcloud_calendar.md

@@ -0,0 +1 @@
+default.md

app_nextcloud_carnet.md

@@ -0,0 +1 @@
+default.md

app_nextcloud_contact.md

@@ -0,0 +1 @@
+default.md

app_nextcloud_fr.md

@@ -0,0 +1,169 @@
+# <img src="/images/nextcloud_logo.png" alt="logo de Nextcloud"> Nextcloud  
+
+ - [Découverte de l'environnement de Nextcloud](#EnvironnementNextcloud)
+ - [Logiciels Clients pour mobile et ordinateur](#LogicielsClients)
+ - [Manipulations & Problèmes rencontrés utiles](#ManipulationsUtiles)
+    - [Ajouter de l'espace à Nextcloud](#AjoutEspace)
+ - [Applications tiers](#AppsTiers)
+ - [Liens utiles](#liensutiles)
+
+Nextcloud est un service d'hébergement de fichiers, de nombreuses applications peuvent être installées afin de lui offrir de nouvelles fonctionnalités tel qu'un agenda, un répertoire de contacts, des notes et pleins d'autres possibles (vous pouvez trouver quelques applications dans la partie [applications tiers](#AppsTiers) mais il en existe une multitude suivant vos besoins).
+
+## Découverte de l'environnement de Nextcloud<a name="EnvironnementNextcloud" href=""></a>
+
+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<a name="LogicielsClients" href=""></a>
+
+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<a name="ManipulationsUtiles" href=""></a>
+
+### Ajouter de l'espace à Nextcloud<a name="AjoutEspace" href=""></a>
+
+La solution I. permet d'ajouter un lien vers un dossier local ou distant.  
+La solution II. permet de déplacer l'espace de stockage principal de nextcloud.
+
+#### I. Ajouter un espace de stockage externe
+
+Paramètre => [Administration] Stockages externe.
+
+En bas de la liste vous pouvez rajouter un dossier (Il est possible de définir un sous dossier en utilisant la convention `dossier/sousDossier`.)  
+Sélectionner un type de stockage et indiquez les information de connexion demandés.  
+Vous pouvez restreindre ce dossier à un ou plusieurs utilisateurs nextcloud avec la colonne `Disponible pour`.  
+Avec l'engrenage vous pouvez autoriser ou interdire la prévisualisation et le partage des fichiers.  
+Enfin cliquer sur la coche pour valider le dossier.
+
+#### II. Migrer les données de Nextcloud dans une partition plus grosse
+
+**Remarque** : Ce qui suit suppose que vous avez un disque dur monté sur `/media/stockage`. Référez-vous à [cet article](/external_storage) pour préparer votre système.
+
+**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:
+```bash
+systemctl stop nginx  
+```
+
+##### Choix de l'emplacement
+
+**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.
+
+```bash
+chown -R nextcloud:nextcloud /media/stockage
+chmod 775 -R /media/stockage
+```
+
+**Cas B : Stockage partagé, données déjà présentes, données Nextcloud dans un sous-dossier**
+
+Si vous souhaitez utiliser ce disque pour d'autres applications, vous pouvez créer un sous-dossier appartenant à Nextcloud.
+
+```bash
+mkdir -p /media/stockage/nextcloud_data
+chown -R nextcloud /media/stockage/nextcloud_data
+chmod 775 -R /media/stockage/nextcloud_data
+```
+
+##### Migrer les données
+
+Migrez vos données vers le nouveau disque. Pour ce faire *(soyez patient, cela peut être long)* :
+
+```bash
+Cas A : cp -ir /home/yunohost.app/nextcloud /media/stockage
+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):
+
+```bash
+ls -la /home/yunohost.app/nextcloud
+
+Cas A : ls -al /media/stockage
+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:
+
+```bash
+nano /var/www/nextcloud/config/config.php
+```
+
+Cherchez la ligne:
+
+```bash
+'datadirectory' => '/home/yunohost.app/nextcloud/data',
+```
+
+Que vous modifiez :
+
+```bash
+CAS A : 'datadirectory' => '/media/stockage',
+CAS B : 'datadirectory' => '/media/stockage/nextcloud_data/nextcloud/data',
+```
+
+Sauvegardez avec `ctrl+x` puis `y` ou `o` (dépend de la locale de votre serveur).
+
+Relancez le serveur web :
+
+```bash
+systemctl start nginx
+```
+
+Ajouter le fichier .ocdata
+```bash
+CAS A : nano /media/stockage/.ocdata
+CAS B : nano /media/stockage/nextcloud_data/nextcloud/data/.ocdata
+```
+Ajouter un espace au fichier pour pouvoir le sauvegarder
+
+Sauvegardez avec `ctrl+x` puis `y` ou `o` (dépend de la locale de votre serveur).
+
+Lancez un scan du nouveau répertoire par Nextcloud:
+
+```bash
+cd /var/www/nextcloud
+sudo -u nextcloud php occ files:scan --all
+```
+
+C'est terminé. À présent testez si tout va bien, essayez de vous connecter à votre instance Nextcloud, envoyer un fichier, vérifiez sa bonne synchronisation.
+
+
+### Nextcloud et Cloudflare
+
+Si vous utilisez Cloudflare pour vos DNS, *ce qui peut-être pratique si vous avez une IP dynamique*, vous aurez très probablement des problèmes d'authentification avec l'application Nextcloud. Sur Internet beaucoup de gens proposent de créer une règle ayant pour effet de désactiver toutes les options reliées à la sécurité et à la vitesse de Cloudflare pour l'URL pointant sur votre instance Nextcloud. Bien que cela fonctionne, ce n'est pas la solution optimale. Je vous propose, certes de créer une règle pour l'URL pointant sur votre instance Nextcloud, mais de désactiver seulement 2 options. Voici donc comment :
+
+#### Cloudflare Page Rules
+
+Dans le panneau de contrôle de Cloudflare, choisissez votre domaine et trouvez Page Rules
+l'URL dans votre barre d'addresse ressemblera à : https://dash.cloudflare.com/*/domain.tld/page-rules
+
+#### Ajouter une règle
+
+La règle à ajouter doit s'appliquer pour l'URL de votre instance Nextcloud soit :
+- `https://nextcloud.domain.tld/*` si vous utilisez un sous-domaine
+- `https://domain.tld/nextcloud/*` si vous avez déployé Nextcloud dans un répertoire
+
+Les options à désactiver (Off) sont :
+
+- Rocket Loader
+- Email Obfuscation
+
+Sauvegarder et nettoyer vos caches (Cloudflare, navigateur, ...) et le tour est joué.
+
+## Applications Tiers<a name="AppsTiers" href=""></a>
+
+ + [Calendrier](/app_nextcloud_calendar)
+ + [contact](/app_nextcloud_contact)
+ + [KeeWeb](/app_nextcloud_keeweb)
+ + [Carnet](/app_nextcloud_carnet)
+
+## Quelques liens utiles<a name="liensutiles" href=""></a>
+
++ Site officiel : [nextcloud.com (en)](https://nextcloud.com/)
++ Catalogue d'application pour nextcloud : [apps.nextcloud.com](https://apps.nextcloud.com/)

app_nextcloud_keeweb.md

@@ -0,0 +1,35 @@
+# The KeeWeb application for NextCloud
+
+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.

app_nextcloud_keeweb_fr.md

@@ -0,0 +1,38 @@
+# L'application KeeWeb pour NextCloud
+
+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
+```
+
+A présent, le problème est corrigé.

app_noalyss.md

@@ -0,0 +1,13 @@
+# Noalyss
+
+Open source accounting software developed in PHP.
+
+All the information on this software is available on the [project website](http://www.noalyss.eu)
+
+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)
+
+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

app_noalyss_fr.md

@@ -0,0 +1,13 @@
+# Noalyss
+
+Logiciel de comptabilité open source développé en PHP.
+
+Toute les infos sur ce logiciel sont disponible sur le [site du projet](http://www.noalyss.eu)
+
+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)
+
+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

app_peertube.md

@@ -0,0 +1,3 @@
+# Peertube
+
+PeerTube is a federated (ActivityPub) video streaming platform using P2P (BitTorrent) directly in the web browser, using WebTorrent.

app_peertube_fr.md

@@ -0,0 +1,16 @@
+# <img src="/images/peertube_logo.png" alt="Logo de PeerTube">  PeerTube
+
+[![Installer PeerTube avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](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)  
+
+<iframe width="560" height="315" sandbox="allow-same-origin allow-scripts" src="https://framatube.org/videos/embed/9db9f3f1-9b54-44ed-9e91-461d262d2205" frameborder="0" allowfullscreen></iframe>
+
+## 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)

app_pihole.md

@@ -0,0 +1,5 @@
+===== Pihole =====
+
+Homepage: https://pi-hole.net
+
+**Pi-hole®** Network-wide ad blocking via your own DNS server, with nice Performance And Statistics web page.

app_pihole_fr.md

@@ -0,0 +1,70 @@
+# <img src="/images/pihole_logo.png" alt="logo de Pi-hole"> Pi-hole
+
+[![Installer Pi-hole avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=pihole)[![Niveau d'intégration](https://dash.yunohost.org/integration/pihole.svg)](https://dash.yunohost.org/appci/app/pihole) ![](https://ci-apps.yunohost.org/ci/badges/pihole.status.svg) ![](https://ci-apps.yunohost.org/ci/badges/pihole.maintain.svg)
+
+- [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-reseau)
+- [Liens utiles](#quelques-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 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.
+
+## Quelques liens utiles
+
++ Site officiel : [pi-hole.net](https://pi-hole.net)
++ Documentation Pi-Hole : [docs.pi-hole.net](https://docs.pi-hole.net/)

app_piwigo.md

@@ -0,0 +1,32 @@
+## <img src="https://yunohost.org/images/piwigo.png">
+
+
+
+
+[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.
+
+[![Install Piwigo with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=piwigo)
+
+![](http://piwigo.org/screenshots/homepage/piwigo-batch-manager.png)
+
+## 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/
+
+

app_piwigo_fr.md

@@ -0,0 +1,30 @@
+## <img src="https://yunohost.org/images/piwigo.png">
+
+
+
+
+[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.
+
+[![Installer Piwigo avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=piwigo)
+
+![](http://piwigo.org/screenshots/homepage/piwigo-batch-manager.png)
+
+## 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/
+
+

app_pleroma.md

@@ -0,0 +1 @@
+Unfortunately, this page only exists [in french here](app_pleroma_fr) for now.

app_pleroma_fr.md

@@ -0,0 +1,52 @@
+# <img src="/images/pleroma_logo.png" alt="logo de Pleroma"> Pleroma
+
+ - [Découverte de l'interface de Pleroma](#d%C3%A9couverte-de-linterface-de-pleroma)
+ - [Logiciels Clients pour mobile et ordinateur](#applications-clients)
+ - [Liens utiles](#quelques-liens-utiles)
+
+Pleroma est un réseau social décentralisé de micro-blogging qui propose une alternative à Twitter, le protocole [Activy Pub](https://en.wikipedia.org/wiki/ActivityPub) qu'il utilise permet d'interagir avec le [fediverse](https://fediverse.party/en/fediverse) composé notamment de Mastodon, GNU Social, et d'autres. Il a l'avantage d'être plus léger que mastodon et se prête donc plus facilement à l'auto-hébergement.
+
+## Découverte de l'interface de Pleroma
+
+Pour celles et ceux qui n'ont pas ou peu l'habitude des réseaux sociaux, voici en détail l'utilisation de chacune des fenêtres proposées :
+
+### Accueil de l'interface
+
+<img src="/images/capture_globale.png" alt="Capture écran accueil de Pleroma">
+
+1. Barre de menu  
+   + <img src="/images/capture_menu_gauche.png" alt="Capture du bouton à gauche de la 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*.
+   + <img src="/images/capture_menu_droite.png" alt="Capture des boutons à droite de la barre de menu"> 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 : 
+      + <img src="/images/capture_menu_droite_chercher_utilisateur.png" alt="Capture bouton chercher un⋅e utilisateur⋅trice"> 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*) 
+      + <img src="/images/capture_menu_droite_preferences.png" alt="Capture bouton préférences"> 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).
+      + <img src="/images/capture_menu_droite_deconnexion.png" alt="Capture Déconnexion"> 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    
+<img src="/images/capture_espace_connexion.png" alt="Fenêtre de connexion à la place de la zone de publications"> 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é. 
+
+4. Le journal  
+Cette zone permet de voir les différentes publications des comptes que vous suivez mais aussi l'ensemble des publications visibles sur votre instance. Vous trouverez aussi les messages privés et les notifications où vous trouverez tous vos toots et les publications où vous avez été cité⋅e.
+
+5. Interface utilisateur·trice  
+Cet espace permet de choisir l'agencement de Pleroma, il est proposé deux agencements : un spécifique à Pleroma et un fork (une copie) de l'agencement de Mastodon, selon vos préférences d'usages et de visualisations ; à vous de faire votre choix.
+
+6. Notifications  
+On retrouve dans cette zone les messages où vous avez été cité⋅e, mais aussi les abonnements à votre compte.
+
+## Applications clients
+
+| Nom de l'applications | Plateforme | Multi-comptes | Autre réseaux supportés | Play Store | F-Droid | Apple Store |
+|---|---|---|---|---|---|---|
+| Tusky | Android | Oui | Mastodon | [https://play.google.com/id=com.keylesspalace.tusky](https://play.google.com/store/apps/details?id=com.keylesspalace.tusky) | [f-droid.org/com.keylesspalace.tusky](https://f-droid.org/fr/packages/com.keylesspalace.tusky/) |  
+| Fedilab | Android | Oui | Mastodon, Pleroma, Peertube, GNU Social, Friendica, Pixelfed | [play.google.com/app.fedilab.android](https://play.google.com/store/apps/details?id=app.fedilab.android&hl=fr) | [f-droid.org//fr.gouv.etalab.mastodon](https:/f-droid.org/fr/packages/fr.gouv.etalab.mastodon/)
+| Twidere | Android | Oui | Twitter, Mastodon | [play.google.com/org.mariotaku.twidere](https://play.google.com/store/apps/details?id=org.mariotaku.twidere) | [https://f-droid.org/org.mariotaku.twidere](https://f-droid.org/fr/packages/org.mariotaku.twidere/) | 
+| Librem Social | Android | Non | ? | [play.google.com/one.librem.social](https://play.google.com/store/apps/details?id=one.librem.social&hl=fr) | [https://f-droid.org/one.librem.social](https://f-droid.org/fr/packages/one.librem.social) | |
+
+## Quelques liens utiles
+
++ Site officiel : [pleroma.social (En anglais)](https://pleroma.social)
++ Trouver d'autres instances de Pleroma : [fediverse.network/pleroma](https://fediverse.network/pleroma)

app_pluxml.md

@@ -0,0 +1,23 @@
+# PluXml
+
+![PluXml_logo](images/PluXml_logo.png)
+
+PluXml is a blog/CMS storing data in XML and not in a SQL database.
+
+## Overview
+
+![PluXml_screenshot](images/PluXml_screenshot.jpg)
+
+## Plugins and themes
+
+Plugins and themes should respectively be installed in the following folders : `/var/www/pluxml/plugins`, `/var/www/pluxml/themes`.
+
+## Backup
+
+To restore your blog, you should keep a copy of the folder `/var/www/pluxml/data`. It is recommended to do this backup before any upgrade.
+
+## Link
+
+PluXml : https://www.pluxml.org/  
+Documentation : https://wiki.pluxml.org/  
+Forum : https://forum.pluxml.org/

app_pluxml_fr.md

@@ -0,0 +1,23 @@
+# PluXml
+
+![PluXml_logo](images/PluXml_logo.png)
+
+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
+
+![PluXml_screenshot](images/PluXml_screenshot.jpg)
+
+## Plugins et thèmes
+
+Les plugins et thèmes doivent être installés manuellement respectivement dans les dossiers `/var/www/pluxml/plugins` et `/var/www/pluxml/themes`.
+
+## Sauvegarde
+
+Pour sauvegarder votre blog, il est nécessaire de réaliser une copie du dossier `/var/www/pluxml/data`. Cette procédure de sauvegarde est également recommandée avant toute mise à jour de l'application.
+
+## Liens
+
+PluXml : https://www.pluxml.org/  
+Documentation : https://wiki.pluxml.org/  
+Forum : https://forum.pluxml.org/

app_radicale.md

@@ -0,0 +1,100 @@
+# Radicale
+
+Radical 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.
+
+To connect another client to radical, we must inform these addresses:
+
+### Complete CalDAV/CardDAV collection of a user
+- URL: https://domain.tld/path/user/
+- Exemple : https://example.org/radicale/me/
+
+### To connect a calendar in particular
+- URL: https://domain.tld/path/user/calendar.ics/
+- Exemple: https://example.org/radicale/me/calendar.ics/
+
+### To connect an address book in particular
+- URL: https://domain.tld/path/user/AddressBook.vcf/
+- 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.
+
+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.
+
+### Go to a calendar or an address book of another user
+Previous addresses also work to access resources not owned by the authenticated user.
+
+> Example:  
+> User1 can connect to the collection of user2  
+> https://example.org/radicale/user2/  
+> Simply to indicate the login and password of user1.  
+> It's sharing rules (see below) that will allow or not to user1 to see the contents of the collection of user2.  
+> By default, no sharing is allowed.
+
+---
+
+### Configure the access rights and sharing of calendars and address books
+By default, any user has the right to read and write on its own calendars and address books.  
+It is possible to refine these default rules and to allow sharing by allowing users to access their resources do not own.  
+The rules governing these rights should be included in the */etc/radicale/rights*
+
+Each rule is in this form:
+```bash
+# Comment before rule and explaining that (optional of course):
+[Rule Name]
+user: user concerned
+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.
+```bash
+sudo service uwsgi restart
+```
+
+### Share resources
+To share a calendar or address book, just write a rule permitting. Sharing can be done with another user.
+```bash
+user: ^user1$
+collection: ^user2/shared2.ics$
+permission: rw
+```
+Or publicly for a remote user does not use the same server.
+```bash
+user: .*
+collection: ^user2/shared2.ics$
+permission: r
+```
+In both cases, the sharing works only using the full address of the calendar or collection. In other words, the shares do not appear in the collection of a user.  
+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 ...
+
+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.
+```bash
+ln -sr user2/shared.ics user1/user2_shared.ics
+```
+The shared resource becomes a resource from the collection of user1, while it physically remains in the collection of user2.  
+However, without recourse to the rules for each resource in the collection of user1, the general rule applies. user1 gets so read and write access by default on the shared resource because it is part of his collection.
+
+---
+
+### 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.  
+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.
+
+---
+
+### Change config of InfCloud
+The configuration of InfCloud is in the *infcloud/config.js* file  
+To load any changes in the *config.js* file (or other file of InfCloud) must reload the cache with the script provided.
+```bash
+sudo ./cache_update.sh
+```

app_radicale_fr.md

@@ -0,0 +1,100 @@
+# Radicale
+
+Radicale est un serveur de calendrier et de contact CalDAV/CardDAV. Il ne dispose pas d’interface graphique d’administration.
+
+Radicale est installé par défaut avec le client web InfCloud qui permettra de visualiser et de modifier vos calendriers et carnets d’adresses.
+
+Pour connecter un autre client au serveur radicale, il faut renseigner ces adresses :
+
+### Collection CalDAV/CardDAV complète d’un utilisateur
+- URL : https://domain.tld/path/user/
+- Exemple : https://example.org/radicale/moi/
+
+### Pour connecter un calendrier en particulier
+- URL : https://domain.tld/path/user/calendar.ics/
+- Exemple : https://example.org/radicale/moi/calendar.ics/
+
+### Pour connecter un carnet d’adresses en particulier
+- URL : https://domain.tld/path/user/AddressBook.vcf/
+- 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.
+
+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.
+
+### Accéder à un calendrier ou un carnet d’adresses d’un autre utilisateur
+Les adresses précédentes fonctionnent également pour accéder à des ressources n’appartenant pas à l’utilisateur authentifié.
+
+> Exemple :
+> User1 peut se connecter à la collection de user2  
+> https://example.org/radicale/user2/  
+> Il lui suffira d’indiquer le login et mot de passe de user1.
+> Ce sont les règles de partage (voir ci-dessous) qui permettront ou pas à user1 de voir le contenu de la collection de user2.  
+> Par défaut, aucun partage n’est autorisé.
+
+---
+
+### Configurer les droits d’accès et les partages de calendriers et de carnets d’adresses
+Par défaut, tout utilisateur a le droit de lecture et d’écriture sur ses propres calendriers et carnets d’adresses.
+Il est toutefois possible d’affiner ces règles par défaut et d’autoriser des partages en autorisant des utilisateurs à accéder à des ressources ne leurs appartenant pas.
+Les règles régissant ces droits doivent être inscrite dans le fichier */etc/radicale/rights*
+
+Chaque règle se présente sous cette forme:
+```bash
+## Commentaire précédant la règle et l’expliquant (optionnel évidemment)
+[Nom de la règle]
+user: utilisateur concerné
+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.
+```bash
+sudo service uwsgi restart
+```
+
+### Partager des ressources
+Pour partager un calendrier ou un carnet d’adresses, il suffit d’écrire une règle le permettant. Le partage peut se faire avec un autre utilisateur.
+```bash
+user: ^user1$
+collection: ^user2/shared2.ics$
+permission: rw
+```
+Ou publiquement pour un utilisateur distant n’utilisant pas le même serveur.
+```bash
+user: .*
+collection: ^user2/shared2$
+permission: r
+```
+Dans les deux cas, le partage ne fonctionnera qu’en utilisant l’adresse complète du calendrier ou de la collection. Autrement dit, les partages n’apparaissent pas dans la collection d’un utilisateur.
+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…
+
+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.
+```bash
+ln -sr user2/shared.ics user1/user2_shared.ics
+```
+La ressource partagée devient ainsi une ressource de la collection de user1, alors qu’elle reste physiquement dans la collection de user2.
+En revanche, sans avoir recours à des règles pour chaque ressource de la collection de user1, la règle générale s’applique. user1 obtient donc le droit de lecture ET d’écriture par défaut sur la ressource partagée, car elle fait partie de sa collection.
+
+---
+
+### 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.  
+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.
+
+---
+
+### Modifier la configuration de InfCloud
+La configuration de InfCloud se trouve dans le fichier *infcloud/config.js*  
+Pour prendre en compte une modification dans le fichier *config.js* (ou tout autre fichier de InfCloud) il faut recharger le cache avec le script fourni.
+```bash
+sudo ./cache_update.sh
+```

app_rainloop.md

@@ -0,0 +1,19 @@
+# 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``

app_rainloop_fr.md

@@ -0,0 +1,25 @@
+# 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``

app_roundcube.md

@@ -0,0 +1,19 @@
+#<img src="/images/roundcube.png">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!

app_roundcube_fr.md

@@ -0,0 +1,19 @@
+#<img src="/images/roundcube.png">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 !

app_sogo.md

@@ -0,0 +1 @@
+Unfortunately, this page only exists [in french here](app_sogo_fr) for now.

app_sogo_fr.md

@@ -0,0 +1,8 @@
+# ![Logo SOGo](/images/logo_sogo.png) 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)

app_spip.md

@@ -0,0 +1,33 @@
+# SPIP for YunoHost
+
+#### SPIP is what?
+
+SPIP is an Internet publishing system that focuses on collective functioning, multilingualism and ease of use. It is free software, distributed under the GNU/GPL license. It can therefore be used for any website, whether associative or institutional, personal or commercial.
+
+Source:[spip.net](https://www.spip.net/fr_rubrique91.html_rubrique91.html)
+
+#### Application functionality for Yunohost
+
+* Installation of the base without going through the installation system
+* Multilingual support
+* LDAP support
+
+##### Installation
+
+```bash
+$ sudo yunohost app install https://github.com/YunoHost-Apps/spip_ynh.git_ynh.git
+```
+
+##### Update
+
+```bash
+sudo yunohost app upgrade --verbose spip -u https://github.com/YunoHost-Apps/spip_ynh.git_ynh.git
+```
+
+##### Use
+
+Access the administration of the site by entering the following address in your browser.
+
+https://www.domain.tld/spip/ecrire
+
+Make a "forgotten password" request to change your password, you will receive an email telling you how to change your password.

app_spip_fr.md

@@ -0,0 +1,33 @@
+# SPIP for YunoHost
+
+### SPIP c'est quoi ?
+
+SPIP est un système de publication pour l’Internet qui s’attache particulièrement au fonctionnement collectif, au multilinguisme et à la facilité d’emploi. C’est un logiciel libre, distribué sous la licence GNU/GPL. Il peut ainsi être utilisé pour tout site Internet, qu’il soit associatif ou institutionnel, personnel ou marchand.
+
+Source : [spip.net](https://www.spip.net/fr_rubrique91.html)
+
+### Fonctionnalité de l'application pour Yunohost
+
+* Installation de la base sans passer par le système d'installation
+* Support multilingue
+* Support LDAP
+
+#### Installation
+
+```bash
+$ sudo yunohost app install https://github.com/YunoHost-Apps/spip_ynh.git
+```
+
+#### Mise à jour
+
+```bash
+$ sudo yunohost app upgrade --verbose spip -u https://github.com/YunoHost-Apps/spip_ynh.git
+```
+
+#### Utilisation
+
+Accéder à l'administration du site en écrivant l'adresse suivante dans votre navigateur.
+
+https://www.domain.tld/spip/ecrire
+
+Faire une demande de "mot de passe oublié" pour changer votre mot de passe, vous recevez un email vous indiquant comment procéder au changement de mot de passe.

app_transmission.md

@@ -0,0 +1,39 @@
+# <img src="/images/transmission.png">Transmission
+
+### What is  Transmission?
+
+Transmission is a share software based on BitTorrent protocol.
+* [Transmission web site](http://transmissionbt.com/)
+
+### How to download completed files?
+
+If Transmission is installed on `/torrent/`, you could download your completed files to the following address: https://your-domain-name.org/torrent/downloads/
+
+### Sending files towards server for seeding
+
+In YunoHost, completed files are saved in: `/home/yunohost.transmission/completed`
+
+#### With SFTP
+
+With your [file manager](https://en.wikipedia.org/wiki/File_manager) (under GNU/Linux) do `CTRL + L` then enter:
+
+```bash
+sftp://<user>@<your-domain.org>/home/yunohost.transmission/completed
+```
+user = admin or root
+
+#### With SCP (complex)
+To transfer file, type in the following command:
+
+```bash
+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 :
+```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)

app_transmission_fr.md

@@ -0,0 +1,42 @@
+# <img src="/images/transmission.png">Transmission
+
+### C’est quoi Transmission ?
+Transmission est un logiciel de téléchargement et de partage de fichiers basé sur le protocole BitTorrent.
+* [Site de transmission](http://transmissionbt.com/)
+
+### Comment télécharger des fichiers complétés ?
+Il est possible de télécharger les fichiers complétés en cliquant sur le bouton « Download ».
+
+Si vous avez installé Transmission sur `/torrent/`, vous pourrez télécharger vos fichiers complétés à l’adresse suivante : https://votre-domaine.org/torrent/downloads/
+
+### Envoi de fichier vers le serveur pour seeder
+Dans YunoHost, les fichiers complétés sont enregistrés dans : `/home/yunohost.transmission/completed`
+
+#### Avec SFTP (simple)
+À partir de votre [gestionnaire de fichiers](https://fr.wikipedia.org/wiki/Gestionnaire_de_fichier) (sous GNU/Linux) faites `CTRL + L` puis entrez :
+```bash
+sftp://<utilisateur>@<votre-domaine.org>/home/yunohost.transmission/completed
+```
+utilisateur = admin ou root
+
+#### Avec SCP (avancé)
+Pour transférer le fichier, entrez la commande suivante :
+
+```bash
+scp -r /votre/fichier/ root@votre-domaine.org:/home/yunohost.transmission/completed
+```
+
+##### Comment télécharger un répertoire entier ?
+Une fois connecté en [SSH](/ssh), placez-vous dans le répertoire de téléchargement et zippez le répertoire :
+```bash
+cd /home/yunohost.transmission/completed
+zip -r votre_archive.zip [dossier]
+```
+
+Pour plus de détails sur le transfert de fichier avec *scp* voir ici : http://doc.ubuntu-fr.org/ssh#transfert_-_copie_de_fichiers
+
+#### Problèmes de droits
+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/*
+```

app_ttrss.md

@@ -0,0 +1,20 @@
+# <img src="/images/ttrss.png">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)

app_ttrss_fr.md

@@ -0,0 +1,21 @@
+# <img src="/images/ttrss.png">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)

app_update.md

@@ -0,0 +1,38 @@
+#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.

app_update_fr.md

@@ -0,0 +1,39 @@
+#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.

app_wallabag2.md

@@ -0,0 +1,33 @@
+## <img src="https://yunohost.org/images/Logo-wallabag-svg.svg">
+
+[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.
+
+[![Install Wallabag v2 with 
+YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](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).

app_wallabag2_fr.md

@@ -0,0 +1,30 @@
+## <img src="https://yunohost.org/images/Logo-wallabag-svg.svg">
+
+
+[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).
+
+[![Installer avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](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).

app_webtrees.md

@@ -0,0 +1,8 @@
+#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.

app_webtrees_fr.md

@@ -0,0 +1,7 @@
+#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.

app_yunofav.md

@@ -0,0 +1,5 @@
+#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.

app_yunofav_fr.md

@@ -0,0 +1,6 @@
+# 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.