source: pst/typesetting/asymptote.xml@ 462dd67

10.0 10.1 11.0 11.1 9.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 462dd67 was e99822d, checked in by Ken Moffat <ken@…>, 3 years ago

Asymptote-2.62.

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

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