source: general/genutils/asciidoc.xml@ f2d585bd

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

Update to glib-2.66.7
Update to WebKitGTK+-2.30.5
Update to asciidoc-9.1.0
Update to xterm-366 (Security Update)
Fix a crash in bluez when using A2DP-based bluetooth devices
Belatedly mark Jinja2 as a security update

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

  • Property mode set to 100644
File size: 5.2 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 "6b0700c602a926325d71f7681dde5c6e">
10 <!ENTITY asciidoc-size "1.2 MB">
11 <!ENTITY asciidoc-buildsize "8.6 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 &lfs10_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 First, fix a build problem if the optional dependencies are not installed:
97 </para>
98
99<screen><userinput remap='pre'>sed -i 's:doc/testasciidoc.1::' Makefile.in &amp;&amp;
100rm doc/testasciidoc.1.txt</userinput></screen>
101
102 <para>
103 Install <application>Asciidoc</application> by running
104 the following commands:
105 </para>
106
107<screen><userinput>./configure --prefix=/usr \
108 --sysconfdir=/etc \
109 --docdir=/usr/share/doc/asciidoc-&asciidoc-version; &amp;&amp;
110make</userinput></screen>
111
112 <para>
113 <!--To test the results, issue: <command>make test</command>-->
114 This package does not come with a test suite.
115 </para>
116
117 <para>
118 Now, as the <systemitem class="username">root</systemitem> user:
119 </para>
120
121<screen role="root"><userinput>make install &amp;&amp;
122make docs</userinput></screen>
123
124 </sect2>
125
126 <sect2 role="content">
127 <title>Contents</title>
128
129 <segmentedlist>
130 <segtitle>Installed Programs</segtitle>
131 <segtitle>Installed Libraries</segtitle>
132 <segtitle>Installed Directories</segtitle>
133
134 <seglistitem>
135 <seg>
136 a2x (symlink to a2x.py),
137 a2x.py,
138 asciidoc (symlink to asciidoc.py), and
139 asciidoc.py
140 </seg>
141 <seg>None</seg>
142 <seg>/etc/asciidoc and
143 /usr/share/doc/asciidoc-&asciidoc-version;
144 </seg>
145 </seglistitem>
146 </segmentedlist>
147
148 <variablelist>
149 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
150 <?dbfo list-presentation="list"?>
151 <?dbhtml list-presentation="table"?>
152
153 <varlistentry id="a2x">
154 <term><command>a2x</command></term>
155 <listitem>
156 <para>
157 is a toolchain manager for AsciiDoc
158 (converts Asciidoc text files to other file formats).
159 </para>
160 <indexterm zone="asciidoc a2x">
161 <primary sortas="b-a2x">a2x</primary>
162 </indexterm>
163 </listitem>
164 </varlistentry>
165
166 <varlistentry id="asciidoc-prog">
167 <term><command>asciidoc</command></term>
168 <listitem>
169 <para>
170 converts an AsciiDoc text file to HTML or DocBook
171 </para>
172 <indexterm zone="asciidoc asciidoc-prog">
173 <primary sortas="b-asciidoc-prog">asciidoc</primary>
174 </indexterm>
175 </listitem>
176 </varlistentry>
177
178 </variablelist>
179
180 </sect2>
181
182</sect1>
Note: See TracBrowser for help on using the repository browser.