1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/onlyoffice_ynh.git synced 2024-09-03 19:56:11 +02:00

Add README_fr

This commit is contained in:
ericgaspar 2020-09-20 14:56:52 +02:00
parent 2c0fa86508
commit 6aa9886342
No known key found for this signature in database
GPG key ID: 574F281483054D44
2 changed files with 137 additions and 24 deletions

View file

@ -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) [![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) [![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. > *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.* 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. 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 ## 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: * A free 30 days demo of Document Server is available from OnlyOffice connector for Nextcloud:
* Install Nextcloud and the ONLYOFFICE app (connector) * Install Nextcloud and the ONLYOFFICE app (connector)
* Go in the Nextcloud administrator settings, section ONLYOFFICE * Go in the Nextcloud administrator settings, section ONLYOFFICE
* Tick the box `Connection to demo ONLYOFFICE Document Server`` in Server Parameters * 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) * Some testing is also possible using [ONLYOFFICE Desktop Editor](https://www.onlyoffice.com/fr/download-desktop.aspx)
## Prerequisite ## 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 * 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 * 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`` * Just click on `I already have a domain`
* Type e.g. ``office.domain.nohost.me`` and click on ``Add`` * Type e.g. `office.domain.nohost.me` and click on `Add`
* Add a Let's Encrypt certificate for this domain * Add a Let's Encrypt certificate for this domain
## Configuration of OnlyOffice Server ## Configuration of OnlyOffice Server
* Suppose: * Suppose:
* ``yunohost.domain`` is your main YunoHost domain * `yunohost.domain` is your main YunoHost domain
* you have configured ``office.yunohost.domain`` for OnlyOffice, see Prerequisite above * you have configured `office.yunohost.domain` for OnlyOffice, see Prerequisite above
* you have Nextcloud installed on ``yunohost.domain/nextcloud`` or ``nextcloud.yunohost.domain`` * you have Nextcloud installed on `yunohost.domain/nextcloud` or `nextcloud.yunohost.domain`
* Install ``onlyoffice`` using CLI or web admin * 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 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) * 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`` * 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`` * 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? ## How to edit OnlyOffice documents?
### Web Edition in Nextcloud ### Web Edition in Nextcloud
Prerequisite: **OnlyOffice should be public**, see previous section. 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) * 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`` * 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`` * Give the installation domain of your `onlyoffice`, e.g. `https://office.yunohost.domain/` and click `Save`
* Create a new document and enjoy! * Create a new document and enjoy!
### Desktop Edition on PC ### Desktop Edition on PC
* Download and install a [ONLYOFFICE Desktop Editor](https://www.onlyoffice.com/fr/download-desktop.aspx) * 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`` * 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`` * 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) * or (only if you connected `onlyoffice` to Nextcloud, see previous section)
* Select ``Nextcloud`` and give your nextcloud installation domain, e.g. ``yunohost.domain/nextcloud`` * Select `Nextcloud` and give your Nextcloud installation domain, e.g. `yunohost.domain/nextcloud`
* Create a new document and enjoy! * Create a new document and enjoy!
## Documentation ## 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). Please send your pull request to the [testing branch](https://github.com/YunoHost-Apps/onlyoffice_ynh/tree/testing).

107
README_fr.md Normal file
View file

@ -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
```