source: general/genutils/asciidoc.xml@ 2c3969a

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 2c3969a was 2c3969a, checked in by Douglas R. Reno <renodr@…>, 16 months ago

Update to Net-DNS-1.25 (Perl Module)
Update to nss-3.54
Update to asciidoc-9.0.1
Update to gtksourceview4-4.6.1

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

  • Property mode set to 100644
File size: 4.9 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 "743b7cf65e7d90a233933926b4759a92">
10 <!ENTITY asciidoc-size "1.2 MB">
11 <!ENTITY asciidoc-buildsize "8.9 MB (with tests)">
12 <!ENTITY asciidoc-time "0.2 SBU (with tests)">
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 </para>
108
109 <para>
110 Now, as the <systemitem class="username">root</systemitem> user:
111 </para>
112
113<screen role="root"><userinput>make install &amp;&amp;
114make docs</userinput></screen>
115
116 </sect2>
117
118 <sect2 role="content">
119 <title>Contents</title>
120
121 <segmentedlist>
122 <segtitle>Installed Programs</segtitle>
123 <segtitle>Installed Libraries</segtitle>
124 <segtitle>Installed Directories</segtitle>
125
126 <seglistitem>
127 <seg>
128 a2x (symlink to a2x.py),
129 a2x.py,
130 asciidoc (symlink to asciidoc.py), and
131 asciidoc.py
132 </seg>
133 <seg>None</seg>
134 <seg>/etc/asciidoc and
135 /usr/share/doc/asciidoc-&asciidoc-version;
136 </seg>
137 </seglistitem>
138 </segmentedlist>
139
140 <variablelist>
141 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
142 <?dbfo list-presentation="list"?>
143 <?dbhtml list-presentation="table"?>
144
145 <varlistentry id="a2x">
146 <term><command>a2x</command></term>
147 <listitem>
148 <para>
149 is a toolchain manager for AsciiDoc
150 (converts Asciidoc text files to other file formats).
151 </para>
152 <indexterm zone="asciidoc a2x">
153 <primary sortas="b-a2x">a2x</primary>
154 </indexterm>
155 </listitem>
156 </varlistentry>
157
158 <varlistentry id="asciidoc-prog">
159 <term><command>asciidoc</command></term>
160 <listitem>
161 <para>
162 converts an AsciiDoc text file to HTML or DocBook
163 </para>
164 <indexterm zone="asciidoc asciidoc-prog">
165 <primary sortas="b-asciidoc-prog">asciidoc</primary>
166 </indexterm>
167 </listitem>
168 </varlistentry>
169
170 </variablelist>
171
172 </sect2>
173
174</sect1>
Note: See TracBrowser for help on using the repository browser.