常见问题

1,忘记了密码怎么办?

如果是使用在线ShowDoc(http://www.showdoc.com.cn ),忘记密码的话可联系xing7th@gmail.com,邮件中说明你的用户名和旗下项目名字(至少提供两个项目)。
如果是自己部署的ShowDoc,则首先根据前面安装文档进行升级,确保使用最新代码(划重点)。然后,根据安装方式的不同有不同的密码重置方式。
如果是使用官方脚本或者docker方式安装的,请在命令行执行命令:

    docker exec showdoc bash -c  "cd /var/www/html/ && php ./index.php home/common/repasswd"

如果是手动安装php方式的,则在命令行中切换到showdoc安装目录然后执行:
php index.php home/common/repasswd
以上命令会把管理员showdoc的密码重置为123456 。用此密码登录管理后台即可管理普通用户以及项目。建议登录后修改密码。
若修改密码出错,请确保自己采用最新版代码。

2,私有版showdoc如何连接数据库

showdoc使用sqlite数据库。数据库文件是安装目录下的Sqlite/showdoc.db.php。你可以网络搜索如何在命令行中使用 sqlite数据库.或者使用SQLiteStudio等可视化工具

3,错误提示 “Could not find driver”

请安装php-pdo 和 pdo_sqlite 。
对于Windowns服务器,在php.ini里面把”extension=php_sqlite.dll”和”extension=php_pdo_sqlite.dll”启用以便开启对SQlite的支持;
Linux服务器安装php5.3以上版本时理论上默认是开启了php-pdo和pdo_sqlite的。如果你安装的PHP依然没有,则可搜索网络教程安装之。

4,错误提示”General error: 11 database disk image is malformed”

请确保服务器安装好了php环境和php-sqlite扩展;
如果你以FTP方式上传代码到服务器,那么请使用二进制模式上传,否则会损害数据库文件,导致此错误提示

5,可以使用mysql数据库吗

官方已经不再支持mysql数据库,详情可看:http://www.showdoc.cc/help?page_id=31990 如你真的需要强制使用mysql,则可自行二次开发,但官方不提供支持,也请勿浪费时间问官方团队。经过二次开发的版本有可能与官方以后的版本升级冲突导致升级失败,请谨慎考虑

6,验证码不显示

请检查是否安装了php-gd库

7,提示验证码验证失败

先到php.ini文件下找找session的保存目录,然后检查安装session目录有没有写入权限,或者可不可能是磁盘空间满了的问题

8,怎么进入管理后台

新安装完成后,默认管理员账号是showdoc/123456 。使用管理员帐户登录后,在项目列表页面的右上角便能看到管理后台入口。如果不能,请重新登录或者刷新浏览器缓存试试

9,自动脚本和docker安装的showdoc如何绑定域名

https://www.showdoc.com.cn/help/7240953917068087

10,如何修改附件允许上传的大小?

https://github.com/star7th/showdoc/issues/571

11,RunApi客户端打不开或者一直显示加载中

runapi需要外网网络。如果在确保已经有了外网网络,可以这样尝试:首先卸载runapi,然后删除以下路径C:\Users\Administrator\AppData\Roaming\runapi(其中Administrator可替换为你当前登录win系统的账户名),然后再重装runapi。MAC环境的用户可以考虑使用AppCleaner来卸载和清理数据后再重装。

12,RunApi客户端看不到showdoc的项目

runapi的数据可以生成markdown格式,但不可逆,markdown数据很难再转换回来runapi。所以它无法跟showdoc原有数据互相转换。只是它们可以共用文档浏览/团队协作等功能。同时runapi生成的文档只能在runapi上编辑,不能在showdoc上编辑。后面如果要做数据共用,可能需要对showdoc编写格式有一定的规范约束,这个后面再探索下。

13,有二次开发文档吗

二次开发简单指引:https://www.showdoc.cc/help?page_id=1385576954326448

14,要迁移到另一台服务器上怎么做

https://www.showdoc.cc/help?page_id=2511252204165611

15,如何寻求官方技术咨询或者支持

对于使用官网在线服务用户,联系官方可发邮件到 xing7th@gmail.com

如果是开源版showdoc,可免费到github提issues https://github.com/star7th/showdoc/issues 如果是想付费获取一对一商业支持,请参考 https://www.showdoc.com.cn/help?page_id=6199117240201189