source: pst/typesetting/asymptote.xml@ 20201cb

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 20201cb was 20201cb, checked in by Ken Moffat <ken@…>, 16 months ago

asymptote-2.67

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

  • Property mode set to 100644
File size: 8.3 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 asymptote-download-http "&sourceforge-dl;/asymptote/asymptote-&asymptote-version;.src.tgz">
8 <!ENTITY asymptote-download-ftp " ">
9 <!ENTITY asymptote-md5sum "7961c8ba5afb9563a50f883508428719">
10 <!ENTITY asymptote-size "4.5 MB">
11 <!ENTITY asymptote-buildsize "190 MB (with all the dependencies which are within BLFS)">
12 <!ENTITY asymptote-time "2.4 SBU">
13]>
14
15<sect1 id="asymptote" xreflabel="asymptote-&asymptote-version;">
16 <?dbhtml filename="asymptote.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>asymptote-&asymptote-version;</title>
24
25 <indexterm zone="asymptote">
26 <primary sortas="a-asymptote">asymptote</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to asymptote</title>
31
32 <para>
33 <application>Asymptote</application> is a powerful descriptive vector
34 graphics language that provides a natural coordinate-based framework for
35 technical drawing. Labels and equations can be typeset with LaTeX. As
36 well as EPS, PDF and PNG output it can produce WebGL 3D HTML rendering
37 and (using <application>dvisvgm</application>) SVG output.
38 </para>
39
40 &lfs91_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&asymptote-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&asymptote-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &asymptote-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &asymptote-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &asymptote-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &asymptote-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="gs"/> and
79 <xref linkend="texlive"/>
80 </para>
81
82 <bridgehead renderas="sect4">Recommended</bridgehead>
83 <para role="recommended">
84 <xref linkend="curl"/>,
85 <xref linkend="freeglut"/>,
86 <xref linkend="gc"/>,
87 <xref linkend="glew"/>,
88 <xref linkend="glm"/> and
89 <xref linkend="libtirpc"/>
90 </para>
91
92 <bridgehead renderas="sect4">Recommended at runtime</bridgehead>
93 <para role="recommended">
94 <xref role="runtime" linkend="dvisvgm"/>
95 </para>
96
97 <bridgehead renderas="sect4">Optional</bridgehead>
98 <para role="optional">
99 <xref linkend="fftw"/>,
100 <xref linkend="gsl"/>,
101 <xref linkend="libsigsegv"/>
102
103 </para>
104
105 <bridgehead renderas="sect4">Optional (at runtime)</bridgehead>
106 <para role="optional">
107 <xref linkend="imagemagick"/> to convert output to other formats such as
108 JPEG or to create animated GIFs,
109 <ulink url="https://pypi.org/project/PyQt5/">PyQt5</ulink> (not tested,
110 has a build dependency of <xref linkend="qt5"/>) to use xasy.
111 </para>
112
113 <para condition="html" role="usernotes">
114 User Notes: <ulink url="&blfs-wiki;/asymptote"/>
115 </para>
116 </sect2>
117
118 <sect2 role="installation">
119 <title>Installation of asymptote</title>
120
121<!-- Editors: for testing this, the minimal latex functionality is
122 covered by the cylinder and triangle tests in
123 http://www.linuxfromscratch.org/~ken/tex-testfiles/latex-test-20190318.tar.xz
124 but the more interesting stuff (WebM html, svg, png, pdf) is tested in
125 http://www.linuxfromscratch.org/~ken/asy-nontex-testfiles/asy-test-20200123.tar.xz
126-->
127 <para>
128 Install <application>asymptote</application> by running the following
129 commands:
130 </para>
131
132<screen><userinput>export TEXARCH=$(uname -m | sed -e 's/i.86/i386/' -e 's/$/-linux/') &amp;&amp;
133
134./configure --prefix=/opt/texlive/&texlive-year; \
135 --bindir=/opt/texlive/&texlive-year;/bin/$TEXARCH \
136 --datarootdir=/opt/texlive/&texlive-year;/texmf-dist \
137 --infodir=/opt/texlive/&texlive-year;/texmf-dist/doc/info \
138 --libdir=/opt/texlive/&texlive-year;/texmf-dist \
139 --mandir=/opt/texlive/&texlive-year;/texmf-dist/doc/man \
140 --enable-gc=system \
141 --with-latex=/opt/texlive/&texlive-year;/texmf-dist/tex/latex \
142 --with-context=/opt/texlive/&texlive-year;/texmf-dist/tex/context/third &amp;&amp;
143
144make</userinput></screen>
145
146 <para>
147 To test the results, issue: <command>make check</command>.
148 </para>
149
150 <para>
151 Now, as the <systemitem class="username">root</systemitem> user:
152 </para>
153
154<screen role="root"><userinput>make install</userinput></screen>
155
156 </sect2>
157
158 <sect2 role="commands">
159 <title>Command Explanations</title>
160
161 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
162 href="../../xincludes/tex-prefix.xml"/>
163
164 <para>
165 <parameter>--libdir=/opt/texlive/&texlive-year;/texmf-dist;</parameter>:
166 This parameter ensures that the <filename
167 class="directory">asymptote</filename> directory will similarly
168 overwrite any files installed by install-tl-unx.
169 </para>
170
171 <para>
172 <parameter>--enable-gc=system</parameter>: this ensures that the system
173 version of <filename class="libraryfile">libgc.so</filename> will be used
174 instead of the version shipped with this package.
175 </para>
176
177 <para>
178 <parameter>--with-latex= ... --with-context=</parameter>: These switches
179 ensure that style files and a tex file will be installed into the
180 <application>texlive</application> directories instead of creating a
181 <filename class="directory">texmf-local</filename> directory for them.
182 </para>
183
184 <!-- commenting for now: 2.44 installs asymptote.info in both places
185 so the old version no longer remains
186
187 <para>
188 <command>rm -fv /opt/texlive/.../asymptote.info</command>:
189 This deletes the file installed by <application>texlive</application>.
190 Exceptionally, asymptote will create an <filename
191 class="directory">asymptote/</filename> subdirectory for its own
192 <filename>asymptote.info</filename> even though a possibly older
193 version from <xref linkend="texlive"/> is in the main
194 <application>texlive</application>
195 <filename class="directory">info/</filename> directory. Both the
196 new version and the existing <filename>asy-faq.info</filename>
197 <emphasis>will</emphasis> be found by <command>info</command>.
198 </para>-->
199
200 </sect2>
201
202 <sect2 role="content">
203 <title>Contents</title>
204
205 <segmentedlist>
206 <segtitle>Installed Programs</segtitle>
207 <segtitle>Installed Libraries</segtitle>
208 <segtitle>Installed Directory</segtitle>
209
210 <seglistitem>
211 <seg>
212 asy, xasy
213 </seg>
214 <seg>
215 None
216 </seg>
217 <seg>
218 /opt/texlive/&texlive-year;texmf-dist/asymptote,
219 /opt/texlive/&texlive-year;/doc/asymptote,
220 /opt/texlive/&texlive-year;/info/asymptote
221 </seg>
222 </seglistitem>
223 </segmentedlist>
224
225 <variablelist>
226 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
227 <?dbfo list-presentation="list"?>
228 <?dbhtml list-presentation="table"?>
229
230 <varlistentry id="asy">
231 <term><command>asy</command></term>
232 <listitem>
233 <para>
234 is a vector graphics program.
235 </para>
236 <indexterm zone="asymptote asy">
237 <primary sortas="b-asy">asy</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="xasy">
243 <term><command>xasy</command></term>
244 <listitem>
245 <para>
246 is a Python3 script providing a Qt5 GUI for asy.
247 </para>
248 <indexterm zone="asymptote xasy">
249 <primary sortas="b-xasy">xasy</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 </variablelist>
255
256 </sect2>
257
258</sect1>
Note: See TracBrowser for help on using the repository browser.