Etherpad - En realtidsbaseret online samarbejdsdokumenteditor til Linux i realtid


Etherpad er et webbaseret gratis dokumentredigeringsværktøj, der giver en gruppe brugere mulighed for at arbejde sammen om et dokument i realtid, som en multi-player editor, der kører i en webbrowser. Etherpad-forfattere kan redigere og samtidig se hinandens redigeringer i realtid med mulighed for at vise forfatterens tekst i deres egne farver.

Dette værktøj har en separat chatboks i sidebjælken, der gør det muligt for forfattere at kommunikere under redigering. Etherpad er skrevet i JavaScript både på serversiden og klientsiden, så det er let for udviklere at vedligeholde og tilføje nye funktioner.

Etherpad er designet på en sådan måde, at du kan få adgang til alle data via en veldokumenteret HTTP API. Denne software hjælper dig også med at importere/eksportere data til mange udvekslingsformater og leveres også med oversættelser, hvor forfattere kan levere det korrekte sprog til deres lokale indstillinger.

Til din reference har jeg vedhæftet en demo af Etherpad Lite ved nedenstående link.

  1. Se EtherPad-demo

I denne vejledning vil jeg beskrive, hvordan du installerer og konfigurerer Etherpad Lite et webbaseret realtids samarbejdsdokumentredigeringsprogram på RHEL, CentOS, Fedora, Debian, Ubuntu og Linux Mint.

Installation af Etherpad Lite på Linux

Først skal vi downloade og installere få krævede biblioteker og udviklingsværktøjer. Åbn terminalen, og kør følgende kommando enten som root eller ved at tilføje sudo i begyndelsen af hver kommando.

Du skal bruge gzip, git, curl, libssl python, udvikle biblioteker, python og gcc-pakker.

# 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

Derudover skal du også downloade og kompilere den nyeste stabile Node.js-version fra kildepakker ved hjælp af følgende kommandoer.

$ 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

Når du har installeret, skal du kontrollere Node.js-versionen ved hjælp af kommandoen som følger.

$ node --version

v0.10.23

Vi opretter en separat bruger kaldet "etherpad" til at køre Etherpad-applikationen uafhængigt. Så lav først en bruger med sin hjemmekatalog.

# useradd --create-home etherpad

Skift nu til "etherpad" -bruger, og download den seneste stabile version af Etherpad Lite ved hjælp af GIT-arkivet som vist.

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

Når du har downloadet kildefiler, skal du skifte til det nyoprettede bibliotek med den klonede kildekode.

$ cd etherpad-lite/bin

Udfør nu run.sh-script.

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

Nu skal du kunne gennemse webgrænsefladen til Etherpad Lite på http:/localhost: 9001 eller http:/din-ip-adresse: 9001 i en webbrowser.

Opret et nyt dokument ved at give et Pad-navn. Husk, indtast nyt navn, når du opretter et nyt dokument, eller indtast navnet på det tidligere redigerede dokument for at få adgang.

For eksempel har jeg oprettet et nyt dokument kaldet "tecmint". Brugerens kan oprette flere nye puder i separate vinduer, hver brugers dokumentvindue vises automatisk i et andet vindue i realtid. Hver brugers vindue er fremhævet i to forskellige farver, og også brugerens kan interagere med hinanden ved hjælp af indbygget chatboks.

Hvert nyoprettede dokument har sin egen URL-struktur. For eksempel får min nye "tecmint" -plade en URL som http:/din-ip-adresse: 9001/p/tecmint. Du kan dele denne dokument-URL med dine venner og kolleger. Du kan endda integrere editorvinduet i en anden HTML-webside som en iframe.

Du kan gemme dokumentet, mens redigering er i gang ved at klikke på STAR-knappen, men de oprettes med jævne mellemrum. For at få adgang til en gemt revision af dokumentet skal du tilføje nummeret på den gemte revision. Hvis du f.eks. Gerne vil se det gemte revisionsnummer (dvs. 2) i dette tilfælde, skal du erstatte nummeret 6 med 2 på http:/din-ip-adresse: 9001/p/tecmint/6/eksport/tekst .

Etherpad leveres også med indbygget funktion kaldet import og eksport, hvor du kan importere ethvert eksternt dokument eller eksportere et aktuelt gemt dokument til en separat fil. Dokumentet kan downloades i HTML, åbent dokument, Microsoft Word, PDF eller almindeligt tekstformat.

En “tidsskyder” -funktion gør det muligt for enhver at udforske padets historie.

Etherpad gemmer som standard dokumenter i en fladfildatabase. Jeg foreslår, at du bruger MySQL som en backend til at gemme oprettede og redigerede dokumenter. Til dette skal du have MySQL installeret på dit system. Hvis du ikke har det, skal du installere det på systemet, du kan installere det ved hjælp af følgende kommandoer som rootbruger eller ved hjælp af sudo.

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

Når MySQL er installeret, skal du oprette forbindelse til mysql-skal ved at køre en følgende kommando.

# mysql -u root -p

Når du er i mysql shell, skal du udstede følgende kommando for at oprette databasen.

create database etherpad_lite;

Giv tilladelser til en nyoprettet databasekonto. Udskift "dit kodeord" med dit eget kodeord.

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

Forlad mysql-klienten.

exit;

Skift nu til “etherpad” -bruger, og gå ind i etherpad-biblioteket, og kør følgende kommandoer:

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

Åbn derefter settings.json med dit valg af editor og skift indstillingerne som vist nedenfor.

# vi settings.json

Find følgende tekst.

"sessionKey" : "",

Tilføj SECURESTRING med mindst 10 alfanumerisk streng.

"sessionKey" : "Aate1mn160",

Find derefter:

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

Og kommenter det som sådan:

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

Indstil derefter mysql og admin-indstillinger som vist nedenfor.

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

Sørg for at udskifte “din adgangskode” med den adgangskode, du oprettede ovenfor, mens du opretter en ny databasekonto og en administratoradgangskode med din egen værdi. Nu skal vi installere nogle yderligere afhængighedspakker med nedenstående kommando.

./bin/installDeps.sh

Når scriptet er afsluttet, skal vi køre Etherpad-script igen. Så det kan oprette de relevante tabeller i databasen.

./bin/run.sh

Når Etherpad er indlæst med succes, skal du trykke på Ctrl + C for at dræbe processen. Log igen på mysql shell og ændre databasen til at bruge korrekt.

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;

Endelig har vi med succes installeret og konfigureret Etherpad til at bruge MySQL-backend. Kør nu etherpad igen for at bruge MySQL som backend.

./bin/run.sh

Scriptet initialiserer Etherpad og starter derefter processen. Husk, at Etherpad-applikationen afslutter processen, når du lukker dit terminalsessionsvindue. Eventuelt kan du bruge skærmkommandoen til at placere Etherpad i en skærmsession for nem adgang.

Det er det for nu, der er mange flere andre ting at udforske og forbedre din Etherpad-installation, som ikke er dækket her. For eksempel kan du bruge Etherpad som service i et Linux-system eller give sikker adgang til din brugers HTTPS/SSL-forbindelse. For mere information om yderligere konfiguration, besøg den officielle side på:

  1. Etherpad Lite Wiki