Mermaid 是一个用于画流程图、状态图、时序图、甘特图的库，使用 JS 进行本地渲染，广泛集成于许多 Markdown 编辑器中。Mermaid 作为一个使用 JS 渲染的库，生成的不是一个“图片”，而是一段 HTML 代码，因此安全许多。其官网：https://mermaidjs.github.io/ Github 项目地址：https://github.com/knsv/mermaid

该插件可为redmine扩展mermaid图的wiki宏语法，通过wiki宏的方式快速引入流程图、状态图、时序图、甘特图等多种图形。更多关于mermaid信息详见 https://mermaidjs.github.io ，样图参考：

• 在页面中嵌入mermaid图

为了方便在文档中画流程图，时序图和甘特图，Redmine mermaid扩展了一个新的宏定义，可以直接在redmine中编辑流程图/时序图的文本，具体语法可参见mermaid官网，并在redmine中嵌入流程图/时序图的源码。第一个参数填写标题，缺省值为空，即没有标题，第二个参数表示是否在页面中显示图形的文本源码，缺省为false，表示不显示文本源码，只显示解析好的svg图

{{mermaid(时序图演示,showsource=true)
sequenceDiagram
  participant RTP客户端
  participant RTP服务器
  participant 新闻服务器
  loop 配置新闻服务
    RTP服务器->>RTP服务器:新闻服务url
  end
  RTP客户端->>RTP服务器:登陆
  RTP服务器-->>RTP客户端: 返回新闻服务器链接
    Note left of RTP服务器: XMPP feature
    Note left of RTP服务器: 返回:新闻服务url
  RTP客户端->>新闻服务器:获取新闻列表
    Note right of RTP客户端: HTTP request
    Note right of RTP客户端: 参数:用户名,所属部门,session key等等
  新闻服务器-->> RTP客户端:返回新闻列表
    Note left of 新闻服务器: HTTP response
    Note left of 新闻服务器: 返回:json(预定的格式，可翻页)
  RTP客户端->>新闻服务器:获取某条新闻
    Note right of RTP客户端: HTTP request
    Note right of RTP客户端: 参数:新闻正文链接
  新闻服务器-->> RTP客户端:返回新闻
    Note left of 新闻服务器: HTTP response
    Note left of 新闻服务器: 返回:新闻正文页面
    Note over RTP服务器: 以下略......
}}

保存redmine页面后可查看效果。

时序图演示

sequenceDiagram
  participant RTP客户端
  participant RTP服务器
  participant 新闻服务器
  loop 配置新闻服务
    RTP服务器->>RTP服务器:新闻服务url
  end
  RTP客户端->>RTP服务器:登陆
  RTP服务器-->>RTP客户端: 返回新闻服务器链接
    Note left of RTP服务器: XMPP feature
    Note left of RTP服务器: 返回:新闻服务url
  RTP客户端->>新闻服务器:获取新闻列表
    Note right of RTP客户端: HTTP request
    Note right of RTP客户端: 参数:用户名,所属部门,session key等等
  新闻服务器-->> RTP客户端:返回新闻列表
    Note left of 新闻服务器: HTTP response
    Note left of 新闻服务器: 返回:json(预定的格式，可翻页)
  RTP客户端->>新闻服务器:获取某条新闻
    Note right of RTP客户端: HTTP request
    Note right of RTP客户端: 参数:新闻正文链接
  新闻服务器-->> RTP客户端:返回新闻
    Note left of 新闻服务器: HTTP response
    Note left of 新闻服务器: 返回:新闻正文页面
    Note over RTP服务器: 以下略......