99 Star 822 Fork 259

tanghc / torna

Create your Gitee Account
Explore and code with more than 6 million developers,Free private repositories !:)
Sign up
Clone or Download
Cancel
Notice: Creating folder will generate an empty file .keep, because not support in Git
Loading...
readme.md

Torna

English | 简体中文

Enterprise API document solution, the goal is to make the document management become more convenient, fast. Torna takes a collaborative approach to managing and maintaining project API documents, incorporating different forms of documents into a unified maintenance approach.

Torna makes up for the shortcomings of traditional document generation tools such as Swagger by enriching and enhancing some useful functionality while maintaining the original functionality.

Current version

Module Version
Torna 1.11.2
sdk-java maven
swagger-plugin maven
smart-doc maven

Usage

Method 1:download zip

Go Release page ,download latest version,unzip

Import database,execute mysql.sql

Openapplication.properties,modify database config

Runsh startup.sh to startup.(Windows run startup.bat)

Visit:http://ip:7700

  • About upgrade

Override torna.jar file and dist folder,and startup.

Method 2: run in docker

Download image

docker pull tanghc2020/torna:latest

Import database,run mysql.sql

Copy server/boot/src/main/resources/application.properties to /opt/torna/config,modify database config

Run docker run --name torna -p 7700:7700 -v /opt/torna/config:/torna/config -d <IMAGE ID>

Visit:http://ip:7700


Test accounts:

All password is 123456

Super admin:admin@torna.cn

docker-compose deploy

docker-compose deploy

kubernetes deploy

kubernetes deploy

Recommended combination

smart-doc + Torna

If you use Java,we recommended you use smart-doc + Torna

smart-doc + Torna form an industry-leading document generation and management solution, using smart-Doc non-intrusive Java source code and annotation extraction to generate API documents, automatically push documents to Torna enterprise interface document management platform. Through this combination you can achieve: only need to write Java annotation can push the API information to the Torna platform, so as to achieve interface preview, interface debugging.

Push content:API name/author/path param/header/body/response/dict/error code

If you use other language, you can use the form page to edit the above content, and then you can also preview and debug the API.

Development and deployment

See:Development document

Other resource

Changelog

changelog

Page preview

API management

Edit API

Preview

Debug API

About

企业接口文档解决方案,目标是让文档管理变得更加方便、快捷。Torna采用团队协作的方式管理和维护项目API文档,将不同形式的文档纳入进来,形成一个统一的维护方式。 expand collapse
Java and 6 more languages
Apache-2.0
Cancel

Releases (53)

All

torna

Contributors

All

Activities

Load More
can not load any more
Java
1
https://git.oschina.net/durcframework/torna.git
git@git.oschina.net:durcframework/torna.git
durcframework
torna
torna
master

Search