Etherpad - Editur ta' Dokumenti Kollaborattivi Online Ibbażat fuq il-Web f'Ħin Real għal Linux

Etherpad hija għodda ta' editur ta' dokumenti b'xejn ibbażata fuq il-web li tippermetti lil grupp ta' utenti jaħdmu flimkien fuq dokument f'ħin reali, bħal editur b'ħafna plejers li jaħdem fuq web browser. L-awturi tal-Etherpad jistgħu jeditjaw u fl-istess ħin jaraw editjar lil xulxin f'ħin reali b'kapaċità li juru t-test tal-awtur bil-kuluri tagħhom stess.

Din l-għodda għandha chat box separata fil-sidebar li tippermetti lill-awturi jikkomunikaw waqt l-editjar. Etherpad huwa miktub f'JavaScript kemm fuq in-naħa tas-server kif ukoll fuq in-naħa tal-klijent, sabiex ikun faċli għall-iżviluppaturi biex iżommu u jżidu karatteristiċi ġodda.

Etherpad huwa ddisinjat b'tali mod li jista 'jkollok aċċess għad-dejta kollha permezz ta' HTTP API dokumentat tajjeb. Dan is-software jgħinek ukoll timporta/tesporta data f'ħafna formati ta' skambju u jiġi wkoll bi traduzzjonijiet fejn l-awturi jistgħu jwasslu lingwa korretta għall-issettjar lokali tagħhom.

Għar-referenza tiegħek, waħħalt Demo ta 'Etherpad Lite fil-link hawn taħt.

  1. Ara Demo EtherPad

F'dan it-tutorja, ser niddeskrivi kif tinstalla u tikkonfigura Etherpad Lite applikazzjoni ta 'editjar ta' dokumenti kollaborattivi f'ħin reali bbażata fuq il-web fuq RHEL, CentOS, Fedora, Debian, Ubuntu u Linux Mint.

Installazzjoni ta 'Etherpad Lite fuq Linux

L-ewwel, għandna bżonn tniżżel u ninstallaw ftit libreriji meħtieġa u għodod ta 'żvilupp. Iftaħ it-terminal u mexxi l-kmand li ġej jew bħala root jew billi żżid sudo fil-bidu ta 'kull kmand.

Ikollok bżonn gzip, git, curl, libssl python, tiżviluppa libreriji, python u pakketti gcc.

# 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

Barra minn hekk, ser ikollok bżonn ukoll tniżżel u tiġbor l-aħħar verżjoni stabbli ta 'Node.js minn pakketti sors billi tuża l-kmandi li ġejjin.

$ 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

Ladarba tkun installat b'suċċess, ivverifika l-verżjoni Node.js billi tuża l-kmand kif ġej.

$ node --version

v0.10.23

Aħna se noħolqu utent separat imsejjaħ \etherpad biex iħaddem l-applikazzjoni Etherpad b'mod indipendenti. Għalhekk, l-ewwel oħloq utent bid-direttorju tad-dar tiegħu.

# useradd --create-home etherpad

Issa aqleb għall-utent \etherpad u niżżel l-aħħar verżjoni stabbli ta 'Etherpad Lite billi tuża r-repożitorju GIT kif muri.

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

Ladarba tkun niżżilt il-fajls tas-sors, ibdel fid-direttorju maħluq ġdid li fih il-kodiċi tas-sors klonat.

$ cd etherpad-lite/bin

Issa, tesegwixxi l-iskrittura 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

Issa għandek tkun tista' tfittex l-interface tal-web ta' Etherpad Lite fuq http://localhost:9001 jew http://your-ip-address:9001 f'web browser.

Oħloq dokument ġdid billi tagħti isem Pad. Jekk jogħġbok ftakar, daħħal isem ġdid meta toħloq dokument ġdid jew daħħal l-isem tad-dokument editjat qabel għall-aċċess.

Per eżempju, ħloqt dokument ġdid imsejjaħ \tecmint. Utent jista 'joħloq pads ġodda multipli fi twieqi separati, it-tieqa tad-dokument ta' kull utent tidher fuq tieqa oħra awtomatikament f'ħin reali. It-tieqa ta 'kull utent hija enfasizzata f'żewġ kuluri differenti u wkoll l-utent jistgħu jinteraġixxu ma 'xulxin bl-użu built-in chat kaxxa.

Kull dokument maħluq ġdid għandu l-istruttura tal-URL tiegħu stess. Pereżempju, il-pad il-ġdid tiegħi \tecmint tikseb URL bħala http://your-ip-address:9001/p/tecmint. Tista' taqsam dan il-URL tad-dokument mal-ħbieb u l-kollegi tiegħek. Tista' anki daħħal it-tieqa tal-editur ġo paġna web HTML oħra bħala iframe.

Tista' tissejvja d-dokument waqt li tkun għaddejja l-editjar billi tikklikkja l-buttuna STAR, madankollu dawn jinħolqu perjodikament. Biex taċċessa reviżjoni ssejvjata tad-dokument żid in-numru tar-reviżjoni ssejvjata. Pereżempju, jekk tixtieq tara n-numru tar-reviżjoni ssejvjat (jiġifieri 2) f'dan il-każ, ibdel in-numru 6 b'2 fuq http://your-ip-address:9001/p/tecmint/6/export/text .

Etherpad jiġi wkoll b'karatteristika integrata msejħa importazzjoni u esportazzjoni, fejn tista 'timporta kwalunkwe dokument estern jew tesporta dokument ffrankat kurrenti f'fajl separat. Id-dokument jista' jitniżżel f'format HTML, Open Document, Microsoft Word, PDF jew Plain text.

Karatteristika time slider tippermetti lil kulħadd jesplora l-istorja tal-kuxxinett.

B'mod awtomatiku Etherpad jaħżen id-dokumenti f'database ta' fajl ċatt. Nissuġġerixxi li tuża MySQL bħala backend biex taħżen dokumenti maħluqa u editjati. Għal dan, irid ikollok MySQL installat fis-sistema tiegħek. Jekk m'għandekx, installaha fuq is-sistema, tista 'tinstallaha billi tuża l-kmandi li ġejjin bħala root user jew billi tuża sudo.

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

Wara li jkun installat MySQL, qabbad mal-shell mysql billi tmexxi kmand li ġej.

# mysql -u root -p

Ladarba inti fil-qoxra mysql, ħarġet il-kmand li ġej biex toħloq id-database.

create database etherpad_lite;

Agħti permessi għal kont tad-database maħluq ġdid. Ibdel \password tiegħek bil-password tiegħek stess.

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

Ħalli l-klijent mysql.

exit;

Issa, aqleb għall-utent etherpad u mur fid-direttorju tal-etherpad u mexxi l-kmandi li ġejjin:

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

Sussegwentement, iftaħ settings.json bl-għażla tal-editur tiegħek u ibdel is-settings kif muri hawn taħt.

# vi settings.json

Sib it-test li ġej.

"sessionKey" : "",

Żid is-SECURESTRING b'sekwenza minima ta' 10 alfanumeriki.

"sessionKey" : "Aate1mn160",

Imbagħad sib:

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

U kkummenta hekk:

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

Sussegwentement issettja mysql u l-issettjar tal-amministratur kif muri hawn taħt.

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

Kun żgur li tissostitwixxi \your-password bil-password li ħloqt hawn fuq waqt li twaqqaf kont tad-database ġdid u password tal-amministratur bil-valur tiegħek. Issa, għandna bżonn ninstallaw xi pakketti ta' dipendenza addizzjonali bil-kmand ta' hawn taħt.

./bin/installDeps.sh

Ladarba l-iskript jitlesta, ikollna bżonn nerġgħu nħaddmu l-iskrittura Etherpad. Għalhekk, tista 'toħloq it-tabelli xierqa fid-database.

./bin/run.sh

Wara li Etherpad tagħbija b'suċċess, agħfas Ctrl + C biex toqtol il-proċess. Għal darb'oħra idħol f'mysql shell u biddel id-database biex tuża b'mod korrett.

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;

Fl-aħħarnett, installajna u kkonfigurajna b'suċċess Etherpad biex juża backend MySQL. Issa erġa ħaddem l-etherpad biex tuża MySQL bħala backend.

./bin/run.sh

L-iskrittura se initialize Etherpad u mbagħad tibda l-proċess. Jekk jogħġbok żomm f'moħħok li l-applikazzjoni Etherpad se ttemm il-proċess tagħha meta tagħlaq it-tieqa tas-sessjoni tat-terminal tiegħek. B'għażla, tista' tuża l-kmand tal-iskrin biex tpoġġi Etherpad f'sessjoni tal-iskrin għal aċċess faċli.

Dak hu għalissa, hemm ħafna aktar affarijiet oħra biex tesplora u ttejjeb l-installazzjoni ta 'Etherpad tiegħek, li mhumiex koperti hawn. Pereżempju, tista 'tuża Etherpad bħala servizz f'sistema Linux jew tipprovdi aċċess sigur għall-konnessjoni tal-utent tiegħek permezz ta' HTTPS/SSL. Għal aktar informazzjoni dwar aktar konfigurazzjoni żur il-paġna uffiċjali fuq:

  1. Etherpad Lite Wiki