source: pst/typesetting/asymptote.xml@ 8b1ee56

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 8b1ee56 was 8b1ee56, checked in by Ken Moffat <ken@…>, 8 months ago

tags

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

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