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,29 +5,29 @@ 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
|
||||
|
||||
YunoHost was created in February 2012 after something like this:
|
||||
|
||||
<blockquote><p>"Shit, I'm too lazy to reconfigure my mail server... Beudbeud, how were you able to get your little server running with LDAP?"</p>
|
||||
<blockquote><p>"Shit, I'm too lazy to reconfigure my mail server... Beudbeud, how were you able to get your little server running with LDAP?"</p>
|
||||
<small>Kload, February 2012</small></blockquote>
|
||||
|
||||
All that was needed was an admin interface for Beudbeud's server to make something usable, so Kload decided to develop one. Finally, after automating several configs and packaging in some web apps, YunoHost v1 was finished.
|
||||
|
|
@ -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)
|
||||
|
||||
[[figure class="nomargin" caption="On a regular computer"]
|
||||
|
||||
[/figure]](/administrate/install/iso)
|
||||
|
||||
[/center][/columns]
|
||||
|
||||
</div>
|
||||
## Install on a remote server
|
||||
|
||||
<br>
|
||||
!!! [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.
|
||||
|
||||
---
|
||||
[center]
|
||||
|
||||
<h1 style="font-weight: 100">Install at home</h1>
|
||||
[[figure class="nomargin" caption="On a dedicated or virtual private server"]
|
||||
|
||||
[/figure]](/administrate/install/vps)
|
||||
|
||||
<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>
|
||||
## Advanced / others
|
||||
|
||||
<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>
|
||||
[columns count=3][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>
|
||||
[[figure class="nomargin" caption="On Debian 10 Buster"]
|
||||
|
||||
[/figure]](/administrate/install/debian)
|
||||
|
||||
</div>
|
||||
[[figure class="nomargin" caption="Dev environment in LXD/LXC"]
|
||||
|
||||
[/figure]](/contribute/dev)
|
||||
|
||||
<br>
|
||||
[[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)
|
||||
|
|
|
|||
|
|
@ -33,4 +33,4 @@
|
|||
{% endif %}
|
||||
<a href="{{ p.url }}">{{ p.menu }}</a>
|
||||
</h5>
|
||||
{% endmacro %}
|
||||
{% endmacro %}
|
||||
|
|
|
|||
|
|
@ -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