{"id":13367660,"url":"https://github.com/asciidoc-py/asciidoc-py","last_synced_at":"2025-12-11T22:48:33.520Z","repository":{"id":39902079,"uuid":"95337610","full_name":"asciidoc-py/asciidoc-py","owner":"asciidoc-py","description":"Legacy python processor for AsciiDoc","archived":false,"fork":false,"pushed_at":"2024-07-25T15:47:18.000Z","size":13455,"stargazers_count":195,"open_issues_count":41,"forks_count":63,"subscribers_count":16,"default_branch":"main","last_synced_at":"2024-07-30T01:10:49.750Z","etag":null,"topics":["asciidoc","python"],"latest_commit_sha":null,"homepage":"https://asciidoc-py.github.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/asciidoc-py.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.adoc","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":"2017-06-25T04:06:28.000Z","updated_at":"2024-07-30T01:11:01.628Z","dependencies_parsed_at":"2024-07-30T01:22:38.430Z","dependency_job_id":null,"html_url":"https://github.com/asciidoc-py/asciidoc-py","commit_stats":{"total_commits":1581,"total_committers":54,"mean_commits":29.27777777777778,"dds":"0.23655913978494625","last_synced_commit":"cca1dd5dba29c019819bb6ab9fdf0e596b05f857"},"previous_names":["asciidoc/asciidoc-py3","asciidoc/asciidoc"],"tags_count":51,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoc-py%2Fasciidoc-py","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoc-py%2Fasciidoc-py/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoc-py%2Fasciidoc-py/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/asciidoc-py%2Fasciidoc-py/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/asciidoc-py","download_url":"https://codeload.github.com/asciidoc-py/asciidoc-py/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243290641,"owners_count":20267754,"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":["asciidoc","python"],"created_at":"2024-07-30T00:01:58.305Z","updated_at":"2025-10-21T06:16:47.059Z","avatar_url":"https://github.com/asciidoc-py.png","language":"Python","funding_links":[],"categories":["\u003ca id=\"tag-dev\" href=\"#tag-dev\"\u003eDev\u003c/a\u003e","Python"],"sub_categories":["\u003ca id=\"tag-dev.docs\" href=\"#tag-dev.docs\"\u003eDocs\u003c/a\u003e"],"readme":"AsciiDoc.py\n===========\n\n[![Test](https://github.com/asciidoc-py/asciidoc-py/actions/workflows/test.yml/badge.svg?branch=main\u0026event=push)](https://github.com/asciidoc-py/asciidoc-py/actions/workflows/test.yml)\n[![codecov](https://codecov.io/gh/asciidoc-py/asciidoc-py/branch/main/graph/badge.svg?token=fNh3QlLTw0)](https://codecov.io/gh/asciidoc-py/asciidoc-py)\n[![PyPI version](https://badge.fury.io/py/asciidoc.svg)](https://badge.fury.io/py/asciidoc)\n\nAsciiDoc is a text document format for writing notes, documentation,\narticles, books, ebooks, slideshows, web pages, man pages and blogs.\nAsciiDoc files can be translated to many formats including HTML, PDF,\nEPUB, man page.\n\nAsciiDoc.py is a legacy processor for this syntax, handling an older\nrendition of AsciiDoc. As such, this will not properly handle the\n[current AsciiDoc specification](https://projects.eclipse.org/projects/technology.asciidoc).\nIt is suggested that unless you specifically require the AsciiDoc.py\ntoolchain, you should find a processor that handles the modern AsciiDoc\nsyntax.\n\nAsciiDoc.py is highly configurable: both the AsciiDoc source file syntax\nand the backend output markups (which can be almost any type of\nSGML/XML markup) can be customized and extended by the user.\n\n## Prerequisites\n\nAsciiDoc.py is written in Python so you need a Python interpreter\n(version 3.5 or later) to execute asciidoc(1). You can install Python using the\npackage manager for your OS or by downloading it from the official Python\nwebsite http://www.python.org.\n\nAdditionally, you will need:\n\n* DocBook XSL Stylesheets 1.76.1\n* xsltproc (libxml 20706, libxslt 10126 and libexslt 815).\n* w3m 0.5.2\n* dblatex 0.3\n* FOP 0.95\n\nto enable the full AsciiDoc.py toolchain.\n\n## Obtaining AsciiDoc.py\n\nDocumentation and installation instructions are on the AsciiDoc.py website\nhttps://asciidoc.org/. Simply, you should use use pip to install it:\n\n```\npip3 install asciidoc\n```\n\n## Contributing\n\nTo contribute and test your changes, you will need to install:\n* flake8\n* pytest\n* pytest-mock\n\nTo lint the codebase: `python3 -m flake8`\n\nAsciiDoc.py has the following types of tests:\n1. doctests: `python3 -m asciidoc.asciidoc --doctest`\n1. unit tests: `python3 -m pytest`\n1. integration tests: `python3 tests/testasciidoc.py`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasciidoc-py%2Fasciidoc-py","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasciidoc-py%2Fasciidoc-py","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasciidoc-py%2Fasciidoc-py/lists"}