如何利用showdoc自动生成数据字典

介绍

showdoc是一个很是适合IT团队的在线API文档、技术文档工具。你可使用Showdoc来编写在线API文档、技术文档、数据字典、在线手册。关于showdoc的详细介绍，可看：https://www.showdoc.cc/help

好的数据字典文档可以清晰地反映出数据库的结构以及相关释义，方便技术人员查阅。咱们很容易使用showdoc来生成展现数据库结构的字典文档，而且能根据数据库结构的变更来自动修改文档，省去人工编辑的麻烦。

这一切的自动化依赖于咱们的上报脚本。你须要下载咱们的脚本到你的服务器上执行，上传数据库结构信息到showdoc。上报脚本的源码彻底公开，你能够阅读之以确认安全。咱们确保它只会上传基本数据库结构信息，不会上传数据库密码配置、业务数据等敏感信息。

目前只支持linux下的mysql数据库，更多类型将来再考虑。

操做步骤

• 执行下载脚本的命令

wget https://www.showdoc.cc/script/showdoc_db.sh

• 打开此文件

vi showdoc_db.sh

• 修改配置信息
  打开文件后，在文件的前面能看到几项配置。其中，像数据库配置、api_key等信息是须要你填写的，填写完毕后保存便可。下面列举出各个配置项表明的意思。

  host ： 数据库所在地址。默认是localhost  
   port  :  数据库访问端口，默认是3306 
   user  :  数据库用户名 
   password   :  密码 
   db  :  要同步的数据库名。要同步多个db能够将本脚本复制多份 |
   api_key   ： 认证凭证。登陆showdoc，建立一个项目后，点击右上角的”项目设置”-“开放API”即可看到 
   api_token : 同上  
   cat_name: 可选。若是想把生成的文档都放在项目的子目录下，则这里填写子目录名。  
   url ：可选。 同步到的url。若是是使用www.showdoc.cc ，则不须要再改此项。若是是部署开源版showdoc，请改此项为http://xx.com/server/index.php?s=/api/open/updateDbItem 。其中xx.com为你的部署域名|

• 执行

  sh showdoc_db.sh

  看到成功字样便ok。你能够打开showdoc项目看看是否真的生成了。

  若是想定时自动更新，则须要为系统增长一个定时任务。下面给一个例子，表示每10分钟同步一次

  /10 * * * * /bin/sh /root/showdoc_db.sh

  其中，showdoc_db.sh脚本在定时任务里须要写绝对路径。

注意事项

若是你设置了脚本的自动执行，那么请不要再手动登陆showdoc修改文档。由于你的修改都会被自动脚本从新覆盖。
由于会覆盖你的修改。因此若是你想为某个字段设置中文注释，请修改mysql字段注释，而不是在showdoc上手动编辑文档。
自动执行的状况下，只会自动新增和修改文档，不会自动删除文档（主要出于数据安全考虑）。因此，若是你删除了一张表，文档里是不会删除那个页面的。须要手动登陆showdoc来删除。通常来说，这种状况不会不少。