Doxygen 对 GitHub 风格 Markdown 警告框的支持增强

在最新的 Doxygen 开发版本中，已经加入了对 GitHub 风格 Markdown 警告框（Alerts）的解析支持。这一功能使得开发者可以在文档中更清晰地突出显示重要信息，提升文档的可读性和用户体验。

GitHub 风格的警告框是一种特殊的 Markdown 扩展语法，基于块引用（blockquote）语法构建，专门用于强调关键信息。它提供了五种不同类型的警告框，每种都有其特定的语义用途：

1. NOTE - 用户应该了解的有用信息，即使快速浏览内容时也需要注意
2. TIP - 关于如何更好或更轻松地完成事情的帮助性建议
3. IMPORTANT - 用户需要了解的关键信息，以实现他们的目标
4. WARNING - 需要用户立即关注的紧急信息，以避免出现问题
5. CAUTION - 关于某些操作可能带来的风险或负面结果的建议

在 Doxygen 的实现中，这些 GitHub 风格的警告框会被自动转换为对应的 Doxygen 命令：

• > [!NOTE] → \note
• > [!TIP] → \remark
• > [!WARNING] → \warning
• > [!CAUTION] → \attention
• > [!IMPORTANT] → 新增的 Doxygen 命令

需要注意的是，Doxygen 只支持单层初始块引用的警告框语法。多层嵌套的块引用将不会被识别为警告框。

对于希望进一步自定义警告框样式的用户，可以通过自定义 CSS 文件（使用 HTML_EXTRA_STYLESHEET 配置选项）来修改警告框的显示效果。用户还可以添加 SVG 图标文件（需要同时考虑浅色和深色模式）来增强视觉效果，这些文件可以通过 HTML_EXTRA_FILES 配置选项添加。

这一改进使得 Doxygen 能够更好地与现代 Markdown 生态系统保持兼容，同时也为技术文档作者提供了更多表达重要信息的工具。通过使用标准化的警告框语法，文档的可维护性和一致性也得到了提升。