Etherpad - En Echtzäit Web-baséiert Online Collaborative Document Editor fir Linux

Etherpad ass e webbaséierten gratis Dokument Editor Tool deen e Grupp vu Benotzer erlaabt zesummen un engem Dokument an Echtzäit ze schaffen, wéi e Multi Player Editor deen op engem Webbrowser leeft. Etherpad Autoren kënnen änneren a gläichzäiteg all aner Ännerungen an Echtzäit gesinn mat enger Kapazitéit fir den Auteur säin Text an hiren eegene Faarwen ze weisen.

Dëst Tool huet eng separat Chatbox an der Sidebar, déi Autoren erlaabt während der Redaktioun ze kommunizéieren. Etherpad ass a JavaScript geschriwwen souwuel op Server Säit wéi och Client Säit, sou datt et einfach ass fir Entwéckler nei Features z'erhalen an ze addéieren.

Etherpad ass sou entworf datt Dir Zougang zu all Daten iwwer eng gutt dokumentéiert HTTP API hutt. Dës Software hëlleft Iech och Daten op villen Austauschformater z'importéieren/exportéieren a kënnt och mat Iwwersetzungen, wou Auteuren déi richteg Sprooch fir hir lokal Astellunge liwwere kënnen.

Fir Är Referenz hunn ech eng Demo vun Etherpad Lite um Link hei ënnen befestegt.

  1. EtherPad Demo kucken

An dësem Tutorial wäert ech beschreiwen wéi ech Etherpad Lite installéiere an konfiguréieren, eng webbaséiert Echtzäit kollaborativ Dokument Editéierungsapplikatioun op RHEL, CentOS, Fedora, Debian, Ubuntu a Linux Mint.

Etherpad Lite op Linux installéieren

Als éischt musse mir e puer erfuerderlech Bibliothéiken an Entwécklungsinstrumenter eroflueden an installéieren. Öffnen den Terminal a lafen de folgende Kommando entweder als Root oder andeems Dir Sudo am Ufank vun all Kommando bäidréit.

Dir braucht gzip, git, curl, libssl Python, entwéckelen Bibliothéiken, Python a gcc Packagen.

# yum install gzip git-core curl python openssl-devel && yum groupinstall "Development Tools" For FreeBSD: portinstall node, npm, git
$ sudo apt-get install gzip git-core curl python libssl-dev pkg-config build-essential

Zousätzlech musst Dir och déi lescht stabil Node.js Versioun aus Quellpakete mat de folgende Kommandoen eroflueden a kompiléieren.

$ 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

Wann Dir erfollegräich installéiert hutt, kontrolléiert d'Node.js Versioun mam Kommando wéi follegt.

$ node --version

v0.10.23

Mir kreéieren en separaten Benotzer mam Numm etherpad fir d'Etherpad Applikatioun onofhängeg ze lafen. Also, erstellt als éischt e Benotzer mat sengem Heemverzeichnis.

# useradd --create-home etherpad

Elo schalt op \etherpad Benotzer an luet déi lescht stabil Versioun vun Etherpad Lite mat GIT Repository erof wéi gewisen.

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

Wann Dir Quelldateien erofgelueden hutt, ännert an den nei erstallten Verzeechnes deen de gekloonten Quellcode enthält.

$ cd etherpad-lite/bin

Elo, lafen run.sh Skript aus.

$ ./run.sh
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

Elo sollt Dir fäeg sinn d'Webinterface vun Etherpad Lite op http://localhost:9001 oder http://your-ip-address:9001 an engem Webbrowser ze surfen.

Erstellt en neit Dokument andeems Dir e Pad Numm gitt. Denkt drun, gitt en neien Numm wann Dir en neit Dokument erstellt oder gitt den Numm vum virdru geännerten Dokument fir Zougang.

Zum Beispill hunn ech en neit Dokument mam Numm \tecmint erstallt. D'Benotzer kënnen e puer nei Pads an getrennten Fënsteren erstellen, d'Dokumentfenster vun all Benotzer erschéngt automatesch an Echtzäit op enger anerer Fënster. D'Fënster vun all Benotzer gëtt an zwou verschiddene Faarwen beliicht an och d'Benotzer kënnen matenee interagéieren andeems d'gebauter Chatbox benotzt.

All nei erstallt Dokument huet seng eege URL Struktur. Zum Beispill, meng nei \tecmint Pad kritt eng URL als http://your-ip-address:9001/p/tecmint. Dir kënnt dës Dokument URL mat Äre Frënn a Kollegen deelen. eng aner HTML Websäit als iframe.

Dir kënnt d'Dokument späicheren wärend d'Ännerung amgaang ass andeems Dir op de STAR Knäppchen klickt, awer se ginn periodesch erstallt. Fir Zougang zu enger gespäicherter Versioun vum Dokument ze addéieren, addéiere mer d'Nummer vun der gespäicherter Versioun. Zum Beispill, wann Dir déi gespäichert Versiounsnummer (dh 2) an dësem Fall wëllt gesinn, ersetzt d'Nummer 6 duerch 2 op der http://your-ip-address:9001/p/tecmint/6/export/text .

Etherpad kënnt och mat enger agebauter Feature genannt Import an Export, wou Dir all extern Dokument importéiere kënnt oder en aktuellt gespäichert Dokument an eng separat Datei exportéieren. D'Dokument kann an HTML, Open Document, Microsoft Word, PDF oder Plain Text Format erofgeluede ginn.

Eng Time Slider Feature erlaabt jiddereen d'Geschicht vum Pad z'entdecken.

Par défaut späichert Etherpad Dokumenter an enger flaach Datei Datebank. Ech proposéieren Iech MySQL als Backend ze benotzen fir erstallt a geännert Dokumenter ze späicheren. Fir dëst musst Dir MySQL op Ärem System installéiert hunn. Wann Dir net hutt, installéiere se op de System, Dir kënnt et installéieren andeems Dir folgend Kommandoen als Root Benotzer benotzt oder Sudo benotzt.

# yum install mysql-server mysql
# service mysqld start
# chkconfig mysqld on
# apt-get install mysql-server mysql-client
# service mysqld start

Nodeems MySQL installéiert ass, verbënnt mat mysql Shell andeems Dir e folgend Kommando ausféiert.

# mysql -u root -p

Wann Dir an mysql Shell sidd, gitt de folgende Kommando aus fir d'Datebank ze kreéieren.

create database etherpad_lite;

Gitt Permissiounen op en nei erstallt Datebankkonto. Ersetzen Äert Passwuert mat Ärem eegene Passwuert.

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

Loosst de mysql Client.

exit;

Elo schalt op etherpad Benotzer a gitt an den Etherpad Verzeichnis a lafen déi folgend Kommandoen:

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

Als nächst, öffnen Settings.json mat Ärem Choix vum Editor a ännert d'Astellunge wéi hei ënnendrënner.

# vi settings.json

Fannt de folgenden Text.

"sessionKey" : "",

Füügt de SECURESTRING mat engem Minimum vun 10 alpha-numeresche String.

"sessionKey" : "Aate1mn160",

Dann fannen:

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

A kommentéieren et esou aus:

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

Nächst set Mysql an Admin Astellunge wéi hei ënnendrënner.

  /* 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
    },

Vergewëssert Iech \Är-Passwuert duerch d'Passwuert ze ersetzen, dat Dir uewen erstallt hutt, während Dir en neien Datebankkonto an en Administrateur-Passwuert mat Ärem eegene Wäert opstellt. Elo musse mir e puer zousätzlech Ofhängegkeetspakete mat ënnen Kommando installéieren.

./bin/installDeps.sh

Wann de Skript fäerdeg ass, musse mir den Etherpad Skript erëm ausféieren. Also, et kann déi entspriechend Dëscher an der Datebank erstellen.

./bin/run.sh

Nodeems Etherpad erfollegräich gelueden ass, dréckt Ctrl + C fir de Prozess ëmzebréngen. Login erëm an mysql Shell an änneren d'Datebank fir richteg ze benotzen.

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;

Endlech hu mir Etherpad erfollegräich installéiert a konfiguréiert fir MySQL Backend ze benotzen. Elo lafen den Etherpad erëm fir MySQL als Backend ze benotzen.

./bin/run.sh

De Skript wäert Etherpad initialiséieren an dann de Prozess starten. Bedenkt w.e.g. datt d'Etherpad Applikatioun säi Prozess ofschléisst wann Dir Är Terminal Sessiounsfenster zoumaacht. Optional kënnt Dir den Écran Kommando benotze fir Etherpad an eng Écran Sessioun ze setzen fir einfach Zougang.

Dat ass et fir de Moment, et gi vill méi aner Saachen fir Är Etherpad Installatioun ze entdecken an ze verbesseren, déi net hei ofgedeckt sinn. Zum Beispill kënnt Dir Etherpad als Service an engem Linux System benotzen oder sécheren Zougang zu Ärem Benotzer iwwer HTTPS/SSL Verbindung ubidden. Fir méi Informatiounen iwwer weider Konfiguratioun besicht déi offiziell Säit op:

  1. Etherpad Lite Wiki