How To Install asciidoc on CentOS 8

asciidoc is Text based document generation

Introduction

In this tutorial we learn how to install asciidoc on CentOS 8.

What is `asciidoc`

AsciiDoc is a text document format for writing short documents, articles, books and UNIX man pages. AsciiDoc files can be translated to HTML and DocBook markups using the asciidoc(1) command.

We can use yum or dnf to install asciidoc on CentOS 8. In this tutorial we discuss both methods but you only need to choose one of method to install asciidoc.

Install asciidoc on CentOS 8 Using dnf

Update yum database with dnf using the following command.

sudo dnf makecache --refresh

The output should look something like this:

CentOS Linux 8 - AppStream                                       43 kB/s | 4.3 kB     00:00    
CentOS Linux 8 - BaseOS                                          65 kB/s | 3.9 kB     00:00    
CentOS Linux 8 - ContinuousRelease                               43 kB/s | 3.0 kB     00:00    
CentOS Linux 8 - Extras                                          23 kB/s | 1.5 kB     00:00    
CentOS Linux 8 - FastTrack                                       40 kB/s | 3.0 kB     00:00    
CentOS Linux 8 - HighAvailability                                36 kB/s | 3.9 kB     00:00    
CentOS Linux 8 - Plus                                            24 kB/s | 1.5 kB     00:00    
CentOS Linux 8 - PowerTools                                      50 kB/s | 4.3 kB     00:00    
Extra Packages for Enterprise Linux Modular 8 - x86_64           13 kB/s | 9.2 kB     00:00    
Extra Packages for Enterprise Linux 8 - x86_64                   24 kB/s | 8.5 kB     00:00    
Metadata cache created.

After updating yum database, We can install asciidoc using dnf by running the following command:

sudo dnf -y install asciidoc

Install asciidoc on CentOS 8 Using yum

Update yum database with yum using the following command.

sudo yum makecache --refresh

The output should look something like this:

CentOS Linux 8 - AppStream                                       43 kB/s | 4.3 kB     00:00    
CentOS Linux 8 - BaseOS                                          65 kB/s | 3.9 kB     00:00    
CentOS Linux 8 - ContinuousRelease                               43 kB/s | 3.0 kB     00:00    
CentOS Linux 8 - Extras                                          23 kB/s | 1.5 kB     00:00    
CentOS Linux 8 - FastTrack                                       40 kB/s | 3.0 kB     00:00    
CentOS Linux 8 - HighAvailability                                36 kB/s | 3.9 kB     00:00    
CentOS Linux 8 - Plus                                            24 kB/s | 1.5 kB     00:00    
CentOS Linux 8 - PowerTools                                      50 kB/s | 4.3 kB     00:00    
Extra Packages for Enterprise Linux Modular 8 - x86_64           13 kB/s | 9.2 kB     00:00    
Extra Packages for Enterprise Linux 8 - x86_64                   24 kB/s | 8.5 kB     00:00    
Metadata cache created.

After updating yum database, We can install asciidoc using yum by running the following command:

sudo yum -y install asciidoc

How To Uninstall asciidoc on CentOS 8

To uninstall only the asciidoc package we can use the following command:

sudo dnf remove asciidoc

asciidoc Package Contents on CentOS 8

/etc/asciidoc
/etc/asciidoc/asciidoc.conf
/etc/asciidoc/dblatex
/etc/asciidoc/docbook-xsl
/etc/asciidoc/docbook45.conf
/etc/asciidoc/filters
/etc/asciidoc/filters/code
/etc/asciidoc/filters/code/code-filter.conf
/etc/asciidoc/filters/code/code-filter.py
/etc/asciidoc/filters/graphviz
/etc/asciidoc/filters/graphviz/graphviz-filter.conf
/etc/asciidoc/filters/graphviz/graphviz2png.py
/etc/asciidoc/filters/source
/etc/asciidoc/filters/source/source-highlight-filter.conf
/etc/asciidoc/help.conf
/etc/asciidoc/html4.conf
/etc/asciidoc/html5.conf
/etc/asciidoc/images
/etc/asciidoc/javascripts
/etc/asciidoc/lang-cs.conf
/etc/asciidoc/lang-de.conf
/etc/asciidoc/lang-el.conf
/etc/asciidoc/lang-en.conf
/etc/asciidoc/lang-es.conf
/etc/asciidoc/lang-fi.conf
/etc/asciidoc/lang-fr.conf
/etc/asciidoc/lang-hu.conf
/etc/asciidoc/lang-id.conf
/etc/asciidoc/lang-it.conf
/etc/asciidoc/lang-ja.conf
/etc/asciidoc/lang-nl.conf
/etc/asciidoc/lang-pl.conf
/etc/asciidoc/lang-pt-BR.conf
/etc/asciidoc/lang-ro.conf
/etc/asciidoc/lang-ru.conf
/etc/asciidoc/lang-sv.conf
/etc/asciidoc/lang-uk.conf
/etc/asciidoc/latex.conf
/etc/asciidoc/slidy.conf
/etc/asciidoc/stylesheets
/etc/asciidoc/text.conf
/etc/asciidoc/themes
/etc/asciidoc/themes/flask
/etc/asciidoc/themes/flask/flask.css
/etc/asciidoc/themes/volnitsky
/etc/asciidoc/themes/volnitsky/volnitsky.css
/etc/asciidoc/xhtml11-quirks.conf
/etc/asciidoc/xhtml11.conf
/usr/bin/a2x
/usr/bin/a2x.py
/usr/bin/asciidoc
/usr/bin/asciidoc.py
/usr/lib/python3.6/site-packages/__pycache__/asciidocapi.cpython-36.opt-1.pyc
/usr/lib/python3.6/site-packages/__pycache__/asciidocapi.cpython-36.pyc
/usr/lib/python3.6/site-packages/asciidocapi.py
/usr/share/asciidoc
/usr/share/asciidoc/dblatex
/usr/share/asciidoc/dblatex/asciidoc-dblatex.sty
/usr/share/asciidoc/dblatex/asciidoc-dblatex.xsl
/usr/share/asciidoc/docbook-xsl
/usr/share/asciidoc/docbook-xsl/chunked.xsl
/usr/share/asciidoc/docbook-xsl/common.xsl
/usr/share/asciidoc/docbook-xsl/epub.xsl
/usr/share/asciidoc/docbook-xsl/fo.xsl
/usr/share/asciidoc/docbook-xsl/htmlhelp.xsl
/usr/share/asciidoc/docbook-xsl/manpage.xsl
/usr/share/asciidoc/docbook-xsl/text.xsl
/usr/share/asciidoc/docbook-xsl/xhtml.xsl
/usr/share/asciidoc/images
/usr/share/asciidoc/images/icons
/usr/share/asciidoc/images/icons/README
/usr/share/asciidoc/images/icons/callouts
/usr/share/asciidoc/images/icons/callouts/1.png
/usr/share/asciidoc/images/icons/callouts/10.png
/usr/share/asciidoc/images/icons/callouts/11.png
/usr/share/asciidoc/images/icons/callouts/12.png
/usr/share/asciidoc/images/icons/callouts/13.png
/usr/share/asciidoc/images/icons/callouts/14.png
/usr/share/asciidoc/images/icons/callouts/15.png
/usr/share/asciidoc/images/icons/callouts/2.png
/usr/share/asciidoc/images/icons/callouts/3.png
/usr/share/asciidoc/images/icons/callouts/4.png
/usr/share/asciidoc/images/icons/callouts/5.png
/usr/share/asciidoc/images/icons/callouts/6.png
/usr/share/asciidoc/images/icons/callouts/7.png
/usr/share/asciidoc/images/icons/callouts/8.png
/usr/share/asciidoc/images/icons/callouts/9.png
/usr/share/asciidoc/images/icons/caution.png
/usr/share/asciidoc/images/icons/example.png
/usr/share/asciidoc/images/icons/home.png
/usr/share/asciidoc/images/icons/important.png
/usr/share/asciidoc/images/icons/next.png
/usr/share/asciidoc/images/icons/note.png
/usr/share/asciidoc/images/icons/prev.png
/usr/share/asciidoc/images/icons/tip.png
/usr/share/asciidoc/images/icons/up.png
/usr/share/asciidoc/images/icons/warning.png
/usr/share/asciidoc/javascripts
/usr/share/asciidoc/javascripts/ASCIIMathML.js
/usr/share/asciidoc/javascripts/LaTeXMathML.js
/usr/share/asciidoc/javascripts/asciidoc.js
/usr/share/asciidoc/javascripts/slidy.js
/usr/share/asciidoc/javascripts/toc.js
/usr/share/asciidoc/stylesheets
/usr/share/asciidoc/stylesheets/asciidoc.css
/usr/share/asciidoc/stylesheets/docbook-xsl.css
/usr/share/asciidoc/stylesheets/pygments.css
/usr/share/asciidoc/stylesheets/slidy.css
/usr/share/asciidoc/stylesheets/toc2.css
/usr/share/asciidoc/stylesheets/xhtml11-quirks.css
/usr/share/doc/asciidoc
/usr/share/doc/asciidoc/COPYING
/usr/share/doc/asciidoc/COPYRIGHT
/usr/share/doc/asciidoc/README.asciidoc
/usr/share/man/man1/a2x.1.gz
/usr/share/man/man1/asciidoc.1.gz
/usr/share/vim/vimfiles/syntax/asciidoc.vim

References

asciidoc website

Summary

In this tutorial we learn how to install asciidoc on CentOS 8 using yum and dnf.