Zoeken op website

Etherpad - Een realtime webgebaseerde online samenwerkende documenteditor voor Linux


Etherpad is een gratis webgebaseerde documenteditor waarmee een groep gebruikers in realtime gezamenlijk aan een document kan werken, zoals een multiplayer-editor die in een webbrowser draait. Etherpad-auteurs kunnen bewerken en tegelijkertijd elkaars bewerkingen in realtime zien, met de mogelijkheid om de tekst van de auteur in hun eigen kleuren weer te geven.

Deze tool heeft een aparte chatbox in de zijbalk waarmee auteurs kunnen communiceren tijdens het bewerken. Etherpad is geschreven in JavaScript, zowel aan de serverkant als aan de clientkant, zodat het voor ontwikkelaars gemakkelijk is om nieuwe functies te onderhouden en toe te voegen.

Etherpad is zo ontworpen dat je toegang hebt tot alle gegevens via een goed gedocumenteerde HTTP API. Deze software helpt u ook bij het importeren/exporteren van gegevens naar vele uitwisselingsformaten en wordt ook geleverd met vertalingen waarbij auteurs de juiste taal kunnen leveren voor hun lokale instellingen.

Ter referentie heb ik een demo van Etherpad Lite bijgevoegd via onderstaande link.

  1. Bekijk de EtherPad-demo

In deze tutorial zal ik beschrijven hoe je Etherpad Lite installeert en configureert, een webgebaseerde realtime applicatie voor het bewerken van documenten op RHEL, CentOS, Fedora, Debian, Ubuntu en Linux Mint.

Etherpad Lite installeren op Linux

Eerst moeten we enkele vereiste bibliotheken en ontwikkeltools downloaden en installeren. Open de terminal en voer de volgende opdracht uit als root of door sudo toe te voegen aan het begin van elke opdracht.

Stap 1: Installeer bibliotheken en ontwikkelingspakketten

Je hebt gzip, git, curl, libssl python, ontwikkelbibliotheken, python en gcc-pakketten nodig.

Op RHEL/CentOS/Fedora
yum install gzip git-core curl python openssl-devel && yum groupinstall "Development Tools" For FreeBSD: portinstall node, npm, git
Op Debian/Ubuntu/Linux Mint
sudo apt-get install gzip git-core curl python libssl-dev pkg-config build-essential

Stap 2: Installeer Node.js

Bovendien moet u ook de nieuwste stabiele Node.js-versie downloaden en compileren vanuit bronpakketten met behulp van de volgende opdrachten.

wget http://nodejs.org/dist/node-latest.tar.gz
tar xvfvz node-latest.tar.gz
cd node-v0.10.23     [Replace a version with your own]
./configure
make
sudo make install

Nadat u de installatie succesvol heeft uitgevoerd, kunt u de Node.js-versie als volgt verifiëren met behulp van de opdracht.

node --version

v0.10.23

Stap 3: Download en installeer Etherpad Lite

We zullen een aparte gebruiker aanmaken met de naam “etherpad ” om de Etherpad-applicatie onafhankelijk uit te voeren. Maak dus eerst een gebruiker aan met zijn thuismap.

useradd --create-home etherpad

Schakel nu over naar de gebruiker “etherpad” en download de nieuwste stabiele versie van Etherpad Lite met behulp van de GIT-repository, zoals weergegeven.

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

Nadat u de bronbestanden heeft gedownload, gaat u naar de nieuw gemaakte map met de gekloonde broncode.

cd etherpad-lite/bin

Voer nu het run.sh-script uit.

./run.sh
Voorbeelduitvoer
Copy the settings template to settings.json...
Ensure that all dependencies are up to date...  If this is the first time you have run Etherpad please be patient.
[2013-12-17 05:52:23.604] [WARN] console - DirtyDB is used. This is fine for testing but not recommended for production.
[2013-12-17 05:52:24.256] [INFO] console - Installed plugins: ep_etherpad-lite
[2013-12-17 05:52:24.279] [INFO] console - Your Etherpad git version is 7d47d91
[2013-12-17 05:52:24.280] [INFO] console - Report bugs at https://github.com/ether/etherpad-lite/issues
[2013-12-17 05:52:24.325] [INFO] console -    info  - 'socket.io started'
[2013-12-17 05:52:24.396] [INFO] console - You can access your Etherpad instance at http://0.0.0.0:9001/
[2013-12-17 05:52:24.397] [WARN] console - Admin username and password not set in settings.json.  To access admin please uncomment and edit 'users' in settings.json

Stap 4: Open en maak een nieuwe pad in Etherpad Lite

Nu zou u door de webinterface van Etherpad Lite moeten kunnen bladeren op http://localhost:9001 of http://uw-ip-adres:9001< in een webbrowser.

Maak een nieuw document door een Padnaam op te geven. Vergeet niet dat u een nieuwe naam moet invoeren wanneer u een nieuw document maakt, of dat u de naam van het eerder bewerkte document moet invoeren om toegang te krijgen.

Ik heb bijvoorbeeld een nieuw document gemaakt met de naam “tecmint”. Gebruikers kunnen meerdere nieuwe pads in afzonderlijke vensters maken, het documentvenster van elke gebruiker verschijnt automatisch in realtime in een ander venster. Het venster van elke gebruiker wordt gemarkeerd in twee verschillende kleuren en gebruikers kunnen ook met elkaar communiceren via de ingebouwde chatbox.

Elk nieuw aangemaakt document heeft zijn eigen URL-structuur. Mijn nieuwe “tecmint” pad krijgt bijvoorbeeld een URL als http://uw-ip-adres:9001/p/tecmint. U kunt deze document-URL URL delen met uw vrienden en collega's. U kunt het editorvenster zelfs als iframe insluiten in een andere HTML webpagina.

U kunt het document opslaan terwijl het wordt bewerkt door op de STAR-knop te klikken. Ze worden echter periodiek aangemaakt. Om toegang te krijgen tot een opgeslagen revisie van het document, voegt u het nummer van de opgeslagen revisie toe. Als u in dit geval bijvoorbeeld het opgeslagen revisienummer (d.w.z. 2) wilt zien, vervangt u het nummer 6 door 2 aan de http://uw-ip-adres:9001/p/tecmint/6/export/text.

Etherpad wordt ook geleverd met een ingebouwde functie genaamd import en export, waarmee u elk extern document kunt importeren of een huidig opgeslagen document kunt exporteren naar een afzonderlijk bestand. Het document kan worden gedownload in HTML, Open document, Microsoft Word, PDF of Platte tekst< formaat.

Met een “tijdschuifregelaar”-functie kan iedereen de geschiedenis van de pad verkennen.

Stap 5: Etherpad Lite gebruiken met MySQL Backend

Standaard slaat Etherpad documenten op in een platte database. Ik stel voor dat u MySQL als backend gebruikt om gemaakte en bewerkte documenten op te slaan. Hiervoor moet u MySQL op uw systeem geïnstalleerd hebben. Als je dit niet hebt, installeer het dan op het systeem. Je kunt het installeren met de volgende opdrachten als root-gebruiker of met sudo.

Op RHEL/CentOS/Fedora
yum install mysql-server mysql
service mysqld start
chkconfig mysqld on
Op Debian/Ubuntu/Linux Mint
apt-get install mysql-server mysql-client
service mysqld start

Nadat MySQL is geïnstalleerd, maakt u verbinding met mysql shell door de volgende opdracht uit te voeren.

mysql -u root -p

Zodra u zich in de mysql-shell bevindt, voert u de volgende opdracht uit om de database te maken.

create database etherpad_lite;

Verleen machtigingen aan een nieuw aangemaakt databaseaccount. Vervang “uw-wachtwoord ” door uw eigen wachtwoord.

grant all privileges on etherpad_lite.* to 'etherpad'@'localhost' identified by 'your-password';

Verlaat de mysql-client.

exit;

Schakel nu over naar de gebruiker “etherpad”, ga naar de directory etherpad en voer de volgende opdrachten uit:

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

Open vervolgens settings.json met de editor van uw keuze en wijzig de instellingen zoals hieronder weergegeven.

vi settings.json

Zoek de volgende tekst.

"sessionKey" : "",

Voeg de SECURESTRING toe met minimaal 10 alfanumerieke tekenreeksen.

"sessionKey" : "Aate1mn160",

Zoek dan:

"dbType" : "dirty",
  //the database specific settings
  "dbSettings" : {
                   "filename" : "var/dirty.db"
                 },

En becommentarieer het als volgt:

// "dbType" : "dirty", */
  //the database specific settings
  // "dbSettings" : {
  //                   "filename" : "var/dirty.db"
  //                 },

Stel vervolgens mysql- en admin-instellingen in zoals hieronder weergegeven.

  /* An Example of MySQL Configuration
   "dbType" : "mysql",
   "dbSettings" : {
                    "user"    : "etherpad",
                    "host"    : "localhost",
                    "password": "your-password",
                    "database": "etherpad_lite"
                  },

  */
  "users": {
    "admin": {
      "password": "your-password",
      "is_admin": true
    },

Zorg ervoor dat u “uw-wachtwoord” vervangt door het wachtwoord dat u hierboven heeft aangemaakt tijdens het instellen van een nieuw database-account en een beheerderswachtwoord met uw eigen waarde. Nu moeten we enkele extra afhankelijkheidspakketten installeren met het onderstaande commando.

./bin/installDeps.sh

Zodra het script is voltooid, moeten we het Etherpad-script opnieuw uitvoeren. Het kan dus de juiste tabellen in de database maken.

./bin/run.sh

Nadat Etherpad succesvol is geladen, drukt u op Ctrl+C om het proces te beëindigen. Log opnieuw in op de mysql-shell en wijzig de database zodat deze correct wordt gebruikt.

mysql -u root -p
alter database etherpad_lite character set utf8 collate utf8_bin;
use etherpad_lite;
alter table store convert to character set utf8 collate utf8_bin;
exit;

Ten slotte hebben we met succes Etherpad geïnstalleerd en geconfigureerd om de MySQL-backend te gebruiken. Voer nu het etherpad opnieuw uit om MySQL als backend te gebruiken.

./bin/run.sh

Het script initialiseert Etherpad en start vervolgens het proces. Houd er rekening mee dat de Etherpad-applicatie het proces beëindigt wanneer u uw terminalsessievenster sluit. Optioneel kunt u de schermopdracht gebruiken om Etherpad in een schermsessie te plaatsen voor gemakkelijke toegang.

Dat is het voor nu. Er zijn nog veel meer dingen die u kunt ontdekken en verbeteren voor uw Etherpad-installatie, die hier niet worden behandeld. U kunt Etherpad bijvoorbeeld gebruiken als service in een Linux-systeem of veilige toegang tot uw gebruikerssystemen bieden via HTTPS/SSL sterke> verbinding. Bezoek de officiële pagina voor meer informatie over verdere configuratie:

  1. Etherpad Lite-wiki