@
star7th 好的,这是你需要的论证:
1.「 clean-jsdoc-theme 」是一个还不错 JSDoc 的开源主题,在 JSDoc 的帮助下可以直接根据代码注释来自动生成 API 文档,且该主题是互联网上随手找的。
2.「 startlight 」是一个美观且全能的文档主题,在 Astro 的加持下,可以直接根据 markdown 来生成文档,并且有更好的 SEO 、更快的加载速度、美观的代码高亮、正确的 markdown 解析,还支持 MDX 和 RSS 更新;
3.showdoc 本身的 UI 是有明显缺陷的,比如:代码类文字没有使用等宽字体、markdown 换行符解析有问题、大量直接暴露的链接、登录界面没有回退机制、首页图片模糊、页面不适配移动端、中英文之间缺少空白符、favicon 四角留白,showdoc 的样式设计是简陋的;
4.如果你只想讨论国产+开源,那么请看 Apifox ,并且 GitHub 还有很多类似的产品;
5.使用者更在乎好用 /易用,没那么在乎国产与否,比如哪怕 14 nm 是国产芯片的最高成熟制程(似乎),我也不会买来用,因为我可以选更好的舶来品;
6.你不是来虚心请教的,你是来找认同的;
链接:
[clean-jsdoc-theme](
https://ankdev.me/clean-jsdoc-theme/v4/)
[startlight](
https://starlight.astro.build/getting-started/)