Difference between revisions of "Asymptote: Macintosh"
m (→Usage: fixed line breaks in tex code) |
(→Installing Asymptote on a Mac/Linux) |
||
Line 8: | Line 8: | ||
|}<noinclude> | |}<noinclude> | ||
− | == Installing Asymptote on a Mac == | + | == Installing Asymptote on a Mac/Linux == |
− | '''This tutorial was tested on Mac OS 10. | + | '''This tutorial was tested on Mac OS 10.15.7 "Catalina," but should work for most older systems as well as other Unix systems''' |
− | Download the Asymptote source [http://sourceforge.net/project/showfiles.php?group_id=120000 here] (at the time of | + | Download the Asymptote source [http://sourceforge.net/project/showfiles.php?group_id=120000 here] (at the time of this edit, it is version 2.68) by selecting the latest version and downloading the asymptote-x.xx.src.tgz file.<br /> |
+ | Download and install [https://www.tug.org/mactex/ MacTeX].<br /> | ||
+ | Note that anywhere you see "x.xx", replace it with the Asymptote version number (e.g. If the file name was asymptote-2.68.src.tgz, you would replace x.xx with 2.68). | ||
− | + | There are two ways to actually install Asymptote: using the AsyIntaller written by PrintrBot, or installing it manually. | |
+ | |||
+ | ===Installing via the AsyInstaller=== | ||
+ | #Download the code from GitHub [https://github.com/Rotorwing/AsyInstaller here] | ||
+ | #Unzip the folder if it was not automatically. | ||
+ | #Double click the asyinstaller file and follow the instructions in the installer. | ||
+ | If all went well, Asymptote should be installed. | ||
+ | <br /> | ||
+ | ===Installing Manually=== | ||
+ | Terminal commands are italicized. | ||
# Open Terminal (located in /Applications/Utilities/Terminal.app) | # Open Terminal (located in /Applications/Utilities/Terminal.app) | ||
− | # Run: ''cd ~/ | + | # Run: ''cd ~/Downloads # or wherever you put the asymptote-x.xx.src.tgz file'' |
# ''tar -xvzf asymptote-x.xx.src.tgz'' | # ''tar -xvzf asymptote-x.xx.src.tgz'' | ||
# ''cd asymptote-x.xx'' | # ''cd asymptote-x.xx'' | ||
− | |||
# ''./configure'' | # ''./configure'' | ||
# ''make all'' | # ''make all'' | ||
Line 27: | Line 37: | ||
You have finished installing Asymptote. | You have finished installing Asymptote. | ||
− | |||
− | |||
== Usage == | == Usage == |
Revision as of 14:58, 24 November 2020
Asymptote (Vector Graphics Language) |
Getting Started - Basics - Reference - Examples - Macros and Packages - Advanced Asymptote - Help |
Contents
[hide]Installing Asymptote on a Mac/Linux
This tutorial was tested on Mac OS 10.15.7 "Catalina," but should work for most older systems as well as other Unix systems
Download the Asymptote source here (at the time of this edit, it is version 2.68) by selecting the latest version and downloading the asymptote-x.xx.src.tgz file.
Download and install MacTeX.
Note that anywhere you see "x.xx", replace it with the Asymptote version number (e.g. If the file name was asymptote-2.68.src.tgz, you would replace x.xx with 2.68).
There are two ways to actually install Asymptote: using the AsyIntaller written by PrintrBot, or installing it manually.
Installing via the AsyInstaller
- Download the code from GitHub here
- Unzip the folder if it was not automatically.
- Double click the asyinstaller file and follow the instructions in the installer.
If all went well, Asymptote should be installed.
Installing Manually
Terminal commands are italicized.
- Open Terminal (located in /Applications/Utilities/Terminal.app)
- Run: cd ~/Downloads # or wherever you put the asymptote-x.xx.src.tgz file
- tar -xvzf asymptote-x.xx.src.tgz
- cd asymptote-x.xx
- ./configure
- make all
- sudo make install
You have finished installing Asymptote.
Usage
Suppose that on the Desktop, you have a file named asyfile.tex
Here is a sample file:
\documentclass[letterpaper,12pt]{article} \usepackage{amsmath} \usepackage{amssymb} \usepackage{asymptote} \begin{document} \begin{asy} size(300); draw((0,0)--(1,1),blue); \end{asy} \end{document}
Use whatever LaTeX editor to compile the file. It will return a warning that looks something like this:
Package asymptote Warning: file asyfile_1.pdf does not exist on input line 17.
Terminal again.
cd ~/Desktop asy asyfile
That will run asymptote on the file asyfile.asy, (created when the tex file was compiled) producing asyfile_1.pdf.
Now run latex on asyfile.tex again, and with any luck, it should compile with no errors. (The image produces a diagonal blue line.)
Automation
This post describes a shell script that automates the compilation process.