Merge branch 'master' into contribadoc7

This commit is contained in:
Alexandre Aubin 2020-05-12 18:08:06 +02:00 committed by GitHub
commit 71045ebd46
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
52 changed files with 1653 additions and 48 deletions

View file

@ -60,3 +60,4 @@
* [Changing the administration password](/change_admin_password)
* [Recover access to your server](/noaccess)
* [Unban IPs in iptables/fail2ban](/fail2ban)
* [Configuring IPv6](/ipv6)

View file

@ -60,3 +60,4 @@
* [Changer le mot de passe dadministration](/change_admin_password)
* [Récupérer l'accès à son serveur](/noaccess)
* [Débannir une IP dans Fail2ban/IPtables](/fail2ban)
* [Configurer l'IPv6](/ipv6)

View file

@ -24,10 +24,11 @@ Baïkal is a server for calendars and address books, which uses the CalDav and C
To configure the app, go to the address: `sub.domain.tld/admin` or `domain.tld/baikal/admin`.
The username to specify is `admin`, followed by the specific password you chose when installing Baïkal. The password can contain any special characters.
### Creating a new user
### LDAP authentication
Go to the `settings` tab, select `Digest` from `WebDAV authentication type`.
Add users in the `Users and resources' tab.
By default, Baikal is configured to look for users in YunoHost's LDAP
directory. YunoHost's users will appear under `User and ressources` menu after their
first authentication.
## CalDAV connection

View file

@ -24,10 +24,11 @@ Baïkal est un serveur de calendriers et de contacts accessible par les protocol
Pour configurer l'appliation il faut se rendre à l'adresse : `sous.domaine.tld/admin` ou `domaine.tld/baikal/admin`
Le nom dutilisateur à spécifier est `admin` suivi du mot de passe spécifique que vous avez choisi lors de linstallation de Baïkal. Attention, le mot de passe ne doit pas contenir de carractères spéciaux.
### Création d'un nouvel utilisateur
### Authentification LDAp
Aller dans l'onglet `settings`, sélectionner `Digest` dans `WebDAV authentication type`.
Ajouter les utilisateurs dans l'onglet `Users and resources`.
Par défaut, Baikal est configuré pour importer les utilisateurs depuis
l'annuaire LDAP de YunoHost. Les utilisateurs YunoHost apparaîtront dans le
menu `Users and ressources` après une première authentification.
## Connexion CalDAV

View file

@ -1,4 +1,4 @@
# <img src="/images/yunohost_package.png" height="80px" alt="Package"> Checky
# <img src="/images/yunohost_package.png" height="80px" alt="Package"> Cheky
[![Install Cheky with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=cheky) [![Integration level](https://dash.yunohost.org/integration/cheky.svg)](https://dash.yunohost.org/appci/app/cheky)
@ -11,7 +11,7 @@ Cheky is a software written in PHP allowing you to receive new ads published on
## Limitations with YunoHost
Updates from the old LBCAlerte package are not possible, the application is only in French. Checky does not work with [SSO](https://yunohost.org/#/users).
Updates from the old LBCAlerte package are not possible, the application is only in French. Cheky does not work with [SSO](https://yunohost.org/#/users).
## Useful links

View file

@ -1,4 +1,4 @@
# <img src="/images/yunohost_package.png" height="80px" alt="Package"> Checky
# <img src="/images/yunohost_package.png" height="80px" alt="Package"> Cheky
[![Install Cheky with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=cheky) [![Integration level](https://dash.yunohost.org/integration/cheky.svg)](https://dash.yunohost.org/appci/app/cheky)
@ -7,11 +7,11 @@
- [Limitations avec YunoHost](#limitations-avec-yunohost)
- [Liens utiles](#liens-utiles)
Cheky est un logiciel écrit en PHP vous permettant de recevoir les nouvelles annonces publiées sur les sites internet Leboncoin.fr et SeLoger.com. Vous pouvez recevoir les alertes via différent canal de communication.
Cheky est un logiciel écrit en PHP vous permettant de recevoir les nouvelles annonces publiées sur les sites internet Leboncoin.fr et SeLoger.com. Vous pouvez recevoir les alertes via différents canaux de communication.
## Limitations avec YunoHost
Les mises à jours depuis l'ancien package LBCAlerte ne sont pas possible, l'application est uniquement en français. Checky ne fonctionne pas avec le [SSO](https://yunohost.org/#/users).
Les mises à jour depuis l'ancien package LBCAlerte ne sont pas possibles, l'application est uniquement en français. Cheky ne fonctionne pas avec le [SSO](https://yunohost.org/#/users).
## Liens utiles

View file

@ -26,7 +26,7 @@ Pour utiliser votre serveur personnel de synchronisation Firefox, vous allez dev
### Firefox mobile
Avec les versions récentes de Firefox pour mobile la démarche est identique identique à la version bureau.
Avec les versions récentes de Firefox pour mobile la démarche est identique à la version bureau.
## Limitations avec YunoHost

34
app_jitsi.md Normal file
View file

@ -0,0 +1,34 @@
# <img src="/images/jitsi_logo.svg" width="80px" alt="Jitsi's logo"> Jitsi
[![Install jitsi with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=jitsi) [![Integration level](https://dash.yunohost.org/integration/jitsi.svg)](https://dash.yunohost.org/appci/app/jitsi)
### Index
- [Limitations of YunoHost](#limitations-with-yunohost)
- [Customer Applications](#customer-applications)
- [Useful links](#useful-links)
Jitsi Meet is an open source software (Apache) that offers high quality, secure and scalable video conferencing. Options for screen sharing, live chat, speech requests, as well as settings for
video quality are offered to facilitate group meetings.
## Limitations with YunoHost
Jitsi for YunoHost for now as some limitations:
* Can only be used using Chrome/Chromium (like [Iron](https://www.srware.net/iron/)) or [Firefox](https://www.mozilla.org/fr/firefox/browsers/) (since version 76)
* Is limited to two participants
## Customer applications
| Application name | Platform | Multi-account | Other supported networks | Play Store | F-Droid | Apple Store | *Other* |
|-----------------------|------------|---------------|-------------------------|------------|---------|-------------|----------|
| Jitsi Meet | Android - iOS | | | [Jitsi Meet](https://play.google.com/store/apps/details?id=org.jitsi.meet) | [Jitsi Meet](https://f-droid.org/en/packages/org.jitsi.meet/) | [Jitsi Meet](https://apps.apple.com/us/app/jitsi-meet/id1165103905) | |
| Jitsi Meet Desktop | Windows - MacOS - Linux | | | | | | [Download](https://desktop.jitsi.org/Main/Download) |
## Useful links
+ Website : [jitsi.org](https://jitsi.org)
+ Official documentation: [jitsi.org/user-faq](https://jitsi.org/user-faq/)
+ Application software repository:: [github.com - YunoHost-Apps/jitsi](https://github.com/YunoHost-Apps/jitsi_ynh)
+ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/jitsi/issues](https://github.com/YunoHost-Apps/jitsi_ynh/issues)

33
app_jitsi_fr.md Normal file
View file

@ -0,0 +1,33 @@
# <img src="/images/jitsi_logo.svg" width="80px" alt="logo de jitsi"> Jitsi
[![Install jitsi with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=jitsi) [![Integration level](https://dash.yunohost.org/integration/jitsi.svg)](https://dash.yunohost.org/appci/app/jitsi)
### Index
- [Limitations avec YunoHost](#limitations-avec-yunohost)
- [Applications clientes](#applications-clientes)
- [Liens utiles](#liens-utiles)
Jitsi Meet est un logiciel libre (Apache) qui propose des vidéos-conférences de haute qualité, sécurisées et évolutives. Des options de partages d'écran, de chats en direct, de demandes de prises de paroles, ainsi que de paramétrages de qualité de vidéo sont proposées pour faciliter les réunions de groupe.
## Limitations avec YunoHost
Jitsi-meet pour YunoHost est limité actuellement :
* Il ne peut être utilisé qu'avec Chrome ou un navigateur basé sur Chromium (comme [Iron](https://www.srware.net/iron/)) ou [Firefox](https://www.mozilla.org/fr/firefox/browsers/) (à partir de la version 76)
* Il est actuellement limité à 2 participants par réunion
## Applications clientes
| Nom de l'application | Plateforme | Multi-comptes | Autres réseaux supportés | Play Store | F-Droid | Apple Store | *Autres* |
|-----------------------|------------|---------------|-------------------------|------------|---------|-------------|----------|
| Jitsi Meet | Android - iOS | | | [Jitsi Meet](https://play.google.com/store/apps/details?id=org.jitsi.meet) | [Jitsi Meet](https://f-droid.org/en/packages/org.jitsi.meet/) | [Jitsi Meet](https://apps.apple.com/us/app/jitsi-meet/id1165103905) | |
| Jitsi Meet Desktop | Windows - MacOS - Linux | | | | | | [Téléchargement](https://desktop.jitsi.org/Main/Download) |
## Liens utiles
+ Site web : [jitsi.org](https://jitsi.org)
+ Documentation officielle : [jitsi.org/user-faq](https://jitsi.org/user-faq/)
+ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/jitsi](https://github.com/YunoHost-Apps/jitsi_ynh)
+ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/jitsi/issues](https://github.com/YunoHost-Apps/jitsi_ynh/issues)

18
app_leed.md Normal file
View file

@ -0,0 +1,18 @@
# <img src="/images/leed_logo.png" height="80px" alt="leed's logo"> Leed
[![Install leed with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=leed) [![Integration level](https://dash.yunohost.org/integration/leed.svg)](https://dash.yunohost.org/appci/app/leed)
### Index
- [Useful links](#useful-links)
Leed (short for Light Feed) is a minimalist RSS/ATOM aggregator which offers fast RSS consultation and non-intrusive features.
This aggregator works with a system of automatic tasks in order to process the information transparently and display it as quickly as possible when you log in.
## Useful links
+ Website: [git.idleman.fr/LeedRSS/Leed](http://git.idleman.fr/LeedRSS/Leed)
+ Official documentation: [git.idleman.fr/LeedRSS/Leed](http://git.idleman.fr/LeedRSS/Leed)
+ Application software repository: [github.com - YunoHost-Apps/leed](https://github.com/YunoHost-Apps/leed_ynh)
+ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/leed/issues](https://github.com/YunoHost-Apps/leed_ynh/issues)

17
app_leed_fr.md Normal file
View file

@ -0,0 +1,17 @@
# <img src="/images/leed_logo.png" height="80px" alt="logo de leed"> Leed
[![Install leed with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=leed) [![Integration level](https://dash.yunohost.org/integration/leed.svg)](https://dash.yunohost.org/appci/app/leed)
### Index
- [Liens utiles](#liens-utiles)
Leed (contraction de Light Feed) est un agrégateur RSS/ATOM minimaliste qui permet la consultation de flux RSS de manière rapide et non intrusive.
Cet agrégateur fonctionne avec un système de tâches automatiques afin de traiter les informations de manière transparente et de les afficher le plus rapidement possible lorsque vous vous y connectez.
## Liens utiles
+ Site web : [git.idleman.fr/LeedRSS/Leed](http://git.idleman.fr/LeedRSS/Leed)
+ Documentation officielle : [git.idleman.fr/LeedRSS/Leed](http://git.idleman.fr/LeedRSS/Leed)
+ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/leed](https://github.com/YunoHost-Apps/leed_ynh)
+ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/leed/issues](https://github.com/YunoHost-Apps/leed_ynh/issues)

View file

@ -16,7 +16,7 @@ To configure a questionnaire, go to `limesurvey.domain.tld/admin`.
## Limitations with YunoHost
Multi-user is not supported
Multi-user is not supported.
## Useful links

View file

@ -12,11 +12,11 @@ LimeSurvey est un outil de création et diffusion de sondage/formulaire en ligne
## Configuration
Pour configurer un questionnaire, il faut se rendre à `limesurvey.domaine.tld/admin`
Pour configurer un questionnaire, il faut se rendre à `limesurvey.domaine.tld/admin`.
## Limitations avec YunoHost
Le multi-utilisateurs n'est pas supporté
Le multi-utilisateurs n'est pas supporté.
## Liens utiles

19
app_lufi.md Normal file
View file

@ -0,0 +1,19 @@
# <img src="/images/lufi_logo.svg" width="80px" alt="Lufi's logo"> Lufi
[![Install lufi with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=lufi) [![Integration level](https://dash.yunohost.org/integration/lufi.svg)](https://dash.yunohost.org/appci/app/lufi)
### Index
- [Useful Links](#useful-links)
Lufi is a free file hosting software. Files sent on an instance of Lufi are encrypted before being sent to the server: the server administrator cannot see the content of your files.
The administrator can only see the file name, size and mime type (file type: video, text, etc.).
## Useful links
+ Website: [Framagit.org/luc/lufi](https://framagit.org/luc/lufi)
+ Demonstration : [demo.lufi.io](https://demo.lufi.io/)
+ Official documentation : [Framagit.org - fiat-tux](https://framagit.org/fiat-tux/hat-softwares/lufi/-/wikis/home)
+ Application software repository: : [github.com - YunoHost-Apps/lufi](https://github.com/YunoHost-Apps/lufi_ynh)
+ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/lufi/issues](https://github.com/YunoHost-Apps/lufi_ynh/issues)

24
app_lufi_fr.md Normal file
View file

@ -0,0 +1,24 @@
# <img src="/images/lufi_logo.svg" width="80px" alt="logo de Lufi"> Lufi
[![Install lufi with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=lufi) [![Integration level](https://dash.yunohost.org/integration/lufi.svg)](https://dash.yunohost.org/appci/app/lufi)
### Index
- [Liens utiles](#liens-utiles)
Lufi est un logiciel libre dhébergement de fichiers. Les fichiers envoyés sur une instance de Lufi sont chiffrés avant lenvoi au serveur : ladministrateur du serveur ne peut pas voir le contenu de vos fichiers.
Ladministrateur ne peut voir que le nom du fichier, sa taille et son type mime (son type de fichier : vidéo, texte, etc.).[¹](#sources)
## Liens utiles
+ Site web : [Framagit.org/luc/lufi](https://framagit.org/luc/lufi)
+ Site de démonstration : [demo.lufi.io](https://demo.lufi.io/)
+ Documentation officielle : [Framagit.org - fiat-tux](https://framagit.org/fiat-tux/hat-softwares/lufi/-/wikis/home)
+ Dépôt logiciel de lufi : [github.com - YunoHost-Apps/lufi](https://github.com/YunoHost-Apps/lufi_ynh)
+ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/lufi/issues](https://github.com/YunoHost-Apps/lufi_ynh/issues)
### Sources
¹ (https://demo.lufi.io/about)

19
app_lutim.md Normal file
View file

@ -0,0 +1,19 @@
# <img src="/images/lutim_logo.png" height="80px" alt="Lutim's logo"> Lutim
[![Install lutim with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=lutim) [![Integration level](https://dash.yunohost.org/integration/lutim.svg)](https://dash.yunohost.org/appci/app/lutim)
### Index
- [Useful links](#useful-links)
Lutim is a free and anonymous image hosting service. It is also the name of the (free) software that provides this service.
Images uploaded to Lutim can be stored indefinitely, or can be deleted on first viewing or after a period of time chosen from those offered.
## Useful links
+ Website : [Framagit - lutim](https://framagit.org/fiat-tux/hat-softwares/lutim)
+ Official documentation : [lut.im/about](https://lut.im/about)
+ Demonstration [lut.im](https://lut.im)
+ Application software repository : [github.com - YunoHost-Apps/lutim](https://github.com/YunoHost-Apps/lutim_ynh)
+ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/lutim/issues](https://github.com/YunoHost-Apps/lutim_ynh/issues)

19
app_lutim_fr.md Normal file
View file

@ -0,0 +1,19 @@
# <img src="/images/lutim_logo.png" height="80px" alt="logo de lutim"> Lutim
[![Install lutim with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=lutim) [![Integration level](https://dash.yunohost.org/integration/lutim.svg)](https://dash.yunohost.org/appci/app/lutim)
### Index
- [Liens utiles](#liens-utiles)
Lutim est un service gratuit et anonyme dhébergement dimages. Il sagit aussi du nom du logiciel (libre) qui fournit ce service.
Les images déposées sur Lutim peuvent être stockées indéfiniment, ou seffacer dès le premier affichage ou au bout du délai choisi parmi ceux proposés.
## Liens utiles
+ Site web : [Framagit - lutim](https://framagit.org/fiat-tux/hat-softwares/lutim)
+ Documentation officielle : [lut.im/about](https://lut.im/about)
+ Démonstration [lut.im](https://lut.im)
+ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/lutim](https://github.com/YunoHost-Apps/lutim_ynh)
+ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/lutim/issues](https://github.com/YunoHost-Apps/lutim_ynh/issues)

21
app_mattermost.md Normal file
View file

@ -0,0 +1,21 @@
# <img src="/images/mattermost_logo.svg" height="80px" alt="mattermost's logo"> Mattermost
[![Install mattermost with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=mattermost) [![Integration level](https://dash.yunohost.org/integration/mattermost.svg)](https://dash.yunohost.org/appci/app/mattermost)
### Index
- [Useful links](#useful-links)
Mattermost is a decentralized team communication software. For Slack enthusiasts, importing your data is possible, allowing a smooth transition to this free tool.
The platform allows :
* The sharing of messages and files on different devices: PCs, computers and tablets thanks to dedicated applications.
* The formatting of messages is done with the Markdown language.
* Continuous archiving and instant search, and support for notifications and integrations with your existing tools.
## Useful links
+ Website: [mattermost.com](https://mattermost.com)
+ Official documentation: [docs.mattermost.com/guides/user.html](https://docs.mattermost.com/guides/user.html)
+ Application software repository: [github.com - YunoHost-Apps/mattermost](https://github.com/YunoHost-Apps/mattermost_ynh)
+ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/mattermost/issues](https://github.com/YunoHost-Apps/mattermost_ynh/issues)

21
app_mattermost_fr.md Normal file
View file

@ -0,0 +1,21 @@
# <img src="/images/mattermost_logo.svg" height="80px" alt="logo de mattermost"> Mattermost
[![Install mattermost with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=mattermost) [![Integration level](https://dash.yunohost.org/integration/mattermost.svg)](https://dash.yunohost.org/appci/app/mattermost)
### Index
- [Liens utiles](#liens-utiles)
Mattermost est un logiciel décentralisé de communication en équipe. Pour les adeptes de Slack, l'importation de vos données est possible, permettant de faire la transition vers cet outil libre en douceur.
La plate-forme permet :
* Le partage de messages et de fichiers sur différents appareils : PC, ordiphones et tablettes grâce aux applications dédiées.
* La mise en forme des messages se fait avec le langage Markdown.
* L'archivage continu et la recherche instantanée, et la prise en charge les notifications et les intégrations avec vos outils existants.
## Liens utiles
+ Site web : [mattermost.com](https://mattermost.com/)
+ Documentation officielle : [docs.mattermost.com/guides/user.html](https://docs.mattermost.com/guides/user.html)
+ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/mattermost](https://github.com/YunoHost-Apps/mattermost_ynh)
+ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/mattermost/issues](https://github.com/YunoHost-Apps/mattermost_ynh/issues)

18
app_minetest.md Normal file
View file

@ -0,0 +1,18 @@
# <img src="/images/minetest_logo.svg" height="80px" alt="minetest's logo"> Minetest
[![Install minetest with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=minetest) [![Integration level](https://dash.yunohost.org/integration/minetest.svg)](https://dash.yunohost.org/appci/app/minetest)
### Index
- [Useful links](#useful-links)
A game of cubes in an unlimited space where picks and shovels are de rigueur to build imaginary constructions, dig tunnels, walk in the sandstone of his wishes, make encounters, pick up a few flowers here and there, swimming...
Minetest is the equivalent of Minecraft with the addition of free gameplay and the possibility of integrating a development team to improve the product.
Minetest is also a server that allows you to welcome your friends or just a few curious visitors or even experienced players.
## Useful links
+ Website: [minetest.net](https://minetest.net)
+ Official documentation: [wiki.minetest.net](https://wiki.minetest.net)
+ Application software repository: [github.com - YunoHost-Apps/minetest](https://github.com/YunoHost-Apps/minetest_ynh)
+ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/minetest/issues](https://github.com/YunoHost-Apps/minetest_ynh/issues)

18
app_minetest_fr.md Normal file
View file

@ -0,0 +1,18 @@
# <img src="/images/minetest_logo.svg" height="80px" alt="logo de minetest"> Minetest
[![Install minetest with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=minetest) [![Integration level](https://dash.yunohost.org/integration/minetest.svg)](https://dash.yunohost.org/appci/app/minetest)
### Index
- [Liens utiles](#liens-utiles)
Un jeu de cubes dans un espace illimité ou pioches et pelles sont de rigueur pour édifier des constructions imaginaires, creuser des tunels, se promener au grès de ses envies, faire des rencontres, ramasser quelques fleurs de-ci de-là, nager...
Minetest c'est l'équivalent de Minecraft avec en supplément la gratuité du jeu et la possibilité d'intégrer une équipe de développement pour améliorer le produit.
Minetest, c'est aussi un serveur qui permet d'accueillir vos amis ou simplement quelques visiteurs curieux voire même des joueurs chevronnés.
## Liens utiles
+ Site web : [minetest.net](https://minetest.net)
+ Documentation officielle : [wiki.minetest.net](https://wiki.minetest.net)
+ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/minetest](https://github.com/YunoHost-Apps/minetest_ynh)
+ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/minetest/issues](https://github.com/YunoHost-Apps/minetest_ynh/issues)

View file

@ -1,17 +1,26 @@
# Minidlna
# <img src="/images/yunohost_package.png" height="80px" alt="Package"> Minidlna (Ready Meadia)
Minidlna is a lightweight [dlna](https://fr.wikipedia.org/wiki/Digital_Living_Network_Alliance) server.
[![Install minidlna with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=minidlna) [![Integration level](https://dash.yunohost.org/integration/minidlna.svg)](https://dash.yunohost.org/appci/app/minidlna)
### Index
- [Configuration](#configuration)
- [Useful links](#useful-links)
Minidlna (Ready Media) 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.
## 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?
### 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.
@ -23,3 +32,11 @@ In any case, it is generally sufficient to seek external sources, USB etc, to fi
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.
## Useful links
+ Website: [minidlna.sourceforge.net](http://minidlna.sourceforge.net)
+ Official : [help.ubuntu.com/community/MiniDLNA](https://help.ubuntu.com/community/MiniDLNA)
+ Application software repository: [github.com - YunoHost-Apps/minidlna](https://github.com/YunoHost-Apps/minidlna_ynh)
+ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/minidlna/issues](https://github.com/YunoHost-Apps/minidlna_ynh/issues)

View file

@ -1,10 +1,19 @@
# Minidlna
# <img src="/images/yunohost_package.png" height="80px" alt="Package"> Minidlna (Ready Media)
Minidlna est un serveur [dlna](https://fr.wikipedia.org/wiki/Digital_Living_Network_Alliance) ultra léger.
[![Install minidlna with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=minidlna) [![Integration level](https://dash.yunohost.org/integration/minidlna.svg)](https://dash.yunohost.org/appci/app/minidlna)
### Index
- [Configuration](#configuration)
- [Liens utiles](#liens-utiles)
Minidlna (renommé Ready Media) 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 dune interface graphique, mais ne nécessite pas de configuration particulière.
## Configuration
### 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 dinformations sur les dossiers multimédias](https://github.com/maniackcrudelis/yunohost.multimedia).
@ -23,3 +32,10 @@ Dans tous les cas, il suffit en général daller chercher les sources externe
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.
## Liens utiles
+ Site web : [minidlna.sourceforge.net](http://minidlna.sourceforge.net/)
+ Documentation : [doc.ubuntu-fr.org/minidlna](https://doc.ubuntu-fr.org/minidlna)
+ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/minidlna](https://github.com/YunoHost-Apps/minidlna_ynh)
+ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com - YunoHost-Apps/minidlna/issues](https://github.com/YunoHost-Apps/minidlna_ynh/issues)

18
app_mobilizon.md Normal file
View file

@ -0,0 +1,18 @@
# <img src="/images/mobilizon_logo.svg" height="80px" alt="mobilizon's logo"> Mobilizon
[![Install mobilizon with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=mobilizon) [![Integration level](https://dash.yunohost.org/integration/mobilizon.svg)](https://dash.yunohost.org/appci/app/mobilizon)
### Index
- [Useful links](#useful-links)
MobiliZon is your federated organization and mobilization platform. It's supported by Framasoft.
MobiliZon aims to solve existing platform's problems to organize events in a decentralised, libre and privacy friendly way.
Mobilizon is a tool designed to create platforms for managing communities and events. Its purpose is to help as many people as possible to free themselves from Facebook groups and events, from Meetup, etc.
## Useful links
+ Website: [joinmobilizon.org](https://joinmobilizon.org)
+ Official documentation: [joinmobilizon.org/fr/faq](https://joinmobilizon.org/en/faq)
+ Application software repository: [github.com - YunoHost-Apps/mobilizon](https://github.com/YunoHost-Apps/mobilizon_ynh)
+ Fix a bug or an improvement by creating a ticket (issue): [github.com - YunoHost-Apps/mobilizon/issues](https://github.com/YunoHost-Apps/mobilizon_ynh/issues)

25
app_mobilizon_fr.md Normal file
View file

@ -0,0 +1,25 @@
# <img src="/images/mobilizon_logo.svg" height="80px" alt="logo de mobilizon"> Mobilizon
[![Install mobilizon with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=mobilizon) [![Integration level](https://dash.yunohost.org/integration/mobilizon.svg)](https://dash.yunohost.org/appci/app/mobilizon)
### Index
- [Liens utiles](#liens-utiles)
Mobilizon est un logiciel actuellement en cours de développement par Framasoft. Il permettra à chaque organisation ou individu de proposer sa propre plateforme de mobilisation.
Il sera possible de :
* Publier des évènements,
* Créer des groupes,
* Dialoguer par messagerie,
* Avoir plusieurs identités avec un seul compte (pour séparer les évènements familiaux ou activités de loisirs de son activité militante, par exemple)
* Fédérer plusieurs instances Mobilizon pour échanger avec dautres instances, afficher plus dévénements que juste ceux de son instance et favoriser les interactions (utilisation du protocole ActivityPub)
Mobilizon sera un logiciel éthique permettant de s'émanciper de Facebook, Meetup, Eventbrite ou tout autre plateforme à but lucratif. Il sera respectueux de la vie privée et des données personnelles de ses utilisateurs.
## Liens utiles
+ Site web : [joinmobilizon.org](https://joinmobilizon.org)
+ Documentation officielle : [joinmobilizon.org/fr/faq](https://joinmobilizon.org/fr/faq)
+ Dépôt logiciel de l'application : [github.com - YunoHost-Apps/mobilizon](https://github.com/YunoHost-Apps/mobilizon_ynh)
+ Remonter un bug ou une amélioration en créant un ticket (issue) : [github.com -YunoHost-Apps/mobilizon/issues](https://github.com/YunoHost-Apps/mobilizon_ynh/issues)

23
app_opensondage.md Normal file
View file

@ -0,0 +1,23 @@
# <img src="/images/opensondage_logo.png" height="80px" alt="opensondage's logo"> Opensondage
[![Install opensondage with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=opensondage) [![Integration level](https://dash.yunohost.org/integration/opensondage.svg)](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)

23
app_opensondage_fr.md Normal file
View file

@ -0,0 +1,23 @@
# <img src="/images/opensondage_logo.png" height="80px" alt="logo de opensondage"> Opensondage
[![Install opensondage with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=opensondage) [![Integration level](https://dash.yunohost.org/integration/opensondage.svg)](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 nest 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)

View file

@ -1,3 +1,17 @@
# Peertube
# <img src="/images/peertube_logo.svg" height="80px" alt="peertube's logo"> Peertube
PeerTube is a federated (ActivityPub) video streaming platform using P2P (BitTorrent) directly in the web browser, using WebTorrent.
[![Install peertube with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=peertube) [![Integration level](https://dash.yunohost.org/integration/peertube.svg)](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)

View file

@ -1,16 +1,17 @@
# <img src="/images/peertube_logo.png" alt="Logo de PeerTube"> PeerTube
# <img src="/images/peertube_logo.svg" height="80px" 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)
[![Install peertube with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=peertube) [![Integration level](https://dash.yunohost.org/integration/peertube.svg)](https://dash.yunohost.org/appci/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.
### Index
x
- [Liens utiles](#liens-utiles)
## Découverte de l'environnement de PeerTube
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.
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>
## Liens utiles
## 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)
+ 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)

17
app_strut.md Normal file
View file

@ -0,0 +1,17 @@
# <img src="/images/strut_logo.png" height="80px" alt="strut's logo"> Strut
[![Install strut with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=strut) [![Integration level](https://dash.yunohost.org/integration/strut.svg)](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)

16
app_strut_fr.md Normal file
View file

@ -0,0 +1,16 @@
# <img src="/images/strut_logo.png" height="80px" alt="logo de strut"> Strut
[![Install strut with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=strut) [![Integration level](https://dash.yunohost.org/integration/strut.svg)](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)

View file

@ -1,3 +1,8 @@
<div class="alert alert-warning" markdown="1" style="margin-right: 120px; margin-top: 12px">La page demandée n'est pour le moment pas disponible en français. Voici à la place la version en anglais. Si vous souhaitez commencer une traduction de cette page, vous pouvez vous rendre sur [cette page](https://yunohost.org/#/apps_wishlist_fr).</div>
<div class="alert alert-warning" markdown="1" style="margin-right: 120px; margin-top: 12px">La page demandée n'est pour le moment pas disponible en français. Voici à la place la version en anglais. Si vous souhaitez commencer une traduction de cette page, vous pouvez vous rendre sur [cette page](https://yunohost.org/#/apps_wishlist_fr).</div>
# Apps wishlist
<div class="alert alert-info">Before to add an app in wishlist please check your app is not already in apps list: see the <a href="/apps">apps list</a></div>
@ -93,7 +98,6 @@ The following list is a compiled wishlist of applications that would be nice-to-
- [Museek+](https://github.com/eLvErDe/museek-plus)
- [N8n.io](https://n8n.io)
- [Netrunner](https://github.com/mtgred/netrunner)
- [Nibbleblog](http://www.nibbleblog.com)/ [github](https://github.com/dignajar/nibbleblog)
- [Nuage](https://nuage.kerjean.me/login) / [github](https://github.com/mickael-kerjean/filestash)
- [OhMyForm](https://github.com/ohmyform) (Only support Docker install way and some VPS aren't compatible, see TellForm which support non-Docker install but is discontinued)
- [Ombi](https://github.com/tidusjar/Ombi)
@ -117,6 +121,7 @@ The following list is a compiled wishlist of applications that would be nice-to-
- [ProcessMaker](http://www.processmaker.com)
- [ProtonMails WebClient](https://github.com/ProtonMail/WebClient)
- [PyLoad](https://github.com/pyload/pyload)
- [Pydio Cells](https://pydio.com/) A file sync and sharing software written in go. / [github](https://github.com/pydio/cells)
- [Pump.io](http://pump.io) / [github](https://github.com/pump-io/pump.io)
- [qBittorrent](https://github.com/qbittorrent/qBittorrent)
- [racktables](http://racktables.org) / [github](https://github.com/RackTables/racktables)
@ -139,6 +144,7 @@ The following list is a compiled wishlist of applications that would be nice-to-
- [Taiga](https://taiga.io) / [github](https://github.com/taigaio/)
- [Taskwarrior](https://taskwarrior.org) / [github](https://github.com/GothenburgBitFactory/taskwarrior)
- [Technitium DNS](https://technitium.com/dns/) / [github](https://github.com/TechnitiumSoftware/DnsServer)
- [Teddy.io](https://teedy.io/#!/) Gestionnaire de documents / [Github](https://github.com/sismics/docs)
- [TellForm](https://github.com/tellform/tellform) (Discontinued (see OhMyForm) but it can be great to have it since OhMyForm does only support Docker install)
- [TMate](https://tmate.io/) / [github](https://github.com/tmate-io/tmate)
- [Tracim](https://github.com/tracim/tracim)
@ -152,9 +158,9 @@ The following list is a compiled wishlist of applications that would be nice-to-
- [Wireguard](https://www.wireguard.com/) / [git](https://git.zx2c4.com/WireGuard/)
- [Xibo](https://github.com/xibosignage) - A FLOSS digital signage solution (CMS?)
- [Xonotic](http://xonotic.org) / [gitlab](https://gitlab.com/xonotic)
- [YesWiki](https://yeswiki.net) / [github](https://github.com/YesWiki/yeswiki)
- [Zammad](https://github.com/zammad/zammad)
- [ZeroTier](https://github.com/zerotier/ZeroTierOne)
- [Zola](https://www.getzola.org/) - A static site generator in one binary
- [Zoneminder](https://github.com/ZoneMinder/zoneminder)
- [Zulip](https://zulipchat.com/) / [github](https://github.com/zulip/zulip)
- [Yggdrasil](https://yggdrasil-network.github.io/) / [github](https://github.com/yggdrasil-network/yggdrasil-go)

View file

@ -9,7 +9,7 @@
- [Borg](app_borg)
- [BoZoN](app_bozon)
- [Calibre-Web](app_calibreweb)
- [Checky](app_checky)
- [Cheky](app_cheky)
- [CiviCRM](app_civicrm_drupal7)
- [Collabora (Docker)](app_collaboradocker)
- [Concret5](app_concrete5)
@ -46,12 +46,21 @@
- [Hubzilla](app_hubzilla)
- [Jappix](app_jappix)
- [Jirafeau](app_jirafeau)
- [Jitsi](app_jitsi)
- [Leed](app_leed)
- [Limesurvey](app_limesurvey)
- [Lstu](app_lstu)
- [Lufi](app_lufi)
- [Lutim](app_lutim)
- [Mattermost](app_mattermost)
- [Mediawiki](app_mediawiki)
- [Minetest](app_minetest)
- [Minidlna](app_minidlna)
- [Mobilizon](app_mobilizon)
- [Netdata](app_netdata)
- [Nextcloud](app_nextcloud)
- [Noalyss](app_noalyss)
- [Opensondage](app_opensondage)
- [Peertube](app_peertube)
- [Pihole](app_pihole)
- [Piwigo](app_piwigo)
@ -61,6 +70,7 @@
- [Rainloop](app_rainloop)
- [Sogo](app_sogo)
- [Spip](app_spip)
- [Strut](app_strut)
- [Transmission](app_transmission)
- [TinyTinyRSS](app_ttrss)
- [Wallabag2](app_wallabag2)
@ -68,5 +78,5 @@
- [Webtrees](app_webtrees)
- [WordPress](app_wordpress)
- [Yunofav](app_yunofav)
- [Zerobin](app_zerobin)
- (Note that you can add a new page here if you want to start document in another `app...))

39
chat_rooms_es.md Normal file
View file

@ -0,0 +1,39 @@
## Salas de chat
El proyecto YunoHost utilisa salas de chat como medio de communicación.
Puede juntarse a una sala de chat utilisando :
- un [cliente IRC](https://es.wikipedia.org/wiki/Anexo:Clientes_IRC) por ejemplo [kiwiirc](https://kiwiirc.com/client/irc.freenode.net/yunohost)
- un [cliente XMPP](https://es.wikipedia.org/wiki/Anexo:Comparaci%C3%B3n_de_clientes_de_mensajer%C3%ADa_instant%C3%A1nea)
- un [Matrix](https://matrix.org/docs/guides/faq.html#what-clients-are-available%3F)
#### Sala de chat de ayuda y soporte
Existe salas publica de chat de [soporte](/help) y ayuda para YunoHost:
- IRC: **#yunohost** on irc.freenode.net ;
- Matrix: **#freenode_#yunohost:matrix.org** ;
- XMPP: **[support@conference.yunohost.org](xmpp:support@conference.yunohost.org?join)**
#### sala de chat para developers
Salas de chat para el desarollo de YunoHost:
- IRC: **#yunohost-dev** on irc.freenode.net ;
- Matrix: **#freenode_#yunohost-dev:matrix.org** ;
- XMPP: **[dev@conference.yunohost.org](xmpp:dev@conference.yunohost.org?join)**
Actualmente, la sala principal de chat para contribuciones en Yunohost
Para mas ayuda, vea la sala de chat **#yunohost** encima.
#### Sala de chat para las integración de aplicaciones
Estos permite la ayuda mutua para los integradores de aplicaciones y también para conversar de evoluciones et de herramientas de integración continua.
- IRC: **#yunohost-apps** en irc.freenode.net
- Matrix: **#freenode_#yunohost-apps:matrix.org**
- XMPP: **[apps@conference.yunohost.org](xmpp:apps@conference.yunohost.org?join)**
#### Sala de chat de Documentación
Lugar donde la comunidad conversa sincroniza y mantiene actualisado la documentación en los aspectos varios comó (backend, frontend, apps, project, community...)
Puede tambien compartir sus materiales sobre el tema de Yunohost (videos, presentaciones, etc.).
- IRC: **#yunohost-doc** on irc.freenode.net
- Matrix: **#freenode_#yunohost-doc:matrix.org**
- XMPP: **[doc@conference.yunohost.org](xmpp:doc@conference.yunohost.org?join)**

View file

@ -2,7 +2,7 @@
* [General ways of contributing to YunoHost](/contribute)
* [Writing documentation](/write_documentation)
* [Documentation wrinting guide](/doc_writing_guide)
* [Documentation writing guide](/doc_writing_guide)
* [Markdown guide](/doc_markdown_guide)
* [Propulser son code avec Git & GitHub](/doc_use_git)
* [Chat rooms](/chat_rooms)
@ -15,11 +15,15 @@
* [Manifest](packaging_apps_manifest)
* [Scripts](packaging_apps_scripts)
* [Arguments management](packaging_apps_arguments_management)
* [Arguments format](#/packaging_apps_arguments_format)
* [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 apps list](https://github.com/YunoHost/Apps/#contributing)
* [Advanced packaging features](#/packaging_apps_advanced)
* [Application actions](#/packaging_apps_actions)
* [Application configuration panel](#/packaging_apps_config_panel)
* Quality tests
* [Package linter](https://github.com/YunoHost/package_linter)
* [Package check](https://github.com/YunoHost/package_check)

View file

@ -15,11 +15,15 @@
* [Manifest](/packaging_apps_manifest)
* [Scripts](/packaging_apps_scripts)
* [Gestion des arguments](/packaging_apps_arguments_management)
* [Format des arguments](#/packaging_apps_arguments_format)
* [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 des apps](https://github.com/YunoHost/Apps/#contributing)
* [Feature de packaging avancées](#/packaging_apps_advanced)
* [Actions pour une application](#/packaging_apps_actions)
* [Panneau de configuration pour une application](#/packaging_apps_config_panel)
* Tests de qualité
* [Package linter](https://github.com/YunoHost/package_linter)
* [Package check](https://github.com/YunoHost/package_check)

650
images/jitsi_logo.svg Normal file

File diff suppressed because one or more lines are too long

After

Width:  |  Height:  |  Size: 35 KiB

BIN
images/leed_logo.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 3 KiB

View file

Before

Width:  |  Height:  |  Size: 70 KiB

After

Width:  |  Height:  |  Size: 70 KiB

93
images/lufi_logo.svg Normal file
View file

@ -0,0 +1,93 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- Created with Inkscape (http://www.inkscape.org/) -->
<svg
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
width="282.70126"
height="282.53867"
id="svg2"
version="1.1"
inkscape:version="0.91 r13725"
sodipodi:docname="lufi.svg"
inkscape:export-filename="/home/luc/PERSONNEL/fiat-tux_designs/lufi.png"
inkscape:export-xdpi="271"
inkscape:export-ydpi="271">
<defs
id="defs4" />
<sodipodi:namedview
id="base"
pagecolor="#ffffff"
bordercolor="#666666"
borderopacity="1.0"
inkscape:pageopacity="0.0"
inkscape:pageshadow="2"
inkscape:zoom="1.979899"
inkscape:cx="26.011995"
inkscape:cy="84.402272"
inkscape:document-units="px"
inkscape:current-layer="layer1"
showgrid="false"
inkscape:window-width="1920"
inkscape:window-height="1039"
inkscape:window-x="0"
inkscape:window-y="41"
inkscape:window-maximized="0"
fit-margin-top="10"
fit-margin-left="10"
fit-margin-right="10"
fit-margin-bottom="10" />
<metadata
id="metadata7">
<rdf:RDF>
<cc:Work
rdf:about="">
<dc:format>image/svg+xml</dc:format>
<dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
<dc:title></dc:title>
</cc:Work>
</rdf:RDF>
</metadata>
<g
inkscape:label="Calque 1"
inkscape:groupmode="layer"
id="layer1"
transform="translate(-221.44765,-362.7203)">
<g
id="g2994"
transform="matrix(1.0020558,-1.0020558,1.0020558,1.0020558,-490.60541,247.60842)"
inkscape:export-filename="/home/luc/tmp/lufi.png"
inkscape:export-xdpi="271.87875"
inkscape:export-ydpi="271.87875">
<path
inkscape:connector-curvature="0"
id="path3875"
d="m 214.90995,548.04352 -38.63833,1.01016 -2.27284,6.56599 3.03045,3.03046 41.92133,0.75761 157.07873,1.01015 40.15356,0 5.3033,-5.3033 -2.77792,-6.81853 -19.69797,-1.01015 -20.20306,0.25254 -2.77791,-15.40483 -6.81853,-16.92005 -14.39468,-17.93021 -13.63706,-12.62691 -13.13198,-6.56599 -18.18275,-5.3033 -22.72843,1.26269 -21.2132,4.79822 -13.38452,5.55584 -13.13199,10.85914 -10.6066,13.38452 -7.3236,9.34392 -3.78808,10.35406 -3.28299,12.87944 z"
style="fill:#ffd119;fill-opacity:1;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" />
<rect
ry="7.3214264"
y="522.78973"
x="216.17265"
height="24.243732"
width="159.85664"
id="rect3873"
style="fill:#ff000a;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" />
<g
transform="translate(-17.800222,72.844826)"
id="g3074">
<path
sodipodi:nodetypes="ssssssssccccssssssssscsscccssccsssscssssssssssssssssssssssssss"
inkscape:connector-curvature="0"
id="path3076"
d="m 191.54148,487.67039 c -5.11077,-4.02013 -3.76609,-12.77744 2.28591,-14.88718 1.90113,-0.66273 9.86788,-1.13532 19.13896,-1.13532 11.85861,0 15.96787,-0.31667 16.22051,-1.25 0.18609,-0.6875 0.81278,-3.78781 1.39265,-6.88958 3.71296,-19.86087 19.21745,-41.97257 37.20623,-53.06158 24.32865,-14.99715 56.89702,-16.92672 82.60964,-4.89433 23.5152,11.00409 42.6905,34.14334 48.04833,57.98096 l 1.78265,7.93123 18.36719,0.34165 17.1045,0.34165 c 9.45192,1.08409 8.2901,17.0871 0.24154,17.5 l -120.94207,0 c -118.96911,0 -120.98307,-0.0323 -123.45604,-1.9775 z m 243.67283,-3.59393 c 2.51368,-0.82861 3.43825,-3.94122 0.37143,-6.22857 -2.52906,-1.88627 -29.03663,-1.2 -120.46482,-1.2 -116.89017,0 -119.28542,0.0385 -120.3,1.93426 -1.4064,2.62788 -1.30648,3.65158 0.53625,5.49431 1.41087,1.41087 13.6645,1.57143 119.92857,1.57143 106.26407,0 116.73199,-0.5177 119.92857,-1.57143 z m -42.52164,-13.34989 c 1.1562,-0.73196 1.21003,-1.8711 0.30207,-6.39217 -0.60767,-3.02582 -1.78032,-7.11812 -2.6059,-9.094 l -1.50105,-3.59251 -74.5376,0 -74.53761,0 -1.4229,3.40548 c -1.94511,4.65531 -3.87987,14.33903 -3.11283,15.58013 0.79688,1.28938 155.38177,1.38078 157.41582,0.0931 z m -25.90693,-24.39153 c 0,-1.24672 -5.7033,-11.73239 -7.62234,-14.01388 -2.88837,-3.43389 -3.05342,-5.67327 -0.41813,-5.67327 4.38551,0 11.74148,11.74497 10.68001,17.05232 l -0.58954,2.94768 7.975,0 c 5.74935,0 7.975,-0.35183 7.975,-1.26068 0,-2.26743 -8.58166,-14.10933 -14.6056,-20.15437 -15.05404,-15.10678 -33.86286,-22.60595 -56.60224,-22.56759 -22.08745,0.0373 -39.40142,6.87913 -54.36384,21.48264 -6.94616,6.77954 -15.42832,18.41013 -15.42832,21.15504 0,1.11203 10.65076,1.34496 61.5,1.34496 33.825,0 61.5,-0.14078 61.5,-0.31285 z m -93.59158,-3.06521 c -0.66235,-1.72604 3.9076,-10.69297 6.76967,-13.28311 1.63365,-1.47843 2.06875,-1.51459 3.27243,-0.27199 1.18957,1.22804 0.82283,2.36345 -2.56242,7.93316 -4.00121,6.58312 -6.41472,8.39719 -7.47968,5.62194 z m 74.8173,0.12806 c -2.02408,-2.4825 -3.63934,-9.73638 -2.43601,-10.93971 1.64641,-1.64641 3.95916,0.61949 5.34149,5.23327 1.63547,5.45873 -0.18778,9.03966 -2.90548,5.70644 z m -87.8736,-3.27477 c -1.08443,-2.82599 9.43089,-16.47523 12.69246,-16.47523 3.51737,0 3.02283,2.00661 -1.97445,8.01145 -2.76577,3.32341 -5.50383,6.93041 -6.08458,8.01556 -1.25494,2.34487 -3.81074,2.59211 -4.63343,0.44822 z m 27.06887,0.17947 c -0.66129,-1.72328 2.00067,-6.21879 4.17686,-7.05387 2.19279,-0.84146 2.95868,2.31694 1.28494,5.29892 -1.67568,2.98543 -4.62586,3.93336 -5.4618,1.75495 z"
style="fill:#000000;fill-opacity:1" />
</g>
</g>
</g>
</svg>

After

Width:  |  Height:  |  Size: 5.8 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 7.4 KiB

After

Width:  |  Height:  |  Size: 57 KiB

File diff suppressed because one or more lines are too long

After

Width:  |  Height:  |  Size: 13 KiB

View file

@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 248.16 46.78"><title>Fichier 1</title><g id="e11b986d-bcba-4466-9834-a5e44ebfe12a" data-name="Calque 2"><g id="ab18705c-9f78-4d57-8f04-bd2f1ccdd04c" data-name="header"><path d="M0,46.07,3.18,5.27a29.88,29.88,0,0,1,5.07-.36,27.74,27.74,0,0,1,4.95.36l4.86,17.16A92.19,92.19,0,0,1,20.4,32.51h.36A92.19,92.19,0,0,1,23.1,22.43L28,5.27a29.23,29.23,0,0,1,5-.36,29.23,29.23,0,0,1,5,.36l3.18,40.8a13.61,13.61,0,0,1-3.63.42,23.41,23.41,0,0,1-3.63-.24l-1.2-19.92q-.36-5.52-.48-12.84H31.8L24.48,40a25.62,25.62,0,0,1-4,.3,23.36,23.36,0,0,1-3.84-.3L9.36,13.49H9q-.3,8.94-.48,12.84L7.26,46.25a22.47,22.47,0,0,1-3.6.24A13.75,13.75,0,0,1,0,46.07Z" transform="translate(0 -0.25)" style="fill:#3f3d56"/><path d="M74,31.31q0,8-4.26,12.3a12.21,12.21,0,0,1-9,3.42,12.21,12.21,0,0,1-9-3.42q-4.26-4.26-4.26-12.3T51.72,19a12.21,12.21,0,0,1,9-3.42,12.21,12.21,0,0,1,9,3.42Q74,23.27,74,31.31ZM60.75,21.23q-5.67,0-5.67,10.08t5.67,10.08q5.67,0,5.67-10.08T60.75,21.23Z" transform="translate(0 -0.25)" style="fill:#3f3d56"/><path d="M103.2,20q2.7,4.11,2.7,11.28T102,42.56a13.18,13.18,0,0,1-10,4.11,31.41,31.41,0,0,1-11.34-2V2.45L81.06,2h2.76A4,4,0,0,1,87,3.08a5.38,5.38,0,0,1,.93,3.57V18.59a12.08,12.08,0,0,1,7.56-2.7A8.71,8.71,0,0,1,103.2,20ZM93.48,22a7.28,7.28,0,0,0-5.58,2.82v16a15,15,0,0,0,4.08.54,5.25,5.25,0,0,0,4.68-2.67q1.68-2.67,1.68-7.59Q98.34,22.07,93.48,22Z" transform="translate(0 -0.25)" style="fill:#3f3d56"/><path d="M121,22.25V46.19a20.85,20.85,0,0,1-3.66.3,23,23,0,0,1-3.78-.3V25q0-3.24-2.7-3.24h-.72a9.32,9.32,0,0,1-.3-2.58,10.7,10.7,0,0,1,.3-2.7,39.63,39.63,0,0,1,4.38-.24h1a5.19,5.19,0,0,1,4,1.62A6.27,6.27,0,0,1,121,22.25Z" transform="translate(0 -0.25)" style="fill:#3f3d56"/><path d="M119.82,1.09a7.37,7.37,0,0,1,.6,3,7.37,7.37,0,0,1-.6,3,7.46,7.46,0,0,1-3.87.84A6.49,6.49,0,0,1,112.26,7a7.37,7.37,0,0,1-.6-3,7.37,7.37,0,0,1,.6-3,8.09,8.09,0,0,1,3.87-.84A7.05,7.05,0,0,1,119.82,1.09Z" transform="translate(0 -0.25)" style="fill:#fff"/><path d="M139.08,40.67h2a10.23,10.23,0,0,1,.6,3.18,9.24,9.24,0,0,1-.18,2.1,38.47,38.47,0,0,1-5.64.54q-6.48,0-6.48-7v-37l.36-.42h2.88a3.94,3.94,0,0,1,3.12,1.05,5.52,5.52,0,0,1,.9,3.57V38Q136.62,40.67,139.08,40.67Z" transform="translate(0 -0.25)" style="fill:#3f3d56"/><path d="M155.94,22.25V46.19a20.85,20.85,0,0,1-3.66.3,23,23,0,0,1-3.78-.3V25q0-3.24-2.7-3.24h-.72a9.32,9.32,0,0,1-.3-2.58,10.7,10.7,0,0,1,.3-2.7,39.63,39.63,0,0,1,4.38-.24h1a5.19,5.19,0,0,1,4.05,1.62A6.27,6.27,0,0,1,155.94,22.25Z" transform="translate(0 -0.25)" style="fill:#3f3d56"/><path d="M154.8,3.09a7.37,7.37,0,0,1,.6,3,7.37,7.37,0,0,1-.6,3,7.46,7.46,0,0,1-3.87.84A6.49,6.49,0,0,1,147.24,9a7.37,7.37,0,0,1-.6-3,7.37,7.37,0,0,1,.6-3,8.09,8.09,0,0,1,3.87-.84A7.05,7.05,0,0,1,154.8,3.09Z" transform="translate(0 -0.25)" style="fill:#fff"/><path d="M163.08,39.47l8.76-11.82q1.32-1.8,4.8-5.7l-.18-.3a63.09,63.09,0,0,1-7.74.42H163a9.79,9.79,0,0,1-.24-2.34,15.8,15.8,0,0,1,.42-3.3h20.4a16.31,16.31,0,0,1,1,4.26,4.1,4.1,0,0,1-.78,2.34L175,34.91a64.65,64.65,0,0,1-4.56,5.7l.18.24q3.12-.3,5.22-.3h2.58a15.35,15.35,0,0,0,6.12-.9,9.4,9.4,0,0,1,.72,3.12q0,3.42-4.32,3.42h-18a14.27,14.27,0,0,1-.9-3.93A5.08,5.08,0,0,1,163.08,39.47Z" transform="translate(0 -0.25)" style="fill:#3f3d56"/><path d="M215.88,31.31q0,8-4.26,12.3a13.63,13.63,0,0,1-18.06,0q-4.26-4.26-4.26-12.3T193.56,19a13.63,13.63,0,0,1,18.06,0Q215.88,23.27,215.88,31.31ZM202.59,21.23q-5.67,0-5.67,10.08t5.67,10.08q5.67,0,5.67-10.08T202.59,21.23Z" transform="translate(0 -0.25)" style="fill:#3f3d56"/><path d="M247,26.09V39.41a11,11,0,0,0,1.2,5.64,7,7,0,0,1-4.41,1.56q-2.43,0-3.33-1.14a5.69,5.69,0,0,1-.9-3.54V27.65a7.74,7.74,0,0,0-.72-3.87,2.78,2.78,0,0,0-2.58-1.17,8.62,8.62,0,0,0-6.3,3V46.19a20.85,20.85,0,0,1-3.66.3,23,23,0,0,1-3.78-.3V16.49l.42-.36h2.76q3.42,0,4.08,3.6,4.38-3.84,8.73-3.84t6.42,2.82A12.17,12.17,0,0,1,247,26.09Z" transform="translate(0 -0.25)" style="fill:#3f3d56"/><path d="M57.26,11a7.37,7.37,0,0,1-.6-3,7.37,7.37,0,0,1,.6-3,8.09,8.09,0,0,1,3.87-.84,7.05,7.05,0,0,1,3.69.84,7.37,7.37,0,0,1,.6,3,7.37,7.37,0,0,1-.6,3,7.46,7.46,0,0,1-3.87.84A6.49,6.49,0,0,1,57.26,11Z" transform="translate(0 -0.25)" style="fill:#fff"/><path d="M198.26,11a7.37,7.37,0,0,1-.6-3,7.37,7.37,0,0,1,.6-3,8.09,8.09,0,0,1,3.87-.84,7.05,7.05,0,0,1,3.69.84,7.37,7.37,0,0,1,.6,3,7.37,7.37,0,0,1-.6,3,7.46,7.46,0,0,1-3.87.84A6.49,6.49,0,0,1,198.26,11Z" transform="translate(0 -0.25)" style="fill:#fff"/></g></g></svg>

After

Width:  |  Height:  |  Size: 4.3 KiB

2
images/peertube_logo.svg Normal file
View file

@ -0,0 +1,2 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<svg height="682.68799" viewBox="2799 -911 512 682.688" width="512" xmlns="http://www.w3.org/2000/svg"><g stroke-width="32"><path d="m2799-911v341.344l256-170.656" fill="#211f20"/><path d="m2799-569.656v341.344l256-170.656" fill="#737373"/><path d="m3055-740.344v341.344l256-170.656" fill="#f1680d"/></g></svg>

After

Width:  |  Height:  |  Size: 365 B

View file

@ -14,5 +14,5 @@ Une fois l'installation terminée, il vous faudra [**procéder à la post-instal
**Note pour les utilisateurs avancés inquiets à propos de l'approche `curl|bash`**
Si vous êtes suspicieux de la tendance à utiliser `curl|bash` (ou commandes similaires) pour déployer des logiciels, prenez le temps de lire ["Is curl|bash insecure?"](https://sandstorm.io/news/2015-09-24-is-curl-bash-insecure-pgp-verified-install) sur le blog de Sandstom, et possiblement [cette discussion sur Hacker News](https://news.ycombinator.com/item?id=12766350).
Si vous êtes suspicieux de la tendance à utiliser `curl|bash` (ou commandes similaires) pour déployer des logiciels, prenez le temps de lire ["Is curl|bash insecure?"](https://sandstorm.io/news/2015-09-24-is-curl-bash-insecure-pgp-verified-install) sur le blog de Sandstorm, et possiblement [cette discussion sur Hacker News](https://news.ycombinator.com/item?id=12766350).

View file

@ -39,7 +39,7 @@ YunoHost doesn't yet support ARM64 boards. For more information, see [this issue
---
## Install on top or ARMbian
## Install on top of ARMbian
<a class="btn btn-lg btn-default" href="https://www.armbian.com/download/">0. Download the ARMbian image for your board</a>

View file

@ -13,7 +13,7 @@ Here : https://yunohost.org/#/dns_subdomains
### Configure the server
On the OVH panel, you will copy two element :
On the OVH panel, you will copy 3 element :
- the IPv6 address
- the IPv6 gateway address
- the IPv6 prefix. On OVH's VPS SSD, prefixes are `/128` because you have only *one* IPv6 address.
@ -40,7 +40,7 @@ Now, save the file and restart the network service with : `service networking re
Check your configuration with these commands :
- `ip a` to display network interfaces and addresses
- `hostname -I` to display the system IP addresses
- try to ping an IPv6 server (for example you can use `ping ip6.yunohost.org`)
- try to ping an IPv6 server (for example you can use `ping6 ip6.yunohost.org`)
- try to ping your server from your PC (assuming your PC has IPv6 enabled)
If it's ok, it's ok !

46
ipv6_fr.md Normal file
View file

@ -0,0 +1,46 @@
# Configuration de l'IPv6
L'IPv6 peut fonctionner directement dans certains cas. Mais dans d'autres, ou chez certains hébergeurs spécifiques, vous devez activer l'IPv6 manuellement.
## Avec un VPS chez OVH
OVH donne une adresse IPv4 et une IPv6 pour ses VPS, mais par défaut, seule l'IPv4 fonctionne.
La documentation d'OVH à ce sujet est ici : https://docs.ovh.com/gb/en/vps/configuring-ipv6/
### Configurer le serveur DNS
Ici : https://yunohost.org/#/dns_subdomains
### Configurer le serveur
Sur le panneau de gestion d'OVH, vous aller récupérer 3 informations :
- l'adresse IPv6 du serveur
- l'adresse passerelle IPv6
- le préfixe IPv6. Les offres VPS SSD d'OVH ne fournissent qu'**une** seule adresse IPV6, le préfixe est donc `/128`
Sur votre VPS, vous aller créer une sauvegarde de votre fichier de configuration des interfaces réseau dans votre répertoire home avec la commande : `cp /etc/network/interfaces ~/interfaces`.
Ensuite, vous pouvez modifier le fichier de configuration `/etc/network/interfaces`).
<div class="alert alert-warning" markdown="1">
Dans cet exemple, nous considérons que votre interface réseau est `eth0`. Si elle est différente (vérifiez avec `ip a`) vous devez adapter l'exemple pour correspondre à votre situation.
</div>
```plaintext
iface eth0 inet6 static
address <votre adresse IPv6>
netmask <votre préfixe IPv6>
post-up /sbin/ip -6 route add <la passerelle IPv6> dev eth0
post-up /sbin/ip -6 route add default via <la passerelle IPv6> dev eth0
pre-down /sbin/ip -6 route del default via <la passerelle IPv6> dev eth0
pre-down /sbin/ip -6 route del <la passerelle IPv6> dev eth0
```
Maintenant, enregistrez le fichier et redémarrez les services réseau avec : `service networking restart`. (TODO : ideally we should find a way to validate the content of the configuration, otherwise it could fuck up the network stack and get disconnected from the VPS ?)
Vérifiez votre configuration avec les commandes :
- `ip a` pour afficher les adresses IP des interfaces
- `hostname -I` pour afficher les adresses IP du système
- essayez de faire un test de `ping` sur un serveur IPv6 (vous pouvez utiliser `ping6 ipv6.yunohost.org`)
- essayez de faire un test de `ping` sur votre server depuis votre PC (cela exige que votre PC puisse utiliser l'IPv6)
Et voilà !

View file

@ -18,7 +18,7 @@ Tous les fournisseurs daccès à Internet [membres de la Fédération French
| **[UPnP](https://fr.wikipedia.org/wiki/Universal_Plug_and_Play)** | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| **[Port 25 ouvrable](/email)**<br> (fermé par défaut) | ✔ | ✔ | ✔ | ✘ | ✔ | ✔ |
| **[Hairpinning](http://fr.wikipedia.org/wiki/Hairpinning)** | ✔ | ✔ | ✔/✘ | ✔ (depuis la Livebox 4) | ✔ | ✔ |
| **[Reverse DNS](https://en.wikipedia.org/wiki/Reverse_DNS_lookup)<br>personnalisable ** | ✔ | ✔ (sauf IPv6) pas de support | … | ✘ | ✘ | ✘ |
| **[Reverse DNS](https://en.wikipedia.org/wiki/Reverse_DNS_lookup)<br>personnalisable ** | ✔ | ✔ (sauf IPv6, pas de support, et buggué sur certaines plages d'adresses ipv4) | … | ✘ | ✘ | ✘ |
| **[IP fixe](/dns_dynamicip)** | ✔ | ✔ | ✔/✘ | ✘ | ✔ | ✔ |
| **[IPv6](https://fr.wikipedia.org/wiki/IPv6)** | ✔ | ✔ | ✔ | ✔ | … | … |
| **[Non listé sur le DUL](https://en.wikipedia.org/wiki/Dialup_Users_List)** | … | ✘ | … | … | … | … |

View file

@ -45,6 +45,11 @@ writing your manifest for the application installation.
You need to write an `actions.toml` file in your application at the root level
like the `manifest.toml`/`manifest.json`.
<div class="alert alert-info">
The arguments are written in **[YunoHost Arguments
Format](#/packaging_apps_arguments_format)** like in `manifest.toml/json`
</div>
The general pattern looks like this:
```toml
@ -67,7 +72,7 @@ accepted_return_codes = [0, 1, 2, 3] # optional otherwise only "0" will be a no
# here, you put a list of arguments exactly like in manifest.toml/json
[first_action.arguments.first_argument]
type = "string"
ask = "service to restart"
ask.en = "service to restart"
example = "nginx"
... # add more arguments here if needed
@ -80,7 +85,7 @@ command = "systemctl restart some_service"
[another_action.arguments]
[another_action.arguments.argument_one]
type = "string"
ask = "some stuff"
ask.en = "some stuff"
example = "stuff"
... # add more arguments here if needed

View file

@ -0,0 +1,303 @@
# YunoHost 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 = "the question in french"
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
},
```
### 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"
}
},
```

View file

@ -60,6 +60,11 @@ REALLY wants it but we really don't recommend it has it is very error prone and
frustrating to write by hand) that will be located at the root of you
application, next to the manifest.json/toml. It looks like this:
<div class="alert alert-info">
The options are written in **[YunoHost Arguments
Format](#/packaging_apps_arguments_format)** like in `manifest.toml/json`
</div>
```toml
version = "0.1" # version number, not used yet but important
name = "name that will be displayed on the admin"
@ -72,7 +77,7 @@ name = "name of the section that will be displayed"
# those arguments are in yunohost argument format like manifest.json
[section_id.sub_section_id.option_id]
ask = "the text displayed for the option"
ask.en = "the text displayed for the option"
type = "argument_option"
default = true
help = "A public Leed will be accessible for third party apps.<br>By turning on 'anonymous readers' in Leed configuration, you can made your feeds public."
@ -108,7 +113,7 @@ name = "Leed configuration"
# those arguments are in yunohost argument format
[main.is_public.is_public]
ask = "Is it a public website ?"
ask.en = "Is it a public website ?"
type = "boolean"
default = true
help = "A public Leed will be accessible for third party apps.<br>By turning on 'anonymous readers' in Leed configuration, you can made your feeds public."
@ -118,13 +123,13 @@ name = "Leed configuration"
name = "Overwriting config files"
[main.overwrite_files.overwrite_nginx]
ask = "Overwrite the nginx config file ?"
ask.en = "Overwrite the nginx config file ?"
type = "boolean"
default = true
help = "If the file is overwritten, a backup will be created."
[main.overwrite_files.overwrite_phpfpm]
ask = "Overwrite the php-fpm config file ?"
ask.en = "Overwrite the php-fpm config file ?"
type = "boolean"
default = true
help = "If the file is overwritten, a backup will be created."