2023-02-16 13:39:23 · 王二  ·  Dev

如题 apidoc 的 @apiGroup 值如果是中文的时候没办法进行分组。官方仓库提了好多这样的 issue，貌似韩文也不支持。

有人提了 pr，但是被拒绝了，不知道为什么。

可以临时根据这个 pr 修改文件来支持中文分组，node_modules/apidoc/lib/core/workers/api_group.js 文件中的：

group = group.replace(/^[^a-z]+|[^\w:.-]+/gi, '');

替换为：

group = encodeURI(group).replace(/^[^a-z]+|[^\w:.-]+/gi, '');

这样如果线上部署生成的话就不太方便了，可以在生成文档的脚本文件中添加一行替换的代码，在生成文档前强行替换：

sed -i 's/group = group.replace/group = encodeURI\(group\).replace/' node_modules/apidoc/lib/core/workers/api_group.js