# 使用 Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper 安装 asciidoc

查看 asciidoc 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:asciidoc
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install asciidoc
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install asciidoc
```

  证据: MacPorts ports tree: textproc/asciidoc/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add asciidoc
```

  证据: Alpine Linux edge package indexes: asciidoc from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install asciidoc
```

  证据: Debian stable package indexes: asciidoc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install asciidoc
```

  证据: Fedora Rawhide package metadata: asciidoc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#asciidoc
```

  证据: nixpkgs package indexes: pkgs/by-name/as/asciidoc/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S asciidoc
```

  证据: Arch Linux sync databases: asciidoc from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install asciidoc
```

  证据: openSUSE Tumbleweed package metadata: asciidoc from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## 软件包事实

- **软件包键:** brew:asciidoc
- **软件包管理器:** Homebrew
- **版本:** 10.2.1
- **来源摘要:** Formatter/translator for text files to numerous formats
- **主页:** <https://asciidoc-py.github.io/>
- **仓库:** <https://github.com/asciidoc-py/asciidoc-py>
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- a2x (别名)
- asciidoc (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 10.2.1
## 项目历史与用法

The Homebrew `asciidoc` formula packages AsciiDoc.py, the legacy Python processor for the AsciiDoc lightweight markup language. The language began as Stuart Rackham's shorthand for DocBook, while the current AsciiDoc.py site now explicitly distinguishes the legacy processor from the modern AsciiDoc specification.

### 项目历史

The official Asciidoctor history records that Stuart Rackham first conceived AsciiDoc in 2002 as a shorthand format for DocBook and launched both the language and processor as the AsciiDoc.py project. The first public AsciiDoc.py 1.0 release, SourceForge registration, and first website publication all happened on 2002-11-25.

AsciiDoc.py evolved for roughly a decade as the original processor. The official timeline records a move from SourceForge-era hosting through Google Code and then, in December 2013, transfer of the source repository to the asciidoc organization on GitHub. The AsciiDoc.py homepage describes it as highly configurable, with source syntax and backend output markups customizable through configuration files.

The later Python package line modernized the old processor. The official changelog records Python 3.5+ support in version 9.0.0 in 2020, a 10.0.0 rewrite into a proper Python package installable with `pip install asciidoc` in 2021, and version 10.2.1 in July 2024.

### 采用历史

AsciiDoc.py spread because it made DocBook-oriented publishing possible from plain text using `asciidoc` and the `a2x` wrapper. The official homepage shows examples for HTML, XHTML, DocBook, EPUB, PDF, slides, websites, and Unix man pages, and the install page lists distro packaging in Fedora, Debian/Ubuntu, and Homebrew.

Its role changed after Asciidoctor appeared. The official history says Asciidoctor became AsciiDoc.py's successor after GitHub disabled AsciiDoc rendering in January 2013 for security concerns and then re-enabled rendering with Asciidoctor. The AsciiDoc.py homepage now recommends using a modern processor unless the AsciiDoc.py toolchain is specifically required.

### 使用方式

Package users install `asciidoc` and `a2x` to translate `.txt` or `.adoc` sources into HTML, DocBook, man pages, EPUB, PDF, and related outputs. The user guide describes AsciiDoc as lightweight, consisting of scripts plus configuration files, with backend plugins and themes extending output generation.

### 为什么软件包爱好者会关心

AsciiDoc.py is historically important because it is the original implementation that made AsciiDoc a package-manager staple. It is also a useful case study in language/tool split: the `asciidoc` package name preserves the old Python processor even as the language specification and modern processing ecosystem moved toward Asciidoctor and the Eclipse AsciiDoc Working Group.

### 时间线

- 2002-11-25: First public release of AsciiDoc.py 1.0 by Stuart Rackham.
- 2007-10-23: AsciiDoc.py source repository converted to Mercurial and transferred to Google Code.
- 2013-12-21: AsciiDoc.py source repository converted to git and transferred to the asciidoc GitHub organization.
- 2020-06-02: AsciiDoc.py 9.0.0 ports the processor to Python 3.5+.
- 2021-10-16: AsciiDoc.py 10.0.0 becomes a proper Python package installable from PyPI.
- 2024-07-16: AsciiDoc.py 10.2.1 released.

### Related projects

- Asciidoctor is the Ruby successor and current reference implementation for the AsciiDoc language.
- a2x is the AsciiDoc.py toolchain wrapper for post-processing DocBook output into formats such as PDF and EPUB.
- The Eclipse AsciiDoc Working Group governs the modern AsciiDoc language direction.

### 来源

- <https://asciidoc-py.github.io/>
- <https://asciidoc-py.github.io/CHANGELOG.html>
- <https://asciidoc-py.github.io/INSTALL.html>
- <https://docs.asciidoctor.org/about/history/>
- <https://docs.asciidoctor.org/asciidoc/latest/>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals

## 其他软件包管理器记录

- Debian apt - asciidoc - 10.2.1-1: normalized package name match | Debian stable package indexes: asciidoc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Highly configurable text format for writing documentation | https://asciidoc.org
- Debian apt - asciidoc-base - 10.2.1-1: normalized package name match | Debian stable package indexes: asciidoc-base from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Minimal version of asciidoc not suitable for pdf | https://asciidoc.org
- Debian apt - asciidoc-common - 10.2.1-1: normalized package name match | Debian stable package indexes: asciidoc-common from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Basic data and configuration files for asciidoc | https://asciidoc.org
- Debian apt - asciidoc-dblatex - 10.2.1-1: normalized package name match | Debian stable package indexes: asciidoc-dblatex from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Asciidoc package including dblatex dependencies | https://asciidoc.org
- Debian apt - asciidoc-fop - 10.2.1-1: normalized package name match | Debian stable package indexes: asciidoc-fop from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Asciidoc package including fop dependencies | https://asciidoc.org
- Debian apt - asciidoc-tests - 10.2.1-1: normalized package name match | Debian stable package indexes: asciidoc-tests from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Test framework for asciidoc | https://asciidoc.org
- Nix - asciidoc: normalized package name match | nixpkgs package indexes: pkgs/by-name/as/asciidoc/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - asciidoc - 10.2.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: asciidoc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Highly configurable text format for writing documentation | https://asciidoc.org
- Ubuntu apt - asciidoc-base - 10.2.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: asciidoc-base from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Minimal version of asciidoc not suitable for pdf | https://asciidoc.org
- Ubuntu apt - asciidoc-common - 10.2.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: asciidoc-common from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Basic data and configuration files for asciidoc | https://asciidoc.org
- Ubuntu apt - asciidoc-dblatex - 10.2.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: asciidoc-dblatex from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Asciidoc package including dblatex dependencies | https://asciidoc.org
- Ubuntu apt - asciidoc-fop - 10.2.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: asciidoc-fop from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Asciidoc package including fop dependencies | https://asciidoc.org
- Ubuntu apt - asciidoc-tests - 10.2.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: asciidoc-tests from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Test framework for asciidoc | https://asciidoc.org
- apk - asciidoc - 10.2.1-r1: normalized package name match | Alpine Linux edge package indexes: asciidoc from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | Text based documentation | https://asciidoc.org/
- apk - asciidoc-doc - 10.2.1-r1: normalized package name match | Alpine Linux edge package indexes: asciidoc-doc from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | Text based documentation (documentation) | https://asciidoc.org/
- apk - asciidoc-pyc - 10.2.1-r1: normalized package name match | Alpine Linux edge package indexes: asciidoc-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for asciidoc | https://asciidoc.org/


## Combined YAML source

View the package source record on GitHub. [combined/asciidoc.yml](https://github.com/mxcl/pkgdb/blob/main/combined/asciidoc.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph