Giter Club home page Giter Club logo

duo-doc's Introduction

自动化文档说明

本工程已经迁移,为了提供更好的服务,请移步新的仓库! https://gitee.com/duoec/duo-doc

一、模块说明

本项目分为两部分: doclet插件和文档展示模块

doclet插件

doclet即是自动化文档模块,由三个模块组件:

doclet-pojo:基类,主要是定义文档的基础信息,由JavaBean组成,是一个公共模块

doclet-render:渲染类,主要实现文档数据的渲染,比如渲染成Markdown / Html

doclet: Maven插件的入口,实现了java源文件的解析与文档元素抽取功能

文档展示模块

tp-demo-api:本模块只是作为Dubbo的接口定义模块,不实现任何功能

tp-demo-server:文档的Web展示端,也作为doclet的测试模块。本模块基于spring-boot + freemarker实现的简单网站

二、代码调试

doclet插件有两种调试方法

  1. 代码调试

com.fangdd.tp.doclet.TpDocletTest类里面有一个简单的Doclet类的调试,本方法可以实现断点功能

  1. 插件调试

插件调试直接在tp-doclet/tp-demo-server/pom.xml里面,但需要将doclet插件打包安装后才能使用,此方法不支持断点

使用插件测试时,请先看下代码:com.fangdd.tp.doclet.TpDoclet#start()目前开发环境与发布环境暂未自动化,所以需要调整此方法内的前面几行配置 发布环境默认是生成到10.0.1.86文档服务器的web模式,而开发环境建议使用本地127.0.0.1的'console'模式,即把生成的Markdow打印到控制台

三、注意事项

  1. 目前发布系统不支持拉此插件的SNAPSHOT包,所以发布时暂时以正式包发布。目前会在将数据提交到文档服务器时添加doclet版本信息,未来,如果版本过低时,需要在文档内做明显升级提示

  2. 本开源项目,禁止用于商业用途和专利注册

duo-doc's People

Contributors

ycoe avatar

Stargazers

 avatar Cary Leung avatar  avatar DyanHe avatar Shun Wang avatar  avatar Schubert Zhang avatar

Watchers

Hzm avatar Schubert Zhang avatar James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.