diff --git a/check_process b/check_process index 71ee0f4..c041d17 100644 --- a/check_process +++ b/check_process @@ -1,14 +1,9 @@ -# See here for more informations -# https://github.com/YunoHost/package_check#syntax-check_process-file - -# Move this file from check_process.default to check_process when you have filled it. - ;; Test complet ; Manifest - domain="domain.tld" (DOMAIN) - path="/path" (PATH) + domain="domain.tld" + path="/path" nextclouddomain="domain.tld" - is_public=1 (PUBLIC|public=1|private=0) + is_public=1 ; Checks pkg_linter=1 setup_sub_dir=1 diff --git a/doc/.DS_Store b/doc/.DS_Store new file mode 100644 index 0000000..c90376b Binary files /dev/null and b/doc/.DS_Store differ diff --git a/doc/DISCLAIMER.md b/doc/DISCLAIMER.md new file mode 100644 index 0000000..05d0e8d --- /dev/null +++ b/doc/DISCLAIMER.md @@ -0,0 +1,47 @@ +## Demo + +* 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 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. +* 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`. +* Add a Let's Encrypt certificate for this domain. + +## Configuration of OnlyOffice Server + +* Assuming that: + * `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`. +* Create a new document and enjoy! + +### Desktop Edition on PC + +* Download and install a [ONLYOFFICE Desktop Editors](https://www.onlyoffice.com/fr/download-desktop.aspx). +* 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! diff --git a/doc/DISCLAIMER_fr.md b/doc/DISCLAIMER_fr.md new file mode 100644 index 0000000..b9cd61c --- /dev/null +++ b/doc/DISCLAIMER_fr.md @@ -0,0 +1,47 @@ +## 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 une instance Nextcloud installée 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 que : + * `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 serveur `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 Editors](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 ! diff --git a/doc/screenshots/.DS_Store b/doc/screenshots/.DS_Store new file mode 100644 index 0000000..2864207 Binary files /dev/null and b/doc/screenshots/.DS_Store differ diff --git a/doc/screenshots/document-short.png b/doc/screenshots/document-short.png new file mode 100644 index 0000000..ed3a480 Binary files /dev/null and b/doc/screenshots/document-short.png differ diff --git a/manifest.json b/manifest.json index 0958286..1fa38a4 100644 --- a/manifest.json +++ b/manifest.json @@ -8,6 +8,13 @@ }, "version": "6.1.0~ynh2", "url": "https://www.onlyoffice.com", + "upstream": { + "license": "GPL-3.0-or-later", + "website": "https://www.onlyoffice.com", + "demo": "https://www.onlyoffice.com/fr/download-desktop.aspx", + "userdoc": "https://yunohost.org/#/app_onlyoffice", + "code": "https://github.com/ONLYOFFICE/DocumentServer" + }, "license": "GPL-3.0-or-later", "maintainer": { "name": "liberodark",