Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Allow asciidoc diagram block pre rendering using kroki. #143

Closed
wants to merge 2 commits into from

Conversation

jtama
Copy link
Member

@jtama jtama commented Nov 13, 2024

Links #142

@jtama jtama requested a review from a team as a code owner November 13, 2024 07:53
Copy link
Contributor

@ia3andy ia3andy left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am in PTO for 2 weeks, I won't be able to review this.

At first glance it seems it should be a separate extension as it brings other dependencies..

@mkouba
Copy link
Contributor

mkouba commented Nov 13, 2024

I am in PTO for 2 weeks, I won't be able to review this.

At first glance it seems it should be a separate extension as it brings other dependencies..

👍 Also I wonder if it's practical/efficient to call an external service to render a diagram. Does asciidoctorj support this feature? If so we should probably rather work on #119 🤷.

@jtama
Copy link
Member Author

jtama commented Nov 13, 2024

I took the kroki path, because this is the one Antora or Asciidoctor.js also took.

asciidoctorj alone doesn't handle diagram, but there is an asciidoctorj-diagram repository but I am not sure exactly sure what kind of diagram it handles.

Another point would be again not sure how it works, where would the rendered image be generated.

I can take a look if you want. Can you juste remember me, why asciidoctor-j was not chosen in the first place ?

@ia3andy
Copy link
Contributor

ia3andy commented Nov 13, 2024

I took the kroki path, because this is the one Antora or Asciidoctor.js also took.

asciidoctorj alone doesn't handle diagram, but there is an asciidoctorj-diagram repository but I am not sure exactly sure what kind of diagram it handles.

Another point would be again not sure how it works, where would the rendered image be generated.

I can take a look if you want. Can you juste remember me, why asciidoctor-j was not chosen in the first place ?

Because we preferred having a light pure Java for the default even if it doesn't do everything, and because we can propose another extension for a heavier alternative for those who need it.

@jtama
Copy link
Member Author

jtama commented Nov 13, 2024

ok, so I have something else that could do the job, tested and working with roq with asciidoctorj and asciidoctorj-diagram.

Haven't even tried native though... Will make a PR tomorrow

Leverage asciidoctoj and asciidoctorj-diagram libraries to render asciidoc content.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants