planturl

一个用于服务器 URL 编码的 plantuml 文件。适用于 Gitea 或任何文档工具。将 plantuml 代码片段编码为可用于 PlantUML-Service 或如 PlantUML 文本编码 中描述的自托管克隆的 URL。可以为给定的 PlantUML 片段返回链接、html-img 片段或下载的图像文件。

安装

查看此项目。

cargo install --features=build-binary --path=<path to this project>

用法

A plantuml-file to server-url-encoder and downloader.


Usage: planturl [OPTIONS]

Options:
  -s, --source <SOURCE>            Input file, stdin if not present
  -u, --base-url <BASE_URL>        appends the encoded-string onto this URL [default: http://www.plantuml.com/plantuml]
  -i, --img                        embeds the url into an HTML-IMG-Tag
  -d, --download                   downloads an image from a plantuml-server
  -c, --compression <COMPRESSION>  compression to use [hex, deflate, best] [default: deflate]
  -t, --type <IMAGE_TYPE>          imagetype [ascii, png, svg] [default: svg]
  -f, --file <FILE>                saves the result in the given file or stdout if not present
  -h, --help                       Print help information
  -V, --version                    Print version information

Gitea 集成

在 app.ini 文件中添加 plantuml 标记段落

[markup.plantuml]
ENABLED = true
# List of file extensions that should be rendered by an external command
FILE_EXTENSIONS = .puml,.uml,.plantuml
# External command to render all matching extensions
RENDER_COMMAND = "/path/to/planturl --base-url https://www.plantuml.com/plantuml --img"
# Don't pass the file on STDIN, pass the filename as argument instead.
IS_INPUT_FILE = false