diff options
author | Karl Berry <karl@freefriends.org> | 2023-06-30 20:51:48 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2023-06-30 20:51:48 +0000 |
commit | 1ac7cb6b83a70441b3a878626b3fad127987740e (patch) | |
tree | eeda546f2d6be680e0abfb4cbdf32ceedbd4b609 /Master/texmf-dist/doc | |
parent | 4f781dbd163d1420e48aa24bf2967ba2eee0af03 (diff) |
blopentype (30jun23)
git-svn-id: svn://tug.org/texlive/trunk@67517 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/luatex/blopentype/LICENSE | 21 | ||||
-rw-r--r-- | Master/texmf-dist/doc/luatex/blopentype/README.md | 15 | ||||
-rw-r--r-- | Master/texmf-dist/doc/luatex/blopentype/blopentype.md | 36 |
3 files changed, 54 insertions, 18 deletions
diff --git a/Master/texmf-dist/doc/luatex/blopentype/LICENSE b/Master/texmf-dist/doc/luatex/blopentype/LICENSE new file mode 100644 index 00000000000..bfed4c5d960 --- /dev/null +++ b/Master/texmf-dist/doc/luatex/blopentype/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2022 Luis Rivera + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/Master/texmf-dist/doc/luatex/blopentype/README.md b/Master/texmf-dist/doc/luatex/blopentype/README.md index 4a0a3930f26..c93988bad15 100644 --- a/Master/texmf-dist/doc/luatex/blopentype/README.md +++ b/Master/texmf-dist/doc/luatex/blopentype/README.md @@ -1,5 +1,5 @@ # blopentype -Basic LuaTeX OpenType Handler +Basic LuaTeX OpenType Manager # Description @@ -11,9 +11,9 @@ In his terse documentation for `PiTeX`, Paul Isambert lists, among the "mandator | fonts.ptxlua | The Lua fontloader; should become independant some day. | | foundry-settings.lua | Default settings for the fontloader. | -Well: the day has come, and the fontloader has now become `blopentype`: a *Basic LuaTeX OpenType Handler*. +Well: the day has come, and the fontloader has now become `blopentype`: a *Basic LuaTeX OpenType Manager*. -The basic code is copied almost verbatim from Isambert's `PiTeX`, save the adoption of the filename extensions `ltm` for *LuaTeX macros*, `lts` for *LuaTeX scripts*, and `blot-sets.lua` for the basic basic settings. +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. 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`. You may find an example of usage in the `blottest.[tex|pdf]` files, and some basic documentation in `blopentype.md`. @@ -22,16 +22,17 @@ You may find an example of usage in the `blottest.[tex|pdf]` files, and some bas The macros are still barely documented, and massively keep the names of their parent (`PiTeX`) package; that may be fixed some day. -The font database is loaded at `$HOME/texmf/luatex/foundry/readable.txt`; it is not updated automatically after installing new fonts: you have to edit it manually, or else delete/rename(backup) it and rerun LuaTeX to rebuild it. +The font database is stored at `$TEXMFLOCAL/texmf/luatex/blotfonts/readable.txt`. +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. -The character table for each typeface is stored in the `luatex/foundry` directory as a flat `lua` file; it would be nice to have it compiled as a `luac` file to save some space. +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. Good luck, and happy LuaTeXing # Authors -Version 0.0.0 (C) 2022 Paul Isambert (massively) and Luis Rivera (minor surgeon; or rather: kludger). +Version 0.0.2 (C) 2023 Paul Isambert (author) and Luis Rivera (maintainer). LaTeX Project Public License, LPPL Version 1.3c 2008-05-04 or MIT License -December 28, 2022
\ No newline at end of file +June 29, 2023 diff --git a/Master/texmf-dist/doc/luatex/blopentype/blopentype.md b/Master/texmf-dist/doc/luatex/blopentype/blopentype.md index a42d55ec489..651f57f2815 100644 --- a/Master/texmf-dist/doc/luatex/blopentype/blopentype.md +++ b/Master/texmf-dist/doc/luatex/blopentype/blopentype.md @@ -1,24 +1,38 @@ -# Basic LuaTeX OpenType Handler Minimal User Guide +# Basic LuaTeX OpenType Manager Minimal User Guide -As for version 0.0.0 December 2022 +As of version 0.0.1 May 2023 -Fonts (fonts.ltm and fonts.lts) -================================== +Loading the macros +================== + +This is a Plain TeX macro package, so simply type + +``` +\input blot +``` + +and you are halfway through: there are font parameter defaults, but no font is loaded +automatically, since it must depend on your system; so you have to load fonts +on your own. + +Fonts +===== The fontloader uses gates, but only superficially. They won't be documented here. To load a given font, you define it in YaX syntax with the `\setfont` command. +Thus, the instruction: -```\setfont <command>:<attributes>``` +```\setfont <fontcommand>:<attributes>``` -Sets <command> to call the font described in <attributes>; all defaults -to the values of the `metafont` parameter. If `<command>` is `\mainfont`, -as the name of the main font for the document, the font is called at once; -any other `\command` requires explicit calls. +sets <fontcommand> to call the font described in <attributes>; all new fonts default +to the values of the `metafont` parameter described elsewhere. +If `<fontcommand>` is `\mainfont`, the font is called at once; +any other `\fontcommand` requires an explicit call. -You may thing of `\setfont <command>` as similar to DEKTeX's `\font\cmr10 at 12pt` -or whatever font definition, but now the call is to an array of font attributes. +You may thing of `\setfont <fontcommand>` as similar to DEKTeX's `\font<fontcommand> <parameters>`, +but now the call is to an array of font attributes, enumerated below. `name` The family name of the font; e.g. Palatino Linotype for the main text of |