club-1 / flarum-ext-server-side-highlight
带有缓存结果的服务器端代码高亮。
v1.4.0
2023-06-09 11:16 UTC
Requires
- php: >=7.3
- flarum/core: ^1.2.0
- scrivo/highlight.php: ^9.18
Requires (Dev)
- flarum/phpstan: ^1.8
- flarum/testing: ^1.0.0
- phpstan/phpstan-deprecation-rules: ^1.0
- phpstan/phpstan-mockery: ^1.1
- phpstan/phpstan-phpunit: ^1.2
Suggests
- club-1/flarum-ext-chore-commands: Allows to reparse all the comment posts with the new formatter's configuration
README
Flarum 扩展。带有缓存结果的服务器端代码高亮。
在解析帖子中的每个代码块时,会计算一个哈希值,然后在渲染时,代码高亮在服务器端一次性完成,并存储在缓存中以供后续渲染使用。
它提供以下优势
- 高亮显示在服务器端完成,因此不需要客户端进行处理。
- 服务器使用缓存来保存高亮块,只进行一次处理。
- 它不需要任何JS,即使在最糟糕的网页浏览器上,高亮也会出现,并且应用高亮时没有延迟。
- 主题会根据 Flarum 的“暗黑模式”设置自动调整。
- 即使在禁用 BBCode 扩展的情况下,它也可以正常工作。
- 管理员可以为“浅色”和“暗色”Flarum 变体选择高亮主题。
- 管理员可以使用
highlight:download
命令从 Flarum 控制台 下载高亮主题。 - 它通过相应地切换高亮主题与
fof/nightmode
兼容。
客户端高亮仍然使用,但仅用于帖子预览。
安装
使用 composer 安装
composer require club-1/flarum-ext-server-side-highlight:"*"
建议
此扩展本身不会将格式更改应用到以前发布的评论中。如果您想重新解析数据库中的所有评论帖子,建议安装并启用 club-1/flarum-ext-chore-commands
扩展并使用其 chore:reparse
命令。
更新
composer update club-1/flarum-ext-server-side-highlight:"*"
php flarum migrate
php flarum cache:clear
php flarum assets:publish
致谢
此扩展基于以下库