Git Product home page Git Product logo

plantuml-gist's Introduction

PlantUML Gist

Render PlantUML from Github Gist & Gitlab

Features

  • Github & Gist support
  • Gitlab support
  • Error Image
  • Cache support

Gitlab

Please create 'plantuml' account on your gitlab, and set token info in web.xml. If you want to render puml files on your repository, please add plantuml as your project developer member as readonly.

the Demo url is: http://localhost:8080/gitlab/namespace/repository_1/blob/master/your_plantuml.puml

Manual Install

please modify web.xml and change 'baseUrl', 'gitlabUrl' and 'userToken', then deploy it to tomcat. Please install following components:

Cache Strategy

  • 2 minutes for url path on server side, no Cache-Control header.
  • Cache for plantuml's image according to puml file's md5
  • Cache for puml file content according to gist id or gitlab path if remote request failed.

You can modify ehcache.xml to adjust cache strategy.

Todo

  • Bitbucket Integration

PlantUML Gist

Render PlantUML from Github Gist & Gitlab 根据 Github Gist 和 Gitlab 中的 puml 文件渲染 PlantUML 图

特性

  • Github & Gist support
  • Gitlab support
  • Error Image
  • Cache support

Gitlab

在 gitlab 中创建 'plantuml' 账号,并将获得的 token 配置在 web.xml 中 如果你想在本地进行 puml 文件的渲染,请先将 plantuml 作为只读用户添加到你的项目中去 Please create 'plantuml' account on your gitlab, and set token info in web.xml. If you want to render puml files on your repository, please add plantuml as your project developer member as readonly.

Demo 地址为: the Demo url is: http://localhost:8080/gitlab/namespace/repository_1/blob/master/your_plantuml.puml

安装手册

修改替换 web.xml 中的 'baseUrl', 'gitlabUrl' 以及 'userToekn', 将应用部署到 tomcat 中 在此之前请确保安装以下组件:

缓存策略

  • URL 路径将在服务端保留2分钟,请求不带 Cache-Control 头
  • puml 生成的图片将根据 puml 文件的 MD5 值进行缓存
  • 如果远程请求失败,puml 文件内容将根据 gist id 或者 gitlab 路径来缓存

你可以修改 ehcache.xml 文件来调整缓存策略

Stash整合

  • use browser api
  • 验证走http basic

规划

  • Stash Integration
  • Bitbucket Integration

plantuml-gist's People

Contributors

huangfengjing avatar linux-china avatar

Watchers

 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.