Flarum 修订历史记录 | Diff for Flarum
本扩展程序向您的 Flarum 论坛添加了“修订记录”功能。
此扩展为您的 Flarum 论坛添加了 “修订历史” 的功能。
效果截图:
功能特性
- 基于 jfcherng/php-diff 的仓库。(这个仓库是已停止维护的 chrisboulton/php-diff 仓库的分支)
- 可选的版本差异检测级别:行级(默认)、词级、字符级。
- 三种对比视图:单栏、双栏、组合。
- 使用 cron 计划任务或手动归档旧修订。
- 可删除修订记录或回滚到某版本。
- 支持扩展:FoF 夜间模式、
the-turk/flarum-quiet-edits
。
另外,本扩展不会加载(或缓存)任何数据,直到您点击“已编辑”按钮,无需担心加载时长的问题。
要求
您可以通过运行 php -v
命令查看您安装的 php 版本;运行 php --ri iconv
命令查看您的服务器是否安装了 iconv
扩展(如果安装了,应该会显示 iconv support => enabled
)。
您还需要更新 s9e/text-formatter
至 v2.3.7,以在修订预览中使用高亮语法(如果尚未更新 flarum/core
至 beta 12,请跳过此步骤)。
composer update s9e/text-formatter:2.3.7
冲突
本插件与以下内容冲突:
安装
通过巴扎市场或手动安装:
composer require the-turk/flarum-diff
更新
composer update the-turk/flarum-diff
php flarum migrate
php flarum cache:clear
使用
启用扩展,前往权限界面设置全向,最后自定义您喜欢的显示效果。
归档旧修订记录
如果 x≥A(其中 x 是帖子的修订次数),则该帖子的前 y = mx + b 个修订版本可以合并并在压缩后以 BLOB
形式存储在新表中(表名 post_edit_histories_archive
)。请在设置中指定 A,m 和 b。y 的浮点值将舍去为下一个最小整数。如果要节省存储量,建议开启归档旧修订版本的功能,如果不想,则不建议归档。
如果要归档旧修订,请考虑在设置中启用 cron 计划任务选项。我设置了一个每周一次的的 cron 任务,它使用 diff:archive
命令** 在每周日凌晨 02:00(没特别原因)工作。否则,一旦 Post\Revised
事件触发或您手动使用了 php flarum diff:archive
命令,它将尝试为帖子查找并归档旧修订记录。
**:这是您唯一需要添加到(Linux)服务器的 Cron 条目:
* * * * * php /<您的/Flarum/路径>/flarum schedule:run >> /dev/null 2>&1
该计划任务将每分钟调用一次 Laravel 命令调度程序。然后,Laravel 将评估您的计划任务并运行到了时间点的任务。
链接
本译文仅用于学习和交流目的,转载请务必注明文章译者、原文出处、和本文链接。