{"id":16958489,"url":"https://github.com/dohliam/asciidoctor-workflow","last_synced_at":"2026-05-18T08:02:45.088Z","repository":{"id":88991735,"uuid":"73532867","full_name":"dohliam/asciidoctor-workflow","owner":"dohliam","description":"Quick prototyping script for creating rich html and pdfs from Asciidoctor documents","archived":false,"fork":false,"pushed_at":"2016-11-12T05:09:23.000Z","size":3,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-21T14:47:02.674Z","etag":null,"topics":["asciidoc","asciidoctor","css","html","pdf","prototyping","ruby"],"latest_commit_sha":null,"homepage":"https://dohliam.github.io/asciidoctor-workflow","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dohliam.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"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}},"created_at":"2016-11-12T05:09:09.000Z","updated_at":"2016-11-18T23:48:35.000Z","dependencies_parsed_at":null,"dependency_job_id":"f8c32fe6-087b-4e2d-b594-7f6c746e563e","html_url":"https://github.com/dohliam/asciidoctor-workflow","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dohliam/asciidoctor-workflow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dohliam%2Fasciidoctor-workflow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dohliam%2Fasciidoctor-workflow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dohliam%2Fasciidoctor-workflow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dohliam%2Fasciidoctor-workflow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dohliam","download_url":"https://codeload.github.com/dohliam/asciidoctor-workflow/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dohliam%2Fasciidoctor-workflow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33170442,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-18T05:43:36.989Z","status":"ssl_error","status_checked_at":"2026-05-18T05:43:19.133Z","response_time":71,"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":["asciidoc","asciidoctor","css","html","pdf","prototyping","ruby"],"created_at":"2024-10-13T22:42:43.153Z","updated_at":"2026-05-18T08:02:45.073Z","avatar_url":"https://github.com/dohliam.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":":toc: left\n\n= asciidoctor-workflow: Quick prototyping script for creating rich html and pdfs from Asciidoctor documents\n\nhttps://github.com/dohliam/asciidoctor-workflow[Asciidoctor-workflow] is a small script for generating nice-looking web pages and pdf documents from Asciidoctor using a https://github.com/darshandsoni/asciidoctor-skins[CSS switcher]. This means that creating a webpage or a pdf is simply a matter of writing some content in Asciidoctor and choosing a CSS template from the https://github.com/darshandsoni/asciidoctor-skins[asciidoctor-skins] project, which can drastically reduce the amount of time required to put documentation online.\n\n== Requirements\n\n* https://www.ruby-lang.org/[ruby] and the https://github.com/asciidoctor/asciidoctor[asciidoctor] gem (\u003e1.5)\n* https://github.com/wkhtmltopdf/wkhtmltopdf[wkhtmltopdf] for PDF support\n\n== Usage\n\nGiven a plain Asciidoctor document, asciidoctor-workflow by default will create an html file with an embedded switcher, allowing you to cycle interactively through a list of CSS templates to see which one works best with your document. You can try this by https://github.com/dohliam/asciidoctor-workflow[cloning or downloading the project] and running the following command on this readme file from within the project directory:\n\n----\n/.asciidoctor_workflow.rb README.adoc\n----\n\nOnce you have decided on a CSS template, just run asciidoctor_workflow.rb again with the `-s` option to generate a permanent file with your chosen CSS included:\n\n----\n./asciidoctor_workflow.rb -s notebook README.md\n----\n\nUse the `-p` option to create a PDF using your selected CSS template:\n\n----\n./asciidoctor_workflow.rb -ps notebook README.md\n----\n\nYou can view an https://dohliam.github.io/asciidoctor-workflow[online demo] or https://dohliam.github.io/asciidoctor-workflow/asciidoctor-workflow.pdf[download a pdf] which is the result of running the above commands.\n\n== Known issues\n\nPDF generation is buggy at the moment and does not produce correct output for most stylesheets. This appears to be a bug with wkhtmltopdf. Feel free to submit a PR if you have a fix or can suggest a different pdf generator!\n\n== Related projects\n\n* https://github.com/darshandsoni/asciidoctor-skins[asciidoctor-skins] by @darshandsoni, the source of the CSS templates for Asciidoctor\n* https://github.com/dohliam/workflow[workflow], for a similar idea but with markdown\n* https://github.com/dohliam/dropin-minimal-css[dropin-minimal-css], on which this script and workflow are based\n\n== License\n\nMIT.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdohliam%2Fasciidoctor-workflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdohliam%2Fasciidoctor-workflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdohliam%2Fasciidoctor-workflow/lists"}