TypeDoc项目中对非支持高亮语言的处理优化

在文档编写过程中，开发者经常需要在代码块中使用多种编程语言进行示例展示。TypeDoc作为TypeScript项目的文档生成工具，其内置的语法高亮功能主要依赖于Shiki高亮引擎。然而在实际应用中，用户可能会遇到以下典型场景：

1. 需要展示Shiki尚未支持的新兴编程语言
2. 文档最终会通过其他工具链（如mkdocs）渲染，这些工具支持的语言集合与Shiki不同
3. 需要保持原始语言标识符以便后续处理流程使用

最新版本的TypeDoc通过引入ignoredHighlightLanguages配置项解决了这个问题。该选项与现有的highlightLanguages配置相配合，形成了完整的语言处理策略：

• highlightLanguages：明确指定需要Shiki进行高亮处理的编程语言
• ignoredHighlightLanguages：声明需要保留原样输出的语言标识符

这种设计带来了三个显著优势：

1. 兼容性提升：允许文档作者使用任意语言标识符，不再受限于Shiki的支持范围
2. 流程灵活性：支持将高亮处理推迟到后续构建环节，适应不同的文档工具链
3. 渐进增强：不支持的语法块会保持原样输出而不会报错中断

对于插件开发者而言，这个改进特别有价值。以typedoc-plugin-markdown为例，现在可以完整保留用户指定的语言标识符，确保生成的Markdown文件能被下游工具正确解析。这种处理方式也体现了TypeDoc作为文档生成工具的核心设计理念：在保证基础功能的同时，为扩展和定制保留充足的空间。

实际配置示例：

{
  "ignoredHighlightLanguages": ["terraform", "hcl"],
  "highlightLanguages": ["typescript", "javascript"]
}

这种配置方式既明确了高亮处理边界，又确保了特殊用例的文档可移植性，是TypeDoc对开发者实际需求做出的又一重要改进。