Skip to content

GitLab Next

  • Menu
Projects Groups Snippets
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
  • GitLab GitLab
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
    • Locked Files
  • Issues 39,511
    • Issues 39,511
    • List
    • Boards
    • Service Desk
    • Milestones
    • Iterations
  • Merge requests 1,222
    • Merge requests 1,222
  • Requirements
    • Requirements
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
    • Test Cases
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Monitor
    • Monitor
    • Metrics
    • Incidents
  • Packages & Registries
    • Packages & Registries
    • Container Registry
  • Analytics
    • Analytics
    • CI/CD
    • Code review
    • Insights
    • Issue
    • Repository
    • Value stream
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • GitLab.org
  • GitLabGitLab
  • Issues
  • #31818

You need to sign in or sign up before continuing.
Closed
Open
Created Sep 12, 2019 by Alexandre Badez@Djabx

AsciiDoc Diagram

Resolution

At this point we're using Kroki to support additional diagram types - we won't be supporting asciidoctor-diagram directly. This allows us to leverage the diagrams for both AsciiDoc and Markdown, and offloads some of the tricky installation requirements onto the kroki external public service or into kroki docker containers. See #31818 (comment 396189329) and #31818 (comment 396191699).

Problem to solve

We can't have diagram in asciidoc.

Intended users

Every users that want to write good documentation with diagrams.

Further details

I would like to be able to add diagram (like mermaid) in asciidoc.

Proposal

Include asciidoctor-diagram so we can include diagrams in asciidoc cf ( https://github.com/asciidoctor/asciidoctor-diagram )

Permissions and Security

NA

Documentation

We should update the documentation of asciidoc: https://docs.gitlab.com/ee/user/asciidoc.html with some sample of diagrams.

Testing

It will change the rendering of asciidoc pages.

So the impact should be contained, but it will require cross-browser testing.

What does success look like, and how can we measure that?

Success will be when we can write asciidoc with diagrams; at least plantuml and mermaid diagrams.

What is the type of buyer?

?

Links / references

Edited Apr 08, 2021 by Brett Walker
Assignee
Assign to
Time tracking