From 6aa988634284c1fa2eb3eeb7921f7eac07e37124 Mon Sep 17 00:00:00 2001 From: ericgaspar Date: Sun, 20 Sep 2020 14:56:52 +0200 Subject: [PATCH] Add README_fr --- README.md | 54 ++++++++++++++------------ README_fr.md | 107 +++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 137 insertions(+), 24 deletions(-) create mode 100644 README_fr.md diff --git a/README.md b/README.md index 9164b0d..1d11ddf 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,8 @@ [![Integration level](https://dash.yunohost.org/integration/onlyoffice.svg)](https://dash.yunohost.org/appci/app/onlyoffice) ![](https://ci-apps.yunohost.org/ci/badges/onlyoffice.status.svg) ![](https://ci-apps.yunohost.org/ci/badges/onlyoffice.maintain.svg) [![Install OnlyOffice with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=onlyoffice) +*[Lire ce readme en français.](./README_fr.md)* + > *This package allows you to install OnlyOffice quickly and simply on a YunoHost server. If you don't have YunoHost, please consult [the guide](https://yunohost.org/#/install) to learn how to install it.* @@ -18,7 +20,7 @@ Online collaborative edition of OnlyOffice documents requires: The Nextcloud addicts may follow [this tutorial](https://github.com/YunoHost-Apps/nextcloud_ynh#configure-onlyoffice-integration) to install 1)b) and 2)a) on one Nextcloud instance. However, performance and architecture are limited. -**Shipped version:** 5.2.8 +**Shipped version:** 5.5.3 ## Screenshots @@ -29,42 +31,47 @@ The Nextcloud addicts may follow [this tutorial](https://github.com/YunoHost-App * A free 30 days demo of Document Server is available from OnlyOffice connector for Nextcloud: * Install Nextcloud and the ONLYOFFICE app (connector) * Go in the Nextcloud administrator settings, section ONLYOFFICE - * Tick the box `Connection to demo ONLYOFFICE Document Server`` in Server Parameters -* Some testing is also possible using [ONLYOFFICE Desktop Editors](https://www.onlyoffice.com/fr/download-desktop.aspx) + * Tick the box `Connection to demo ONLYOFFICE Document Server` in Server Parameters +* Some testing is also possible using [ONLYOFFICE Desktop Editor](https://www.onlyoffice.com/fr/download-desktop.aspx) ## Prerequisite -You should not install ``onlyoffice`` on your main YunoHost domain, especially if you want to use it with a ``nextcloud`` installed on the same domain. + +You should not install `onlyoffice` on your main YunoHost domain, especially if you want to use it with a `nextcloud` installed on the same domain. * Add a new domain for OnlyOffice in YunoHost - * If your main YunoHost domain was provided by YunoHost, e.g. ``domain.nohost.me``, then you don't have to buy/register a new domain name - * Just click on ``I already have a domain`` - * Type e.g. ``office.domain.nohost.me`` and click on ``Add`` + * If your main YunoHost domain was provided by YunoHost, e.g. `domain.nohost.me`, then you don't have to buy/register a new domain name + * Just click on `I already have a domain` + * Type e.g. `office.domain.nohost.me` and click on `Add` * Add a Let's Encrypt certificate for this domain ## Configuration of OnlyOffice Server + * Suppose: - * ``yunohost.domain`` is your main YunoHost domain - * you have configured ``office.yunohost.domain`` for OnlyOffice, see Prerequisite above - * you have Nextcloud installed on ``yunohost.domain/nextcloud`` or ``nextcloud.yunohost.domain`` -* Install ``onlyoffice`` using CLI or web admin - * Choose a domain name for OnlyOffice that is different from your Nextcloud domain, e.g. ``office.yunohost.domain`` (or ``office.domain.nohost.me``, see previous section) - * Choose a path for OnlyOffice, e.g. ``/`` if you install on ``office.yunohost.domain`` (do not install any further app on this domain) - * The domain of your Nextcloud instance, e.g. ``yunohost.domain/nextcloud`` or ``nextcloud.yunohost.domain`` - * Is it a public application? **If you want to connect it to Nextcloud, OnlyOffice should be public**: then select ``Yes`` or ``tick the box`` + * `yunohost.domain` is your main YunoHost domain + * you have configured `office.yunohost.domain` for OnlyOffice, see Prerequisite above + * you have Nextcloud installed on `yunohost.domain/nextcloud` or `nextcloud.yunohost.domain` +* Install `onlyoffice` using CLI or webadmin + * Choose a domain name for OnlyOffice that is different from your Nextcloud domain, e.g. `office.yunohost.domain` (or `office.domain.nohost.me`, see previous section) + * Choose a path for OnlyOffice, e.g. `/` if you install on `office.yunohost.domain` (do not install any other app on this domain) + * The domain of your Nextcloud instance, e.g. `yunohost.domain/nextcloud` or `nextcloud.yunohost.domain` + * Is it a public application? **If you want to connect it to Nextcloud, OnlyOffice should be public**: then select `Yes` or `tick the box` ## How to edit OnlyOffice documents? + ### Web Edition in Nextcloud + Prerequisite: **OnlyOffice should be public**, see previous section. -* In Nextcloud apps store, install ``ONLYOFFICE``, i.e. the [OnlyOffice connector for Nextcloud](https://apps.nextcloud.com/apps/onlyoffice) -* Go in the Nextcloud ``settings``>``Administration``>``ONLYOFFICE``>``Server settings``>``Address of the Document Server`` -* Give the installation domain of your ``onlyoffice``, e.g. ``https://office.yunohost.domain/`` and click ``Save`` +* In Nextcloud apps store, install `ONLYOFFICE`, i.e. the [OnlyOffice connector for Nextcloud](https://apps.nextcloud.com/apps/onlyoffice) +* Go in the Nextcloud `settings` > `Administration` > `ONLYOFFICE` > `Server settings` > `Address of the Document Server` +* Give the installation domain of your `onlyoffice`, e.g. `https://office.yunohost.domain/` and click `Save` * Create a new document and enjoy! ### Desktop Edition on PC + * Download and install a [ONLYOFFICE Desktop Editor](https://www.onlyoffice.com/fr/download-desktop.aspx) -* Start the Editor and Go to ``Connect to cloud``>``Add cloud`` - * Select ``ONLYOFFICE`` and give the installation domain of your ``onlyoffice``, e.g. ``office.yunohost.domain`` - * or (only if you connected ``onlyoffice`` to Nextcloud, see previous section) - * Select ``Nextcloud`` and give your nextcloud installation domain, e.g. ``yunohost.domain/nextcloud`` +* Start ONLYOFFICE and Go to `Connect to cloud` > `Add cloud` + * Select `ONLYOFFICE` and give the installation domain of your `onlyoffice`, e.g. `office.yunohost.domain` + * or (only if you connected `onlyoffice` to Nextcloud, see previous section) + * Select `Nextcloud` and give your Nextcloud installation domain, e.g. `yunohost.domain/nextcloud` * Create a new document and enjoy! ## Documentation @@ -87,8 +94,7 @@ Prerequisite: **OnlyOffice should be public**, see previous section. --- -Developer info ----------------- +## Developer info Please send your pull request to the [testing branch](https://github.com/YunoHost-Apps/onlyoffice_ynh/tree/testing). diff --git a/README_fr.md b/README_fr.md new file mode 100644 index 0000000..8a08a60 --- /dev/null +++ b/README_fr.md @@ -0,0 +1,107 @@ +# OnlyOffice Server pour YunoHost + +[![Integration level](https://dash.yunohost.org/integration/onlyoffice.svg)](https://dash.yunohost.org/appci/app/onlyoffice) ![](https://ci-apps.yunohost.org/ci/badges/onlyoffice.status.svg) ![](https://ci-apps.yunohost.org/ci/badges/onlyoffice.maintain.svg) +[![Installer OnlyOffice avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=onlyoffice) + +*[Read this readme in english.](./README.md)* + +> *Ce package vous permet d'installer OnlyOffice rapidement et simplement sur un serveur YunoHost. +Si vous n'avez pas YunoHost, consultez [le guide](https://yunohost.org/#/install) pour apprendre comment l'installer.* + +## Vue d'ensemble + +L'édition collaborative en ligne des documents OnlyOffice nécessite: +1) une partie serveur, avec deux options d'installation: + a) **Ce package installe OnlyOffice Document Server**. + b) Le [Community Document Server for Nextcloud](https://apps.nextcloud.com/apps/documentserver_community) + +2) une partie client, telle que: + a) [ONLYOFFICE connector pour Nextcloud](https://apps.nextcloud.com/apps/onlyoffice) + b) [ONLYOFFICE Desktop Editor](https://www.onlyoffice.com/fr/download-desktop.aspx) + +Les utilisateurs de Nextcloud peuvent suivre [ce tutoriel](https://github.com/YunoHost-Apps/nextcloud_ynh#configure-onlyoffice-integration) pour installer le Community Document Server (1.b) et l'ONLYOFFICE connector (2.a) sur une instance Nextcloud. Cependant, les performances et l'architecture sont limitées. + +**Version incluse :** 5.5.3 + +## Captures d'écran + +![](https://static-www.onlyoffice.com/v9.5.0/images/mainpage/may2018/editors/document-short.jpg) + +## Démo + +* Une démo gratuite de 30 jours de Document Server est disponible à partir du connecteur OnlyOffice pour Nextcloud: + * Installez Nextcloud et l'application ONLYOFFICE (connector) + * Allez dans les paramètres de l'administrateur Nextcloud, section ONLYOFFICE + * Cochez la case `Connexion à la démonstration ONLYOFFICE Document Server` dans les paramètres du serveur +* Certains tests sont également possibles en utilisant [ONLYOFFICE Desktop Editor](https://www.onlyoffice.com/fr/download-desktop.aspx) + +## Prérequis + +Vous ne devez pas installer `onlyoffice` sur votre domaine YunoHost principal, surtout si vous souhaitez l'utiliser avec un `nextcloud` installé sur le même domaine. +* Ajouter un nouveau domaine pour OnlyOffice dans YunoHost + * Si votre domaine YunoHost principal a été fourni par YunoHost, par exemple `domain.nohost.me`, alors vous n'avez pas à acheter/enregistrer un nouveau nom de domaine + * Cliquez simplement sur `J'ai déjà un nom de domaine` + * Tapez par exemple `office.domain.nohost.me` et cliquez sur `Ajouter` +* Ajoutez un certificat Let's Encrypt pour ce domaine + +## Configuration de OnlyOffice Server + +* Supposons: + * `yunohost.domain` est votre domaine principal YunoHost + * vous avez configuré `office.yunohost.domain` pour OnlyOffice, voir Prérequis ci-dessus + * vous avez Nextcloud installé sur `yunohost.domain / nextcloud` ou `nextcloud.yunohost.domain` +* Installez `onlyoffice` à l'aide de la CLI ou de l'administrateur Web + * choisissez un nom de domaine pour OnlyOffice différent de votre domaine Nextcloud, par exemple `office.yunohost.domain` (ou `office.domain.nohost.me`, voir section précédente) + * Choisissez un chemin pour OnlyOffice, par exemple `/` si vous installez sur `office.yunohost.domain` (n'installez aucune autre application sur ce domaine) + * Le domaine de votre instance Nextcloud, par exemple `yunohost.domain / nextcloud` ou `nextcloud.yunohost.domain` + * Est-ce une application publique? **Si vous souhaitez le connecter à Nextcloud, OnlyOffice doit être public**: puis sélectionnez `Oui` ou `cochez la case` + +## Comment éditer des documents OnlyOffice ? + +### Web Édition dans Nextcloud + +Prérequis : **OnlyOffice doit être public**, voir la section précédente. +* dans le magasin d'applications Nextcloud, installez `ONLYOFFICE`, c'est-à-dire le [connecteur OnlyOffice pour Nextcloud](https://apps.nextcloud.com/apps/onlyoffice) +* allez dans Nextcloud `Paramètres` > `Administration` > `ONLYOFFICE` > `Paramètres du serveur` > `Adresse du service d'édition de document` +* spécifiez le domaine d'installation de votre server `onlyoffice`, par exemple `https://office.yunohost.domain/` et cliquez sur `Enregistrer` +* créez un nouveau document ! + +### Desktop Édition sur PC + +* Téléchargez et installez [ONLYOFFICE Desktop Editor](https://www.onlyoffice.com/fr/download-desktop.aspx) +* Démarrez l'éditeur et allez dans `Connecter au Cloud` > `Ajouter cloud` + * sélectionnez `ONLYOFFICE` et indiquez le domaine d'installation de votre server `onlyoffice`, par ex. `office.yunohost.domain` + * ou (uniquement si vous avez connecté `onlyoffice` à Nextcloud, voir section précédente) + * sélectionnez `Nextcloud` et donnez votre domaine d'installation nextcloud, par exemple `yunohost.domain/nextcloud` +* Créez un nouveau document ! + +## Documentation + +## Caractéristiques spécifiques YunoHost + +#### Support multi-utilisateur + +#### Architectures supportées + +* x86-64 - [![Build Status](https://ci-apps.yunohost.org/ci/logs/onlyoffice%20%28Apps%29.svg)](https://ci-apps.yunohost.org/ci/apps/onlyoffice/) +* ARMv8-A - [![Build Status](https://ci-apps-arm.yunohost.org/ci/logs/onlyoffice%20%28Apps%29.svg)](https://ci-apps-arm.yunohost.org/ci/apps/onlyoffice/) + +## Liens + + * Signaler un bug : https://github.com/YunoHost-Apps/onlyoffice_ynh/issues + * Site de l'application : https://www.onlyoffice.com + * Dépôt de l'application principale : https://github.com/ONLYOFFICE/DocumentServer + * Site web YunoHost : https://yunohost.org/ + +--- + +## Informations pour les développeurs + +Merci de faire vos pull request sur la [testing branch](https://github.com/YunoHost-Apps/onlyoffice_ynh/tree/testing). + +Pour essayer la branche testing, procédez comme suit. +``` +sudo yunohost app install https://github.com/YunoHost-Apps/onlyoffice_ynh/tree/testing --debug +or +sudo yunohost app upgrade onlyoffice -u https://github.com/YunoHost-Apps/onlyoffice_ynh/tree/testing --debug +```