source: pst/typesetting/asymptote.xml

trunk
Last change on this file was 8a2cb97, checked in by Douglas R. Reno <renodr@…>, 5 weeks ago

Tag GNOME Applications and dependencies

  • Property mode set to 100644
File size: 9.6 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 "1e88e480a0e0f1b24274d1eedd644f9b">
10 <!ENTITY asymptote-size "14 MB">
11 <!ENTITY asymptote-buildsize "222 MB (55 MB installed,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.3 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 &lfs112_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;-upstream_fixes-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 both <xref linkend="boost"/> and
115 <ulink url="https://github.com/Tencent/rapidjson/releases/">rapidjson</ulink>
116 to use
117 <ulink url="https://microsoft.github.io/language-server-protocol/implementors/tools/">LSP</ulink>
118 which can be used with
119 <ulink url="https://asymptote.sourceforge.io/doc/Language-server-protocol.html#index-LSP/">emacs</ulink>,
120 and <ulink url="https://eigen.tuxfamily.org/">eigen</ulink>
121 </para>
122
123 <bridgehead renderas="sect4">Optional (at runtime)</bridgehead>
124 <para role="optional">
125 <xref linkend="imagemagick"/> to convert output to other formats such as
126 JPEG or to create animated GIFs,
127 <ulink url="https://pypi.org/project/PyQt5/">PyQt5</ulink> (not tested,
128 has a build dependency of <xref linkend="qt5"/>) to use xasy.
129 </para>
130
131 <para condition="html" role="usernotes">
132 User Notes: <ulink url="&blfs-wiki;/asymptote"/>
133 </para>
134 </sect2>
135
136 <sect2 role="installation">
137 <title>Installation of asymptote</title>
138
139<!-- Editors: for testing this, the minimal latex functionality is
140 covered by the cylinder and triangle tests in
141 https://www.linuxfromscratch.org/~ken/tex-testfiles/latex-test-20220322.tar.xz
142 but the more interesting stuff (WebM html, svg, png, pdf) is tested in
143 https://www.linuxfromscratch.org/~ken/asy-nontex-testfiles/asy-test-20200809.tar.xz
144-->
145<!--<para>
146 First apply a patch to fix runtime issues on some machines:
147 </para>
148
149<screen><userinput>patch -Np1 -i ../asymptote-&asymptote-version;-upstream_fixes-1.patch</userinput></screen>-->
150
151 <para>
152 Install <application>asymptote</application> by running the following
153 commands:
154 </para>
155
156<screen><userinput>export TEXARCH=$(uname -m | sed -e 's/i.86/i386/' -e 's/$/-linux/') &amp;&amp;
157
158./configure --prefix=$TEXLIVE_PREFIX \
159 --bindir=$TEXLIVE_PREFIX/bin/$TEXARCH \
160 --datarootdir=$TEXLIVE_PREFIX/texmf-dist \
161 --infodir=$TEXLIVE_PREFIX/texmf-dist/doc/info \
162 --libdir=$TEXLIVE_PREFIX/texmf-dist \
163 --mandir=$TEXLIVE_PREFIX/texmf-dist/doc/man \
164 --disable-lsp \
165 --enable-gc=system \
166 --with-latex=$TEXLIVE_PREFIX/texmf-dist/tex/latex \
167 --with-context=$TEXLIVE_PREFIX/texmf-dist/tex/context/third &amp;&amp;
168
169make</userinput></screen>
170
171 <para>
172 To test the results, issue: <command>make check</command>.
173 </para>
174
175 <para>
176 Now, as the <systemitem class="username">root</systemitem> user:
177 </para>
178
179<screen role="root"><userinput>make install</userinput></screen>
180
181 </sect2>
182
183 <sect2 role="commands">
184 <title>Command Explanations</title>
185
186 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
187 href="../../xincludes/tex-prefix.xml"/>
188
189 <para>
190 <parameter>--libdir=$TEXLIVE_PREFIX/texmf-dist;</parameter>:
191 This parameter ensures that the <filename
192 class="directory">asymptote</filename> directory will similarly
193 overwrite any files installed by install-tl-unx.
194 </para>
195
196 <para>
197 <parameter>--disable-lsp</parameter>: The Language Server Protocol is
198 enabled by default, with several third-party sources included, but it
199 does not build unless boost and repidjson have been installed.
200 </para>
201
202 <para>
203 <parameter>--enable-gc=system</parameter>: this ensures that the system
204 version of <filename class="libraryfile">libgc.so</filename> will be used
205 instead of the version shipped with this package.
206 </para>
207
208 <para>
209 <parameter>--with-latex= ... --with-context=</parameter>: These switches
210 ensure that style files and a tex file will be installed into the
211 <application>texlive</application> directories instead of creating a
212 <filename class="directory">texmf-local</filename> directory for them.
213 </para>
214
215 <!-- commenting for now: 2.44 installs asymptote.info in both places
216 so the old version no longer remains
217
218 <para>
219 <command>rm -fv /opt/texlive/.../asymptote.info</command>:
220 This deletes the file installed by <application>texlive</application>.
221 Exceptionally, asymptote will create an <filename
222 class="directory">asymptote/</filename> subdirectory for its own
223 <filename>asymptote.info</filename> even though a possibly older
224 version from <xref linkend="texlive"/> is in the main
225 <application>texlive</application>
226 <filename class="directory">info/</filename> directory. Both the
227 new version and the existing <filename>asy-faq.info</filename>
228 <emphasis>will</emphasis> be found by <command>info</command>.
229 </para>-->
230
231 </sect2>
232
233 <sect2 role="content">
234 <title>Contents</title>
235
236 <segmentedlist>
237 <segtitle>Installed Programs</segtitle>
238 <segtitle>Installed Libraries</segtitle>
239 <segtitle>Installed Directory</segtitle>
240
241 <seglistitem>
242 <seg>
243 asy, xasy
244 </seg>
245 <seg>
246 None
247 </seg>
248 <seg>
249 $TEXLIVE_PREFIX/texmf-dist/asymptote,
250 $TEXLIVE_PREFIX/doc/asymptote,
251 $TEXLIVE_PREFIX/info/asymptote
252 </seg>
253 </seglistitem>
254 </segmentedlist>
255
256 <variablelist>
257 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
258 <?dbfo list-presentation="list"?>
259 <?dbhtml list-presentation="table"?>
260
261 <varlistentry id="asy">
262 <term><command>asy</command></term>
263 <listitem>
264 <para>
265 is a vector graphics program
266 </para>
267 <indexterm zone="asymptote asy">
268 <primary sortas="b-asy">asy</primary>
269 </indexterm>
270 </listitem>
271 </varlistentry>
272
273 <varlistentry id="xasy">
274 <term><command>xasy</command></term>
275 <listitem>
276 <para>
277 is a Python3 script providing a Qt5 GUI for asy
278 </para>
279 <indexterm zone="asymptote xasy">
280 <primary sortas="b-xasy">xasy</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 </variablelist>
286
287 </sect2>
288
289</sect1>
Note: See TracBrowser for help on using the repository browser.