Beyond Linux® From Scratch (systemd Edition) - Version r12.0-816

Chapter 51. Typesetting

asymptote-2.86

Introduction to asymptote

Asymptote is a powerful descriptive vector graphics language that provides a natural coordinate-based framework for technical drawing. Labels and equations can be typeset with LaTeX. As well as EPS, PDF and PNG output it can produce WebGL 3D HTML rendering and (using dvisvgm) SVG output.

[Note]

Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

Package Information

Additional Downloads

asymptote Dependencies

Required

ghostscript-10.02.1 and texlive-20230313

Recommended

cURL-8.4.0, Freeglut-3.4.0, GC-8.2.4, GLEW-2.2.0, GLM-0.9.9.8 and libtirpc-1.3.4

Recommended at runtime

dvisvgm-3.1.2 to allow svg output

Optional

fftw-3.3.10, Gsl-2.7.1, libsigsegv-2.14, both Boost-1.83.0 and rapidjson to use LSP which can be used with emacs, and eigen

Optional (at runtime)

ImageMagick-7.1.1-15 to convert output to other formats such as JPEG or to create animated GIFs, PyQt5 (not tested, has a build dependency of (Qt-5.15.11 or qt-alternate-5.15.11)) to use xasy.

Editor Notes: https://wiki.linuxfromscratch.org/blfs/wiki/asymptote

Installation of asymptote

[Note]

Note

Certain 3D PDF scripts may not work when invoked from pdflatex on some zen+ amdgpu APU machines.

First apply a patch to fix building without the Language Server Protocol : 

patch -Np1 -i ../asymptote-2.86-build_fix-1.patch

Install asymptote by running the following commands: 

export TEXARCH=$(uname -m | sed -e 's/i.86/i386/' -e 's/$/-linux/') &&

./configure --prefix=$TEXLIVE_PREFIX                          \
            --bindir=$TEXLIVE_PREFIX/bin/$TEXARCH             \
            --datarootdir=$TEXLIVE_PREFIX/texmf-dist          \
            --infodir=$TEXLIVE_PREFIX/texmf-dist/doc/info     \
            --libdir=$TEXLIVE_PREFIX/texmf-dist               \
            --mandir=$TEXLIVE_PREFIX/texmf-dist/doc/man       \
            --disable-lsp                                     \
            --enable-gc=system                                \
            --with-latex=$TEXLIVE_PREFIX/texmf-dist/tex/latex \
            --with-context=$TEXLIVE_PREFIX/texmf-dist/tex/context/third &&

make

To test the results, issue: make check.

Now, as the root user: 

make install

Command Explanations

--prefix=, --bindir=, --datarootdir=, --infodir=, --mandir= ... : these switches ensure that the files installed from source will overwrite any corresponding files previously installed by install-tl-unx so that the alternative methods of installing texlive are consistent.

--libdir=$TEXLIVE_PREFIX/texmf-dist;: This parameter ensures that the asymptote directory will similarly overwrite any files installed by install-tl-unx.

--disable-lsp: The Language Server Protocol is enabled by default, with several third-party sources included, but it does not build unless boost and repidjson have been installed.

--enable-gc=system: this ensures that the system version of libgc.so will be used instead of the version shipped with this package.

--with-latex= ... --with-context=: These switches ensure that style files and a tex file will be installed into the texlive directories instead of creating a texmf-local directory for them.

Contents

Installed Programs: asy, xasy
Installed Libraries: None
Installed Directory: $TEXLIVE_PREFIX/texmf-dist/asymptote, $TEXLIVE_PREFIX/doc/asymptote, $TEXLIVE_PREFIX/info/asymptote

Short Descriptions

asy

is a vector graphics program

xasy

is a Python3 script providing a Qt5 GUI for asy