source: pst/typesetting/asymptote.xml@ 0a727a0

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

asymptote-2.66

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