Etherpad: En dokumentredigerer i sanntid

Etherpad Lite er et nettbasert, gratis dokumentredigeringsverktøy som gjør det mulig for grupper av brukere å samarbeide om et dokument i sanntid, på samme måte som en flerspillerredigerer som kjører i en nettleser.

Etherpad lar forfattere redigere samtidig, se hverandres redigeringer i sanntid, med muligheten til å vise hver forfatters tekst i sine egne farger.

Etherpad Nøkkelfunksjoner

  • Flere brukere kan redigere et dokument samtidig mens de ser endringer i sanntid.
  • En chatteboks i sidefeltet lar forfattere kommunisere mens de redigerer, noe som forbedrer samarbeidet.
  • Den er bygget med JavaScript på både server- og klientsiden, noe som gjør det enkelt for utviklere å vedlikeholde og legge til nye funksjoner.
  • Et godt dokumentert HTTP API gir tilgang til alle data, noe som gjør det enkelt å integrere det i andre applikasjoner.
  • Den støtter import og eksport av dokumenter i ulike formater (HTML, Open Document, Microsoft Word, PDF og ren tekst) og tilbyr oversettelser for å imøtekomme lokale språk.
  • «tidsglidebryteren»-funksjonen lar brukere utforske historien til dokumentrevisjoner.

For din referanse kan du sjekke ut en demo av Etherpad Lite på lenken: Se EtherPad Demo

I denne opplæringen vil vi gå gjennom installasjonen og konfigurasjonen av Etherpad Lite på RHEL-baserte og Debian-baserte distribusjoner.

Trinn 1: Installer biblioteker og utviklingspakker

Først må vi installere noen nødvendige biblioteker og utviklingsverktøy ved å kjøre følgende kommandoer, enten som root eller ved å legge til sudo i begynnelsen av hver kommando.

På RHEL-baserte distribusjoner:

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

På Debian-baserte distribusjoner:

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

Trinn 2: Installer Node.js

Du må laste ned og installere den siste stabile versjonen av Node.js ved å kjøre følgende kommandoer.

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

Trinn 3: Last ned og installer Etherpad Lite

Opprett en egen bruker kalt «etherpad» for å kjøre Etherpad-applikasjonen uavhengig.

sudo useradd --create-home etherpad

Bytt til «etherpad »-brukeren og last ned den siste stabile versjonen av Etherpad Lite ved å bruke Git-depotet.

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

Bytt til Etherpad Lite-katalogen og utfør run.sh-skriptet:

cd etherpad-lite/bin
./run.sh

Du bør se utdata som indikerer at Etherpad kjører og er tilgjengelig på http://0.0.0.0:9001/.

Trinn 4: Få tilgang til og lag nye pads i Etherpad Lite

Åpne nettleseren din og naviger til http://localhost:9001 eller http://din-ip-adresse:9001.

For å opprette et nytt dokument, skriv inn et navn for Pad. Hvis du for eksempel oppretter en Pad kalt «tecmint», vil du få URL-en http://din-ip-adresse:9001/p/tecmint. Du kan dele denne nettadressen med samarbeidspartnere, og de kan bli med i redigeringsøkten i sanntid.

Trinn 5: Bruk av Etherpad Lite med MySQL Backend

Som standard lagrer Etherpad dokumenter i en flatfildatabase. For bedre ytelse anbefales det å bruke MySQL som en backend.

På RHEL-baserte systemer:

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

På Debian-baserte systemer:

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

Koble til MySQL-skallet og lag Etherpad-databasen:

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

Bytt tilbake til «etherpad»-brukeren og endre filen settings.json:

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

Oppdater databasekonfigurasjonen:

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

Installer nå avhengigheter og kjør Etherpad igjen for å initialisere MySQL-backend:

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

Til slutt, husk at Etherpad-applikasjonen vil avslutte prosessen når du lukker terminaløkten. Du kan bruke systemd-tjenesten til å administrere Etherpad-applikasjonen enklere, inkludert start, stopp og la den kjøres ved oppstart.

Trinn 6: Opprett Etherpad Systemd Service File

Logg inn som en vanlig sudo-bruker og lag en ny tjenestefil i systemd-katalogen:

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

Legg til følgende innhold i tjenestefilen:

[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

Sørg for å justere ExecStart-banen hvis Node.js-installasjonen er på et annet sted.

Etter å ha opprettet tjenestefilen, må du laste systemd på nytt for å gjenkjenne den nye tjenesten:

sudo systemctl daemon-reload

Nå kan du starte Etherpad-tjenesten og aktivere den til å starte ved oppstart:

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

Hvis alt er riktig konfigurert, kan du få tilgang til Etherpad ved å navigere til http://din-ip-adresse:9001 i nettleseren din.

Konklusjon

Du har installert og konfigurert Etherpad Lite til å bruke MySQL som backend-databasen. Det er mye mer å utforske og forbedre i Etherpad-installasjonen din, for eksempel å konfigurere sikker tilgang over HTTPS/SSL.

For mer informasjon om ytterligere konfigurasjoner, besøk den offisielle Etherpad Lite-wikien.