如题 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