Jason's Home Page - Linux HOWTOs

asciidoc - Legacy processor for the AsciiDoc document format ChangeLog

Web site:	https://asciidoc-py.github.io/
Repository:	https://github.com/asciidoc-py/asciidoc-py
Wikipedia:	https://en.wikipedia.org/wiki/AsciiDoc

HOWTO

# AsciiDoc 10.2.0 (2022-05-22)
# ===============
# The Slackware 'linuxdoc-tools' package includes AsciiDoc (and others)
# The following Slackware releases include the specified version of
# AsciiDoc:
# Slackware 14.0: 8.6.7
# Slackware 14.1: 8.6.8
# Slackware 14.2: 8.6.9
# Slackware 15.0: 9.1.0
#
# Because linuxdoc-tools includes several different pieces of software that
# work together, I would suggest NOT removing the linuxdoc-tools package
# if you are upgrading AsciiDoc from source. (unless you are upgrading
# OpenJade, xmlto, etc. also)

# ChangeLog (1.0 through 10.2.0)
# AsciiDoc User Guide
# AsciiDoc Installation
# AsdiiDoc file format
# Slackware64-current source linuxdoc-tools
# web.archive.org: Old version of site when at www.methods.co.nz (version 8.6.9 at the time)
# Asciidoctor

# Prerequisites:
# Python >= 3.5
# DocBook XSL Stylesheets (Slackware's linuxdoc-tools package)
# xsltproc
# w3m
# dblatex (Slackware's linuxdoc-tools package)
# FOP

## Install from PyPI using pip

# Once you have the prerequisites, you should be able to install AsciiDoc.py
# from PyPI using pip

# Become root
# ...unless you have your own local copy of Python
# ...or you have been using a virtual environment
su

## Remove/backup/move existing AsciiDoc to avoid conflicts:
## (at least remove/backup/move /usr/bin/asciidoc.py)
#
# rm /usr/bin/asciidoc.py
# test -d /etc/asciidoc && rm -r /etc/asciidoc
# find /usr/doc/ -type d -name "asciidoc-*" -exec rm -r {} \;
# rm /usr/man/man1/asciidoc.1.gz

# Upgrade pip
python3 -m pip install --upgrade pip

# Install AsciiDoc
python3 -m pip install asciidoc

## Now you should have /usr/bin/asciidoc (with today's date) and
## something like:
# /usr/bin/asciidoc
# /usr/lib*/python3.x/site-packages/asciidoc/asciidoc.py
## Everything that used to be in /etc/asciidoc/ is now in:
# /usr/lib*/python3.8/site-packages/asciidoc/resources/

# Run this to make sure it is functional at least that much
asciidoc --version

## Install AsciiDoc 10.2.0 (2022-05-22) from GitHub tarball
https://github.com/asciidoc-py/asciidoc-py/releases/tag/10.2.0

# Get the source tarball
cd
test -f installed/asciidoc-10.2.0.tar.gz &&
mv -f installed/asciidoc-10.2.0.tar.gz .
test ! -f asciidoc-10.2.0.tar.gz &&
wget https://github.com/asciidoc-py/asciidoc-py/releases/download/10.2.0/\
asciidoc-10.2.0.tar.gz

# Extract the source
mkdir -p -m 0700 ~/src
cd ~/src
find -maxdepth 1 -type d -name "asciidoc-*" -exec rm -r {} \;
tar xzvf ~/asciidoc-10.2.0.tar.gz
cd asciidoc-10.2.0
test $UID = 0 && chown -R root:root .

# Configure the build
./configure --prefix=/usr --docdir=/usr/doc/asciidoc-10.2.0 --mandir=/usr/man

# Become root to install it
su

# Install the docs under /usr/doc/asciidoc-10.2.0
make docs

# Install AsciiDoc with pip
# (this runs "python3 -m pip install --root / .")
make install

# Become your non-root user again
exit

# Save the tarball for later
cd
mkdir -p -m 0700 installed
rm -f installed/asciidoc-*.tar.*
mv installed/asciidoc-10.2.0.tar.gz installed/