Summary of SATySFi
SATySFi (pronounced in the same way as the verb “satisfy” in English) is a new typesetting system equipped with a statically-typed, functional programming language. It consists mainly of two “layers” ― the text layer and the program layer. The former is for writing documents in LaTeX-like syntax. The latter, which has OCaml-like syntax, is for defining functions and commands. SATySFi enables you to write documents markuped with flexible commands of your own making. In addition, its informative type error reporting will be a good help to your writing.
This software was supported by:
- IPA Mitou Project 2017 (June 2017 – February 2018; see the abstract here written in Japanese),
- Dwango Co., Ltd. (October 2018 – March 2019; as a part-time job), and
- many anonymous supporters who bought The SATySFibook,
and its development continues to this day (February 2021).
Install using Satyrographos (for non-devs)
You can install SATySFi with package manager Satyrographos.
# For Ubuntu 20.04 sudo apt-get update sudo apt-get install build-essential git m4 unzip curl pkg-config sh <(curl -sL https://raw.githubusercontent.com/ocaml/opam/master/shell/install.sh) # For Mac # Please make sure homebrew is installed. Otherwise, follow https://brew.sh/ brew update brew install opam # Common: Set up OPAM opam init eval $(opam env) opam repository add satysfi-external https://github.com/gfngfn/satysfi-external-repo.git opam repository add satyrographos https://github.com/na4zagin3/satyrographos-repo.git opam update # Common: Install SATySFi opam depext satysfi satysfi-dist satyrographos opam install satysfi satysfi-dist satyrographos # Common: Set up the SATySFi standard library satyrographos install
Install using OPAM
Here is a list of minimally required softwares.
- wget or curl
- opam 2
- See https://opam.ocaml.org/doc/Install.html.
- On Windows, Windows Subsystem for Linux (WSL) 2 is recommended to avoid bubblewrap-related issues.
- ocaml 4.10.0 (installed by OPAM)
Also, we must add an external OPAM repo to build. This can be done by the following command.
opam repository add satysfi-external https://github.com/gfngfn/satysfi-external-repo.git opam update
sudo apt-get update sudo apt-get install build-essential git m4 unzip curl sh <(curl -sL https://raw.githubusercontent.com/ocaml/opam/master/shell/install.sh) # The following command will ask if you allow OPAM to modify some files (e.g. ~/.bash_profile). # Be sure to read its instructions. Otherwise, some environment variables won't be set. opam init --comp 4.10.0 eval $(opam env) opam repository add satysfi-external https://github.com/gfngfn/satysfi-external-repo.git opam update
Example (OS X Mavericks or later)
# Before running this scripts, install essential softwares such as GCC and Make. They can be installed from Xcode Command Line Tools. # Also, install Homebrew. brew update brew install opam # The following command will ask if OPAM modifies some files. # Be sure to read their instructions. Otherwise, some environment variables won't be set. opam init --comp 4.10.0 eval $(opam env) opam repository add satysfi-external https://github.com/gfngfn/satysfi-external-repo.git opam update
First, clone this repository and submodules. Then build SATySFi using OPAM.
# clone git clone https://github.com/gfngfn/SATySFi.git cd SATySFi # build opam pin add satysfi . opam install satysfi
- To reinstall, run
opam reinstall satysfi.
- To uninstall, run
opam uninstall satysfi.
Setup for SATySFi
Before using SATySFi, one should put libraries and fonts onto the appropriate directory. This can be done by invoking the following commands in order:
The former downloads the fonts required by the default settings into
lib-satysfi/dist/fonts/, and the latter copies
During this setup, the following fonts are downloaded. Consult their license before using them.
Usage of SATySFi
satysfi <input file> -o <output file>
in order to convert
<input file> into
<output file>. For example, when you want to convert
output.pdf, the following command will work:
satysfi doc.saty -o output.pdf
First of all, let’s try to compile the demo file. It is in
demo folder. Because this demo file has
MakeFile, All you should do is only type
cd demo make
demo.pdf is created, then the setup has been finished correctly.
In addition, a concice reference of SATySFi is written by SATySFi itself in
doc folder. You need to compile it to read.
cd doc make
--version: Prints the version.
--output: Specify the name of the output PDF file. if this option is not given explicitly, the name of the output file is the concatenation of the base name of the input file and the extension
--bytecomp: Use byte compiler and enhance performance of computation.
--full-path: Displays file names with their absolute path when outputting them to stdout.
--type-check-only: Stops after type checking.
--debug-show-bbox: Outputs bounding boxes for each glyph (for the purpose of debugging).
--debug-show-space: Outputs boxes for spaces (for the purpose of debugging).
Wiki (currently written only in Japanese) has some information about learning SATySFi.