{"id":13503217,"url":"https://github.com/asciidoctor/docker-asciidoctor","last_synced_at":"2026-04-18T23:14:03.771Z","repository":{"id":20790917,"uuid":"24076072","full_name":"asciidoctor/docker-asciidoctor","owner":"asciidoctor","description":":ship: A Docker image for using the Asciidoctor toolchain to process AsciiDoc content","archived":false,"fork":false,"pushed_at":"2026-04-13T15:47:42.000Z","size":2154,"stargazers_count":349,"open_issues_count":33,"forks_count":162,"subscribers_count":18,"default_branch":"main","last_synced_at":"2026-04-13T17:40:54.067Z","etag":null,"topics":["asciidoctor","docker","hacktoberfest","hacktoberfest2021"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/asciidoctor/docker-asciidoctor/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/asciidoctor.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":"CONTRIBUTING.adoc","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2014-09-15T22:18:03.000Z","updated_at":"2026-04-13T15:47:46.000Z","dependencies_parsed_at":"2023-12-26T09:06:25.513Z","dependency_job_id":"8984b8d8-4873-470d-b5ac-acac4feb2d68","html_url":"https://github.com/asciidoctor/docker-asciidoctor","commit_stats":{"total_commits":743,"total_committers":60,"mean_commits":"12.383333333333333","dds":0.7079407806191117,"last_synced_commit":"d459e206474743da52e28cb6ff9f859b7e8c268b"},"previous_names":[],"tags_count":117,"template":false,"template_full_name":null,"purl":"pkg:github/asciidoctor/docker-asciidoctor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoctor%2Fdocker-asciidoctor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoctor%2Fdocker-asciidoctor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoctor%2Fdocker-asciidoctor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoctor%2Fdocker-asciidoctor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/asciidoctor","download_url":"https://codeload.github.com/asciidoctor/docker-asciidoctor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoctor%2Fdocker-asciidoctor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31987934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"ssl_error","status_checked_at":"2026-04-18T20:23:29.375Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asciidoctor","docker","hacktoberfest","hacktoberfest2021"],"created_at":"2024-07-31T22:02:42.148Z","updated_at":"2026-04-18T23:14:03.762Z","avatar_url":"https://github.com/asciidoctor.png","language":"Shell","funding_links":[],"categories":["Misc","Shell","docker"],"sub_categories":[],"readme":":ALPINE_VERSION: 3.23.4\n:ASCIIDOCTOR_VERSION: 2.0.26\n:ASCIIDOCTOR_CONFLUENCE_VERSION: 0.0.2\n:ASCIIDOCTOR_PDF_VERSION: 2.3.24\n:ASCIIDOCTOR_DIAGRAM_VERSION: 3.2.1\n:ASCIIDOCTOR_EPUB3_VERSION: 2.3.0\n:ASCIIDOCTOR_FB2_VERSION: 0.8.0\n:ASCIIDOCTOR_MATHEMATICAL_VERSION: 0.3.5\n:ASCIIDOCTOR_REVEALJS_VERSION: 5.2.0\n:KRAMDOWN_ASCIIDOC_VERSION: 2.1.1\n:ASCIIDOCTOR_BIBTEX_VERSION: 0.9.0\n:ASCIIDOCTOR_KROKI_VERSION: 0.10.2\n:ASCIIDOCTOR_REDUCER_VERSION: 1.0.2\n= Asciidoctor Docker Container\n:source-highlighter: coderay\n\n////\nGitHub renders asciidoctor natively, but DockerHub does not (it needs markdown).\n`make README.md` converts this page into markdown.\n////\n\n== The environment\n\nThis Docker image provides:\n\n* https://asciidoctor.org/[Asciidoctor] {ASCIIDOCTOR_VERSION}\n* https://asciidoctor.org/docs/asciidoctor-diagram/[Asciidoctor Diagram] {ASCIIDOCTOR_DIAGRAM_VERSION} with ERD and Graphviz integration (supports plantuml and graphiz diagrams)\n* https://asciidoctor.org/docs/asciidoctor-pdf/[Asciidoctor PDF] {ASCIIDOCTOR_PDF_VERSION}\n* https://asciidoctor.org/docs/asciidoctor-epub3/[Asciidoctor EPUB3] {ASCIIDOCTOR_EPUB3_VERSION}\n* https://github.com/asciidoctor/asciidoctor-fb2/[Asciidoctor FB2] {ASCIIDOCTOR_FB2_VERSION}\n* https://github.com/asciidoctor/asciidoctor-mathematical[Asciidoctor Mathematical] {ASCIIDOCTOR_MATHEMATICAL_VERSION}\n* https://docs.asciidoctor.org/reveal.js-converter/latest/[Asciidoctor reveal.js] {ASCIIDOCTOR_REVEALJS_VERSION}\n* https://rubygems.org/gems/asciimath[AsciiMath]\n* Source highlighting using http://rouge.jneen.net[Rouge], https://rubygems.org/gems/coderay[CodeRay] or https://pygments.org/[Pygments]\n* https://github.com/asciidoctor/asciidoctor-confluence[Asciidoctor Confluence] {ASCIIDOCTOR_CONFLUENCE_VERSION}\n* https://github.com/asciidoctor/asciidoctor-bibtex[Asciidoctor Bibtex] {ASCIIDOCTOR_BIBTEX_VERSION}\n* https://github.com/Mogztter/asciidoctor-kroki[Asciidoctor Kroki] {ASCIIDOCTOR_KROKI_VERSION}\n* https://github.com/asciidoctor/asciidoctor-reducer[Asciidoctor Reducer] {ASCIIDOCTOR_REDUCER_VERSION}\n\nThis image uses Alpine Linux {ALPINE_VERSION} as base image.\n\nNOTE: Docker Engine link:https://docs.docker.com/engine/release-notes/#20100[20.10] or later is required (or any container engine supporting link:https://wiki.alpinelinux.org/wiki/Release_Notes_for_Alpine_3.14.0[Alpine 3.14]) to avoid unexpected `No such file or directory` errors (such as link:https://github.com/asciidoctor/docker-asciidoctor/issues/214[#214] or link:https://github.com/asciidoctor/docker-asciidoctor/issues/215[#215]).\n\nNOTE: This image uses the Go-based https://github.com/kaishuu0123/erd-go/[erd-go] instead of the original Haskell-based https://github.com/BurntSushi/erd[erd] to allow the Docker image to be provided as a multi-platform image.\n\n== How to use it\n\nJust run:\n\n[source,bash]\n----\ndocker run -it -u $(id -u):$(id -g) -v \u003cyour directory\u003e:/documents/ asciidoctor/docker-asciidoctor\n----\n\nor the following for https://podman.io/[Podman]:\n\n[source,bash]\n----\npodman run -it -v \u003cyour directory\u003e:/documents/ docker.io/asciidoctor/docker-asciidoctor\n----\n\nDocker/Podman maps your directory with [path]_/documents_ directory in the container.\n\nNOTE: You might need to add the option `:z` or `:Z` like `\u003cyour directory\u003e:/documents/:z` or `\u003cyour directory\u003e:/documents/:Z` if you are using SELinux. See https://docs.docker.com/storage/bind-mounts/#configure-the-selinux-label[Docker docs] or https://docs.podman.io/en/latest/markdown/podman-run.1.html#volume-v-source-volume-host-dir-container-dir-options[Podman docs].\n\nAfter you start the container, you can use Asciidoctor commands to convert AsciiDoc files that you created in the directory mentioned above.\nYou can find several examples below.\n\n* To run Asciidoctor on a basic AsciiDoc file:\n+\n[source,bash]\n----\nasciidoctor sample.adoc\nasciidoctor-pdf sample.adoc\nasciidoctor-epub3 sample.adoc\n----\n\n* To run AsciiDoc on an AsciiDoc file that contains diagrams:\n+\n[source,bash]\n----\nasciidoctor -r asciidoctor-diagram sample-with-diagram.adoc\nasciidoctor-pdf -r asciidoctor-diagram sample-with-diagram.adoc\nasciidoctor-epub3 -r asciidoctor-diagram sample-with-diagram.adoc\n----\n\n* To run AsciiDoc on an AsciiDoc file that contains latexmath and stem blocks:\n+\n[source,bash]\n----\nasciidoctor -r asciidoctor-mathematical sample-with-diagram.adoc\nasciidoctor-pdf -r asciidoctor-mathematical sample-with-diagram.adoc\nasciidoctor-epub3 -r asciidoctor-mathematical sample-with-diagram.adoc\n----\n\n* To use Asciidoctor Confluence:\n+\n[source,bash]\n----\nasciidoctor-confluence --host HOSTNAME --spaceKey SPACEKEY --title TITLE --username USER --password PASSWORD sample.adoc\n----\n\n* To use Asciidoctor reveal.js with local downloaded reveal.js:\n+\n[source,bash]\n----\nasciidoctor-revealjs sample-slides.adoc\nasciidoctor-revealjs -r asciidoctor-diagram sample-slides.adoc\n----\n\n* To use Asciidoctor reveal.js with online reveal.js:\n+\n[source,bash]\n----\nasciidoctor-revealjs -a revealjsdir=https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.9.2 sample-slides.adoc\nasciidoctor-revealjs -a revealjsdir=https://cdnjs.cloudflare.com/ajax/libs/reveal.js/3.9.2 -r asciidoctor-diagram sample-slides.adoc\n----\n\n* To convert files in batch:\n+\n[source,bash]\n----\ndocker run --rm -u $(id -u):$(id -g) -v $(pwd):/documents/ asciidoctor/docker-asciidoctor asciidoctor-pdf index.adoc\n----\n+\nor:\n+\n[source,bash]\n----\npodman run --rm -v $(pwd):/documents/ docker.io/asciidoctor/docker-asciidoctor asciidoctor-pdf index.adoc\n----\n\n== How to contribute / do it yourself?\n\nCheck the link:https://github.com/asciidoctor/docker-asciidoctor/blob/main/CONTRIBUTING.adoc[Contributing to the Asciidoctor Docker Container] page.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasciidoctor%2Fdocker-asciidoctor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasciidoctor%2Fdocker-asciidoctor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasciidoctor%2Fdocker-asciidoctor/lists"}