Beyond Linux® From Scratch (System V Edition) - Version 2021-04-13

Chapter 11. General Utilities

Asciidoc-9.1.0

Introduction to Asciidoc

The Asciidoc package is a text document format for writing notes, documentation, articles, books, ebooks, slideshows, web pages, man pages and blogs. AsciiDoc files can be translated to many formats including HTML, PDF, EPUB, and man page.

This package is known to build and work properly using an LFS-10.1 platform.

Package Information

Asciidoc Dependencies

Optional (tests and runtime)

docbook-xsl-1.79.2, fop-2.6, libxslt-1.1.34, Lynx-2.8.9rel.1, dblatex, and W3m

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/asciidoc

Installation of Asciidoc

First, fix a build problem if the optional dependencies are not installed: 

sed -i 's:doc/testasciidoc.1::' Makefile.in &&
rm doc/testasciidoc.1.txt

Install Asciidoc by running the following commands: 

./configure --prefix=/usr     \
            --sysconfdir=/etc \
            --docdir=/usr/share/doc/asciidoc-9.1.0 &&
make

This package does not come with a test suite.

Now, as the root user: 

make install &&
make docs

Contents

Installed Programs: a2x (symlink to a2x.py), a2x.py, asciidoc (symlink to asciidoc.py), and asciidoc.py
Installed Libraries: None
Installed Directories: /etc/asciidoc and /usr/share/doc/asciidoc-9.1.0

Short Descriptions

a2x

is a toolchain manager for AsciiDoc (converts Asciidoc text files to other file formats)

asciidoc

converts an AsciiDoc text file to HTML or DocBook

Last updated on 2021-04-05 07:36:04 -0500