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

Feature Request: Any chance we could add asciibuild? #203

Open
Bruno-366 opened this issue May 6, 2021 · 2 comments
Open

Feature Request: Any chance we could add asciibuild? #203

Bruno-366 opened this issue May 6, 2021 · 2 comments

Comments

@Bruno-366
Copy link

Bruno-366 commented May 6, 2021

asciibuild allows you to use asciidoc for literate programming,
ie: executing the code within an asciidoc file, which allows a documentation-first approach.

Including it in docker-asciidoctor could open up a really cool workflow.
Code in source blocks get executed inside the docker container,
and the output gets recorded in the very same asciidoc file.

@Bruno-366
Copy link
Author

I am currently using the github action asciidoctor-ghpages-action to build my blog from asciidoc files
I really appreciate that it is hosted on github pages and updates my blog on every change (push).

However, since asciidoctor-ghpages-action uses docker-asciidoctor (which doesn't include asciibuild),
I can't currently document the output/results of the code that is on my blog.

See:
manoelcampos/asciidoctor-ghpages-action#15 (comment)

@Bruno-366
Copy link
Author

Bruno-366 commented Jul 12, 2021

Issue #54 (comment)
mentions that having 2 Docker images might be more appropriate:

  1. a minimal Docker image asciidoctor/asciidoctor and
  2. an asciidoctor/box with asciidoctor + tools included

Right now it seems like on docker hub asciidoctor/box and asciidoctor/docker-asciidoctor are equivalent?

Also issue #191 (which request adding asciidoctor-kroki)
mentions that using layers would be a good idea.

I am pretty sure asciibuild can use layers ^1 ^2 ^3,
it also has "out-of-the-box support for creating, manipulating, and executing code inside of Docker containers" ^4.

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

No branches or pull requests

1 participant