source: pst/typesetting/asymptote.xml@ eede1a3

11.0 ken/refactor-virt lazarus qt5new trunk
Last change on this file since eede1a3 was c9aa980, checked in by Xi Ruoyao <xry111@…>, 7 months ago

secure LFS url

  • 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 "b57e685568a7cca69024a86c7276eb6d">
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 "0.9 SBU (using parallelism=4)">
14]>
15
16<sect1 id="asymptote" xreflabel="asymptote-&asymptote-version;">
17 <?dbhtml filename="asymptote.html"?>
18
19 <sect1info>
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 &lfs101_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="sect3">Additional Downloads</bridgehead>
77 <itemizedlist spacing="compact">
78 <listitem>
79 <para>
80 Required patch:
81 <ulink url="&patch-root;/asymptote-&asymptote-version;-ghostscript_fix-1.patch"/>
82 </para>
83 </listitem>
84 </itemizedlist>-->
85
86 <bridgehead renderas="sect3">asymptote Dependencies</bridgehead>
87
88 <bridgehead renderas="sect4">Required</bridgehead>
89 <para role="required">
90 <xref linkend="gs"/> and
91 <xref linkend="texlive"/>
92 </para>
93
94 <bridgehead renderas="sect4">Recommended</bridgehead>
95 <para role="recommended">
96 <xref linkend="curl"/>,
97 <xref linkend="freeglut"/>,
98 <xref linkend="gc"/>,
99 <xref linkend="glew"/>,
100 <xref linkend="glm"/> and
101 <xref linkend="libtirpc"/>
102 </para>
103
104 <bridgehead renderas="sect4">Recommended at runtime</bridgehead>
105 <para role="recommended">
106 <xref role="runtime" linkend="dvisvgm"/>
107 </para>
108
109 <bridgehead renderas="sect4">Optional</bridgehead>
110 <para role="optional">
111 <xref linkend="fftw"/>,
112 <xref linkend="gsl"/>,
113 <xref linkend="libsigsegv"/>
114
115 </para>
116
117 <bridgehead renderas="sect4">Optional (at runtime)</bridgehead>
118 <para role="optional">
119 <xref linkend="imagemagick"/> to convert output to other formats such as
120 JPEG or to create animated GIFs,
121 <ulink url="https://pypi.org/project/PyQt5/">PyQt5</ulink> (not tested,
122 has a build dependency of <xref linkend="qt5"/>) to use xasy.
123 </para>
124
125 <para condition="html" role="usernotes">
126 User Notes: <ulink url="&blfs-wiki;/asymptote"/>
127 </para>
128 </sect2>
129
130 <sect2 role="installation">
131 <title>Installation of asymptote</title>
132
133<!-- Editors: for testing this, the minimal latex functionality is
134 covered by the cylinder and triangle tests in
135 https://www.linuxfromscratch.org/~ken/tex-testfiles/latex-test-20190318.tar.xz
136 but the more interesting stuff (WebM html, svg, png, pdf) is tested in
137 https://www.linuxfromscratch.org/~ken/asy-nontex-testfiles/asy-test-20200123.tar.xz
138-->
139<!--<para>
140 First apply a patch for building with ghostscript-9.53:
141 </para>
142
143<screen><userinput>patch -Np1 -i ../asymptote-&asymptote-version;-ghostscript_fix-1.patch</userinput></screen>-->
144
145 <para>
146 Install <application>asymptote</application> by running the following
147 commands:
148 </para>
149
150<screen><userinput>export TEXARCH=$(uname -m | sed -e 's/i.86/i386/' -e 's/$/-linux/') &amp;&amp;
151
152./configure --prefix=/opt/texlive/&texlive-year; \
153 --bindir=/opt/texlive/&texlive-year;/bin/$TEXARCH \
154 --datarootdir=/opt/texlive/&texlive-year;/texmf-dist \
155 --infodir=/opt/texlive/&texlive-year;/texmf-dist/doc/info \
156 --libdir=/opt/texlive/&texlive-year;/texmf-dist \
157 --mandir=/opt/texlive/&texlive-year;/texmf-dist/doc/man \
158 --enable-gc=system \
159 --with-latex=/opt/texlive/&texlive-year;/texmf-dist/tex/latex \
160 --with-context=/opt/texlive/&texlive-year;/texmf-dist/tex/context/third &amp;&amp;
161
162make</userinput></screen>
163
164 <para>
165 To test the results, issue: <command>make check</command>.
166 </para>
167
168 <para>
169 Now, as the <systemitem class="username">root</systemitem> user:
170 </para>
171
172<screen role="root"><userinput>make install</userinput></screen>
173
174 </sect2>
175
176 <sect2 role="commands">
177 <title>Command Explanations</title>
178
179 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
180 href="../../xincludes/tex-prefix.xml"/>
181
182 <para>
183 <parameter>--libdir=/opt/texlive/&texlive-year;/texmf-dist;</parameter>:
184 This parameter ensures that the <filename
185 class="directory">asymptote</filename> directory will similarly
186 overwrite any files installed by install-tl-unx.
187 </para>
188
189 <para>
190 <parameter>--enable-gc=system</parameter>: this ensures that the system
191 version of <filename class="libraryfile">libgc.so</filename> will be used
192 instead of the version shipped with this package.
193 </para>
194
195 <para>
196 <parameter>--with-latex= ... --with-context=</parameter>: These switches
197 ensure that style files and a tex file will be installed into the
198 <application>texlive</application> directories instead of creating a
199 <filename class="directory">texmf-local</filename> directory for them.
200 </para>
201
202 <!-- commenting for now: 2.44 installs asymptote.info in both places
203 so the old version no longer remains
204
205 <para>
206 <command>rm -fv /opt/texlive/.../asymptote.info</command>:
207 This deletes the file installed by <application>texlive</application>.
208 Exceptionally, asymptote will create an <filename
209 class="directory">asymptote/</filename> subdirectory for its own
210 <filename>asymptote.info</filename> even though a possibly older
211 version from <xref linkend="texlive"/> is in the main
212 <application>texlive</application>
213 <filename class="directory">info/</filename> directory. Both the
214 new version and the existing <filename>asy-faq.info</filename>
215 <emphasis>will</emphasis> be found by <command>info</command>.
216 </para>-->
217
218 </sect2>
219
220 <sect2 role="content">
221 <title>Contents</title>
222
223 <segmentedlist>
224 <segtitle>Installed Programs</segtitle>
225 <segtitle>Installed Libraries</segtitle>
226 <segtitle>Installed Directory</segtitle>
227
228 <seglistitem>
229 <seg>
230 asy, xasy
231 </seg>
232 <seg>
233 None
234 </seg>
235 <seg>
236 /opt/texlive/&texlive-year;texmf-dist/asymptote,
237 /opt/texlive/&texlive-year;/doc/asymptote,
238 /opt/texlive/&texlive-year;/info/asymptote
239 </seg>
240 </seglistitem>
241 </segmentedlist>
242
243 <variablelist>
244 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
245 <?dbfo list-presentation="list"?>
246 <?dbhtml list-presentation="table"?>
247
248 <varlistentry id="asy">
249 <term><command>asy</command></term>
250 <listitem>
251 <para>
252 is a vector graphics program
253 </para>
254 <indexterm zone="asymptote asy">
255 <primary sortas="b-asy">asy</primary>
256 </indexterm>
257 </listitem>
258 </varlistentry>
259
260 <varlistentry id="xasy">
261 <term><command>xasy</command></term>
262 <listitem>
263 <para>
264 is a Python3 script providing a Qt5 GUI for asy
265 </para>
266 <indexterm zone="asymptote xasy">
267 <primary sortas="b-xasy">xasy</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271
272 </variablelist>
273
274 </sect2>
275
276</sect1>
Note: See TracBrowser for help on using the repository browser.