Debian Codegraph @

texmf-dist/doc/luatex/blopentype/README.md

raw
1 # blopentype
2 Basic LuaTeX OpenType Manager
3
4 # Description
5
6 In his terse documentation for `PiTeX`, Paul Isambert lists, among the "mandatory PiTeX" files, the following:
7
8 | file name | Description |
9 |-|-|
10 | fonts.ptx | Interface for fonts; relies on the next file. |
11 | fonts.ptxlua | The Lua fontloader; should become independant some day. |
12 | foundry-settings.lua | Default settings for the fontloader. |
13
14 Well: the day has come, and the fontloader has now become `blopentype`: a *Basic LuaTeX OpenType Manager*.
15
16 The basic code is copied almost verbatim from Isambert's `PiTeX`, save the adoption of the canonical filename extensions `tex` for *LuaTeX macros*, `lua` for *LuaTeX scripts*, and `blot-sets.lua` for the basic basic settings.
17 The required dependencies are Isambert packages [texapi](https://ctan.org/pkg/texapi), [YaX](https://ctan.org/pkg/yax) and [Gates](https://ctan.org/pkg/gates), as stated in `DEPENDS.txt`.
18
19 You may find an example of usage in the `blottest.[tex|pdf]` files, and some basic documentation in `blopentype.md`.
20
21 # Bugs and caveats
22
23 The macros are still barely documented, and massively keep the names of their parent (`PiTeX`) package; that may be fixed some day.
24
25 The font database is stored at `$TEXMFLOCAL/texmf/luatex/blotfonts/readable.txt`.
26 It is updated automatically after installing *and using* new fonts, but you may edit it, or else delete/rename(backup) the database by hand, and rerun LuaTeX to rebuild it.
27
28 The character table for each typeface is stored in the `luatex/blotfonts` directory as a flat `lua` file; it would be nice to have it compiled as a `luac/luc` file to save some space, some day.
29
30 Good luck, and happy LuaTeXing
31
32 # Authors
33
34 (C) 2022-2023 Paul Isambert (author) and Luis Rivera (maintainer).
35
36 LaTeX Project Public License, LPPL Version 1.3c 2008-05-04 or MIT License