V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
V2EX  ›  Jynxio  ›  全部回复第 1 页 / 共 1 页
回复总数  8
乙方的乙方就是项目外包 ^ ^
24 寸的 5k 屏幕才能达到苹果屏幕的像素密度
2023-07-05 14:06:14 +08:00
回复了 hamsterbase 创建的主题 分享创造 用 vitepress 重写了官网,求大家点评一下。
很赞!
2023-06-28 11:14:12 +08:00
回复了 star7th 创建的主题 分享创造 可能是国内颜值最高的开源文档工具?
@star7th
“如果硬要从客观上看,本标题并没有脱离事实太多”

-> 请让我说得再直白一些吧!<b>你的标题完全违背了事实</b>。如果你不愿意大方承认这一点,而是想要跳过这个问题,那么后面的人还会继续讲。
2023-06-28 11:00:01 +08:00
回复了 star7th 创建的主题 分享创造 可能是国内颜值最高的开源文档工具?
@Jynxio 补充,如果只想当 XXX 领域第一,那么建议把前置条件收的再窄一点。
2023-06-28 10:56:58 +08:00
回复了 star7th 创建的主题 分享创造 可能是国内颜值最高的开源文档工具?
@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/)
2023-06-28 10:09:08 +08:00
回复了 star7th 创建的主题 分享创造 可能是国内颜值最高的开源文档工具?
1.我赞同 @ggp1ot2 和 @vayci 的观点,我也认为 showdoc 的审美很平庸,它不可能是「国内颜值最高的 XXX 」
关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   4985 人在线   最高记录 6679   ·     Select Language
创意工作者们的社区
World is powered by solitude
VERSION: 3.9.8.5 · 18ms · UTC 09:49 · PVG 17:49 · LAX 01:49 · JFK 04:49
Developed with CodeLauncher
♥ Do have faith in what you're doing.