source: pst/typesetting/asymptote.xml@ ef289151

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 ef289151 was ef289151, checked in by Ken Moffat <ken@…>, 3 years ago

asymptote-2.61

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22457 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 "38fa6c77881a006c1b5b22f382ac8d8b">
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.4 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 <note>
119 <para>
120 At the moment, there are issues in building <application>dvisvgm</application>.
121 Without that, <command>asy</command> cannot create svg files. The current
122 source, for those who need it, can be found at <ulink url="https://dvisvgm.de/"/>
123 </para>
124 </note>
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><parameter>--libdir=/opt/texlive/&texlive-year;/texmf-dist;</parameter>:
164 This parameter ensures that the <filename class="directory">asymptote</filename>
165 directory will similarly overwrite any files installed by install-tl-unx.</para>
166
167 <para><parameter>--enable-gc=system</parameter>: this ensures that the system
168 version of <filename class="libraryfile">libgc.so</filename> will be used
169 instead of the version shipped with this package.</para>
170
171 <para><parameter>--with-latex= ... --with-context=</parameter>: These switches
172 ensure that style files and a tex file will be installed into the
173 <application>texlive</application> directories instead of creating a
174 <filename class="directory">texmf-local</filename> directory for them.</para>
175
176 <!-- commenting for now: 2.44 installs asymptote.info in both places
177 so the old version no longer remains
178
179 <para>
180 <command>rm -fv /opt/texlive/.../asymptote.info</command>:
181 This deletes the file installed by <application>texlive</application>.
182 Exceptionally, asymptote will create an <filename
183 class="directory">asymptote/</filename> subdirectory for its own
184 <filename>asymptote.info</filename> even though a possibly older
185 version from <xref linkend="texlive"/> is in the main
186 <application>texlive</application>
187 <filename class="directory">info/</filename> directory. Both the
188 new version and the existing <filename>asy-faq.info</filename>
189 <emphasis>will</emphasis> be found by <command>info</command>.
190 </para>-->
191
192 </sect2>
193
194 <sect2 role="content">
195 <title>Contents</title>
196
197 <segmentedlist>
198 <segtitle>Installed Programs</segtitle>
199 <segtitle>Installed Libraries</segtitle>
200 <segtitle>Installed Directory</segtitle>
201
202 <seglistitem>
203 <seg>
204 asy, xasy
205 </seg>
206 <seg>
207 None
208 </seg>
209 <seg>
210 /opt/texlive/&texlive-year;texmf-dist/asymptote,
211 /opt/texlive/&texlive-year;/doc/asymptote,
212 /opt/texlive/&texlive-year;/info/asymptote
213 </seg>
214 </seglistitem>
215 </segmentedlist>
216
217 <variablelist>
218 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
219 <?dbfo list-presentation="list"?>
220 <?dbhtml list-presentation="table"?>
221
222 <varlistentry id="asy">
223 <term><command>asy</command></term>
224 <listitem>
225 <para>
226 is a vector graphics program.
227 </para>
228 <indexterm zone="asymptote asy">
229 <primary sortas="b-asy">asy</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="xasy">
235 <term><command>xasy</command></term>
236 <listitem>
237 <para>
238 is a Python3 script providing a Qt5 GUI for asy.
239 </para>
240 <indexterm zone="asymptote xasy">
241 <primary sortas="b-xasy">xasy</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 </variablelist>
247
248 </sect2>
249
250</sect1>
Note: See TracBrowser for help on using the repository browser.