Etherpad: Συνεργατικό πρόγραμμα επεξεργασίας εγγράφων σε πραγματικό χρόνο

Το Etherpad Lite είναι ένα δωρεάν εργαλείο επεξεργασίας εγγράφων που βασίζεται στον ιστό που επιτρέπει σε ομάδες χρηστών να εργάζονται συλλογικά σε ένα έγγραφο σε πραγματικό χρόνο, παρόμοια με ένα πρόγραμμα επεξεργασίας πολλών παικτών που εκτελείται σε ένα πρόγραμμα περιήγησης ιστού.

Το Etherpad επιτρέπει στους συγγραφείς να επεξεργάζονται ταυτόχρονα, βλέποντας ο ένας τις επεξεργασίες του άλλου σε πραγματικό χρόνο, με τη δυνατότητα εμφάνισης του κειμένου κάθε συγγραφέα με τα δικά του χρώματα.

Βασικά χαρακτηριστικά Etherpad

Πολλοί χρήστες μπορούν να επεξεργαστούν ένα έγγραφο ταυτόχρονα ενώ βλέπουν τις αλλαγές σε πραγματικό χρόνο.
Ένα πλαίσιο συνομιλίας στην πλαϊνή γραμμή επιτρέπει στους συγγραφείς να επικοινωνούν κατά την επεξεργασία, ενισχύοντας τη συνεργασία.
Είναι κατασκευασμένο με JavaScript τόσο από την πλευρά του διακομιστή όσο και από την πλευρά του πελάτη, διευκολύνοντας τους προγραμματιστές να διατηρούν και να προσθέτουν νέες δυνατότητες.
Ένα καλά τεκμηριωμένο HTTP API παρέχει πρόσβαση σε όλα τα δεδομένα, καθιστώντας εύκολη την ενσωμάτωσή τους σε άλλες εφαρμογές.
Υποστηρίζει εισαγωγή και εξαγωγή εγγράφων σε διάφορες μορφές (HTML, Open Document, Microsoft Word, PDF και απλό κείμενο) και προσφέρει μεταφράσεις για την προσαρμογή των τοπικών γλωσσών.
Η δυνατότητα "ρυθμιστικό χρόνου" επιτρέπει στους χρήστες να εξερευνούν το ιστορικό των αναθεωρήσεων εγγράφων.

Για αναφορά, μπορείτε να δείτε μια επίδειξη του Etherpad Lite στον σύνδεσμο: Παρακολούθηση επίδειξης EtherPad

Σε αυτό το σεμινάριο, θα εξετάσουμε την εγκατάσταση και τη διαμόρφωση του Etherpad Lite σε διανομές που βασίζονται σε RHEL και σε διανομές Debian.

Βήμα 1: Εγκαταστήστε βιβλιοθήκες και πακέτα ανάπτυξης

Αρχικά, πρέπει να εγκαταστήσουμε μερικές απαιτούμενες βιβλιοθήκες και εργαλεία ανάπτυξης εκτελώντας τις ακόλουθες εντολές, είτε ως root είτε προσθέτοντας sudo στην αρχή κάθε εντολής.

Σε διανομές που βασίζονται σε RHEL:

sudo yum install gzip git curl python3 openssl-devel && yum groupinstall "Development Tools"

Σε διανομές που βασίζονται στο Debian:

sudo apt install gzip git curl python3 libssl-dev pkg-config build-essential

Βήμα 2: Εγκαταστήστε το Node.js

Πρέπει να κάνετε λήψη και εγκατάσταση της πιο πρόσφατης σταθερής έκδοσης του Node.js εκτελώντας τις ακόλουθες εντολές.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 23
node -v
npm -v

Βήμα 3: Λήψη και εγκατάσταση του Etherpad Lite

Δημιουργήστε έναν ξεχωριστό χρήστη που ονομάζεται "etherpad " για να εκτελέσετε την εφαρμογή Etherpad ανεξάρτητα.

sudo useradd --create-home etherpad

Μεταβείτε στον χρήστη "etherpad " και πραγματοποιήστε λήψη της πιο πρόσφατης σταθερής έκδοσης του Etherpad Lite χρησιμοποιώντας το χώρο αποθήκευσης Git.

su - etherpad
cd /home/etherpad
git clone https://github.com/ether/etherpad-lite.git

Αλλάξτε στον κατάλογο Etherpad Lite και εκτελέστε το σενάριο run.sh:

cd etherpad-lite/bin
./run.sh

Θα πρέπει να δείτε την έξοδο που υποδεικνύει ότι το Etherpad εκτελείται και είναι προσβάσιμο στη διεύθυνση http://0.0.0.0:9001/.

Βήμα 4: Πρόσβαση και δημιουργία νέων επιθεμάτων στο Etherpad Lite

Ανοίξτε το πρόγραμμα περιήγησής σας και μεταβείτε στη διεύθυνση http://localhost:9001 ή http://your-ip-address:9001.

Για να δημιουργήσετε ένα νέο έγγραφο, εισαγάγετε ένα όνομα για το Pad. Για παράδειγμα, η δημιουργία ενός Pad με το όνομα "tecmint " θα σας δώσει τη διεύθυνση URL http://your-ip-address:9001/p/tecmint. Μπορείτε να μοιραστείτε αυτήν τη διεύθυνση URL με συνεργάτες και μπορούν να συμμετάσχουν στην περίοδο λειτουργίας επεξεργασίας σε πραγματικό χρόνο.

Βήμα 5: Χρήση του Etherpad Lite με το MySQL Backend

Από προεπιλογή, το Etherpad αποθηκεύει έγγραφα σε μια βάση δεδομένων επίπεδων αρχείων. Για καλύτερη απόδοση, συνιστάται η χρήση του MySQL ως backend.

Σε συστήματα που βασίζονται σε RHEL:

sudo yum install mysql-server
sudo systemctl start mysqld
sudo systemctl enable mysqld

Σε συστήματα που βασίζονται στο Debian:

sudo apt install mysql-server
sudo systemctl start mysql
sudo systemctl enable mysql

Συνδεθείτε στο κέλυφος MySQL και δημιουργήστε τη βάση δεδομένων Etherpad:

mysql -u root -p
CREATE USER 'etherpad'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON etherpad_lite.* TO 'etherpad'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Επιστρέψτε στον χρήστη "etherpad" και τροποποιήστε το αρχείο settings.json:

su - etherpad
cd /home/etherpad/etherpad-lite
cp settings.json.template settings.json
nano settings.json

Ενημερώστε τη διαμόρφωση της βάσης δεδομένων:

"dbType": "mysql",
"dbSettings": {
  "user": "etherpad",
  "host": "localhost",
  "password": "your-password",
  "database": "etherpad_lite"
},

Τώρα εγκαταστήστε τις εξαρτήσεις και εκτελέστε ξανά το Etherpad για να αρχικοποιήσετε το MySQL backend:

./bin/installDeps.sh
./bin/run.sh

Τέλος, έχετε υπόψη σας ότι η εφαρμογή Etherpad θα τερματίσει τη διαδικασία όταν κλείσετε την περίοδο λειτουργίας τερματικού. Μπορείτε να χρησιμοποιήσετε την υπηρεσία systemd για να διαχειριστείτε την εφαρμογή Etherpad πιο εύκολα, συμπεριλαμβανομένης της εκκίνησης, της διακοπής και της δυνατότητας εκτέλεσης κατά την εκκίνηση.

Βήμα 6: Δημιουργήστε Etherpad Systemd Service File

Τώρα συνδεθείτε ως κανονικός χρήστης sudo και δημιουργήστε ένα νέο αρχείο υπηρεσίας στον κατάλογο systemd:

sudo nano /etc/systemd/system/etherpad.service

Προσθέστε το ακόλουθο περιεχόμενο στο αρχείο υπηρεσίας:

[Unit]
Description=Etherpad Lite
After=network.target

[Service]
Type=simple
User=etherpad
WorkingDirectory=/home/etherpad/etherpad-lite
ExecStart=/usr/bin/node /home/etherpad/etherpad-lite/node/node server.js
Restart=on-failure

[Install]
WantedBy=multi-user.target

Φροντίστε να προσαρμόσετε τη διαδρομή ExecStart εάν η εγκατάσταση του Node.js βρίσκεται σε διαφορετική τοποθεσία.

Αφού δημιουργήσετε το αρχείο υπηρεσίας, πρέπει να φορτώσετε ξανά το systemd για να αναγνωρίσετε τη νέα υπηρεσία:

sudo systemctl daemon-reload

Τώρα μπορείτε να ξεκινήσετε την υπηρεσία Etherpad και να ενεργοποιήσετε την εκκίνηση κατά την εκκίνηση:

sudo systemctl start etherpad
sudo systemctl enable etherpad
sudo systemctl status etherpad

Εάν όλα έχουν ρυθμιστεί σωστά, μπορείτε να αποκτήσετε πρόσβαση στο Etherpad μεταβαίνοντας στο http://your-ip-address:9001 στο πρόγραμμα περιήγησής σας.

Σύναψη

Εγκαταστήσατε με επιτυχία και διαμορφώσατε το Etherpad Lite ώστε να χρησιμοποιείτε το MySQL ως βάση δεδομένων υποστήριξης. Υπάρχουν πολλά περισσότερα για εξερεύνηση και βελτίωση στην εγκατάσταση του Etherpad, όπως η διαμόρφωση ασφαλούς πρόσβασης μέσω HTTPS/SSL.

Για περισσότερες πληροφορίες σχετικά με περαιτέρω διαμορφώσεις, επισκεφτείτε το επίσημο wiki του Etherpad Lite.