Cách cài đặt VisualEditor cho MediaWiki trên CentOS 7

[theanh]

VisualEditor là trình soạn thảo văn bản có định dạng cho MediaWiki. Có sẵn dưới dạng tiện ích mở rộng và dựa vào dịch vụ phân tích cú pháp Parsoid để chạy và chỉnh sửa các trang MediaWiki.

Đến với Parsoid, đây là dịch vụ phân tích cú pháp dựa trên Nodejs. Dịch vụ này đang được nhiều tiện ích mở rộng MediaWiki sử dụng, bao gồm VisualEditor, Flow, Content Translation và các ứng dụng khác.

Trong hướng dẫn này, tôi sẽ chỉ cho bạn cách cài đặt và cấu hình VisualEditor từng bước cho MediaWiki phiên bản 1.30 mới nhất. Điều đáng chia sẻ là MediaWiki của chúng tôi được cài đặt trên hệ điều hành CentOS 7 và chúng tôi sẽ thêm và cài đặt Nodejs, dịch vụ Parsoid và cấu hình VisualEditor cho MediaWiki Editor.

Điều kiện tiên quyết​

• CentOS 7 đã cài đặt MediaWiki
• Quyền root

Những việc chúng tôi sẽ làm​

1. Kiểm tra cài đặt MediaWiki
2. Cài đặt các phần phụ thuộc
3. Cài đặt và cấu hình dịch vụ Parsoid
4. Cài đặt và cấu hình VisualEditor cho MediaWiki
5. Kiểm tra thiết lập

Bước 1 - Kiểm tra cài đặt MediaWiki​

Trong bước này, chúng tôi sẽ kiểm tra cài đặt MediaWiki của mình. MediaWiki được cài đặt dưới tên miền 'http://wiki.hakase-labs.me'. Mở trình duyệt web và truy cập địa chỉ URL MediaWiki sau, của tôi là:

http://wiki.hakase-labs.me/

Bạn sẽ được chuyển hướng đến kết nối HTTPS, sau đó bạn sẽ đến trang MediaWiki với giao diện 'Vector' tương tự như giao diện hiển thị bên dưới.



Tiếp theo, hãy đăng nhập với tư cách là người dùng quản trị và thử chỉnh sửa trang. Nhấp vào tab 'Chỉnh sửa' và bạn sẽ nhận được trình chỉnh sửa MediaWiki mặc định như bên dưới.



MediaWiki đang hoạt động mà không có bất kỳ lỗi nào.

Bước 2 - Cài đặt các phụ thuộc​

Để cài đặt dịch vụ Parsoid và cấu hình VisualEditor, chúng ta cần cài đặt một số gói CentOS trên hệ thống. Cụ thể, chúng ta sẽ cài đặt Nodejs, npm, vim và git.

Cài đặt tất cả các gói cần thiết bằng lệnh yum bên dưới.

yum -y install nodejs npm vim-enhanced git

Tất cả các gói và phụ thuộc đã được cài đặt.

Bước 3 - Cài đặt và cấu hình Parsoid​

Parsoid có thể được cài đặt trên một máy chủ MediaWiki riêng biệt. Nhưng đối với hướng dẫn này, chúng ta sẽ chỉ sử dụng 1 máy chủ CentOS 7 cho cả MediaWiki và Parsoid.

Bây giờ, vì chúng ta đang sử dụng máy chủ CentOS 7, chúng ta cần cài đặt dịch vụ Parsoid theo cách thủ công từ nguồn vì các gói chính thức chỉ khả dụng cho các hệ điều hành dựa trên Ubuntu/Debian.

Vì vậy, để bắt đầu, hãy tạo một thư mục '/opt/parsoid' mới và sao chép parsoid mới nhất bằng lệnh git, như được hiển thị bên dưới.

mkdir -p /opt/parsoid
git clone https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid /opt/parsoid

Bây giờ hãy đến thư mục '/opt/parsoid' và cài đặt dịch vụ Parsoid bằng lệnh npm sau.

cd /opt/parsoid
npm cài đặt

Sau khi cài đặt hoàn tất, bạn sẽ nhận được kết quả như bên dưới.



Tiếp theo, cấu hình dịch vụ Parsoid bằng cách chỉnh sửa các tệp cấu hình tương ứng.

Sao chép cấu hình ví dụ 'localsettings.example.js' vào 'localsettings.js', sau đó chỉnh sửa tệp bằng vim.

cp localsettings.example.js localsettings.js
vim localsettings.js

Bỏ chú thích dòng 'parsoidConfig.setMwApi' và thay đổi giá trị 'uri' bằng URL API MediaWiki của bạn như bên dưới.

exports.setup = function(parsoidConfig) {
 // Thực hiện một số thao tác động với `parsoidConfig` như,
 parsoidConfig.setMwApi({
 uri: 'http://wiki.hakase-labs.me/api.php',
 });
 };

Vậy là xong. Lưu và thoát.

Bây giờ hãy sao chép cấu hình 'config.example.yaml' vào 'config.yaml' và chỉnh sửa bằng trình soạn thảo vim.

cp config.example.yaml config.yaml
vim config.yaml

Trên dòng 'mwApis' (dòng số 34), hãy thay đổi giá trị 'uri' bằng URL API MediaWiki của bạn và giá trị 'domain' bằng tên miền của riêng bạn.

mwApis:
 - # Đây là tham số bắt buộc duy nhất,
 # URL của điểm cuối API MediaWiki của bạn.
 uri: 'http://wiki.hakase-labs.me/api.php'
 # "domain" được sử dụng để giao tiếp với Visual Editor
 # và RESTBase. Mặc định là phần tên máy chủ của 
 # thuộc tính `uri` ở trên, nhưng bạn có thể tự tay thiết lập 
 # thành một chuỗi tùy ý. Nó phải khớp với "domain" được thiết lập 
 # trong $wgVirtualRestConfig. 
 domain: 'wiki.hakase-labs.me' 
 #optional

Lưu và thoát.

Tiếp theo, chúng ta sẽ cấu hình Parsoid như một dịch vụ. Để thực hiện việc này, hãy vào thư mục '/etc/systemd/system' và tạo một tệp dịch vụ mới có tên là 'parsoid.service'.

cd /etc/systemd/system/
vim parsoid.service

Dán cấu hình dịch vụ Parsoid bên dưới.

[Unit]
 Description=Mediawiki Dịch vụ web Parsoid trên node.js
 Documentation=http://www.mediawiki.org/wiki/Parsoid
 Wants=local-fs.target network.target
 After=local-fs.target network.target
 
 [Install]
 WantedBy=multi-user.target
 
 [Service]
 Type=simple
 User=root
 Group=root
 WorkingDirectory=/opt/parsoid
 ExecStart=/usr/bin/node /opt/parsoid/bin/server.js
 KillMode=process
 Restart=on-success
 PrivateTmp=true
 StandardOutput=syslog

Lưu và thoát. Sau đó thực hiện lệnh tải lại sau.

systemctl daemon-reload

Bây giờ, hãy khởi động dịch vụ Parsoid và cho phép dịch vụ này thực thi mọi lúc khi khởi động hệ thống.

systemctl start parsoid
systemctl enable parsoid

Parsoid hiện sẽ chạy như một dịch vụ trên CentOS 7, sử dụng cổng 8000. Bạn có thể kiểm tra bằng lệnh netstat theo cách sau.

netstat -plntu

Và bạn sẽ nhận được kết quả tương tự như sau:



Quá trình cài đặt và cấu hình parsoid đã hoàn tất.

Lưu ý:

Nếu bạn đang chạy Firewalld trên máy chủ của mình, hãy thêm cổng parsoid 8000 vào cấu hình firewalld bằng các lệnh sau.

firewall-cmd --add-port=8000/tcp --permanent
firewall-cmd --reload

Bước 4 - Cài đặt và cấu hình VisualEditor​

Trong bước này, chúng ta sẽ cài đặt và cấu hình tiện ích mở rộng VisualEditor cho MediaWiki.

Vào thư mục cài đặt MediaWiki '/var/www/mediawiki/extensions' và tải xuống phiên bản VisualEditor mới nhất bằng git.

cd /var/www/mediawiki/extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/VisualEditor.git

Bây giờ hãy vào thư mục VisualEditor, khởi tạo và cập nhật tất cả các mô-đun con bên trong thư mục đó.

cd VisualEditor/
git submodule update --init

Tiếp theo, chúng ta cần chỉnh sửa tệp cấu hình Mediawiki 'LocalSettings.php' để kích hoạt VisualEditor. Để thực hiện việc này, hãy vào thư mục mediawiki và chỉnh sửa tệp 'LocalSettings.php' bằng vim.

cd /var/www/mediawiki
vim LocalSettings.php

Dán cấu hình bên dưới vào cuối tệp.

wfLoadExtension( 'VisualEditor' );
 
 // Bật theo mặc định cho mọi người
 $wgDefaultUserOptions['visualeditor-enable'] = 1;
 
 // Tùy chọn: Đặt VisualEditor làm mặc định cho người dùng ẩn danh
 // nếu không, họ sẽ phải chuyển sang VE
 // $wgDefaultUserOptions['visualeditor-editor'] = "visualeditor";
 
 // Không cho phép người dùng tắt nó
 $wgHiddenPrefs[] = 'visualeditor-enable';
 
 // TÙY CHỌN: Bật Các tính năng mã thử nghiệm của VisualEditor
 #$wgDefaultUserOptions['visualeditor-enable-experimental'] = 1;
 
 
 $wgVirtualRestConfig['modules']['parsoid'] = array(
 // URL đến phiên bản Parsoid
 // Sử dụng cổng 8142 nếu bạn sử dụng gói Debian
 'url' => 'http://wiki.hakase-labs.me:8000',
 // "Tên miền" Parsoid, xem bên dưới (tùy chọn)
 'Tên miền' => 'wiki.hakase-labs.me',
 // "Tiền tố" Parsoid, xem bên dưới (tùy chọn)
 'Tiền tố' => 'wiki.hakase-labs.me'
 );

Vậy là xong. Lưu và thoát.

Lưu ý:

Vui lòng thay đổi URL bằng tên miền của riêng bạn.

Tiếp theo, thay đổi quyền sở hữu cho thư mục mediawiki thành người dùng và nhóm 'nginx'.

chown -R nginx:nginx /var/www/mediawiki

Quá trình cài đặt tiện ích mở rộng VisualEditor đã hoàn tất.

Bước 5 - Kiểm tra​

Mở trình duyệt web của bạn và truy cập URL MediaWiki sau, của tôi là:

http://wiki.hakase-labs.me

Bây giờ, hãy đăng nhập với tư cách quản trị viên.



Sau khi đăng nhập, hãy nhấp vào tab 'Chỉnh sửa' để chỉnh sửa trang chủ. Bạn sẽ tải VisualEditor như hiển thị bên dưới.



Quá trình cài đặt và cấu hình VisualEditor của MediaWiki trên CentOS 7 đã hoàn tất thành công.

Tham khảo​

• https://www.mediawiki.org/wiki/Extension:VisualEditor