Etherpad - reaalajas veebipõhine veebidokumentide koostöötlus Linuxile

Etherpad on veebipõhine tasuta dokumendiredaktori tööriist, mis võimaldab kasutajagrupil töötada reaalajas dokumendi kallal koos, nagu veebibrauseris töötav mitme mängijaga toimetaja. Etherpad'i autorid saavad redigeerida ja samal ajal näha üksteist reaalajas, võimaldades kuvada autori teksti oma värvides.

Selle tööriista külgribal on eraldi vestluskast, mis võimaldab autoritel redigeerimise ajal suhelda. Etherpad on kirjutatud JavaScripti nii serveri- kui kliendipoolel, nii et arendajatel on hõlbus hooldada ja lisada uusi funktsioone.

Etherpad on loodud nii, et teil oleks juurdepääs kõikidele andmetele hästi dokumenteeritud HTTP API kaudu. See tarkvara aitab teil andmeid importida/eksportida paljudesse vahetusvormingutesse ning kaasas on ka tõlked, kus autorid saavad kohalike seadete jaoks pakkuda õiget keelt.

Lisan viitamiseks lingi all olevale Etherpad Lite'i demo.

  1. Vaadake EtherPadi demot

Selles õpetuses kirjeldan, kuidas installida ja konfigureerida veebipõhist reaalajas dokumentide redigeerimisrakendust Etherpad Lite RHEL, CentOS, Fedora, Debian, Ubuntu ja Linux Mint.

Etherpad Lite'i installimine Linuxi

Esiteks peame alla laadima ja installima mõned vajalikud teegid ja arendustööriistad. Avage terminal ja käivitage järgmine käsk kas juurena või lisades iga käsu alguses sudo.

Teil on vaja gzip, git, curl, libssl python, arendage teeke, pythoni ja gcc pakette.

# 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

Lisaks peate allalaaditavatest pakettidest alla laadima ja kompileerima uusima stabiilse Node.js versiooni, kasutades järgmisi käske.

$ 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

Kui olete edukalt installinud, kontrollige Node.js versiooni, kasutades käsku järgmiselt.

$ node --version

v0.10.23

Etherpadi rakenduse iseseisvaks käitamiseks loome eraldi kasutaja nimega “etherpad”. Nii et kõigepealt looge kasutaja oma kodukataloogiga.

# useradd --create-home etherpad

Nüüd lülituge „etherpad“ kasutajale ja laadige alla Etherpad Lite uusim stabiilne versioon, kasutades GIT hoidlat, nagu näidatud.

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

Kui olete lähtekoodifailid alla laadinud, vahetage see uuesti loodud kataloogi, mis sisaldab kloonitud lähtekoodi.

$ cd etherpad-lite/bin

Nüüd käivitage skript run.sh.

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

Nüüd peaksite sirvima veebibrauseris Etherpad Lite'i veebiliidest aadressil http:// localhost: 9001 või http:// teie-ip-aadress: 9001.

Looge uus dokument, andes Padi nime. Pidage meeles, et uue dokumendi loomisel sisestage uus nimi või juurdepääsuks sisestage varem muudetud dokumendi nimi.

Näiteks olen loonud uue dokumendi nimega “tecmint”. Kasutaja saab eraldi akendesse luua mitu uut klotsi, iga kasutaja dokumendiaken kuvatakse teises aknas reaalajas automaatselt. Iga kasutaja aken on esile tõstetud kahe erineva värviga ja ka kasutaja saab sisseehitatud vestluskasti abil üksteisega suhelda.

Igal vastloodud dokumendil on oma URL-i struktuur. Näiteks on minu uue „tecmint” padi URL-i URL: http:// teie-ip-aadress: 9001/p/tecmint. Selle dokumendi URL-i saate jagada oma sõprade ja kolleegidega. Võite isegi redigeerimisakna iframe'ina manustada teisele HTML-i veebilehele.

Redigeerimise ajal saate dokumendi salvestada, klõpsates nuppu STAR, kuid need luuakse perioodiliselt. Dokumendi salvestatud redaktsioonile juurdepääsemiseks lisage salvestatud redaktsiooni number. Näiteks kui soovite sel juhul näha salvestatud redaktsiooni numbrit (st 2), asendage number 6 numbriga 2 aadressil http:// teie-ip-aadress: 9001/p/tecmint/6/export/text .

Etherpadil on ka sisseehitatud funktsioon nimega import ja eksport, kus saate importida mis tahes välise dokumendi või eksportida praeguse salvestatud dokumendi eraldi faili. Dokumendi saab alla laadida HTML-, Open Document-, Microsoft Word-, PDF- või lihttekstivormingus.

Ajaliuguri funktsioon võimaldab kõigil uurida padja ajalugu.

Vaikimisi salvestab Etherpad dokumendid kindla failiga andmebaasi. Soovitan teil loodud ja muudetud dokumentide salvestamiseks kasutada MySQL-i taustaprogrammina. Selleks peab teie arvutisse olema installitud MySQL. Kui teil seda pole, installige see süsteemi, saate selle installida järgmiste käskude abil juurkasutajana või sudo abil.

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

Kui MySQL on installitud, looge järgmine käsk, ühendage mysql shelliga.

# mysql -u root -p

Kui olete mysql-i shellis, andke andmebaasi loomiseks järgmine käsk.

create database etherpad_lite;

Andke õigused äsja loodud andmebaasikontole. Asendage oma parool oma parooliga.

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

Jätke mysql klient.

exit;

Nüüd lülituge kasutajale „etherpad” ja minge etherpad'i kataloogi ning käivitage järgmised käsud:

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

Järgmisena avage redaktori valikul settings.json ja muutke seadeid, nagu allpool näidatud.

# vi settings.json

Leidke järgmine tekst.

"sessionKey" : "",

Lisage SECURESTRING vähemalt 10 tähtnumbrilise stringiga.

"sessionKey" : "Aate1mn160",

Seejärel leidke:

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

Ja kommenteerige seda nii:

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

Järgmisena määrake mysql ja administraatori sätted, nagu allpool näidatud.

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

Uue andmebaasikonto ja oma väärtusega administraatori parooli seadistamisel asendage parool kindlasti oma loodud parooliga. Nüüd peame installima mõned täiendavad sõltuvuspaketid käsuga allpool.

./bin/installDeps.sh

Kui skript on valmis, peame uuesti käivitama Etherpadi skripti. Nii saab see andmebaasi luua sobivad tabelid.

./bin/run.sh

Kui Etherpad on edukalt laaditud, vajutage protsessi tapmiseks klahvikombinatsiooni Ctrl + C. Jällegi logige sisse mysql shellisse ja muutke andmebaasi õigeks kasutamiseks.

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;

Lõpuks oleme edukalt installinud ja konfigureerinud Etherpadi MySQL-i taustaprogrammi kasutamiseks. Nüüd käivitage etherpad uuesti, et MySQL-i taustaprogrammina kasutada.

./bin/run.sh

Skript lähtestab Etherpadi ja alustab seejärel protsessi. Pidage meeles, et rakendus Etherpad lõpetab selle protsessi, kui sulgete terminaliseansi akna. Soovi korral saate hõlpsalt juurdepääsemiseks kasutada Etherpadi ekraaniseanssi paigutamiseks ekraanikäsu.

See on praegu, teie Etherpadi installimise uurimiseks ja täiustamiseks on veel palju muid asju, mida siin ei käsitleta. Näiteks võite kasutada Etherpadit Linuxi süsteemi teenusena või pakkuda turvalist juurdepääsu oma kasutajale HTTPS/SSL-ühenduse kaudu. Lisateavet täiendava seadistamise kohta leiate ametlikust lehelt aadressil:

  1. Etherpad Lite Wiki