{"id":25073727,"url":"https://github.com/stefapi/asciidoc_generator","last_synced_at":"2025-10-24T03:52:56.443Z","repository":{"id":274376997,"uuid":"922699538","full_name":"stefapi/asciidoc_generator","owner":"stefapi","description":"Some scripts to generate docx odt pdf files with templates and styles  from asciidoctor and preserving formatting like admonest","archived":false,"fork":false,"pushed_at":"2025-03-26T08:23:03.000Z","size":196,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T09:30:58.515Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","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/stefapi.png","metadata":{"files":{"readme":"README.asc","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":"2025-01-26T21:42:44.000Z","updated_at":"2025-03-26T08:23:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"918e5f35-bc51-45ec-840b-8c1e1595452f","html_url":"https://github.com/stefapi/asciidoc_generator","commit_stats":null,"previous_names":["stefapi/asciidoc_generator"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefapi%2Fasciidoc_generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefapi%2Fasciidoc_generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefapi%2Fasciidoc_generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefapi%2Fasciidoc_generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stefapi","download_url":"https://codeload.github.com/stefapi/asciidoc_generator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246523844,"owners_count":20791444,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2025-02-06T23:30:00.267Z","updated_at":"2025-10-14T01:08:24.132Z","avatar_url":"https://github.com/stefapi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":" \n== Software Description\n\nThis repository contains a script designed to generate high-quality documentation from Asciidoctor files with templating support. Key features include:\n\n* **Company-Branded Templates**: Use your company's templates to generate documentation with consistent guard pages, headers, footers, and a final page.\n* **Automatic Template Transformation**: The script automatically converts the document template into a template file and style file to ensure proper formatting and style consistency.\n* **Multi-Format Output**: Starting from an ODT file generated with Pandoc, the script produces DOCX and PDF versions of the document.\n\n=== Additional Features\n\nThe script also allows you to:\n\n* Specify a **reviewer** and their **title** for the document.\n* Specify an **approver** and their **title**.\n* Add a **confidentiality policy** to the document.\n* Preserve **revision marks** from the original Asciidoctor file and integrate them into a small table that can be positioned anywhere in your document.\n\n== How to Use\n\nAn example of script usage is provided in the `Makefile`. This example demonstrates how to generate documentation using the script.\n\nFor details on creating and testing a document template, refer to the `README` file located in the `template` directory.\n\n== Prerequisites\n\nBefore using the script, ensure the following dependencies are installed:\n\n=== Required Software\n\n* `python3` with the following tools: `awk`, `sed`\n* `pandoc`\n* `lua` engine for Pandoc (usually included in most distributions of Pandoc)\n* `libreoffice`\n* `asciidoctor` with the following extensions/modules:\n** `asciidoctor-diagram`\n** `asciidoctor-kroki` (if using Kroki for diagrams)\n** `asciidoctor-include-ext` (if advanced inclusion features are needed)\n** `asciidoctor-epub3` (if generating EPUB3 documents)\n** `asciidoctor-reducer` (to flatten Asciidoctor files)\n* `asciimath` (for AsciiMath support)\n* `ascii` (general support)\n* `rqrcode` and `barby` (for generating QR codes for document URLs)\n\n=== Installation of Asciidoctor Modules\n\nAll Asciidoctor modules can be installed using the `gem install` command. For example:\n\n[source,bash]\n----\ngem install asciidoctor-diagram\ngem install asciidoctor-kroki\ngem install asciidoctor-reducer\n----\n\nEnsure you install any additional modules as needed based on the features you plan to use.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstefapi%2Fasciidoc_generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstefapi%2Fasciidoc_generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstefapi%2Fasciidoc_generator/lists"}