mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
(Grav GitSync) Automatic Commit from Yunobot
This commit is contained in:
Yunobot
parent
f143dea554
commit
ceb7a25a86
23 changed files with 295 additions and 268 deletions
|
|
@ -5,7 +5,7 @@ taxonomy:
|
|||
category: docs
|
||||
---
|
||||
|
||||
<img src="/images/YunoHost_logo_vertical.png" width=400>
|
||||
|
||||
|
||||
YunoHost est un **système d’exploitation** qui vise à simplifier autant que possible l'administration d'un **serveur** pour ainsi démocratiser [l’auto-hébergement](/selfhosting) tout en restant fiable, sécurisé, éthique et léger. C'est un projet de logiciel libre maintenu exclusivement par des bénévoles. Techniquement, il peut être vu comme une distribution basée sur [Debian GNU/Linux](https://debian.org) et peut s'installer sur [de nombreux types de matériel](/install).
|
||||
|
||||
|
|
|
|||
|
|
@ -5,23 +5,23 @@ taxonomy:
|
|||
category: docs
|
||||
---
|
||||
|
||||
<img src="/images/YunoHost_logo_vertical.png" width=400>
|
||||
|
||||
|
||||
YunoHost is an **operating system** aiming for the simplest administration of a **server**, and therefore democratize [self-hosting](selfhosting), while making sure it stays reliable, secure, ethical and lightweight. It is a copylefted libre software project maintained exclusively by volunteers. Technically, it can be seen as a distribution based on [Debian GNU/Linux](https://debian.org) and can be installed on [many kinds of hardware](install).
|
||||
|
||||
## Features
|
||||
|
||||
- <img src="/images/icon-debian.png" width=32 style="margin-right:5px"> Based on Debian;
|
||||
- <img src="/images/icon-tools.png" width=32 style="margin-right:5px" width=64> Administrate your server through a **friendly web interface** ;
|
||||
- <img src="/images/icon-package.png" width=32 style="margin-right:5px"> Deploy **apps in just a few clicks**;
|
||||
- <img src="/images/icon-users.png" width=32 style="margin-right:5px"> Manage **users** <small>(based on LDAP)</small>;
|
||||
- <img src="/images/icon-globe.png" width=32 style="margin-right:5px"> Manage **domain names**;
|
||||
- <img src="/images/icon-medic.png" width=32 style="margin-right:5px"> Create and restore **backups**;
|
||||
- <img src="/images/icon-door.png" width=32 style="margin-right:5px"> Connect to all apps simultaneously through the **user portal** <small>(NGINX, SSOwat)</small>;
|
||||
- <img src="/images/icon-mail.png" width=32 style="margin-right:5px"> Includes a **full e-mail stack** <small>(Postfix, Dovecot, Rspamd, DKIM)</small>;
|
||||
- <img src="/images/icon-messaging.png" width=32 style="margin-right:5px">... as well as **an instant messaging server** <small>(XMPP)</small>;
|
||||
- <img src="/images/icon-lock.png" width=32 style="margin-right:5px"> Manages **SSL certificates** <small>(based on Let's Encrypt)</small> ;
|
||||
- <img src="/images/icon-shield.png" width=32 style="margin-right:5px">... and **security systems** <small>(Fail2ban, yunohost-firewall)</small>;
|
||||
-  Based on Debian;
|
||||
-  Administrate your server through a **friendly web interface** ;
|
||||
-  Deploy **apps in just a few clicks**;
|
||||
-  Manage **users** <small>(based on LDAP)</small>;
|
||||
-  Manage **domain names**;
|
||||
-  Create and restore **backups**;
|
||||
-  Connect to all apps simultaneously through the **user portal** <small>(NGINX, SSOwat)</small>;
|
||||
-  Includes a **full e-mail stack** <small>(Postfix, Dovecot, Rspamd, DKIM)</small>;
|
||||
- ... as well as **an instant messaging server** <small>(XMPP)</small>;
|
||||
-  Manages **SSL certificates** <small>(based on Let's Encrypt)</small> ;
|
||||
- ... and **security systems** <small>(Fail2ban, yunohost-firewall)</small>;
|
||||
|
||||
## Origin
|
||||
|
||||
|
|
@ -35,7 +35,7 @@ All that was needed was an admin interface for Beudbeud's server to make somethi
|
|||
Noting the growing enthusiasm around YunoHost and around self-hosting in general, the original developers along with new contributors decided to start work on version 2, a more extensible, more powerful, more easy-to-use, and at that, one that makes a nice cup of fair-trade coffee for the elves of Lapland.
|
||||
|
||||
The name **YunoHost** comes from the jargon "Y U NO Host". The [Internet meme](https://en.wikipedia.org/wiki/Internet_meme) should illustrate it:
|
||||
<div class="text-center"><img style="border-radius: 5px; box-shadow: 0 5px 15px rgba(0,0,0,0.15);" src="/images/dude_yunohost.jpg"></div>
|
||||
|
||||
|
||||
## What YunoHost is not?
|
||||
|
||||
|
|
@ -49,10 +49,7 @@ You can host your friends, your family and your company safely and with ease, bu
|
|||
|
||||
Black and white YunoHost PNG logo by ToZz (400 × 400 px):
|
||||
|
||||
<a href="/images/ynh_logo_black_300dpi.png"><img src="/images/ynh_logo_black_300dpi.png" width=220></a>
|
||||
|
||||
<a href="/images/ynh_logo_white_300dpi.png"><img src="/images/ynh_logo_white_300dpi.png" width=220></a>
|
||||
|
||||
Click to download.
|
||||
[](image://ynh_logo_black_300dpi.png)
|
||||
[](image://ynh_logo_white_300dpi.png)
|
||||
|
||||
Licence: CC-BY-SA 4.0
|
||||
|
|
|
|||
|
|
@ -5,28 +5,17 @@ taxonomy:
|
|||
category: docs
|
||||
---
|
||||
|
||||
<div class="alert alert-warning" markdown="1">
|
||||
**Note:** This demo server could be down from time to time.
|
||||
<br>
|
||||
! This demo server could be down from time to time.
|
||||
|
||||
</div>
|
||||
[center]
|
||||
[columns]
|
||||
[<i class="fa fa-user"></i> User interface](https://demo.yunohost.org/?target=_blank&classes=btn,btn-lg,btn-success)
|
||||
Username: demo
|
||||
Password: demo
|
||||
|
||||
<br>
|
||||
[<i class="fa fa-user"></i> Administration interface](https://demo.yunohost.org/yunohost/admin?target=_blank&classes=btn,btn-lg,btn-primary)
|
||||
Password: demo</p>
|
||||
[/columns]
|
||||
[/center]
|
||||
|
||||
<div class="row text-center">
|
||||
<div class="col-md-6">
|
||||
<a href="https://demo.yunohost.org/" target="_blank" class="btn btn-success btn-lg"><span class="glyphicon glyphicon-user"></span> User interface</a>
|
||||
<p class="text-muted">Username: demo<br>Password: demo</p>
|
||||
</div>
|
||||
<div class="col-md-5">
|
||||
<a href="https://demo.yunohost.org/yunohost/admin" target="_blank" class="btn btn-primary btn-lg"><span class="glyphicon glyphicon-lock"></span> Administration interface</a>
|
||||
<p class="text-muted">Password: demo</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<br>
|
||||
|
||||
<p class="text-center" markdown="1">
|
||||
***Demo server gracefully provided by
|
||||
<a href="https://www.gitoyen.net" target="_blank">Gitoyen</a>***
|
||||
</p>
|
||||
!!! **Demo server gracefully provided by [Gitoyen](https://www.gitoyen.net?target=_blank)**
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ You can host yourself at home (on a small computer), or on a remote server. Each
|
|||
You can host yourself at home with an ARM board or a re-purposed regular computer, connected to your home router/box.
|
||||
|
||||
- **Pros** : you will have physical control of the machine and only need to buy the hardware;
|
||||
- **Cons** : you will have to [manually configure your internet box](isp_box_config) and [might be limited by your ISP](isp).
|
||||
- **Cons** : you will have to [manually configure your internet box](/administrate/postinstall/ispbox) and [might be limited by your ISP](/administrate/advance/isp).
|
||||
|
||||
### At home, behind a VPN
|
||||
|
||||
|
|
|
|||
|
|
@ -10,7 +10,7 @@ YunoHost can be installed on the following hardware :
|
|||
- 'Old' desktop computers or laptops ;
|
||||
- Remote servers, a.k.a Virtual Private Servers (VPS).
|
||||
|
||||
Corresponding installation guides can be found on [this page](/install).
|
||||
Corresponding installation guides can be found on [this page](/administrate/install).
|
||||
|
||||
### Minimum requirements
|
||||
|
||||
|
|
|
|||
|
|
@ -0,0 +1,8 @@
|
|||
---
|
||||
title: YunoHost images
|
||||
flex:
|
||||
directory: images
|
||||
---
|
||||
|
||||
# YunoHost images
|
||||
|
||||
|
|
@ -5,18 +5,18 @@ taxonomy:
|
|||
category: docs
|
||||
---
|
||||
|
||||
*Find other ways to install YunoHost **[here](/install)**.*
|
||||
## Requirements
|
||||
|
||||
### Requirements
|
||||
|
||||
<img src="/images/laptop.png" width=200>
|
||||
<img src="/images/desktop.jpg">
|
||||
<img src="/images/nettop.jpg">
|
||||
[center]
|
||||
|
||||
|
||||
|
||||
[/center]
|
||||
|
||||
* A x86-compatible hardware dedicated to YunoHost: laptop, nettop, netbook, desktop.
|
||||
You can use any computer with **256MB RAM or more**.
|
||||
* Another computer to read this guide and access to your server.
|
||||
* A [reasonable ISP](/isp), preferably with a good and unlimited upstream bandwidth
|
||||
* A [reasonable ISP](/administrate/advance/isp), preferably with a good and unlimited upstream bandwidth
|
||||
* A **USB stick** of at least 1GB capacity **OR** a standard **blank CD**
|
||||
* ***Particular case*** : If your server has no graphic card, [prepare iso for booting with serial port](https://github.com/luffah/debian-mkserialiso).
|
||||
|
||||
|
|
@ -24,8 +24,7 @@ You can use any computer with **256MB RAM or more**.
|
|||
|
||||
## Installation steps
|
||||
|
||||
|
||||
<a class="btn btn-lg btn-default" href="/images">0. Download the YunoHost ISO image</a>
|
||||
[0. Download the YunoHost ISO image](/administrate/install/iso/images?classes=btn,btn-lg,btn-primary)
|
||||
|
||||
<a class="btn btn-lg btn-default" href="/burn_or_copy_iso">1. Burn the ISO image on a USB stick</a>
|
||||
|
||||
|
|
|
|||
|
|
@ -5,91 +5,66 @@ taxonomy:
|
|||
category: docs
|
||||
---
|
||||
|
||||
There are multiple ways to install YunoHost. The process may differ slightly depending on whether it takes place at home or on a remote server, and depending on the hardware used: **[See the requirements](/hardware)**
|
||||
There are multiple ways to install YunoHost. The process may differ slightly depending on whether it takes place at home or on a remote server, and depending on the hardware used: **[See the requirements](hardware)**.
|
||||
|
||||
This page lists a few installation guides.
|
||||
|
||||
---
|
||||
## Give it a try
|
||||
|
||||
<h1 style="font-weight: 100">Give it a try</h1>
|
||||
[columns][center]
|
||||
|
||||
<div class="row">
|
||||
[[figure caption="Demo server"][/figure]](/administrate/selfhosting/tryyunohost)
|
||||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/try"><img height=150 src="/images/logo.png" style="vertical-align:bottom"><b><p>Demo server</p></b></a>
|
||||
</div>
|
||||
[[figure caption="Try with VirtualBox"]
|
||||
|
||||
[/figure]](/administrate/install/virtualbox)
|
||||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/install_on_virtualbox"><img src="/images/virtualbox.png" height=150 style="vertical-align:bottom"><b><p>Try in VirtualBox</p></b></a>
|
||||
</div>
|
||||
[/center][/columns]
|
||||
|
||||
</div>
|
||||
## Install at home
|
||||
|
||||
[columns count=3][center]
|
||||
|
||||
[[figure class="nomargin" caption="On a Raspberry Pi"]
|
||||
|
||||
[/figure]](/administrate/install/rpi)
|
||||
|
||||
[[figure class="nomargin" caption="On an ARM board"]
|
||||
|
||||
[/figure]](/administrate/install/arm)
|
||||
|
||||
</div>
|
||||
[[figure class="nomargin" caption="On a regular computer"]
|
||||
|
||||
[/figure]](/administrate/install/iso)
|
||||
|
||||
<br>
|
||||
[/center][/columns]
|
||||
|
||||
---
|
||||
## Install on a remote server
|
||||
|
||||
<h1 style="font-weight: 100">Install at home</h1>
|
||||
!!! [fa=fa-heart /] Local associative ISP near you might be able to provide you with a *Virtual Private Server* (VPS), managed by human beings who respect users and care about [Net Neutrality](https://en.wikipedia.org/wiki/Net_neutrality) ! Check out [this page](https://db.ffdn.org/) for more information.
|
||||
|
||||
<div class="row">
|
||||
[center]
|
||||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/install_on_raspberry"><img src="/images/raspberrypi.jpg" height=150 style="vertical-align:bottom"><b><p>On a Raspberry Pi</p></b></a>
|
||||
</div>
|
||||
[[figure class="nomargin" caption="On a dedicated or virtual private server"]
|
||||
|
||||
[/figure]](/administrate/install/vps)
|
||||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/install_on_arm_board"><img src="/images/olinuxino.jpg" height=150 style="vertical-align:bottom; padding:20px"><b><p>On an ARM board</p></b></a>
|
||||
</div>
|
||||
[/center]
|
||||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/install_iso"><img src="/images/computer.png" height=150 style="vertical-align:bottom"><b><p>On a regular computer</p></b></a>
|
||||
</div>
|
||||
## Advanced / others
|
||||
|
||||
</div>
|
||||
[columns count=3][center]
|
||||
|
||||
<br>
|
||||
[[figure class="nomargin" caption="On Debian 10 Buster"]
|
||||
|
||||
[/figure]](/administrate/install/debian)
|
||||
|
||||
[[figure class="nomargin" caption="Dev environment in LXD/LXC"]
|
||||
|
||||
[/figure]](/contribute/dev)
|
||||
|
||||
---
|
||||
[[figure class="nomargin" caption="(Non-official!) Docker images"]
|
||||
|
||||
[/figure]](/administrate/install/docker)
|
||||
|
||||
<h1 style="font-weight: 100">Install on a remote server</h1>
|
||||
|
||||
<div class="alert alert-info" markdown="1">
|
||||
<span class="glyphicon glyphicon-heart"></span> Local associative ISP near you might be able to provide you with a *Virtual Private Server* (VPS), managed by human beings who respect users and care about [Net Neutrality](https://en.wikipedia.org/wiki/Net_neutrality) ! Check out [this page](https://db.ffdn.org/) for more information.
|
||||
</div>
|
||||
|
||||
<div class="row">
|
||||
|
||||
<div class="block-center text-center">
|
||||
<a href="/install_on_vps"><img src="/images/vps.png" height=150 style="vertical-align:bottom; text-align:center"><b><p>On a dedicated or virtual private server</p></b></a>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
|
||||
<br>
|
||||
|
||||
---
|
||||
|
||||
<h1 style="font-weight: 100">Advanced / others</h1>
|
||||
|
||||
<div class="row">
|
||||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/install_on_debian"><img height=150 src="/images/debian-logo.png" style="vertical-align:bottom">
|
||||
<b><p>On Debian 10/Buster</p></b></a>
|
||||
</div>
|
||||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/dev"><img src="/images/lxc.png" height=150 style="vertical-align:bottom"><b><p>Dev environment in LXD/LXC</p></b></a>
|
||||
</div>
|
||||
|
||||
<div class="col col-md-3 text-center">
|
||||
<a href="/docker"><img src="/images/docker.png" height=150 style="vertical-align:bottom"><b><p>(Non-official!) Docker images</p></b></a>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
[/center][/columns]
|
||||
|
|
|
|||
|
|
@ -1,69 +1,10 @@
|
|||
---
|
||||
title: Guide de l'administrateur
|
||||
template: docs
|
||||
title: Administrer
|
||||
template: chapter
|
||||
taxonomy:
|
||||
category: docs
|
||||
---
|
||||
|
||||
* Découvrir l'auto-hébergement
|
||||
* [Qu'est-ce que l'auto-hébergement](/selfhosting)
|
||||
* [Qu'est-ce que YunoHost](/whatsyunohost)
|
||||
* [Essayer YunoHost](/try)
|
||||
* [Choisir son mode d'hébergement](/howtohostyourself)
|
||||
* [Matériel compatible](/hardware)
|
||||
* [À propos des fournisseurs d'accès internet](/isp)
|
||||
* [Guide d’installation](/install)
|
||||
* [Sur un ordinateur "standard"](/install_iso)
|
||||
* [Sur un serveur dédié ou virtuel (VPS)](/install_on_vps)
|
||||
* [Sur un Raspberry Pi](/install_on_raspberry)
|
||||
* [Sur une carte ARM](/install_on_arm_board)
|
||||
* [Sur Debian](/install_on_debian)
|
||||
* [Sur VirtualBox](/install_on_virtualbox)
|
||||
* Finaliser son installation
|
||||
* [Post-installation](/postinstall)
|
||||
* [Configurer les redirections de port](/isp_box_config)
|
||||
* [Configurer les enregistrements DNS](/dns_config)
|
||||
* [Installer un certificat SSL](/certificate)
|
||||
* [Diagnostic du bon fonctionnement du YunoHost](/diagnostic)
|
||||
* Apprendre à connaitre YunoHost
|
||||
* [Vue d'ensemble de YunoHost](/overview)
|
||||
* [Conseil généraux](/guidelines)
|
||||
* [L'interface d'administration web](/admin)
|
||||
* [SSH](/ssh) et [l'administration en ligne de commande](/commandline)
|
||||
* [Les utilisateurs et le SSO](/users)
|
||||
* [Les groupes et les permissions](/groups_and_permissions)
|
||||
* [Les applications](/apps_overview)
|
||||
* [Les domaines, la configuration DNS et les certificats](/domains)
|
||||
* [Les emails](/email)
|
||||
* [Formulaires pour enlever son adresse IP des listes noires](/blacklist_forms)
|
||||
* [XMPP](/XMPP)
|
||||
* [Les sauvegardes](/backup)
|
||||
* [Mettre à jour le système](/update) et [les applications](/app_update)
|
||||
* [La sécurité](/security)
|
||||
* Pour aller plus loin
|
||||
* Noms de domaine
|
||||
* [Nom de domaine en noho.st / nohost.me / ynh.fr](/dns_nohost_me)
|
||||
* [Configurer un DNS dynamique avec une adresse IP dynamique](/dns_dynamicip)
|
||||
* [DNS et installation d’une application sur un sous-domaine](/dns_subdomains)
|
||||
* [Gérer les enregistrements DNS chez OVH](/OVH)
|
||||
* Notes à propos de certains fournisseurs d'accès à Internet
|
||||
* [SFR](/isp_sfr)
|
||||
* [Orange](/isp_orange)
|
||||
* [Free](/isp_free)
|
||||
* [Documentation spécifique à certaines apps](/appsdoc)
|
||||
* [Équivalence entre service Framasoft et apps](/apps_framasoft)
|
||||
* [Échanger des fichiers avec son serveur à l'aide d'une interface graphique](/filezilla)
|
||||
* [Modifier l'apparence du portail utilisateur](/theming)
|
||||
* [Ajouter un stockage externe](/external_storage)
|
||||
* [Déplacer un dossier d'app vers un autre stockage](/moving_app_folder)
|
||||
* [Migrer ses emails vers YunoHost](/email_migration)
|
||||
* [YunoHost avec un service caché Tor](/torhiddenservice)
|
||||
* [Utilisation de certificats autres que Let's Encrypt](/certificate_custom)
|
||||
* [Une discussion sur les avantages d'utiliser un VPN](/vpn_advantage)
|
||||
* [Procedure de Migration Stretch->Buster](stretch_buster_migration)
|
||||
* [(vieux) Procedure de Migration Jessie->Stretch](jessie_stretch_migration)
|
||||
* Dépannage
|
||||
* [Changer le mot de passe d’administration](/change_admin_password)
|
||||
* [Récupérer l'accès à son serveur](/noaccess)
|
||||
* [Débannir une IP dans Fail2Ban/IPtables](/fail2ban)
|
||||
* [Configurer l'IPv6](/ipv6)
|
||||
### Administrer
|
||||
|
||||
# Découvrez l'auto-hébergement, comment installer et utiliser YunoHost
|
||||
|
|
|
|||
|
|
@ -1,69 +1,10 @@
|
|||
---
|
||||
title: Administrator documentation
|
||||
template: docs
|
||||
title: Administrate
|
||||
template: chapter
|
||||
taxonomy:
|
||||
category: docs
|
||||
---
|
||||
|
||||
* Discovering self-hosting
|
||||
* [What is Self-hosting](/selfhosting)
|
||||
* [What is YunoHost](/whatsyunohost)
|
||||
* [Try YunoHost](/try)
|
||||
* [How to host yourself](howtohostyourself)
|
||||
* [Choosing hardware](/hardware)
|
||||
* [About the friendliness of internet service providers](/isp)
|
||||
* [Installing YunoHost](/install)
|
||||
* [On a regular computer](/install_iso)
|
||||
* [On a dedicated or a virtual private server](/install_on_vps)
|
||||
* [On a Raspberry Pi](/install_on_raspberry)
|
||||
* [On an ARM board](/install_on_arm_board)
|
||||
* [On Debian](/install_on_debian)
|
||||
* [On VirtualBox](/install_on_virtualbox)
|
||||
* Finalizing your setup
|
||||
* [Post-installation](/postinstall)
|
||||
* [Configuring port forwarding](/isp_box_config)
|
||||
* [Configuring DNS records](/dns_config)
|
||||
* [Installing an SSL certificate](/certificate)
|
||||
* [Diagnose if your setup is working properly](/diagnostic)
|
||||
* Getting to know YunoHost
|
||||
* [Overview of YunoHost](/overview)
|
||||
* [General advices and guidelines](/guidelines)
|
||||
* [Web administration interface](/admin)
|
||||
* [SSH](/ssh) and [command-line administration](/commandline)
|
||||
* [Users and the SSO](/users)
|
||||
* [Groups and permissions](/groups_and_permissions)
|
||||
* [Applications](/apps_overview)
|
||||
* [Domains, DNS and certificates](/domains)
|
||||
* [Email](/email)
|
||||
* [Forms to remove its IP address from the black lists](/blacklist_forms)
|
||||
* [XMPP](/XMPP)
|
||||
* [Backup](/backup)
|
||||
* [Updating the system](/update) and [apps](/app_update)
|
||||
* [Security](/security)
|
||||
* Going further
|
||||
* Domain names
|
||||
* [Noho.st / nohost.me / ynh.fr domain names](/dns_nohost_me)
|
||||
* [Configure a dynamic DNS with a dynamic IP address](/dns_dynamicip)
|
||||
* [DNS and subdomains for apps](/dns_subdomains)
|
||||
* [Managing DNS records at OVH](/OVH)
|
||||
* Notes about some French ISPs
|
||||
* [SFR](/isp_sfr)
|
||||
* [Orange](/isp_orange)
|
||||
* [Free](/isp_free)
|
||||
* [Specific apps documentations](/appsdoc)
|
||||
* [Equivalence between Framasoft service and apps](/apps_framasoft)
|
||||
* [Exchange files with your server using a graphical interface](/filezilla)
|
||||
* [Customize the appearance of the YunoHost portal](/theming)
|
||||
* [Adding an external storage](/external_storage)
|
||||
* [Moving an app folder to an other storage](/moving_app_folder)
|
||||
* [Migrating emails to YunoHost](/email_migration)
|
||||
* [Hide services with Tor](/torhiddenservice)
|
||||
* [Using certificates other than Let's Encrypt](/certificate_custom)
|
||||
* [A discussion about the advantages of using a VPN](/vpn_advantage)
|
||||
* [Stretch->Buster migration procedure](stretch_buster_migration)
|
||||
* [(old) Jessie->Stretch migration procedure](jessie_stretch_migration)
|
||||
* Troubleshooting
|
||||
* [Changing the administration password](/change_admin_password)
|
||||
* [Recover access to your server](/noaccess)
|
||||
* [Unban IPs in IPiptables/Fail2Ban](/fail2ban)
|
||||
* [Configuring IPv6](/ipv6)
|
||||
### Administrate
|
||||
|
||||
# Discover self-hosting, how to install and use YunoHost
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
title: Contributor documentation
|
||||
title: Contribute
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
title: Organisation du projet YunoHost
|
||||
title: Organisation du projet
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
title: YunoHost project organisation
|
||||
title: Project organisation
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
|
|
|
|||
|
|
@ -1,4 +1,9 @@
|
|||
# Mécénes et partenaires
|
||||
---
|
||||
title: Mécénes et partenaires
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
---
|
||||
|
||||
Afin d'avancer et de faire fonctionner le projet, en plus du travail des bénévoles et des dons, YunoHost bénéficie du soutien de mécénes et de partenaires.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,4 +1,9 @@
|
|||
# Sponsors and partners
|
||||
---
|
||||
title: Sponsors and partners
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
---
|
||||
|
||||
In order to advance and make the project works, in addition to the work of volunteers and donations, YunoHost benefits from the support of sponsors and partners.
|
||||
|
||||
|
|
|
|||
|
|
@ -5,26 +5,16 @@ taxonomy:
|
|||
category: docs
|
||||
---
|
||||
|
||||
<p class="lead">
|
||||
YunoHost's documentation has 2 different sections:
|
||||
</p>
|
||||
|
||||
<div class="row text-center">
|
||||
[<i class="fa fa-lock"></i> Administrator's guide](/administrate?classes=btn,btn-lg,btn-primary)
|
||||
Including installation, server management, and application management.
|
||||
|
||||
<div class="col col-md-4 col-md-offset-1">
|
||||
<a class="btn btn-primary btn-lg" href="/admindoc"><span class="glyphicon glyphicon-lock"></span> Administrator guide</a>
|
||||
<p><small class="text-muted">Including installation, server management and application management</small></p>
|
||||
</div>
|
||||
|
||||
<div class="col col-md-4 col-md-offset-1">
|
||||
<a class="btn btn-danger btn-lg" href="/contributordoc"><span class="glyphicon glyphicon-heart"></span> Contributor guide</a>
|
||||
<p><small class="text-muted">Which contains everything you have to know about us and the way we work</small></p>
|
||||
</div>
|
||||
|
||||
</div>
|
||||
[<i class="fa fa-heart"></i> Contributor's guide](/contribute?classes=btn,btn-lg,btn-error)
|
||||
Which contains everything you have to know about us and the way we work.
|
||||
|
||||
* Project's life:
|
||||
* [Frequently asked questions](/faq)
|
||||
* [Frequently asked questions](/help/faq)
|
||||
* [Project news](/news)
|
||||
* [Project organization](/project_organization)
|
||||
* [Project budget](/project_budget)
|
||||
|
|
|
|||
|
|
@ -2,3 +2,37 @@
|
|||
background: linear-gradient(150deg, #8E1313 0, #0B1B41 100%);
|
||||
}
|
||||
|
||||
.highlightable h5:first-of-type {
|
||||
margin-top: 2rem;
|
||||
}
|
||||
|
||||
.highlightable h5 {
|
||||
margin-top: 1rem;
|
||||
color: #ECECFE;
|
||||
}
|
||||
|
||||
#chapter {
|
||||
max-width: 80%;
|
||||
}
|
||||
|
||||
img.inline {
|
||||
display:inline;
|
||||
margin:5px 15px 5px 5px;
|
||||
vertical-align: middle;
|
||||
}
|
||||
|
||||
.nomargin * {
|
||||
margin: 0px auto;
|
||||
}
|
||||
|
||||
#top-bar #breadcrumbs > span span, #top-bar #breadcrumbs > a span {
|
||||
padding: 0 !important;
|
||||
}
|
||||
|
||||
#top-bar #breadcrumbs > span, #top-bar #breadcrumbs > a {
|
||||
padding: 0 !important;
|
||||
}
|
||||
|
||||
#top-bar #breadcrumbs > a {
|
||||
padding: 0;
|
||||
}
|
||||
|
|
|
|||
43
themes/yunohost-docs/languages.yaml
Normal file
43
themes/yunohost-docs/languages.yaml
Normal file
|
|
@ -0,0 +1,43 @@
|
|||
en:
|
||||
THEME_LEARN4_GITHUB_EDIT: Edit
|
||||
THEME_LEARN4_GITHUB_NOTE: "Found errors? Think you can improve this documentation? Simply click the <strong><i class=\"fa fa-pencil-square\"></i> Edit</strong> link at the top of the page, and then the <strong><i class=\"fa fa-pencil\"></i></strong> icon on Github to make your changes."
|
||||
THEME_LEARN4_CLEAR_HISTORY: Clear History
|
||||
THEME_LEARN4_BUILT_WITH_GRAV: Built with <a href="http://getgrav.org">Grav</a> - The Modern Flat File CMS
|
||||
THEME_LEARN4_SEARCH_DOCUMENTATION: Search...
|
||||
THEME_LEARN4_SEARCH_ADVANCED: Advanced search
|
||||
cn:
|
||||
THEME_LEARN4_GITHUB_NOTE: 发现错误？请帮忙改进，谢谢！
|
||||
THEME_LEARN4_CLEAR_HISTORY: 清除历史
|
||||
THEME_LEARN4_BUILT_WITH_GRAV: Built with <a href="http://getgrav.org">Grav</a> - The Modern Flat File CMS
|
||||
THEME_LEARN4_SEARCH_DOCUMENTATION: 搜索文档
|
||||
cs:
|
||||
THEME_LEARN4_GITHUB_NOTE: Našli jste chybu? Myslíte, že můžete vylepšit tuto dokumentaci?
|
||||
THEME_LEARN4_CLEAR_HISTORY: Smazat historii
|
||||
THEME_LEARN4_BUILT_WITH_GRAV: Postaveno na <a href="http://getgrav.org">Grav</a> - Moderní správce obsahu pomocí souborů prostých textů
|
||||
THEME_LEARN4_SEARCH_DOCUMENTATION: Vyhledat v dokumentaci
|
||||
de:
|
||||
THEME_LEARN4_GITHUB_NOTE: Fehler gefunden? Möchten Sie diese Seite verbessern?
|
||||
THEME_LEARN4_CLEAR_HISTORY: Verlauf löschen
|
||||
THEME_LEARN4_BUILT_WITH_GRAV: Seite erstellt mit <a href="http://getgrav.org">Grav</a> - The Modern Flat File CMS
|
||||
THEME_LEARN4_SEARCH_DOCUMENTATION: Dokumentation durchsuchen
|
||||
es:
|
||||
THEME_LEARN4_GITHUB_NOTE: ¿Encontraste errores? ¿Crees que puedes mejorar esta documentación?
|
||||
THEME_LEARN4_CLEAR_HISTORY: Limpiar historial
|
||||
THEME_LEARN4_BUILT_WITH_GRAV: Hecho con <a href="http://getgrav.org">Grav</a> - El CMS moderno de archivos planos
|
||||
THEME_LEARN4_SEARCH_DOCUMENTATION: Buscar en la documentación
|
||||
fr:
|
||||
THEME_LEARN4_GITHUB_NOTE: Vous avez découvert des erreurs ? Vous pensez pouvoir améliorer cette documentation ?
|
||||
THEME_LEARN4_CLEAR_HISTORY: Effacer l'historique
|
||||
THEME_LEARN4_BUILT_WITH_GRAV: Créé avec <a href="http://getgrav.org">Grav</a> - Le CMS moderne sans base de données
|
||||
THEME_LEARN4_SEARCH_DOCUMENTATION: Recherche...
|
||||
THEME_LEARN4_SEARCH_ADVANCED: Recherche avancée
|
||||
it:
|
||||
THEME_LEARN4_GITHUB_NOTE: Hai trovato degli errori? Pensi di poter migliorare questa documentazione?
|
||||
THEME_LEARN4_CLEAR_HISTORY: Cancella Cronologia
|
||||
THEME_LEARN4_BUILT_WITH_GRAV: Built with <a href="http://getgrav.org">Grav</a> - The Modern Flat File CMS
|
||||
THEME_LEARN4_SEARCH_DOCUMENTATION: Cerca nella Documentatione
|
||||
ru:
|
||||
THEME_LEARN4_GITHUB_NOTE: Нашли ошибки? Думаете, что можете улучшить документацию?
|
||||
THEME_LEARN4_CLEAR_HISTORY: Очистить историю
|
||||
THEME_LEARN4_BUILT_WITH_GRAV: Сделано на <a href="http://getgrav.org">Grav</a> — современной файловой CMS
|
||||
THEME_LEARN4_SEARCH_DOCUMENTATION: Поиск по документации
|
||||
20
themes/yunohost-docs/templates/docs.html.twig
Normal file
20
themes/yunohost-docs/templates/docs.html.twig
Normal file
|
|
@ -0,0 +1,20 @@
|
|||
{% set body_classes = body_classes ~ ' ' ~ page.header.body_classes %}
|
||||
{% extends 'partials/base.html.twig' %}
|
||||
|
||||
{% set tags = page.taxonomy.tag %}
|
||||
{% if tags %}
|
||||
{% set progress = page.collection({'items':{'@taxonomy':{'category': 'docs', 'tag': tags}},'order': {'by': 'default', 'dir': 'asc'}}) %}
|
||||
{% else %}
|
||||
{% set progress = page.collection({'items':{'@taxonomy':{'category': 'docs'}},'order': {'by': 'default', 'dir': 'asc'}}) %}
|
||||
{% endif %}
|
||||
|
||||
{% block content %}
|
||||
{% include 'partials/toc.html.twig' %}
|
||||
|
||||
{% include 'partials/page.html.twig' %}
|
||||
|
||||
{% if github_config.note == true %}
|
||||
{% include 'partials/github-note.html.twig' %}
|
||||
{% endif %}
|
||||
|
||||
{% endblock %}
|
||||
35
themes/yunohost-docs/templates/macros/macros.html.twig
Normal file
35
themes/yunohost-docs/templates/macros/macros.html.twig
Normal file
|
|
@ -0,0 +1,35 @@
|
|||
{% macro loop(page, parent_loop) %}
|
||||
{% import _self as macros %}
|
||||
{% if parent_loop|length > 0 %}
|
||||
{% set data_level = parent_loop %}
|
||||
{% else %}
|
||||
{% set data_level = 0 %}
|
||||
{% endif %}
|
||||
{% for p in page.children.visible %}
|
||||
{% set parent_page = p.activeChild ? ' parent' : '' %}
|
||||
{% set current_page = p.active ? ' active' : '' %}
|
||||
<li class="dd-item{{ parent_page }}{{ current_page }}" data-nav-id="{{ p.route }}">
|
||||
<a href="{{ p.url }}" {% if p.header.class %}class="{{ p.header.class }}"{% endif %}>
|
||||
<i class="fa fa-check-square read-icon"></i>
|
||||
<span><b>{% if data_level == 0 %}{{ loop.index }}. {% endif %}</b>{{ p.menu }}</span>
|
||||
</a>
|
||||
{% if p.children.count > 0 %}
|
||||
<ul>
|
||||
{{ macros.loop(p, parent_loop|default(0)+loop.index) }}
|
||||
</ul>
|
||||
{% endif %}
|
||||
</li>
|
||||
{% endfor %}
|
||||
{% endmacro %}
|
||||
|
||||
{% macro version(p) %}
|
||||
{% set parent_page = p.activeChild ? ' parent' : '' %}
|
||||
{% set current_page = p.active ? ' active' : '' %}
|
||||
<h5 class="{{ parent_page }}{{ current_page }}">
|
||||
{% if p.activeChild or p.active %}
|
||||
<a href="{{ p.url }}"><i class="fa fa-chevron-down fa-fw"></i>{{ p.menu }}</a>
|
||||
{% else %}
|
||||
<a href="{{ p.url }}"><i class="fa fa-plus fa-fw"></i>{{ p.menu }}</a>
|
||||
{% endif %}
|
||||
</h5>
|
||||
{% endmacro %}
|
||||
|
|
@ -1,3 +1,4 @@
|
|||
{% set theme_config = attribute(config.themes, config.system.pages.theme) %}
|
||||
{% set github_config = theme_var('github') %}
|
||||
{% set grid_size = theme_var('grid-size') %}
|
||||
{% set compress = theme_var('production-mode') ? '.min.css' : '.css' %}
|
||||
|
|
|
|||
44
themes/yunohost-docs/templates/partials/sidebar.html.twig
Normal file
44
themes/yunohost-docs/templates/partials/sidebar.html.twig
Normal file
|
|
@ -0,0 +1,44 @@
|
|||
{% import 'macros/macros.html.twig' as macros %}
|
||||
|
||||
<div class="learn-brand">
|
||||
<div id="header">
|
||||
<a id="logo" href="{{ theme_config.home_url ?: base_url_absolute }}">{% include 'partials/logo.html.twig' %}</a>
|
||||
<div class="searchbox">
|
||||
<label for="search-by"><i class="fa fa-search"></i></label>
|
||||
<input id="search-by" type="text" placeholder="{{ 'THEME_LEARN4_SEARCH_DOCUMENTATION'|t }}"
|
||||
data-search-input="{{ base_url_relative }}/s/q"/>
|
||||
<span data-search-clear><i class="fa fa-close"></i></span>
|
||||
</div>
|
||||
<div class="search-options columns">
|
||||
<div class="adv-search column col-8"><i class="fa fa-sliders"></i> <a href="{{ url('search') }}">{{ 'THEME_LEARN4_SEARCH_ADVANCED'|t }}</a></div>
|
||||
{% include 'partials/versions.html.twig' %}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="learn-nav" data-simplebar>
|
||||
<div class="highlightable">
|
||||
{% if theme_config.top_level_version %}
|
||||
{% for slug, ver in pages.children %}
|
||||
{{ macros.version(ver) }}
|
||||
<ul id="{{ slug }}" class="topics">
|
||||
{% if ver.activeChild or ver.active %}
|
||||
{{ macros.loop(ver, '') }}
|
||||
{% endif %}
|
||||
</ul>
|
||||
{% endfor %}
|
||||
{% else %}
|
||||
<ul class="topics">
|
||||
{% if theme_config.root_page %}
|
||||
{{ macros.loop(page.find(theme_config.root_page), '') }}
|
||||
{% else %}
|
||||
{{ macros.loop(pages, '') }}
|
||||
{% endif %}
|
||||
</ul>
|
||||
{% endif %}
|
||||
<hr />
|
||||
|
||||
<a class="side-tools padding" href="#" data-clear-history-toggle>
|
||||
<i class="fa fa-fw fa-history"></i> {{ 'THEME_LEARN4_CLEAR_HISTORY'|t }}
|
||||
</a><br/>
|
||||
</div>
|
||||
</div>
|
||||
Loading…
Reference in a new issue