你这个让我想起了一件几年前的事情。

2016 年，我那时候也是做好一款开源软件不久。https://github.com/star7th/showdoc

那时候，也搭建了一个 demo 网站给别人试用。

过了一阵子，发现有不少用户放真实数据到我的环境，情况跟你现在差不多。

于是我做了一个决定，真正以此机会推出 saas 服务，https://www.showdoc.com.cn/ 并且也在项目中鼓励用户使用官网环境，同时承诺官网环境数据稳定可靠。

就这样发展了几年，我的 saas 服务商业化了，按阶梯推出了付费版。

有了资金收入，我可以投入更多资源来优化产品。而产品好又带来更多用户。就这样产生了正向循环。

跟你说那么多，你应该明白我的意思了。我就是想说，投入一点原始资源去运作，不要舍不得花服务器资源。就当作投资。万一起来了呢。

@gongquanlin

移动端好久没更新了，因为用户少，大部分用户都是电脑上把 showdoc 当生产力工具使用。有空再看看移动端吧

@sairoa 昨天晚点的时候发布了 3.0.1 版，就是修复此问题的。你更新下。

@geekboy

评论需求是一个很模糊的需求。说需要嘛，这几年来用户的呼声不大。说不需要嘛，偶尔会有人说。https://github.com/star7th/showdoc/issues/553

我自己依然没想好。再确认之前，我可能暂时先不动手做这个，因为评论功能会强势地占用视觉空间，并不是躲在一个二级菜单里等着用户使用就好。

@CaffreySun

showdoc 没办法像 gitbook 那种将大片显示区域留给内容，因为两者面向的文档类型不一样。

像 gitbook 这样的大片区域，非常适合文字段落饱满的情况，比如写一篇教程，文字或者代码非常饱满，可以充满一个个段落的。
但是 showdoc 没办法，因为 showdoc 大部分用来解决 api 文档场景。写 api 文档，段落是不饱满的，我自己测试过，在锻炼不饱满的情况下，不同分辨率下的视觉效果无法统一，且都不算好看。
至于说排版细节，那就确实是的，showdoc 有不少要改进的地方。但无论如何，都不能直接仿照 gitbook ，因为主要面向的文档类型不一样。

至于说配色的问题，我后面会咨询设计师意见，后面再做个更完善的版本。

@u21t20o15

如果你要用注解生成 api 的话，可以参考这里
https://www.showdoc.com.cn/page/741656402509783

我推荐的做法是，注解生成 runapi 项目。而 runapi 项目会自动生产 showdoc 项目。从而实现你说的需求，即：
可以注释生成文档，并且生成的接口在 runapi 可以调试

@u21t20o15

RunApi 已经可以做到自动化生成接口文档到私有部署的 showdoc https://www.showdoc.com.cn/runapi

runapi 无法同步历史 showdoc 项目到客户端，因为历史上使用 markdown 编写，不是结构化数据，转不回来。但是从 runapi 创建的项目都可以自动生成文档到 showdoc

@dcsite
说实话，gitbook 当然不难看，但是如果将它封为效仿的标准，感觉就不是很有必要，因为是两种风格不一样的产品。
我推出 3.0 版后，除了你，没有一个人说难看的。最多就是说细节没到位，还可以完善，但远谈不上难看。

力气没用对方向，怎么努力都是白费功夫。这个短链服务都在 v 站宣传好多次了，累计才 80 个注册，并且几乎没啥活跃。你自己应该好好反思。

@815979670 实际上官网版跟开源版，很多数据库结构都不一样了。官网版我都是单独维护的。

@815979670

官网的并发，sqlite 肯定扛不住的。用了 mysql 和 redis 。

@yushiro
我找了挺多香港 ip 来做测试，ip 库都显示正确。像你的那种情况，应该是因为 ip 被识别为大陆内地了——但实际网络是香港，所以才有这个问题。我估计应该是特例，因为我测试其他香港 ipi 都是正常的。
如果方便的话你可以把 ip 段告诉我下。或者你就针对 showdoc 使用代理访问吧。

@siknet 挺不方便的，因为 showdoc 看起来简单，但其实有很多很多细节。很多细节没有从一开始做成变量或者方便批量切换，所以要做在运行时换一套模板或者皮肤都不容易。而且我觉得嘛，模板不是刚需，可以暂时不用花精力。

@Psily1017

1.0 的版本，那确实有好几年了。

@yushiro

额。那应该是我们的 ip 库定位有差异。如果是非中国的 ip ，我们会转向国外节点。你这样，你用个代理先临时访问，用大陆内或者美国代理都行，我们后面修正下对香港的 ip 库记录。

@pengtdyd

能的。其实 api 以及文档市场没有你想象中的小众。甚至说这个领域并不小众，只是说我占据的市场份额小。

@lower 嗯，多年来的账号没清理过。顶多清理下系统生成的示例文档, 但用户创建的数据没动。

@mydingyan
可能是没有写入权限导致。在你目录 /showdoc_data 下应该能找到类似 html_bakxxxx 这样名字的文件夹。将它改掉，替换原来的 html 目录，然后重启下 docker 容器就好了

@EngAPI 多谢支持