1.为MediaWiki安装可视化编辑器VisualEditor
2.[译] 为什么我们需要 LSP?源码
3.ubuntu 22.04上vim-plug插件管理器,相关插件与ROS2的构建安装
4.Debian 12 / Ubuntu 22.04 下体验 HTTP/3 协议的 Nginx QUIC
为MediaWiki安装可视化编辑器VisualEditor
本来没想要更新的,直到今天群里有朋友贴了一段配置代码,源码就知道很多人可能“吃药”了。构建在MediaWiki升级到1.之后,源码Parsoid服务被PHP重构了,构建代挂源码教学直接装入源码中,源码可视化编辑器变得“开箱即用”,构建所以下面的源码文章极有可能会成为历史。
这篇文章于年的构建1月份发布于本人的网站,当时偷懒,源码有部分内容没有写完整。构建直到最近重新安装可视化编辑器才发现:安装过程并不是源码bug修复源码太过复杂,基本上只要你的构建Parsoid安装成功并且能够运行,那么离成功也就不远了,源码而所缺的就是几个检测结果和。另外被restbase给迷惑了,其实并不是必须的。
MediaWiki的可视化编辑器从年5月立项开始,发展到至今快6个年头,而真正走入大众视野却是在年的年中。目前维基百科的默认编辑器就是VisualEditor,它的所见即所得的特性提高了用户的体验,降低了入门门槛并提升了编辑维基的乐趣。 VisualEditor的天道轮回源码原理,简单来说就是通过后台Parsoid 的程序来承担把wiki标记转化成html的任务,同时VisualEditor以插件的形式在MediaWiki中运行,用户可以在原来的编辑界面直接使用,编辑者角度上几乎无学习成本。 而它的安装难度要大于其他扩展程序,主要也就在于需要Parsoid服务(它是一个基于Nodejs的解析器服务。 它被许多MediaWiki扩展使用,包括VisualEditor,Flow,内容翻译和其他应用程序)的支持。而官方文档上除了有Ubuntu和Debian的安装方法外(基本上属于自动安装),没有给出CentOS的ab源码网站安装方法。 本文以指导如何在CentOS7下安装VisualEditor。
提示:
一、安装Parsoid
这是为在没有安装Parsoid的情况下,系统提示的错误信息。你虽然能够看到一个可视化编辑器的样式却无法使用。
1、安装依赖关系
要安装Parsoid服务并配置VisualEditor,我们需要在系统上安装一些CentOS软件包。 具体来说,我们将安装Nodejs,npm,vim和git。楼梯动画源码 使用下面的yum命令安装所有需要的软件包。
一定要确保所有的软件包和依赖项已经安装(如果你使用宝塔面板,那么在软件商店中安装PM2管理器,并且选择你的Node版本)。
2、安装并配置Parsoid
Parsoid可以安装在单独的MediaWiki服务器上。 但是对于本教程,我们默认是将MediaWiki和Parsoid安装在同一个CentOS 7服务器。 现在,由于我们使用的是CentOS 7服务器,因此我们需要手动安装Parsoid服务,因为官方软件包仅适用于基于Ubuntu / Debian的操作系统。 因此,首先创建一个新的/ opt / parsoid目录,并使用git命令克隆最新的parsoid,如下所示。
现在进入“/ opt / parsoid”目录,使用下面的npm命令安装Parsoid服务。
安装完成后,您将得到如下结果。
接下来,通过编辑相应的配置文件来配置Parsoid服务。 将示例配置“localsettings.example.js”复制到“localsettings.js”,然后使用vim编辑该文件。
取消注释“parsoidConfig.setMwApi”行,并使用MediaWiki API URL更改“uri”值,如下所示。
保存并退出。
注:此步骤非必须,而且默认配置文件关闭了调用localsettings.js文件的功能的,除非你的Parsoid和MediaWiki不在同一个服务器上。
现在将'config.example.yaml'配置复制到'config.yaml'并用vim编辑器进行编辑。
在“mwApis”行(第行)上,使用MediaWiki API URL和“域”值更改“uri”值,并使用你自己的域名。
uri中的地址请复制到浏览器检验一下,在我的网站中api.php文件是位于网站根目录下的,如果你将MediaWiki安装在网站的某个子目录下(如Wiki),那么请将uri改为/sb/n... $(lsb_release -sc) main" > /etc/apt/sources.list.d/n.wtf.list
或
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/n.wtf.gpg] mirror.nju.edu.cn/sb/ng... $(lsb_release -sc) main" > /etc/apt/sources.list.d/n.wtf.list
2.4 更新并安装 Nginx
apt update apt install nginx-extras -y
安装完毕后,我们可以使用nginx -V 命令看到 Nginx 已经是最新的 1..0 主线版 + QUIC 了:
root@debian ~ # nginx -V nginx version: nginx-n.wtf/1..0 built with OpenSSL 3.0.8+quic 7 Feb TLS SNI support enabled
2.5 使用 Docker 安装
你也可以使用 Docker 进行体验:
docker run --name nginx --net host --restart always -v $HOME/nginx-config:/usr/src/docker-nginx/conf:ro -d ghcr.io/u-sb/nginx
此时配置文件的目录在当前目录的nginx-config 文件夹下。
3、配置 Nginx
首先,HTTP/3 仅支持 HTTPS 协议,因此我们需要准备好 SSL 证书,可以参考 《Nginx 配置 SSL 证书》获取 SSL 证书。
其次,需要开启 TLS 1.3 支持,因为 HTTP/3 是基于 TLS 1.3 的,如果没有开启 TLS 1.3,那么 HTTP/3 将无法正常工作。
最后,需要添加listen ; root /var/www/example.com; index index.html; ssl_certificate /etc/nginx/ssl/example.com.crt; ssl_certificate_key /etc/nginx/ssl/example.com.key; ssl_trusted_certificate /etc/nginx/ssl/example.com.ca.crt; ssl_session_timeout 1d; ssl_session_cache shared:MozSSL:m; ssl_session_tickets off; ssl_protocols TLSv1.3; ssl_prefer_server_ciphers off; ssl_stapling on; ssl_stapling_verify on; resolver 1.1.1.1 8.8.8.8 valid=s; resolver_timeout s; add_header Alt-Svc 'h3=":"; ma='; }
请注意listen quic reuseport 里的 reuseport 参数,所有 server 段里,只允许一个段出现 reuseport 参数,否则会报错。
另外listen 段里的 ssl http2 无法和 quic 放一起,必须分开写两段。
4、测试 HTTP/3
我们使用 Firefox 浏览器,因为目前 DNS SVCB/HTTPS 记录 尚未普及,所以第一次访问的时候,浏览器还是走 TCP 协议使用 HTTP/2 或者 HTTP/1.1 请求你的网站,获取 Alt-Svc 的头部信息后,才会走 HTTP/3 协议,所以第一次访问以后,可以关掉浏览器重新打开再测试。
我们可以打开 F 开发者工具,查看 Network 选项卡,可以看到 HTTP/3 协议的请求:
Debian / Ubuntu . 下体验 HTTP/3 协议的 Nginx QUIC u.sb/debian-nginx-quic/