Etherpad: Editor Dokumen Kerjasama Masa Nyata

Etherpad Lite ialah alat penyuntingan dokumen percuma berasaskan web yang membolehkan kumpulan pengguna bekerja secara kolaboratif pada dokumen dalam masa nyata, serupa dengan editor berbilang pemain yang dijalankan dalam penyemak imbas web.

Etherpad membenarkan pengarang mengedit secara serentak, melihat pengeditan satu sama lain dalam masa nyata, dengan keupayaan untuk memaparkan setiap teks pengarang dalam warna mereka sendiri.

Ciri Utama Etherpad

  • Berbilang pengguna boleh mengedit dokumen secara serentak sambil melihat perubahan dalam masa nyata.
  • Kotak sembang dalam bar sisi membolehkan pengarang berkomunikasi semasa mengedit, meningkatkan kerjasama.
  • Ia dibina dengan JavaScript pada kedua-dua bahagian pelayan dan klien, menjadikannya mudah bagi pembangun untuk mengekalkan dan menambah ciri baharu.
  • API HTTP yang didokumentasikan dengan baik menyediakan akses kepada semua data, menjadikannya mudah untuk menyepadukannya ke dalam aplikasi lain.
  • Ia menyokong pengimportan dan pengeksportan dokumen dalam pelbagai format (HTML, Open Document, Microsoft Word, PDF dan teks biasa) dan menawarkan terjemahan untuk menampung bahasa tempatan.
  • Ciri "gelangsar masa" membolehkan pengguna meneroka sejarah semakan dokumen.

Untuk rujukan anda, anda boleh menyemak demo Etherpad Lite di pautan: Tonton Demo EtherPad

Dalam tutorial ini, kami akan melalui pemasangan dan konfigurasi Etherpad Lite pada pengedaran berasaskan RHEL dan berasaskan Debian.

Langkah 1: Pasang Perpustakaan dan Pakej Pembangunan

Pertama, kita perlu memasang beberapa pustaka dan alat pembangunan yang diperlukan dengan menjalankan arahan berikut, sama ada sebagai root atau dengan menambah sudo pada permulaan setiap arahan.

Mengenai pengedaran berasaskan RHEL:

sudo yum install gzip git curl python3 openssl-devel && yum groupinstall "Development Tools"

Mengenai pengedaran berasaskan Debian:

sudo apt install gzip git curl python3 libssl-dev pkg-config build-essential

Langkah 2: Pasang Node.js

Anda perlu memuat turun dan memasang versi stabil terkini Node.js dengan menjalankan arahan berikut.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 23
node -v
npm -v

Langkah 3: Muat turun dan Pasang Etherpad Lite

Buat pengguna berasingan yang dipanggil “etherpad ” untuk menjalankan aplikasi Etherpad secara bebas.

sudo useradd --create-home etherpad

Beralih kepada pengguna “etherpad ” dan muat turun versi stabil terkini Etherpad Lite menggunakan repositori Git.

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

Tukar kepada direktori Etherpad Lite dan laksanakan skrip run.sh:

cd etherpad-lite/bin
./run.sh

Anda sepatutnya melihat output yang menunjukkan bahawa Etherpad sedang berjalan dan boleh diakses di http://0.0.0.0:9001/.

Langkah 4: Akses dan Cipta Pad Baharu dalam Etherpad Lite

Buka penyemak imbas web anda dan navigasi ke http://localhost:9001 atau http://your-ip-address:9001.

Untuk membuat dokumen baharu, masukkan nama untuk Pad. Contohnya, mencipta Pad bernama “tecmint ” akan memberikan anda URL http://your-ip-address:9001/p/tecmint. Anda boleh berkongsi URL ini dengan rakan usaha sama dan mereka boleh menyertai sesi pengeditan dalam masa nyata.

Langkah 5: Menggunakan Etherpad Lite dengan MySQL Backend

Secara lalai, Etherpad menyimpan dokumen dalam pangkalan data fail rata. Untuk prestasi yang lebih baik, disyorkan untuk menggunakan MySQL sebagai hujung belakang.

Pada sistem berasaskan RHEL:

sudo yum install mysql-server
sudo systemctl start mysqld
sudo systemctl enable mysqld

Pada sistem berasaskan Debian:

sudo apt install mysql-server
sudo systemctl start mysql
sudo systemctl enable mysql

Sambungkan ke shell MySQL dan buat pangkalan data Etherpad:

mysql -u root -p
CREATE USER 'etherpad'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON etherpad_lite.* TO 'etherpad'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Beralih kembali kepada pengguna “etherpad” dan ubah suai fail settings.json:

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

Kemas kini konfigurasi pangkalan data:

"dbType": "mysql",
"dbSettings": {
  "user": "etherpad",
  "host": "localhost",
  "password": "your-password",
  "database": "etherpad_lite"
},

Sekarang pasang kebergantungan dan jalankan Etherpad sekali lagi untuk memulakan backend MySQL:

./bin/installDeps.sh
./bin/run.sh

Akhir sekali, perlu diingat bahawa aplikasi Etherpad akan menamatkan prosesnya apabila anda menutup sesi terminal. Anda boleh menggunakan perkhidmatan systemd untuk mengurus aplikasi Etherpad dengan lebih mudah, termasuk memulakan, menghentikan dan membolehkannya berjalan semasa but.

Langkah 6: Cipta Fail Perkhidmatan Etherpad Systemd

Sekarang log masuk sebagai pengguna sudo biasa dan buat fail perkhidmatan baharu dalam direktori systemd:

sudo nano /etc/systemd/system/etherpad.service

Tambahkan kandungan berikut pada fail perkhidmatan:

[Unit]
Description=Etherpad Lite
After=network.target

[Service]
Type=simple
User=etherpad
WorkingDirectory=/home/etherpad/etherpad-lite
ExecStart=/usr/bin/node /home/etherpad/etherpad-lite/node/node server.js
Restart=on-failure

[Install]
WantedBy=multi-user.target

Pastikan anda melaraskan laluan ExecStart jika pemasangan Node.js anda berada di lokasi lain.

Selepas mencipta fail perkhidmatan, anda perlu memuat semula systemd untuk mengenali perkhidmatan baharu:

sudo systemctl daemon-reload

Kini anda boleh memulakan perkhidmatan Etherpad dan membolehkannya bermula semasa but:

sudo systemctl start etherpad
sudo systemctl enable etherpad
sudo systemctl status etherpad

Jika semuanya dikonfigurasikan dengan betul, anda boleh mengakses Etherpad dengan menavigasi ke http://your-ip-address:9001 dalam penyemak imbas web anda.

Kesimpulan

Anda telah berjaya memasang dan mengkonfigurasi Etherpad Lite untuk menggunakan MySQL sebagai pangkalan data bahagian belakang. Terdapat banyak lagi untuk diterokai dan dipertingkatkan dalam pemasangan Etherpad anda, seperti mengkonfigurasi akses selamat melalui HTTPS/SSL.

Untuk mendapatkan maklumat lanjut tentang konfigurasi lanjut, lawati wiki rasmi Etherpad Lite.