[Etherpad MyPads] Collaborative real-time editor

[Maniack_Crudelis]

Etherpad with mypads plugin for YunoHost

Overview

Etherpad is a highly customizable Open Source online editor providing collaborative editing in really real-time.
This package will install the same plugins than Framapad.

Shipped version: 1.7.5

Screenshots

Demo

• Official demo

Configuration

You can access to 2 different admin panels, for etherpad by accessing domain.tld/admin and for mypads by domain.tld/mypads/?/admin.
Or, you can find a config file for etherpad at this path /var/www/etherpad_mypads/settings.json.

Documentation

• Official documentation: About this Documentation - Etherpad v1.7.0 Manual & Documentation
• YunoHost documentation: There no other documentations, feel free to contribute.

YunoHost specific features

Multi-users support

Supported, with LDAP.

Supported architectures

• x86-64b -
• ARMv8-A -
• Jessie x86-64b -

Limitations

Additionnal informations

• This package will install the following plugins:

  • ep_align - Add Left/Center/Right/Justify to lines of text in a pad
  • ep_author_hover - Adds author names to span titles
  • ep_automatic_logut - Automatically disconnects user after some period of time (Prevent server overload)
  • ep_comments_page - Adds comments on sidebar and link it to the text.
  • ep_countable - Displays paragraphs, sentences, words and characters counts.
  • ep_delete_empty_pads - Delete pads which were never edited
  • ep_font_color - Apply colors to fonts
  • ep_headings2 - Adds heading support to Etherpad Lite.
  • ep_markdown - Edit and Export as Markdown in Etherpad
  • ep_mypads - Groups and private pads for etherpad
  • ep_page_view - Add support to do ‘page view’, with a toggle on/off option in Settings, also Page Breaks with Control Enter
  • ep_spellcheck - Add support to do ‘Spell checking’
  • ep_subscript_and_superscript - Add support for Subscript and Superscript
  • ep_table_of_contents - View a table of contents for your pad
  • ep_user_font_size - User Pad Contents font size can be set in settings, this does not effect other peoples views

Links

• Report a bug: Issues · YunoHost-Apps/etherpad_mypads_ynh · GitHub
• Etherpad website: http://etherpad.org/
• Mypads plugin website: Framasoft / Etherpad / ep_mypads · GitLab
• Upstream app repository: GitHub - ether/etherpad-lite: Etherpad: A modern really-real-time collaborative document editor.</titl
• YunoHost website: https://yunohost.org/

---

Changelog

Testing branch

Master branch (Official release)

• 26 May 2019 - #69
  • Global upgrade of the package.
  • Upgrade to Etherpad 1.7.5
• 8 Mar 2019 - #58
  • Allow to include a pad in an other page
• 11 Mar 2019 - #62
  • Update to last packaging standard
  • Update to mypads 1.7.6
  • Add progress bar
• 8 Dec 2018 - #55
  • Update to mypads 1.6.8
• 01 Sep 2018 - #40
  • Disable Development mode
• 26 Aug 2018 - #51
  • Upgrade Etherpad to 1.7.0
  • Upgrade to mypads 1.6.2
• 25 May 2018 - #38
  • Upgrade helpers

---

Developers infos

Please do your pull request to the testing branch.

To try the testing branch, please proceed like that.

sudo yunohost app install https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --debug
or
sudo yunohost app upgrade etherpad_mypads -u https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --debug

---

Etherpad avec plugin mypads pour YunoHost

Résumé

Etherpad est un éditeur en ligne Open Source hautement personnalisable qui permet l’édition collaborative en temps réel.
Ce paquet installera les mêmes plugins que Framapad.

Version embarquée: 1.7.5

Captures d’écran

Démo

• Démo officielle

Configuration

Vous pouvez accéder à 2 panneaux d’administration différents, pour etherpad en accédant à domain.tld/admin et pour mypads par domain.tld/mypads/?/admin.
Ou, vous pouvez trouver un fichier de configuration pour etherpad à /var/www/etherpad_mypads/settings.json.

Documentation

• Documentation officielle: http://etherpad.org/doc/v1.7.0
• Documentation YunoHost: Il n’y a pas d’autre documentation, n’hésitez pas à contribuer.

Fonctionnalités spécifiques à YunoHost

Support multi-utilisateurs

Supportée, avec LDAP.

Architectures supportées.

• x86-64b -
• ARMv8-A -
• Jessie x86-64b -

Limitations

Informations additionnelles

• Ce paquet installera les plugins suivants:

  • ep_align - Ajoute Gauche/Centre/Droite/Justifier à des lignes de texte dans un pad
  • ep_author_hover - Ajoute des noms d’auteurs
  • ep_automatic_logut - Déconnecte automatiquement l’utilisateur après une certaine période de temps (Prévient la surcharge du serveur)
  • ep_comments_page - Ajoute des commentaires sur la sidebar et le lie au texte.
  • ep_countable - Affiche les paragraphes, phrases, mots et nombres de caractères.
  • ep_delete_empty_pads - Supprimer les pads qui n’ont jamais été édités
  • ep_font_color - Appliquer les couleurs aux polices de caractères
  • ep_headings2 - Ajoute le support de titre à Etherpad Lite.
  • ep_markdown - Modifier et exporter en tant que Markdown dans Etherpad
  • ep_mypads - Groupes et pads privés pour etherpad
  • ep_page_view - Ajouter la prise en charge de ‘page view’, avec une option d’activation/désactivation dans Paramètres, ainsi que ‘Page Breaks’ avec Control + Entrée
  • ep_spellcheck - Ajouter le support pour faire de la vérification orthographique
  • ep_subscript_and_superscript - Ajouter la prise en charge de Subscript et Superscript.
  • ep_table_of_contents - Voir une table des matières pour votre pad
  • ep_user_font_size- Permet de définir taille de la police dans les paramètres, cela n’affecte pas les vues des autres personnes.

Liens

• Reporter un bug: Issues · YunoHost-Apps/etherpad_mypads_ynh · GitHub
• Site de etherpad: http://etherpad.org/
• Site du plugin mypads: Framasoft / Etherpad / ep_mypads · GitLab
• Dépôt git de l’app: GitHub - ether/etherpad-lite: Etherpad: A modern really-real-time collaborative document editor.</titl
• Site de YunoHost: https://yunohost.org/

---

Changelog

Testing branch

Master branch (Official release)

• 26 May 2019 - #69
  • Global upgrade of the package.
  • Upgrade to Etherpad 1.7.5
• 8 Mar 2019 - #58
  • Allow to include a pad in an other page
• 11 Mar 2019 - #62
  • Update to last packaging standard
  • Update to mypads 1.7.6
  • Add progress bar
• 8 Dec 2018 - #55
  • Update to mypads 1.6.8
• 01 Sep 2018 - #40
  • Disable Development mode
• 26 Aug 2018 - #51
  • Upgrade Etherpad to 1.7.0
  • Upgrade to mypads 1.6.2
• 25 May 2018 - #38
  • Upgrade helpers

---

Informations à l’intention des développeurs

Merci de faire vos pull request sur la branche testing.

Pour tester la branche testing, merci de procéder ainsi.

sudo yunohost app install https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --debug
ou
sudo yunohost app upgrade etherpad_mypads -u https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --debug

[Maniack_Crudelis]

New testing available

• 25 May 2018 - #38
  • Upgrade to mypads 1.4.6
  • Upgrade helpers

sudo yunohost app install https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --verbose
or
sudo yunohost app upgrade etherpad_mypads -u https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --verbose

[Maniack_Crudelis]

New testing available

• 02 Aug 2018 - #42
  • Upgrade Etherpad to 1.7.0
  • Upgrade Mypads module to 1.6.2
  • Fix the way modules are updated

sudo yunohost app install https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --verbose
or
sudo yunohost app upgrade etherpad_mypads -u https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --debug

[kanhu]

Thanks for the update.

[Maniack_Crudelis]

Another commit in the current testing

• 01 Sep 2018 - #40
  • Disable Development mode

sudo yunohost app install https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --debug
sudo yunohost app upgrade etherpad_mypads -u https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --debug

[Maniack_Crudelis]

I’m glad to announce a new stable release for Etherpad, which fix the issues about installing the app.

• 01 Sep 2018 - #40
  • Disable Development mode
• 26 Aug 2018 - #51
  • Upgrade Etherpad to 1.7.0
  • Upgrade to mypads 1.6.2
• 25 May 2018 - #38
  • Upgrade helpers

[Maniack_Crudelis]

New testing available

• 25 Sep 2018 - #55
  • Set the permissions in the restore script.

sudo yunohost app install https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --debug
or
sudo yunohost app upgrade etherpad_mypads -u https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --debug

[tomdereub]

Salut, depuis la dernière mise à jour (il me semble), mon etherpad ne marche plus, même après reboot du serveur. Dans les logs de l’interface admin j’ai ça : https://plaf.fr/zerobin/?98e6129c7dce422e#PGuF8NuJ33JhNGXDQ4tVWGEQ3EL3IYyDQwv9rWPT7Cc=
Une idée ?

[Maniack_Crudelis]

This error is because of the plugin mypads, for the version 1.6.3
Mypads has fixed this error since, you just have to update your instance of this plugin.

Either you can let the package do it for you.

sudo YNH_FORCE_UPGRADE=1 yunohost app upgrade etherpad_mypads -u https://github.com/YunoHost-Apps/etherpad_mypads_ynh

Or you can upgrade the plugin yourself.

su root
source /usr/share/yunohost/helpers
app=etherpad_mypads
ynh_use_nodejs
cd /var/www/etherpad_mypads
npm cache clean
npm install --upgrade ep_mypads
chown -R etherpad_mypads: /var/www/etherpad_mypads

[kanhu]

I am getting this error:

 npm install --upgrade ep_mypads
npm WARN deprecated mimelib@0.2.14: This project is unmaintained
npm WARN enoent ENOENT: no such file or directory, open '/var/www/etherpad_mypads/package.json'
npm WARN etherpad_mypads No description
npm WARN etherpad_mypads No repository field.
npm WARN etherpad_mypads No README data
npm WARN etherpad_mypads No license field.

npm ERR! path /var/www/etherpad_mypads/node_modules/.staging/ep_etherpad-lite-629fb491/node_modules/async
npm ERR! code ENOENT
npm ERR! errno -2
npm ERR! syscall rename
npm ERR! enoent ENOENT: no such file or directory, rename '/var/www/etherpad_mypads/node_modules/.staging/ep_etherpad-lite-629fb491/node_modules/async' -> '/var/www/etherpad_mypads/node_modules/.staging/async-2b4b7ef5'
npm ERR! enoent This is related to npm not being able to find a file.
npm ERR! enoent 

npm ERR! A complete log of this run can be found in:
npm ERR!     /root/.npm/_logs/2018-09-26T08_41_34_295Z-debug.log

[Maniack_Crudelis]

By doing it manually ?
If so, try to upgrade the package, it should works.

[tomdereub]

Worked like a charm, thanks !

[Maniack_Crudelis]

A new commit has been released in the current testing branch

• 8 Oct 2018 - #56
  • Update to mypads 1.6.8

sudo yunohost app install https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --debug
or
sudo yunohost app upgrade etherpad_mypads -u https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --debug

[Maniack_Crudelis]

New release for Etherpad.

• 8 Dec 2018 - #55
  • Update to mypads 1.6.8

[SiM]

The update fails for me.
Here is the result of yunohost app upgrade etherpad_mypads -u https://github.com/YunoHost-Apps/etherpad_mypads_ynh :

Info: Upgrading apps etherpad_mypads
Info: Upgrading app etherpad_mypads...
Warning: Starting of etherpad_mypads
Warning: .........The service etherpad_mypads has correctly started.
Warning: Up-to-date, nothing to do
DEBUG + '[' 1.7.0~ynh1 = 1.7.0~ynh1 ']'
DEBUG + '[' 0 '!=' 0 ']'
DEBUG + '[' 0 '!=' 0 ']'
DEBUG + ynh_die 'Up-to-date, nothing to do' 0
DEBUG + echo 'Up-to-date, nothing to do'
DEBUG + exit 0

And the process is stuck there, I have to do “Ctrl-c” to regain control.

Here is my full log : https://paste.yunohost.org/raw/perukureqi

Edit : I have checked /etc/yunohost/apps/etherpad_mypads/status.json and I’m not at the last revision - mine : “88b055aa24284caea61384fb381e721a746c96eb”

[Maniack_Crudelis]

My bad, I forgot to update the version number into the manifest… That’s now done.

[SiM]

Thanks, it worked

[Maniack_Crudelis]

New testing available

• 8 Mar 2019 - #58
  • Allow to include a pad in an other page
• 11 Mar 2019 - #62
  • Update to last packaging standard
  • Update to mypads 1.7.6
  • Add progress bar

sudo yunohost app install https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --debug
or
sudo yunohost app upgrade etherpad_mypads -u https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --debug

[Maniack_Crudelis]

New upgrade available

• 8 Mar 2019 - #58
  • Allow to include a pad in an other page
• 11 Mar 2019 - #62
  • Update to last packaging standard
  • Update to mypads 1.7.6
  • Add progress bar

[Maniack_Crudelis]

New testing available

• 13 May 2019 - #69
  • Global upgrade of the package.
  • Upgrade to Etherpad 1.7.5

sudo yunohost app install https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --debug
or
sudo yunohost app upgrade etherpad_mypads -u https://github.com/YunoHost-Apps/etherpad_mypads_ynh/tree/testing --debug