source: general/genutils/asciidoc.xml@ b0134bfa

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b0134bfa was b0134bfa, checked in by Bruce Dubbs <bdubbs@…>, 15 months ago

Update to proftpd-1.3.7a.
Update to Log-Log4perl-1.50 (Perl Module).
Update to asciidoc-9.0.2.
Update to liblinear-240.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23410 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 5.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY asciidoc-download-http "https://github.com/asciidoc/asciidoc-py3/releases/download/&asciidoc-version;/asciidoc-&asciidoc-version;.tar.gz">
8 <!ENTITY asciidoc-download-ftp " ">
9 <!ENTITY asciidoc-md5sum "c93a0cad453540eb94407909e3c673de">
10 <!ENTITY asciidoc-size "1.2 MB">
11 <!ENTITY asciidoc-buildsize "5.0 MB">
12 <!ENTITY asciidoc-time "less than 0.1 SBU">
13]>
14
15<sect1 id="asciidoc" xreflabel="asciidoc-&asciidoc-version;">
16 <?dbhtml filename="asciidoc.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Asciidoc-&asciidoc-version;</title>
24
25 <indexterm zone="asciidoc">
26 <primary sortas="a-asciidoc">asciidoc</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Asciidoc</title>
31
32 <para>
33 The <application>Asciidoc</application> package is a text document
34 format for writing notes, documentation, articles, books, ebooks,
35 slideshows, web pages, man pages and blogs. AsciiDoc files can be
36 translated to many formats including HTML, PDF, EPUB, and man page.
37 </para>
38
39 &lfs91_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&asciidoc-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&asciidoc-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &asciidoc-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &asciidoc-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &asciidoc-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &asciidoc-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">Asciidoc Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Optional (tests and runtime)</bridgehead>
78 <para role="optional">
79 <xref linkend="docbook-xsl"/>,
80 <xref linkend="fop"/>,
81 <xref linkend="libxslt"/>,
82 <xref linkend="lynx"/>,
83 <ulink url="http://sourceforge.net/projects/dblatex/">dblatex</ulink>, and
84 <ulink url="&w3m-url;">W3m</ulink>
85 </para>
86
87 <para condition="html" role="usernotes">User Notes:
88 <ulink url="&blfs-wiki;/asciidoc"/></para>
89
90 </sect2>
91
92 <sect2 role="installation">
93 <title>Installation of Asciidoc</title>
94
95 <para>
96 Install <application>Asciidoc</application> by running
97 the following commands:
98 </para>
99
100<screen><userinput>./configure --prefix=/usr \
101 --sysconfdir=/etc \
102 --docdir=/usr/share/doc/asciidoc-&asciidoc-version; &amp;&amp;
103make</userinput></screen>
104
105 <para>
106 <!--To test the results, issue: <command>make test</command>-->
107 This package does not come with a test suite.
108 </para>
109
110 <para>
111 Now, as the <systemitem class="username">root</systemitem> user:
112 </para>
113
114<screen role="root"><userinput>make install &amp;&amp;
115make docs</userinput></screen>
116
117 </sect2>
118
119 <sect2 role="content">
120 <title>Contents</title>
121
122 <segmentedlist>
123 <segtitle>Installed Programs</segtitle>
124 <segtitle>Installed Libraries</segtitle>
125 <segtitle>Installed Directories</segtitle>
126
127 <seglistitem>
128 <seg>
129 a2x (symlink to a2x.py),
130 a2x.py,
131 asciidoc (symlink to asciidoc.py), and
132 asciidoc.py
133 </seg>
134 <seg>None</seg>
135 <seg>/etc/asciidoc and
136 /usr/share/doc/asciidoc-&asciidoc-version;
137 </seg>
138 </seglistitem>
139 </segmentedlist>
140
141 <variablelist>
142 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
143 <?dbfo list-presentation="list"?>
144 <?dbhtml list-presentation="table"?>
145
146 <varlistentry id="a2x">
147 <term><command>a2x</command></term>
148 <listitem>
149 <para>
150 is a toolchain manager for AsciiDoc
151 (converts Asciidoc text files to other file formats).
152 </para>
153 <indexterm zone="asciidoc a2x">
154 <primary sortas="b-a2x">a2x</primary>
155 </indexterm>
156 </listitem>
157 </varlistentry>
158
159 <varlistentry id="asciidoc-prog">
160 <term><command>asciidoc</command></term>
161 <listitem>
162 <para>
163 converts an AsciiDoc text file to HTML or DocBook
164 </para>
165 <indexterm zone="asciidoc asciidoc-prog">
166 <primary sortas="b-asciidoc-prog">asciidoc</primary>
167 </indexterm>
168 </listitem>
169 </varlistentry>
170
171 </variablelist>
172
173 </sect2>
174
175</sect1>
Note: See TracBrowser for help on using the repository browser.