| 1 |
.TH ALBATROSS 1 "13 February 2024" "v0.5.1" |
| 2 |
. |
| 3 |
.SH NAME |
| 4 |
albatross \- a tool for finding fonts that contain a given (Unicode) glyph. |
| 5 |
. |
| 6 |
.SH SYNOPSIS |
| 7 |
.B albatross |
| 8 |
.RI [ options ] |
| 9 |
.IR glyphs ... |
| 10 |
. |
| 11 |
.SH DESCRIPTION |
| 12 |
\fBalbatross\fP is a command line tool for finding fonts that contain a given |
| 13 |
(Unicode) glyph. |
| 14 |
It relies on Fontconfig, a library for configuring and customizing font |
| 15 |
access. |
| 16 |
.PP |
| 17 |
Albatross takes a list of glyphs as input. |
| 18 |
Three formats are supported: |
| 19 |
.IP #1 |
| 20 |
The glyph itself, e.g., \fBß\fP (Eszett). |
| 21 |
Internally, the tool converts it to the corresponding Unicode code point. |
| 22 |
.IP #2 |
| 23 |
The glyph as a Unicode code point in the hexadecimal notation, |
| 24 |
e.g., \fB0xDF\fP. |
| 25 |
The \fB0x\fP prefix is mandatory. |
| 26 |
Note that the tool takes the value as case insensitive, e.g., |
| 27 |
\fB0xDF\fP is equal to \fB0xdf\fP (or any case combination thereof). |
| 28 |
.IP #3 |
| 29 |
The glyph as a Unicode code point using the multiset union notation, |
| 30 |
e.g, \fBU+DF\fP. |
| 31 |
The \fBU+\fP prefix is mandatory. |
| 32 |
Be mindful that this notation expects an uppercase \fBU\fP. |
| 33 |
. |
| 34 |
.SH OPTIONS |
| 35 |
.IP \fB--show-styles\fP |
| 36 |
Show available font styles |
| 37 |
.IP \fB--detailed\fP |
| 38 |
Show a detailed font list |
| 39 |
.IP "\fB--ansi-level\fP [n|a16|a256|tc]" |
| 40 |
Set the default ANSI level |
| 41 |
.IP "\fB--border-style\fP [0|1|2|3|4|5|6]" |
| 42 |
Set the border style |
| 43 |
.IP \fB--or\fP |
| 44 |
Look for each glyph separately |
| 45 |
.IP \fB--version\fP |
| 46 |
Show the version and exit |
| 47 |
.IP \fB--help\fP |
| 48 |
Show a help message and exit |
| 49 |
. |
| 50 |
.SH BUGS |
| 51 |
Issue tracker at |
| 52 |
.UR https://gitlab.com/islandoftex/albatross/-/issues |
| 53 |
.UE . |