多语言文档站：技术写作的蛮荒西部

The Wild West of polyglot docs sites

当项目涉及多种编程语言时，文档站往往需要整合 Doxygen、rustdoc、Sphinx 等不同生成器的输出。这种“多语言文档站”就像技术写作的蛮荒西部，充满挑战与机遇。作者分享了两种策略：一是将各语言文档转换为统一格式，但可能丢失细节且违背生态习惯；二是保留各生成器原生输出，通过 CSS 和 Pagefind 实现视觉与搜索的统一。尽管后者存在导航断裂、搜索碎片化等问题，但通过引入通用头部和全面搜索，能显著提升用户体验。这是一次在混乱中寻求秩序的实战探索。