glfs/general/genutils/asciidoc.xml
Bruce Dubbs 998a0e06c9 Update to 264-snapshot-20160827-2245-stable.
Update to LVM2.2.02.164. 
Tags fo r all lof xfce and various other packages



git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17689 af4574ff-66df-0310-9fd7-8a98e5e911e0
2016-08-29 18:02:18 +00:00

145 lines
4.4 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 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 "http://sourceforge.net/projects/asciidoc/files/asciidoc/&asciidoc-version;/asciidoc-&asciidoc-version;.tar.gz">
<!ENTITY asciidoc-download-ftp " ">
<!ENTITY asciidoc-md5sum "c59018f105be8d022714b826b0be130a">
<!ENTITY asciidoc-size "888 KB">
<!ENTITY asciidoc-buildsize "3.9 MB">
<!ENTITY asciidoc-time "less than 0.1 SBU">
]>
<sect1 id="asciidoc" xreflabel="asciidoc-&asciidoc-version;">
<?dbhtml filename="asciidoc.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>Asciidoc-&asciidoc-version;</title>
<indexterm zone="asciidoc">
<primary sortas="a-asciidoc">asciidoc</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Asciidoc</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>
&lfs7a_checked;
<bridgehead renderas="sect3">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="sect3">Asciidoc Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="python2"/> or
<xref linkend="python3"/>
</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/asciidoc"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Asciidoc</title>
<para>Install <application>Asciidoc</application> by running
the following commands:</para>
<screen><userinput>./configure --prefix=/usr \
--sysconfdir=/etc \
--docdir=/usr/share/doc/asciidoc-&asciidoc-version; &amp;&amp;
make</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>make install &amp;&amp;
make docs</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
a2x (symlink to a2x.py),
a2x.py,
asciidoc (symlink to asciidoc.py), and
asciidoc.py
</seg>
<seg>None</seg>
<seg>/etc/asciidoc</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">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>
</sect2>
</sect1>