BookStack代码高亮功能对自定义自闭合标签的支持优化

在BookStack v24.05.2版本中，用户反馈了一个关于代码高亮显示的问题：当使用Markdown编辑器创建代码块时，某些包含自定义自闭合标签的HTML代码行未能正确着色。这个问题特别出现在使用Vuetify框架的HTML代码示例中。

问题现象分析

用户提供的示例代码展示了Vuetify组件库中的导航抽屉组件，其中包含多个自闭合标签如<v-list-item />和<v-divider />。在渲染结果中，这些自闭合标签所在行失去了语法高亮效果，而常规的闭合标签行则显示正常。

通过检查DOM结构发现，问题源于底层语法高亮库对自定义自闭合标签的处理方式。默认情况下，该库不会将非标准HTML的自闭合标签识别为有效语法结构，导致这些行被排除在高亮处理之外。

技术解决方案

BookStack开发团队通过修改底层高亮库的配置解决了这个问题。具体措施是：

1. 启用了高亮库的自定义自闭合标签支持选项
2. 确保该配置能正确处理Vuetify等现代前端框架的特殊标签语法
3. 保持与标准HTML自闭合标签（如<img />）的兼容性

这个修改已通过提交adb7bf7实现，并将在下一个补丁版本中发布。

对用户的影响

这项改进将带来以下好处：

1. 提升代码示例的视觉一致性，所有代码行都将获得正确的高亮效果
2. 更好地支持现代前端框架的文档展示
3. 保持与各种HTML变体的兼容性
4. 改善技术文档的阅读体验

最佳实践建议

对于需要在BookStack中展示代码的用户，建议：

1. 使用标准的Markdown代码块语法
2. 对于包含自定义标签的代码，确保使用正确的自闭合语法
3. 在升级到包含此修复的版本后，重新保存受影响的页面以获取正确的高亮效果

这项改进体现了BookStack对文档展示质量的持续追求，特别是在支持现代Web开发技术栈方面所做的努力。