diff --git a/pages/00.home/docs.fr.md b/pages/00.home/docs.fr.md index 77105ef3..67447104 100644 --- a/pages/00.home/docs.fr.md +++ b/pages/00.home/docs.fr.md @@ -7,6 +7,8 @@ routes: default: '/docs' --- +! This page is obsolete and should be reworked + La documentation de YunoHost s’articule autour de deux sections : [[fa=fa-lock /] Guide de l’administrateur](/administrate?classes=btn,btn-lg,btn-primary) diff --git a/pages/00.home/docs.md b/pages/00.home/docs.md index 25ad9161..cd58d86e 100644 --- a/pages/00.home/docs.md +++ b/pages/00.home/docs.md @@ -7,6 +7,8 @@ routes: default: '/docs' --- +! This page is obsolete and should be reworked + YunoHost's documentation has 2 different sections: [[fa=fa-lock /] Administrator's guide](/administrate?classes=btn,btn-lg,btn-primary) diff --git a/pages/01.administrate/05.install/05.diagnostics/diagnostic.fr.md b/pages/01.administrate/05.install/05.diagnostics/diagnostic.fr.md deleted file mode 100644 index b440ee56..00000000 --- a/pages/01.administrate/05.install/05.diagnostics/diagnostic.fr.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: Diagnostic du bon fonctionnement de YunoHost -template: docs -taxonomy: - category: docs -routes: - default: '/diagnostic' ---- - -Pour vérifier que tous les aspects critiques de votre serveur sont correctement -configurés, il est recommandé d'utiliser le système de diagnostic disponible -dans la webadmin de YunoHost. (Cette fonctionnalité a été ajoutée dans la version -3.8) - -Quelques points à retenir: -* Le diagnostique tourne périodiquement -* Un email est envoyé à root, qui est normalement forwardé vers le premier utilisateur créé -* Les problèmes trouvés doivent soient être réglé, soit ignorés (si ils sont -compris ou ne sont pas pertinents) autrement un mail est envoyé deux fois par -jour. diff --git a/pages/01.administrate/05.install/05.diagnostics/diagnostic.md b/pages/01.administrate/05.install/05.diagnostics/diagnostic.md deleted file mode 100644 index 8257c717..00000000 --- a/pages/01.administrate/05.install/05.diagnostics/diagnostic.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Diagnose YunoHost functioning -template: docs -taxonomy: - category: docs -routes: - default: '/diagnostic' ---- - -To diagnose that all critical aspects of your server are properly configured, -you should run a diagnosis from the webadmin in the "Diagnosis" section. (This -feature was added in YunoHost 3.8). - -TODO: elaborate on the fact that the diagnosis runs periodically, sends an email -to root which is forwarded to the very first user created, and that issues -should either be fixed or ignored (if they are understood/not relevant) -otherwise an email will be sent twice a day.. diff --git a/pages/03.community/05.project_organization/yunohost_project_organization.fr.md b/pages/03.community/05.project_organization/yunohost_project_organization.fr.md index de830c30..c7edf193 100644 --- a/pages/03.community/05.project_organization/yunohost_project_organization.fr.md +++ b/pages/03.community/05.project_organization/yunohost_project_organization.fr.md @@ -7,7 +7,10 @@ routes: default: '/yunohost_project_organization' --- +! This page is outdated and should be reworked + ## Objectif du document + Ce document a pour objectif de permettre aux contributeurs de se sentir légitimes d’effectuer une contribution dans le projet YunoHost avec un avis collectif. Il vise également à renforcer le projet en le structurant autour de groupes de travail autonomes pouvant résister au départ ou à l'absence de certains contributeurs. Le projet étant communautaire, les décisions prises hâtivement et discrètement par un groupe restreint de contributeurs peuvent entraîner des frustrations postérieures. Pour pallier ce problème, la solution proposée ici est de faire en sorte que les décisions soient prises collectivement, qu’elles soient suffisamment réfléchies, et qu'elles soient documentées ou rendues publiques. diff --git a/pages/03.community/05.project_organization/yunohost_project_organization.md b/pages/03.community/05.project_organization/yunohost_project_organization.md index ae83eccf..8fa75e4f 100644 --- a/pages/03.community/05.project_organization/yunohost_project_organization.md +++ b/pages/03.community/05.project_organization/yunohost_project_organization.md @@ -7,6 +7,8 @@ routes: default: '/yunohost_project_organization' --- +! This page is outdated and should be reworked + ## Document objective This document aims at allowing contributors to feel legitimate in contributing to the YunoHost project together with collective feedback. diff --git a/pages/03.community/10.ngo/use_case_non-profit_organisations.ca.md b/pages/03.community/10.ngo/use_case_non-profit_organisations.ca.md index 0c6ac78a..23deee39 100644 --- a/pages/03.community/10.ngo/use_case_non-profit_organisations.ca.md +++ b/pages/03.community/10.ngo/use_case_non-profit_organisations.ca.md @@ -5,20 +5,10 @@ taxonomy: category: docs routes: default: '/use_case_non-profit_organisations' +page-toc: + active: true --- -## Taula de continguts -* [Introducció](#introduction) -* [Qui](#who) -* [Què](#what) -* [Quan](#when) -* [On](#where) -* [Per què](#why) -* [Com](#how) -* [Conclusió](#conclusion) - -## Introducció - L'objectiu d'aquest document és presentar un cas d'ús específic de [YunoHost](https://yunohost.org) per a organitzacions sense ànim de lucre. ## Qui diff --git a/pages/03.community/10.ngo/use_case_non-profit_organisations.fr.md b/pages/03.community/10.ngo/use_case_non-profit_organisations.fr.md index 531a41e5..7d217971 100644 --- a/pages/03.community/10.ngo/use_case_non-profit_organisations.fr.md +++ b/pages/03.community/10.ngo/use_case_non-profit_organisations.fr.md @@ -5,20 +5,10 @@ taxonomy: category: docs routes: default: '/use_case_non-profit_organisations' +page-toc: + active: true --- -## Table des matières -* [Introduction](#introduction) -* [Qui ](#qui) -* [Quoi](#quoi) -* [Quand](#quand) -* [Où](#o-) -* [Pourquoi](#pourquoi) -* [Comment](#comment) -* [Conclusion](#conclusion) - -## Introduction - L'objet de ce document est de présenter une utilisation spécifique de [YunoHost](https://yunohost.org/) pour des organisations à but non lucratif. ## Qui diff --git a/pages/03.community/10.ngo/use_case_non-profit_organisations.md b/pages/03.community/10.ngo/use_case_non-profit_organisations.md index 4892a0ad..0b585731 100644 --- a/pages/03.community/10.ngo/use_case_non-profit_organisations.md +++ b/pages/03.community/10.ngo/use_case_non-profit_organisations.md @@ -5,21 +5,11 @@ taxonomy: category: docs routes: default: '/use_case_non-profit_organisations' +page-toc: + active: true --- -## Table of Contents -* [Introduction](#introduction) -* [Who](#who) -* [What](#what) -* [When](#when) -* [Where](#where) -* [Why](#why) -* [How](#how) -* [Conclusion](#conclusion) - -## Introduction - -The object of this document is to present a specific use of [YunoHost](https://yunohost.org/) for non-profit organizations. +The purpose of this document is to present a specific use of [YunoHost](https://yunohost.org/) for non-profit organizations. ## Who diff --git a/pages/03.community/10.ngo/use_case_non-profit_organisations.oc.md b/pages/03.community/10.ngo/use_case_non-profit_organisations.oc.md index 62d58ad1..563c0fd7 100644 --- a/pages/03.community/10.ngo/use_case_non-profit_organisations.oc.md +++ b/pages/03.community/10.ngo/use_case_non-profit_organisations.oc.md @@ -5,20 +5,10 @@ taxonomy: category: docs routes: default: '/use_case_non-profit_organisations' +page-toc: + active: true --- -## Ensenhador -* [Introduccion](#introduccion) -* [Qual ](#qual) -* [Qué](#qué) -* [Quand](#quand) -* [Ont](#ont) -* [Perque](#perque) -* [Cossí](#cossí) -* [Conclusion](#conclusion) - -## Introduccion - L'objectiu d’aqueste document es de presentar una utilizacion especifica de [YunoHost](https://yunohost.org/) per d’organizacions sens tòca lucrativa. ## Qual diff --git a/pages/04.contribute/02.write_documentation/write_documentation.fr.md b/pages/04.contribute/02.write_documentation/write_documentation.fr.md index 8d6e5df6..4ab275bc 100644 --- a/pages/04.contribute/02.write_documentation/write_documentation.fr.md +++ b/pages/04.contribute/02.write_documentation/write_documentation.fr.md @@ -7,6 +7,8 @@ routes: default: '/write_documentation' --- +! This page is outdated and should be reworked + ## Sur le site Ce site permet d’éditer le contenu directement en ligne. diff --git a/pages/04.contribute/02.write_documentation/write_documentation.md b/pages/04.contribute/02.write_documentation/write_documentation.md index 06235c96..755e63bf 100644 --- a/pages/04.contribute/02.write_documentation/write_documentation.md +++ b/pages/04.contribute/02.write_documentation/write_documentation.md @@ -7,6 +7,8 @@ routes: default: '/write_documentation' --- +! This page is outdated and should be reworked + ## Online This site allows to edit content directly online. diff --git a/pages/04.contribute/04.packaging_apps/02.technical_intro/packaging_apps.fr.md b/pages/04.contribute/04.packaging_apps/02.technical_intro/packaging_apps.fr.md index 36efcd1a..9f8a1d75 100644 --- a/pages/04.contribute/04.packaging_apps/02.technical_intro/packaging_apps.fr.md +++ b/pages/04.contribute/04.packaging_apps/02.technical_intro/packaging_apps.fr.md @@ -11,6 +11,8 @@ routes: Ce document a pour but de vous apprendre à packager une application pour YunoHost. +! This page is outdated and should be reworked + ### Prérequis Pour packager une application, voici les prérequis : * Un compte sur un serveur Git comme [GitHub](https://github.com/) pour pouvoir ensuite publier l’application ; @@ -54,36 +56,6 @@ Comme les instances de YunoHost possèdent une architecture unifiée, vous serez ### Commandes pratiques [div class="btn btn-lg btn-default"] [Commandes pratiques](/packaging_apps_helpers) [/div] -### Référencement des logs -Dans de nombreuses situations, vous pouvez vouloir indexer un fichier de log pour qu'il soit affiché dans la webadmin. Pour indexer un log, il faut créer un fichier d'indexation dans `/var/log/yunohost/categories/app/APPNAME.yml`. - -Il est possible de spécifier la date de début en commençant le nom de fichier par la date `YYYYMMDD-HHMMSS`. - -Exemple de fichier de log d'indexation : -```bash -log_path: /chemin/vers/le/fichier.log -``` - -Il est possible d'afficher des infos complémentaires, la variable env sera affichée dans la partie "Contexte" : -```bash -extra: - env: - args1: value1 - args2: value2 - args3: value3 -``` - -Il est possible de rattacher le log à une application précise et/ou un service, un nom de domaine, une personne : -```bash -related_to: - - ['app', 'APPNAME'] - - ['service', 'SERVICE1'] - - ['service', 'SERVICE2'] - - ['domain', 'DOMAIN.TLD'] -``` - -Ces informations seront utilisées pour permettre de filtrer les logs en relation avec une de ces entités application, service, domaine, personne. - ### Améliorer la qualité du paquet d’installation Vous trouverez ci-dessous une liste des points à vérifier concernant la qualité de vos scripts : diff --git a/pages/04.contribute/04.packaging_apps/02.technical_intro/packaging_apps.md b/pages/04.contribute/04.packaging_apps/02.technical_intro/packaging_apps.md index 27fa9d93..33da1b70 100644 --- a/pages/04.contribute/04.packaging_apps/02.technical_intro/packaging_apps.md +++ b/pages/04.contribute/04.packaging_apps/02.technical_intro/packaging_apps.md @@ -11,6 +11,8 @@ routes: The purpose of this document is to teach you how to package an application for YunoHost. +! This page is outdated and should be reworked + ### Requirements To package an application, here are the requirements: * An account on a Git server (e.g. [GitHub](https://github.com/)) to publish the application; @@ -57,37 +59,6 @@ Take a look at the [Nextcloud package](https://github.com/YunoHost-Apps/nextclou ### Helpers [div class="btn btn-lg btn-default"] [Helpers](/packaging_apps_helpers) [/div] -### Registering a log file - -In a lot of case, you might want to register a log file created by your app, to make it available in the webadmin. To register a log, you can create a reference file `/var/log/yunohost/categories/app/APPNAME.yml`. - -You can specify a start date by starting the file name with the date formatted as `YYYYMMDD-HHMMSS`. - -Example of yml metadata log file: -```bash -log_path: /path/to/your/log/file.log -``` - -If you want display some context info, you can add: -```bash -extra: - env: - args1: value1 - args2: value2 - args3: value3 -``` - -You can attach the log to an app, domain, service or user like this : -```bash -related_to: - - ['app', 'APPNAME'] - - ['service', 'SERVICE1'] - - ['service', 'SERVICE2'] - - ['domain', 'DOMAIN.TLD'] -``` - -This will be used to filter logs and display all log related to an entity like a user, a domain, an app or a service. - ### Test it! In order to test your package, you can execute your script standalone as `admin` (do not forget to append required arguments): ```bash diff --git a/pages/04.contribute/04.packaging_apps/15.quality_tests/02.yep/packaging_apps_guidelines.fr.md b/pages/04.contribute/04.packaging_apps/15.quality_tests/02.yep/packaging_apps_guidelines.fr.md index 25a20691..cfbcf9ea 100644 --- a/pages/04.contribute/04.packaging_apps/15.quality_tests/02.yep/packaging_apps_guidelines.fr.md +++ b/pages/04.contribute/04.packaging_apps/15.quality_tests/02.yep/packaging_apps_guidelines.fr.md @@ -7,16 +7,11 @@ routes: default: '/packaging_apps_guidelines' --- -