Skip to content

Conversation

@wfouche
Copy link
Member

@wfouche wfouche commented Sep 9, 2025

Thank you for opening a pull request and contributing to AsciidoctorJ!

Please take a bit of time giving some details about your pull request:

Kind of change

  • Bug fix
  • New non-breaking feature
  • New breaking feature
  • Documentation update
  • Build improvement

Description

AsciidoctorJ can be run directly from the command-line using JBang without having first having to install AsciidoctorJ. Update the cli.adoc file to describe how to use AsciidoctorJ with JBang.

Issue

If this PR fixes an open issue, please add a line of the form:

Fixes #1314

Release notes

Please add a corresponding entry to the file CHANGELOG.adoc

----

== Linux and MacOS installation
== Automatic distribution installation
Copy link
Member

Choose a reason for hiding this comment

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

I am a bit unsure about the term "Automatic distribution installation".
What exactly does that mean?

Copy link
Member Author

@wfouche wfouche Sep 10, 2025

Choose a reason for hiding this comment

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

I used the orginal starting text as reference which talks about "automatic installation".

There are two basic ways to make AsciidoctorJ available as a command line tool.

* Manual installation using the binary distribution.

* Automatic installation using a package manager like SDKMAN or Chocolatey.

Most likely the word the writer had in mind was Automated instead of Automatic.

Automated distribution installation

Copy link
Member

Choose a reason for hiding this comment

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

Oh, I wonder if I wrote this :D
Yes, I think automated sounds better.

Copy link
Member Author

Choose a reason for hiding this comment

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

@robertpanzer , will this update appear at https://docs.asciidoctor.org/asciidoctorj/latest/cli/ automatically or will the docs site only be updated when a future release of asciidoctorj becomes available? Was hoping to see the update appear sooner rather than later.

Copy link
Member

Choose a reason for hiding this comment

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

The docs pull from the main branch (see https://github.com/asciidoctor/docs.asciidoctor.org/blob/main/antora-playbook.yml#L39-L41), so the update will be seen after the nightly run. I can go ahead and trigger it now.

@robertpanzer robertpanzer merged commit 807e293 into asciidoctor:main Sep 10, 2025
12 checks passed
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.

Docs: describe how to run asciidoctorj using JBang from the command-line

3 participants