Refactor admin guide

Co-authored-by: ljf (zamentur) <zamentur@users.noreply.github.com>
Co-authored-by: nathanael-h <7300309+nathanael-h@users.noreply.github.com>
This commit is contained in:
tituspijean 2022-04-23 16:08:50 +02:00
parent 1d45295ecb
commit 77d721485a
No known key found for this signature in database
GPG key ID: EF3B0D7CC0A94720
151 changed files with 92 additions and 85 deletions

View file

@ -25,7 +25,7 @@ Ein VPN ist ein verschlüsselter Tunnel zwischen zwei Computern. In der Praxis s
### Auf einem Remote-Server (VPS oder dedizierter Server) ### Auf einem Remote-Server (VPS oder dedizierter Server)
Sie können einen virtuellen privaten Server oder eine dedizierte Maschine von [associative](https://db.ffdn.org/) oder von anderen kommerziellen "Cloud"-Anbietern mieten. Sie können einen virtuellen privaten Server oder eine dedizierte Maschine von [associative](https://db.ffdn.org/) oder von anderen [kommerziellen](/providers/server) "Cloud"-Anbietern mieten.
- **Pros** : Ihr Server und seine Internetverbindung sind schnell; - **Pros** : Ihr Server und seine Internetverbindung sind schnell;
- **Cons** : Sie müssen ein monatliches Abonnement bezahlen und haben keine physische Kontrolle über Ihren Server. - **Cons** : Sie müssen ein monatliches Abonnement bezahlen und haben keine physische Kontrolle über Ihren Server.

View file

@ -1,5 +1,5 @@
--- ---
title: Elegir manera de autohospedaje title: Elegir manera y proveedores de autohospedaje
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs
@ -25,7 +25,7 @@ Una VPN es un tunel encriptado entre dos máquinas. En la práctica, permite hac
### En un servidor remoto (VPS o servidor dedicado) ### En un servidor remoto (VPS o servidor dedicado)
Puedes alquilar un servidor privado virtual (VPS) o una máquina dedicada a alojamientos [asociativos](https://db.ffdn.org/) o comerciales. Puedes alquilar un servidor privado virtual (VPS) o una máquina dedicada a alojamientos [asociativos](https://db.ffdn.org/) o [comerciales](/providers/server).
- **Ventajas**: Tu servidor será rápido y su conexión veloz. - **Ventajas**: Tu servidor será rápido y su conexión veloz.
- **Desventajas**: Ocasiona un gasto mensual por la máquina, y no tienes control físico. - **Desventajas**: Ocasiona un gasto mensual por la máquina, y no tienes control físico.

View file

@ -1,5 +1,5 @@
--- ---
title: Choisir son mode d'autohébergement title: Choisir son mode et fournisseurs d'autohébergement
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs
@ -25,7 +25,7 @@ Un VPN est un tunnel chiffré entre deux machines. En pratique, cela permet de f
### Sur un serveur distant (VPS ou serveur dédié) ### Sur un serveur distant (VPS ou serveur dédié)
Vous pouvez louer un serveur privé virtuel ou une machine dédiée à des hébergeurs [associatifs](https://db.ffdn.org/) ou commerciaux. Vous pouvez louer un serveur privé virtuel ou une machine dédiée à des hébergeurs [associatifs](https://db.ffdn.org/) ou [commerciaux](/providers/server).
- **Avantages** : votre serveur sera rapide et la connectivité internet sera bonne ; - **Avantages** : votre serveur sera rapide et la connectivité internet sera bonne ;
- **Inconvénients** : il vous faudra payer des frais mensuels pour la machine, et vous n'aurez pas de contrôle physique dessus. - **Inconvénients** : il vous faudra payer des frais mensuels pour la machine, et vous n'aurez pas de contrôle physique dessus.

View file

@ -1,5 +1,5 @@
--- ---
title: Scegliere il proprio self-hosting title: Scegliere il tuo metodo e provider de self-hosting
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs
@ -25,7 +25,7 @@ Una VPN è un tunnel criptato tra due macchine. In pratica permette di avere una
### Su un server distante (VPS o server dedicato) ### Su un server distante (VPS o server dedicato)
Puoi affittare un server virtuale privato o un macchina dedicata da fornitori "Cloud" come [associazioni](https://db.ffdn.org) o commerciali Puoi affittare un server virtuale privato o un macchina dedicata da fornitori "Cloud" come [associazioni](https://db.ffdn.org) o [commerciali](/providers/server)
- **Pro**: il tuo server e la connessione saranno veloci; - **Pro**: il tuo server e la connessione saranno veloci;
- **Contro**: dovrai pagare un canone mensile per la macchina e non avrai il controllo fisico del tuo server. - **Contro**: dovrai pagare un canone mensile per la macchina e non avrai il controllo fisico del tuo server.

View file

@ -1,5 +1,5 @@
--- ---
title: How to host yourself? title: Choose your selfhosting method and providers
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs
@ -25,7 +25,7 @@ A VPN is an encrypted tunnel between two machines. In practice, it makes it "as
### On a remote server (VPS or dedicated server) ### On a remote server (VPS or dedicated server)
You can rent a virtual private server or a dedicated machine from [associative](https://db.ffdn.org/) or commercial "Cloud" providers. You can rent a virtual private server or a dedicated machine from [associative](https://db.ffdn.org/) or [commercial](/providers/server) "Cloud" providers.
- **Pros** : your server and its internet connectivity will be fast; - **Pros** : your server and its internet connectivity will be fast;
- **Cons** : you will have to pay a monthly subscription and won't have physical control of your server. - **Cons** : you will have to pay a monthly subscription and won't have physical control of your server.

View file

@ -33,6 +33,8 @@ Ein weiterer wichtiger Aspekt der Domain-Konfiguration ist das SSL/HTTPS-Zertifi
## Unterpfade vs. einzelne Domains pro Anwendungen ## Unterpfade vs. einzelne Domains pro Anwendungen
!!!! Section to be moved to a translated /apps_overview page
Im Zusammenhang mit YunoHost ist es durchaus üblich, eine einzige (oder einige wenige) Domains zu haben, auf denen mehrere Anwendungen in "Unterpfaden" installiert sind, so dass man am Ende etwas wie dieses erhält: Im Zusammenhang mit YunoHost ist es durchaus üblich, eine einzige (oder einige wenige) Domains zu haben, auf denen mehrere Anwendungen in "Unterpfaden" installiert sind, so dass man am Ende etwas wie dieses erhält:
```bash ```bash

View file

@ -44,28 +44,3 @@ YunoHost peut générer une configuration DNS recommandée pour chaque domaine,
## Certificats SSL/HTTPS ## Certificats SSL/HTTPS
Un autre aspect important de la configuration des domaines est le certificat SSL/HTTPS. YunoHost est intégré avec Let's Encrypt, de sorte qu'une fois que votre serveur est correctement accessible depuis n'importe qui sur Internet via le nom de domaine, l'administrateur peut demander l'installation d'un certificat Let's Encrypt. Voir la documentation sur les [certificats](/certificate) pour plus d'informations. Un autre aspect important de la configuration des domaines est le certificat SSL/HTTPS. YunoHost est intégré avec Let's Encrypt, de sorte qu'une fois que votre serveur est correctement accessible depuis n'importe qui sur Internet via le nom de domaine, l'administrateur peut demander l'installation d'un certificat Let's Encrypt. Voir la documentation sur les [certificats](/certificate) pour plus d'informations.
## Sous-chemins vs. domaines individuels par application
Dans le contexte de YunoHost, il est assez courant d'avoir un seul (ou quelques) domaines sur lesquels plusieurs applications sont installées dans des "sous-chemins", de sorte que l'on se retrouve avec quelque chose comme ceci :
```bash
yolo.com
├─── /blog : Wordpress (un blog)
├─── /cloud : Nextcloud (un service de cloud)
├─── /rss : TinyTiny RSS (un lecteur RSS)
├─── /wiki : DokuWiki (un wiki)
```
Alternativement, on peut choisir d'installer chaque application (ou certaines) sur un domaine dédié. Au delà de la question esthétique, utiliser des sous-domaines au lieu de sous-chemins permet de laisser la possibilité de déplacer un service sur un autre serveur plus facilement. Par ailleurs, certaines applications peuvent avoir besoin d'un domaine entier qui leur est dédié, pour des raisons techniques. L'inconvénient est que vous devez ajouter un nouveau domaine à chaque fois, et donc potentiellement configurer des enregistrements DNS supplémentaire, relancer le diagnostique et l'installation d'un nouveau certificat Let's Encrypt.
Si toutes les applications de l'exemple précédent étaient installées sur un domaine séparé, cela donnerait quelque chose comme ceci :
```bash
blog.yolo.com : Wordpress (un blog)
cloud.yolo.com : Nextcloud (un service de cloud)
rss.yolo.com : TinyTiny RSS (un lecteur RSS)
wiki.yolo.com : DokuWiki (un wiki)
```
!!! De nombreuses applications intègrent une fonctionnalité qui vous permet de changer l'URL de votre application. Ce choix entre sous-chemin et sous-domaine peut donc dans certains cas être réversible via une simple manipulation dans l'interface d'administration.

View file

@ -48,30 +48,3 @@ YunoHost can generate a recommended DNS configuration for each domain, including
## SSL/HTTPS certificates ## SSL/HTTPS certificates
Another important aspect of domain configuration is the SSL/HTTPS certificate. YunoHost is integrated with Let's Encrypt, so once your server is correctly reachable from anybody on the internet through the domain name, the administrator can request a Let's Encrypt certificate. See the documentation about [certificates](/certificate) for more information. Another important aspect of domain configuration is the SSL/HTTPS certificate. YunoHost is integrated with Let's Encrypt, so once your server is correctly reachable from anybody on the internet through the domain name, the administrator can request a Let's Encrypt certificate. See the documentation about [certificates](/certificate) for more information.
## Subpaths vs. individual domains per apps
In the context of YunoHost, it is quite common to have a single (or a few) domains on which several apps are installed in "subpaths", so that you end up with something like this:
```bash
yolo.com
├── /blog : Wordpress (a blog)
├── /cloud : Nextcloud (a cloud service)
├── /rss : TinyTiny RSS (a RSS reader)
├── /wiki : DokuWiki (a wiki)
```
Alternatively, you may choose to install each (or some) apps on a dedicated domain. Beyond the aesthetic, using sub-domains instead of sub-paths allows the possibility to move a service to another server more easily. Also, some applications may need an entire domain dedicated to them, for technical reasons. The disadvantage is that you have to add a new domain each time, and therefore potentially configure additional DNS records, restart the diagnostics and install a new Let's Encrypt certificate.
This might look prettier for end users, but is generally considered more complicated and less efficient in the context of YunoHost, since you need to add a new domain each time. Nevertheless, some apps might need an entire domain dedicated to them, for technical reasons.
If all apps from the previous example were installed on a separate domain, this would give something like this:
```bash
blog.yolo.com : Wordpress (a blog)
cloud.yolo.com : Nextcloud (a cloud service)
rss.yolo.com : TinyTiny RSS (a RSS reader)
wiki.yolo.com : DokuWiki (a wiki)
```
!!! Many applications integrate a functionality that allows you to change the URL of your application. This choice between subpath and subdomain can be reversed in some cases via a simple manipulation in the administration interface.

View file

@ -46,3 +46,28 @@ L'accès aux applications peut être limité à certains utilisateurs seulement.
## Packaging d'applications ## Packaging d'applications
Si vous voulez apprendre ou contribuer à l'empaquetage des applications, veuillez consulter la [documentation des contributeurs](/contributordoc). Si vous voulez apprendre ou contribuer à l'empaquetage des applications, veuillez consulter la [documentation des contributeurs](/contributordoc).
## Sous-chemins vs. domaines individuels par application
Dans le contexte de YunoHost, il est assez courant d'avoir un seul (ou quelques) domaines sur lesquels plusieurs applications sont installées dans des "sous-chemins", de sorte que l'on se retrouve avec quelque chose comme ceci :
```bash
yolo.com
├─── /blog : Wordpress (un blog)
├─── /cloud : Nextcloud (un service de cloud)
├─── /rss : TinyTiny RSS (un lecteur RSS)
├─── /wiki : DokuWiki (un wiki)
```
Alternativement, on peut choisir d'installer chaque application (ou certaines) sur un domaine dédié. Au delà de la question esthétique, utiliser des sous-domaines au lieu de sous-chemins permet de laisser la possibilité de déplacer un service sur un autre serveur plus facilement. Par ailleurs, certaines applications peuvent avoir besoin d'un domaine entier qui leur est dédié, pour des raisons techniques. L'inconvénient est que vous devez ajouter un nouveau domaine à chaque fois, et donc potentiellement configurer des enregistrements DNS supplémentaire, relancer le diagnostique et l'installation d'un nouveau certificat Let's Encrypt.
Si toutes les applications de l'exemple précédent étaient installées sur un domaine séparé, cela donnerait quelque chose comme ceci :
```bash
blog.yolo.com : Wordpress (un blog)
cloud.yolo.com : Nextcloud (un service de cloud)
rss.yolo.com : TinyTiny RSS (un lecteur RSS)
wiki.yolo.com : DokuWiki (un wiki)
```
!!! De nombreuses applications intègrent une fonctionnalité qui vous permet de changer l'URL de votre application. Ce choix entre sous-chemin et sous-domaine peut donc dans certains cas être réversible via une simple manipulation dans l'interface d'administration.

View file

@ -35,6 +35,33 @@ Applications may support integration with the LDAP / Single Sign On system, such
Some applications support the ability to be installed several times (at different locations) ! To do so, just go another time in Applications > Install, and select again the application to install. Some applications support the ability to be installed several times (at different locations) ! To do so, just go another time in Applications > Install, and select again the application to install.
## Subpaths vs. individual domains per apps
In the context of YunoHost, it is quite common to have a single (or a few) domains on which several apps are installed in "subpaths", so that you end up with something like this:
```bash
yolo.com
├── /blog : Wordpress (a blog)
├── /cloud : Nextcloud (a cloud service)
├── /rss : TinyTiny RSS (a RSS reader)
├── /wiki : DokuWiki (a wiki)
```
Alternatively, you may choose to install each (or some) apps on a dedicated domain. Beyond the aesthetic, using sub-domains instead of sub-paths allows the possibility to move a service to another server more easily. Also, some applications may need an entire domain dedicated to them, for technical reasons. The disadvantage is that you have to add a new domain each time, and therefore potentially configure additional DNS records, restart the diagnostics and install a new Let's Encrypt certificate.
This might look prettier for end users, but is generally considered more complicated and less efficient in the context of YunoHost, since you need to add a new domain each time. Nevertheless, some apps might need an entire domain dedicated to them, for technical reasons.
If all apps from the previous example were installed on a separate domain, this would give something like this:
```bash
blog.yolo.com : Wordpress (a blog)
cloud.yolo.com : Nextcloud (a cloud service)
rss.yolo.com : TinyTiny RSS (a RSS reader)
wiki.yolo.com : DokuWiki (a wiki)
```
!!! Many applications integrate a functionality that allows you to change the URL of your application. This choice between subpath and subdomain can be reversed in some cases via a simple manipulation in the administration interface.
## Tile management ## Tile management
Web applications can provide tiles available from the user portal, it is possible to choose whether or not to display them and redefine the text via the web administration interface `Applications > APP name > Operations > Manage labels and tiles` or via the command line: `yunohost app change-label <app> "New text"`. Web applications can provide tiles available from the user portal, it is possible to choose whether or not to display them and redefine the text via the web administration interface `Applications > APP name > Operations > Manage labels and tiles` or via the command line: `yunohost app change-label <app> "New text"`.
@ -46,3 +73,4 @@ Access to apps can be restricted to some users only. This can be configured via
## Applications packaging ## Applications packaging
If you want to learn or contribute to app packaging, please check the [contributor documentation](/contributordoc). If you want to learn or contribute to app packaging, please check the [contributor documentation](/contributordoc).

View file

@ -1,6 +1,6 @@
--- ---
title: Übersicht des YunoHost Ökosystems title: Übersicht des YunoHost Ökosystems
menu: Geführte Tour menu: Geführte Tour für den Admin
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs

View file

@ -1,6 +1,6 @@
--- ---
title: Vue d'ensemble de l'écosystème YunoHost title: Vue d'ensemble de l'écosystème YunoHost
menu: Visite guidée menu: Visite guidée pour l'administrateur
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs

View file

@ -1,6 +1,6 @@
--- ---
title: Vista d'insieme dell'ecosistema YunoHost title: Vista d'insieme dell'ecosistema YunoHost
menu: Tour guidato menu: Tour guidato per l'amministratore
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs

View file

@ -1,6 +1,6 @@
--- ---
title: Overview of the YunoHost ecosystem title: Overview of the YunoHost ecosystem
menu: Guided tour menu: Guided tour for the admin
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs

View file

@ -1,10 +0,0 @@
---
title: Cas d'usage spécifiques
template: docs
taxonomy:
category: docs
routes:
default: '/specific_use_cases'
---
Dans les pages suivantes, vous trouverez des explications spécifiques à certains cas d'utilisation

View file

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

Some files were not shown because too many files have changed in this diff Show more