source: pst/typesetting/asymptote.xml@ 5e61060

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 5e61060 was 5e61060, checked in by Ken Moffat <ken@…>, 6 years ago

Update texlive to 2016, also update xindy to current source. Various cleanups, in particular the perl modules are now mode 644. Explanations brought into same order as the commands (I hope). Tag asymptote and biber. Any users of asymptote on gcc-6.1 systems should consult the wiki pages for install-tl-unx or asymptote (i.e. if from source) as appropriate. E&OE.

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

  • Property mode set to 100644
File size: 7.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-repo;/sourceforge/asymptote/asymptote-&asymptote-version;.src.tgz">
8 <!ENTITY asymptote-download-ftp " ">
9 <!ENTITY asymptote-md5sum "aca55728252777d58ad6eeb2ee550b10">
10 <!ENTITY asymptote-size "3.4 MB">
11 <!ENTITY asymptote-buildsize "164 MB">
12 <!ENTITY asymptote-time "1.7 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.
36 </para>
37
38 &lfs79_checked;&gcc6_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&asymptote-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&asymptote-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &asymptote-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &asymptote-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &asymptote-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &asymptote-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect4">Required</bridgehead>
75 <para role="required">
76 <xref linkend="freeglut"/>,
77 <xref linkend="gs"/>,
78 <xref linkend="texlive"/>
79 </para>
80
81 <bridgehead renderas="sect4">Recommended</bridgehead>
82 <para role="recommended">
83 <xref linkend="gc"/>
84 </para>
85
86 <bridgehead renderas="sect4">Optional</bridgehead>
87 <para role="optional">
88 <ulink url="http://www.fftw.org/">FFTW</ulink>,
89 <xref linkend="gsl"/>
90 </para>
91
92 <bridgehead renderas="sect4">Optional (at runtime, to use xasy)</bridgehead>
93 <para role="optional">
94 <ulink url="http://effbot.org/downloads/Imaging-1.1.7.tar.gz">Imaging</ulink>
95 which needs
96 <!-- hard-coded because I'm not sure if the book scripts will find this and move
97 it to svn/ -->
98 <ulink url="http://www.linuxfromscratch.org/patches/downloads/Imaging/Imaging-1.1.7-freetype_fix-1.patch">Imaging-1.1.7-freetype_fix-1.patch</ulink>
99 and has a build dependency of
100 <xref linkend="python2"/> (re-) compiled against <xref linkend="tk"/>
101 to provide <filename>_tkinter.so</filename>
102 </para>
103
104 <para condition="html" role="usernotes">
105 User Notes: <ulink url="&blfs-wiki;/asymptote"/>
106 </para>
107 </sect2>
108
109 <sect2 role="installation">
110 <title>Installation of asymptote</title>
111
112 <para>
113 Install <application>asymptote</application> by running the following
114 commands:
115 </para>
116
117<screen><userinput>export TEXARCH=$(uname -m | sed -e 's/i.86/i386/' -e 's/$/-linux/') &amp;&amp;
118./configure --prefix=/opt/texlive/&texlive-year; \
119 --bindir=/opt/texlive/&texlive-year;/bin/$TEXARCH \
120 --datarootdir=/opt/texlive/&texlive-year;/texmf-dist \
121 --infodir=/opt/texlive/&texlive-year;/texmf-dist/doc/info \
122 --libdir=/opt/texlive/&texlive-year;/texmf-dist \
123 --mandir=/opt/texlive/&texlive-year;/texmf-dist/doc/man \
124 --enable-gc=system \
125 --with-latex=/opt/texlive/&texlive-year;/texmf-dist/tex/latex \
126 --with-context=/opt/texlive/&texlive-year;/texmf-dist/tex/context/third &amp;&amp;
127make</userinput></screen>
128
129 <para>
130 To test the results, issue: <command>make check</command>.
131 </para>
132
133 <para>
134 Now, as the <systemitem class="username">root</systemitem> user:
135 </para>
136
137<screen role="root"><userinput>make install</userinput></screen>
138
139 </sect2>
140
141 <sect2 role="commands">
142 <title>Command Explanations</title>
143
144 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
145 href="../../xincludes/tex-prefix.xml"/>
146
147 <para>
148 Exceptionally, asymptote will create an <filename
149 class="directory">asymptote/</filename> subdirectory for
150 <filename>asymptote.info</filename> even though the
151 <filename>asy-faq.info</filename> file will be in the main
152 <application>texlive</application>
153 <filename class="directory">info/</filename> directory. Both files
154 <emphasis>will</emphasis> be found by <command>info</command>.
155 </para>
156
157 <para><parameter>--libdir=/opt/texlive/&texlive-year;/texmf-dist;</parameter>:
158 This parameter ensures that the <filename class="directory">asymptote</filename>
159 directory will similarly overwrite any files installed by install-tl-unx.</para>
160
161 <para><parameter>--enable-gc=system</parameter>: this ensures that the system
162 version of <filename class="libraryfile">libgc.so</filename> will be used
163 instead of the version shipped with this package.</para>
164
165 <para><parameter>--with-latex= ... --with-context=</parameter>: These switches
166 ensure that style files and a tex file will be installed into the
167 <application>texlive</application> directories instead of creating a
168 <filename class="directory">texmf-local</filename> directory for them.</para>
169
170 </sect2>
171
172 <sect2 role="content">
173 <title>Contents</title>
174
175 <segmentedlist>
176 <segtitle>Installed Programs</segtitle>
177 <segtitle>Installed Libraries</segtitle>
178 <segtitle>Installed Directory</segtitle>
179
180 <seglistitem>
181 <seg>
182 asy, xasy
183 </seg>
184 <seg>
185 None
186 </seg>
187 <seg>
188 /opt/texlive/&texlive-year;texmf-dist/asymptote,
189 /opt/texlive/&texlive-year;/doc/asymptote,
190 /opt/texlive/&texlive-year;/info/asymptote
191 </seg>
192 </seglistitem>
193 </segmentedlist>
194
195 <variablelist>
196 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
197 <?dbfo list-presentation="list"?>
198 <?dbhtml list-presentation="table"?>
199
200 <varlistentry id="asy">
201 <term><command>asy</command></term>
202 <listitem>
203 <para>
204 is a vector graphics program.
205 </para>
206 <indexterm zone="asymptote asy">
207 <primary sortas="b-asy">asy</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 <varlistentry id="xasy">
213 <term><command>xasy</command></term>
214 <listitem>
215 <para>
216 is a Python script providing the preliminary GUI for asy. It can be
217 used for final adjustments of an existing asy file.
218 </para>
219 <indexterm zone="asymptote xasy">
220 <primary sortas="b-xasy">xasy</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 </variablelist>
226
227 </sect2>
228
229</sect1>
Note: See TracBrowser for help on using the repository browser.