建站知识:ShowDoc在线API文档工具安装/升级手册

建站知识:ShowDoc在线API文档工具安装/升级手册

ShowDoc自动脚本安装

官方强烈推荐使用自动脚本安装showdoc，你只需要在命令行下执行命令即可。自动脚本安装教程：https://www.showdoc.com.cn/help?page_id=828455960655160 。假如自动脚本安装失败，你可以考虑手动安装。手动安装

• docker安装
  如果你不想通过自动脚本，但是又想用docker来自定义安装，则可以参考教程https://www.showdoc.com.cn/help?page_id=65610
• php安装

  如果你不想使用自动脚本或者docker安装，showwdoc需要PHP5.3及以上版本（开启php-gd php-sqlite扩展），你可以参考这里安装环境http://www.showdoc.com.cn/php 。安装完PHP环境后，下载代码：https://github.com/star7th/showdoc （国内镜像 https://gitee.com/star7th/showdoc ） 。下载完毕后将代码放到PHP的web目录。一般来讲，不同系统的web目录路径不太一样。请根据你安装的环境来定。如果是windows下安装，可以参考这篇教程：https://www.showdoc.com.cn/help?page_id=4087044677189279

• 二次开发指引

  https://www.showdoc.com.cn/help?page_id=1385576954326448

ShowDoc升级安装

• 如果你是使用自动脚本安装showdoc，那么升级只需要执行命令./showdoc update
• 如果你原本是手动安装，但想通过自动脚本升级，则请参考教程中的“从手动方式升级到自动脚本方式”：https://www.showdoc.com.cn/help?page_id=828455960655160
• 如果你是使用docker方式安装，则请参考docker教程中“如何升级”部分：http://www.showdoc.com.cn/help?page_id=65610

• 如果你是手动安装环境的，则继续往下看。首先将旧代码目录复制一份以便备份。
• 全新安装（具体操作参考文档）并初始化ShowDoc完毕后，进入之前备份的目录。将Sqlite/showdoc.db.php（这是原来的数据库文件），以及Public/Uploads/下的所有文件（这些是上传的图片。如没有图片则可忽略之），全部复制并覆盖到新showdoc目录的相应文件。覆盖后重新给这些文件可写权限。

ShowDoc错误排查和建议反馈

• 常见问题：http://www.showdoc.com.cn/help?page_id=16118
• 对showdoc的问题或建议请至https://github.com/star7th/showdoc 处提issue。若觉得showdoc好用，不妨点个star。良好的关注度和参与度有助于开源项目的长远发展。