torna接口文档解决方案，目标是让接口文档管理变得更加方便、快捷。Torna采用团队协作的方式管理和维护接口文档，将不同形式的文档纳入进来统一维护。

Torna弥补了传统文档生成工具(如swagger)的不如之处，在保持原有功能的前提下丰富并增强了一些实用的功能。

解决文档管理痛点

1、不满足swagger文档预览页面和调试页面的展现方式

2、不喜欢swagger这种侵入式注解

3、希望使用javadoc注释生成文档，并进行接口调试

4、希望把公司所有项目接口文档进行统一管理

5、希望把项目中的若干文档提供给第三方调用者查看

6、希望可以统一管理项目中的字典枚举

使用步骤

方式1：下载zip本地运行

准备工作

Java环境，最低要求Java8

MySQL，要求5.6.5及以后，5.6.5之前的版本见：支持低版本MySQL

1、下载最新版本，解压zip

2、导入数据库，执行mysql.sql

3、打开application.properties配置文件，修改数据库连接配置

4、执行sh startup.sh启动(Windows执行startup.bat)

5、访问：http://ip:7700

登录账号：

用户名：admin，密码：123456

6、后续升级

无特殊说明，只需要覆盖torna.jar文件和dist文件夹，然后重启即可

方式2：docker运行

1、导入数据库，执行mysql.sql

2、下载公共镜像

docker pull tanghc2020/torna:1.18.1

3、在/etc/torna/下创建一个空文件application.properties用来存放配置，执行命令：

mkdir /etc/torna && touch /etc/torna/application.properties

4、编辑配置文件

vim /etc/torna/application.properties

5、输入如下配置：

# 服务器端口

server.port=7700

# MySQL地址

mysql.host=<mysql_ip>:3306

# 数据库名称

mysql.schema=torna

# 数据库账号，确保能执行DDL语句

mysql.username=<username>

mysql.password=<password>

修改对应的MySQL地址、账号

6、执行docker命令：

docker run --name torna --restart=always \

-p 7700:7700 \

-e JAVA_OPTS="-server -Xms512m -Xmx512m" \

-v /etc/torna/application.properties:/torna/config/application.properties \

-d tanghc2020/torna:1.18.1

7、浏览器访问http://ip:7700，ip对应docker宿主机器ip，非docker容器ip

推荐组合

smart-doc + Torna实现文档全流程自动化

如果您使用Java语言，推荐使用smart-doc + Torna

smart-doc + Torna 组成行业领先的文档生成和管理解决方案，使用smart-doc无侵入完成Java源代码和注释提取生成API文档，自动将文档推送到Torna企业级接口文档管理平台。

通过这套组合您可以实现：只需要写完Java注释就能把接口信息推送到Torna平台，从而实现接口预览、接口调试。

如果您是非Java语言，可以使用表单页面编辑以上内容，完成后同样可以进行接口预览、调试。

更新内容

v1.31.1

【新增】导出postman文件

【新增】分享文档可设置过期时间 PR

【新增】用户管理页面新增查询条件(用户状态、是否是超级管理员) PR

【调整】推送文档不会更改文档状态，由用户手动控制

• 免费PDF转换阅读器
• 标准证件照
• 雄安智慧社保
• Emby Server
• vue调试工具
• 三维扫描仪软件
• SQL脚本
• TopSolid
• 天工直通车
• Sequoia
• VMware16
• Yoroot
• 拍小课电脑版
• 国地学易通电脑版
• 家长慕课电脑版
• 小猴启蒙语文电脑版
• 青春航院电脑版
• 巴蜀云校电脑版
• 知达课堂电脑版
• 资助通电脑版
• 天财附小电脑版
• 汇学电脑版
• System Designer Mac
• Expo XDE Mac
• Amazing Slider Mac
• 塞尔达传说：时之笛 高清重制PC版 英文免安装版
• 塞尔达传说：梅祖拉的假面 高清重置PC版 英文免安装版
• 马里奥赛车 虚幻4版 英文免安装版
• 大金刚64 英文免安装版
• 索尼克大冒险2 英文免安装版
• 涂鸦上帝：8位元音轨 官方简体中文硬盘版
• 半死不活 官方简体中文硬盘版
• 水乡小镇正版(模拟城镇建造游戏) v1.1.9 安卓版
• 狄仁杰：城隍案 简体中文硬盘版
• 电装天使 简体中文硬盘版
• 淘气公主SOS
• 神秘的底格里斯与幼发拉底河/世界河域文明系列
• 印度细密画
• 重建
• 利用技术分析选择赢利股/华尔街操盘手阅读新经典
• 积极资产配置投资者理财指南
• 赢的法则(企业获得出色业绩的5要素)
• 欲望
• 建筑技术新论/高校建筑类专业参考书系
• AutoCAD2010建筑绘图教程(附光盘建设行业技能型紧缺人才培养培训教材)
• 跨国追逃
• 孝庄秘史
• 雪地里的星星
• 爱情白皮书
• 太阳滴血
• 终极悬案
• 壮志雄心
• 大醉侠
• 我的淘气天使
• 白领公寓