Etherpad: suradnički uređivač dokumenata u stvarnom vremenu

Etherpad Lite je besplatni alat za uređivanje dokumenata koji se temelji na webu i omogućuje grupama korisnika da zajednički rade na dokumentu u stvarnom vremenu, slično uređivaču za više igrača koji radi u web pregledniku.

Etherpad omogućuje autorima istovremeno uređivanje, gledajući međusobna uređivanja u stvarnom vremenu, uz mogućnost prikazivanja teksta svakog autora u vlastitim bojama.

Ključne značajke Etherpada

  • Više korisnika može uređivati dokument istovremeno gledajući promjene u stvarnom vremenu.
  • Okvir za razgovor na bočnoj traci omogućuje autorima komunikaciju tijekom uređivanja, poboljšavajući suradnju.
  • Izgrađen je pomoću JavaScripta i na strani poslužitelja i na strani klijenta, što programerima olakšava održavanje i dodavanje novih značajki.
  • Dobro dokumentirani HTTP API omogućuje pristup svim podacima, što olakšava njihovu integraciju u druge aplikacije.
  • Podržava uvoz i izvoz dokumenata u različitim formatima (HTML, Open Document, Microsoft Word, PDF i običan tekst) i nudi prijevode za lokalne jezike.
  • Značajka “vremenski klizač” korisnicima omogućuje istraživanje povijesti revizija dokumenta.

Za vašu referencu, možete pogledati demo Etherpad Lite na poveznici: Pogledajte EtherPad demo

U ovom vodiču proći ćemo kroz instalaciju i konfiguraciju Etherpad Lite na distribucijama temeljenim na RHEL-u i Debianu.

Korak 1: Instalirajte biblioteke i razvojne pakete

Prvo moramo instalirati nekoliko potrebnih biblioteka i razvojnih alata pokretanjem sljedećih naredbi, bilo kao root ili dodavanjem sudo na početku svake naredbe.

Na distribucijama temeljenim na RHEL-u:

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

Na distribucijama temeljenim na Debianu:

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

Korak 2: Instalirajte Node.js

Morate preuzeti i instalirati najnoviju stabilnu verziju Node.js pokretanjem sljedećih naredbi.

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

Korak 3: Preuzmite i instalirajte Etherpad Lite

Napravite zasebnog korisnika pod nazivom “etherpad” za neovisno pokretanje aplikacije Etherpad.

sudo useradd --create-home etherpad

Prebacite se na korisnika “etherpad” i preuzmite najnoviju stabilnu verziju Etherpad Lite koristeći Git repozitorij.

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

Promijenite u direktorij Etherpad Lite i pokrenite skriptu run.sh:

cd etherpad-lite/bin
./run.sh

Trebali biste vidjeti izlaz koji pokazuje da je Etherpad pokrenut i dostupan na http://0.0.0.0:9001/.

Korak 4: Pristupite i stvorite nove podloge u Etherpad Lite

Otvorite svoj web preglednik i idite na http://localhost:9001 ili http://vaša-ip-adresa:9001.

Za izradu novog dokumenta unesite naziv za Pad. Na primjer, stvaranje Pada pod nazivom “tecmint” dat će vam URL http://vaša-ip-adresa:9001/p/tecmint. Ovaj URL možete podijeliti sa suradnicima, a oni se mogu pridružiti sesiji uređivanja u stvarnom vremenu.

Korak 5: Korištenje Etherpad Lite s MySQL pozadinom

Prema zadanim postavkama, Etherpad pohranjuje dokumente u bazu podataka ravnih datoteka. Za bolju izvedbu, preporučuje se korištenje MySQL kao pozadine.

Na sustavima koji se temelje na RHEL-u:

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

Na sustavima temeljenim na Debianu:

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

Povežite se na MySQL ljusku i kreirajte Etherpad bazu podataka:

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

Vratite se na korisnika “etherpad” i izmijenite datoteku settings.json:

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

Ažurirajte konfiguraciju baze podataka:

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

Sada instalirajte ovisnosti i ponovno pokrenite Etherpad da inicijalizirate MySQL backend:

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

Na kraju, imajte na umu da će aplikacija Etherpad prekinuti svoj proces kada zatvorite terminalsku sesiju. Možete koristiti uslugu systemd za lakše upravljanje aplikacijom Etherpad, uključujući pokretanje, zaustavljanje i omogućavanje pokretanja pri pokretanju.

Korak 6: Stvorite servisnu datoteku Etherpad Systemd

Sada se prijavite kao obični sudo korisnik i kreirajte novu servisnu datoteku u direktoriju systemd:

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

Dodajte sljedeći sadržaj u servisnu datoteku:

[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

Obavezno prilagodite stazu ExecStart ako je vaša instalacija Node.js na drugoj lokaciji.

Nakon kreiranja servisne datoteke, trebate ponovno učitati systemd da biste prepoznali novu uslugu:

sudo systemctl daemon-reload

Sada možete pokrenuti uslugu Etherpad i omogućiti joj da se pokrene pri pokretanju:

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

Ako je sve ispravno konfigurirano, Etherpadu možete pristupiti navigacijom do http://vaša-ip-adresa:9001 u svom web pregledniku.

Zaključak

Uspješno ste instalirali i konfigurirali Etherpad Lite za korištenje MySQL kao pozadinske baze podataka. Ima još mnogo toga za istražiti i poboljšati u vašoj Etherpad instalaciji, kao što je konfiguriranje sigurnog pristupa preko HTTPS/SSL-a.

Za više informacija o daljnjim konfiguracijama posjetite službeni Etherpad Lite wiki.