glfs/general/prog/asciidoc.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY asciidoc-download-http "https://files.pythonhosted.org/packages/source/a/asciidoc/asciidoc-&asciidoc-version;.tar.gz">
  <!ENTITY asciidoc-download-ftp  " ">
  <!ENTITY asciidoc-md5sum        "ecac3af818f7a65596efc6e243b520a0">
  <!ENTITY asciidoc-size          "212 KB">
  <!ENTITY asciidoc-buildsize     "2.6 MB">
  <!ENTITY asciidoc-time          "less than 0.1 SBU">
]>

<!-- Begin Py3c -->
  <sect2 id="asciidoc" xreflabel="asciidoc-&asciidoc-version;">

    <title>Asciidoc-&asciidoc-version;</title>

    <indexterm zone="asciidoc">
      <primary sortas="a-asciidoc">asciidoc</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to Asciidoc Module</title>

      <para>
        The <application>Asciidoc</application> 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.
      </para>

      &lfs112_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&asciidoc-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&asciidoc-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &asciidoc-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &asciidoc-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &asciidoc-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &asciidoc-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">Asciidoc Dependencies</bridgehead>

      <bridgehead renderas="sect5">Optional (runtime)</bridgehead>
      <para role="optional">
        <xref linkend="docbook-xsl"/>,
        <xref linkend="fop"/>,
        <xref linkend="libxslt"/>,
        <xref linkend="lynx"/>,
        <ulink url="https://sourceforge.net/projects/dblatex/">dblatex</ulink>, and
        <ulink url="&w3m-url;">W3m</ulink>
      </para>

    </sect3>

    <sect3 role="installation">
      <title>Installation of Asciidoc</title>
<!-- version 9.x is from blfs 11.0. We are now at 11.1
      <para>
        If you are upgrading from version 9.x, remove the previously installed
        executables, as the <systemitem class="username">root</systemitem>
        user:
      </para>

<screen role="root"><userinput>rm -rf /usr/bin/{asciidoc*,a2x*}</userinput></screen>
-->
    <para> Build the module: </para>

<screen><userinput>pip3 wheel -w dist --no-build-isolation --no-deps $PWD</userinput></screen>

    <para>
      This package does not come with a test suite.
    </para>

    <para>
      Now, as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>pip3 install --no-index --find-links dist --no-cache-dir --no-user asciidoc</userinput></screen>

    </sect3>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
      href="../../xincludes/pip3-cmd-explain.xml"/>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Programs</segtitle>
        <segtitle>Installed Libraries</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>
            a2x and
            asciidoc
          </seg>
          <seg>None</seg>
          <seg>
            /usr/lib/python&python3-majorver;/site-packages/asciidoc and
            /usr/lib/python&python3-majorver;/site-packages/asciidoc-&asciidoc-version;.dist-info
          </seg>
        </seglistitem>
      </segmentedlist>

      <variablelist>
        <bridgehead renderas="sect5">Short Descriptions</bridgehead>
        <?dbfo list-presentation="list"?>
        <?dbhtml list-presentation="table"?>

        <varlistentry id="a2x">
          <term><command>a2x</command></term>
          <listitem>
            <para>
              is a toolchain manager for AsciiDoc
              (converts Asciidoc text files to other file formats)
            </para>
            <indexterm zone="asciidoc a2x">
              <primary sortas="b-a2x">a2x</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <varlistentry id="asciidoc-prog">
          <term><command>asciidoc</command></term>
          <listitem>
            <para>
              converts an AsciiDoc text file to HTML or DocBook
            </para>
            <indexterm zone="asciidoc asciidoc-prog">
              <primary sortas="b-asciidoc-prog">asciidoc</primary>
            </indexterm>
          </listitem>
        </varlistentry>

      </variablelist>

    </sect3>

  </sect2>