https://github.com/leplusorg/docker-adoc
Multi-platform Docker container with utilities to process AsciiDoc files (asciidoc, a2x, ascidoctor...).
https://github.com/leplusorg/docker-adoc
asciidoc asciidoctor asciidoctor-converter docker docker-container docker-image dockerfile
Last synced: 15 days ago
JSON representation
Multi-platform Docker container with utilities to process AsciiDoc files (asciidoc, a2x, ascidoctor...).
- Host: GitHub
- URL: https://github.com/leplusorg/docker-adoc
- Owner: leplusorg
- License: apache-2.0
- Created: 2025-09-21T21:33:26.000Z (17 days ago)
- Default Branch: main
- Last Pushed: 2025-09-22T16:15:43.000Z (16 days ago)
- Last Synced: 2025-09-22T18:34:19.405Z (16 days ago)
- Topics: asciidoc, asciidoctor, asciidoctor-converter, docker, docker-container, docker-image, dockerfile
- Language: Dockerfile
- Homepage: https://hub.docker.com/r/leplusorg/adoc
- Size: 30.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# AsciiDoc
Multi-platform Docker container with utilities to process AsciiDoc files (`asciidoc`, `a2x`, `ascidoctor`...).
[](adoc/Dockerfile)
[](https://github.com/leplusorg/docker-adoc/actions?query=workflow:"Docker")
[](https://hub.docker.com/r/leplusorg/adoc)
[](https://hub.docker.com/r/leplusorg/adoc)
[](https://hub.docker.com/r/leplusorg/adoc)
[](https://bestpractices.coreinfrastructure.org/projects/11218)
[](https://securityscorecards.dev/viewer/?uri=github.com/leplusorg/docker-adoc)
## Example without using the filesystem
Let's say that you want to convert an AsciiDoc file intput.adoc in your current working directory to HTML:
**Mac/Linux**
```bash
cat intput.adoc | docker run --rm -i --net=none leplusorg/adoc asciidoctor -o - - > output.html
```
**Windows**
```batch
type intput.adoc | docker run --rm -i --net=none leplusorg/adoc asciidoctor -o - - > output.html
```
## Example using the filesystem
Same thing, assuming that you want to convert an AsciiDoc file intput.adoc in your current working directory to HTML:
**Mac/Linux**
```bash
docker run --rm -t --user="$(id -u):$(id -g)" --net=none -v "$(pwd):/tmp" leplusorg/adoc asciidoctor -o output.html intput.adoc
```
**Windows**
In `cmd`:
```batch
docker run --rm -t --net=none -v "%cd%:/tmp" leplusorg/adoc asciidoctor -o output.html intput.adoc
```
In PowerShell:
```pwsh
docker run --rm -t --net=none -v "${PWD}:/tmp" leplusorg/adoc asciidoctor -o output.html intput.adoc
```
## Software Bill of Materials (SBOM)
To get the SBOM for the latest image (in SPDX JSON format), use the
following command:
```bash
docker buildx imagetools inspect leplusorg/adoc --format '{{ json (index .SBOM "linux/amd64").SPDX }}'
```
Replace `linux/amd64` by the desired platform (`linux/amd64`, `linux/arm64` etc.).
### Sigstore
[Sigstore](https://docs.sigstore.dev) is trying to improve supply
chain security by allowing you to verify the origin of an
artifcat. You can verify that the image that you use was actually
produced by this repository. This means that if you verify the
signature of the Docker image, you can trust the integrity of the
whole supply chain from code source, to CI/CD build, to distribution
on Maven Central or whever you got the image from.
You can use the following command to verify the latest image using its
sigstore signature attestation:
```bash
cosign verify leplusorg/adoc --certificate-identity-regexp 'https://github\.com/leplusorg/docker-adoc/\.github/workflows/.+' --certificate-oidc-issuer 'https://token.actions.githubusercontent.com'
```
The output should look something like this:
```text
Verification for index.docker.io/leplusorg/xml:main --
The following checks were performed on each of these signatures:
- The cosign claims were validated
- Existence of the claims in the transparency log was verified offline
- The code-signing certificate was verified using trusted certificate authority certificates
[{"critical":...
```
For instructions on how to install `cosign`, please read this [documentation](https://docs.sigstore.dev/cosign/system_config/installation/).
## Request new tool
Please use [this link](https://github.com/leplusorg/docker-adoc/issues/new?assignees=thomasleplus&labels=enhancement&template=feature_request.md&title=%5BFEAT%5D) (GitHub account required) to request that a new tool be added to the image. I am always interested in adding new capabilities to these images.