summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/luatex/blopentype
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-01-02 21:31:04 +0000
committerKarl Berry <karl@freefriends.org>2023-01-02 21:31:04 +0000
commitb9587c576db3679c338a1d395c182023ff4d711c (patch)
treed36ea573074a6c7d740f15e323b5ec7720e976bc /Master/texmf-dist/doc/luatex/blopentype
parent7bde2bb3891ad0c87d05ad80fabb4258dc5b84fb (diff)
blopentype (2jan23)
git-svn-id: svn://tug.org/texlive/trunk@65441 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/luatex/blopentype')
-rw-r--r--Master/texmf-dist/doc/luatex/blopentype/DEPENDS.txt4
-rw-r--r--Master/texmf-dist/doc/luatex/blopentype/README.md37
-rw-r--r--Master/texmf-dist/doc/luatex/blopentype/blopentype.md142
-rw-r--r--Master/texmf-dist/doc/luatex/blopentype/blottest.pdfbin0 -> 144031 bytes
-rw-r--r--Master/texmf-dist/doc/luatex/blopentype/blottest.tex82
5 files changed, 265 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/luatex/blopentype/DEPENDS.txt b/Master/texmf-dist/doc/luatex/blopentype/DEPENDS.txt
new file mode 100644
index 00000000000..46b92da95be
--- /dev/null
+++ b/Master/texmf-dist/doc/luatex/blopentype/DEPENDS.txt
@@ -0,0 +1,4 @@
+# Basic LuaTeX OpenType handler dependencies
+texapi
+yax
+gates
diff --git a/Master/texmf-dist/doc/luatex/blopentype/README.md b/Master/texmf-dist/doc/luatex/blopentype/README.md
new file mode 100644
index 00000000000..4a0a3930f26
--- /dev/null
+++ b/Master/texmf-dist/doc/luatex/blopentype/README.md
@@ -0,0 +1,37 @@
+# blopentype
+Basic LuaTeX OpenType Handler
+
+# Description
+
+In his terse documentation for `PiTeX`, Paul Isambert lists, among the "mandatory PiTeX" files, the following:
+
+| file name | Description |
+|-|-|
+| fonts.ptx | Interface for fonts; relies on the next file. |
+| 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*.
+
+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 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`.
+
+# Bugs and caveats
+
+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 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.
+
+Good luck, and happy LuaTeXing
+
+# Authors
+
+Version 0.0.0 (C) 2022 Paul Isambert (massively) and Luis Rivera (minor surgeon; or rather: kludger).
+
+LaTeX Project Public License, LPPL Version 1.3c 2008-05-04 or MIT License
+
+December 28, 2022 \ No newline at end of file
diff --git a/Master/texmf-dist/doc/luatex/blopentype/blopentype.md b/Master/texmf-dist/doc/luatex/blopentype/blopentype.md
new file mode 100644
index 00000000000..a42d55ec489
--- /dev/null
+++ b/Master/texmf-dist/doc/luatex/blopentype/blopentype.md
@@ -0,0 +1,142 @@
+# Basic LuaTeX OpenType Handler Minimal User Guide
+
+As for version 0.0.0 December 2022
+
+Fonts (fonts.ltm and fonts.lts)
+==================================
+
+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.
+
+```\setfont <command>:<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.
+
+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.
+
+`name`
+The family name of the font; e.g. Palatino Linotype for the main text of
+this document.
+
+`size (dimension)`
+The size of the font.
+
+`small (dimension)`
+The size of the font when \small is called. Can be a relative value by
+prefixing it with "-" or "+", in which case it is set relative to ?size.
+
+`verysmall (dimension)`
+The size (possibly relative) for \verysmall.
+
+`big (dimension)`
+The size (possibly relative) for \big.
+
+`verybig (dimension)`
+The size (possibly relative) for \verybig.
+
+`bold (font modifier)`
+The modifier used for the bold version of the font, without the leading slash;
+!metafont sets it to "Bold".
+
+`italic (font modifier)`
+Same as !bold for the italic version; set to "Italic" by !metafont.
+
+`math (true or false)`
+If true, math fonts will be created.
+
+`features`
+Well, err, font features...
+
+`slant (angle)`
+The slant applied to the font to create a fake italic.
+
+`slantsc (angle)`
+The slant applied to the font to create fake italic smallcaps; if not
+given, defaults to ?slant.
+
+There's actually much more going under the hood, but "font.ptxlua" (the
+font loader itself) is a work in progress, and undocumented.
+
+# Font change commands
+
+The same macros as in plain TeX can be used, except they're cumulative,
+i.e. "\it\bf" switches to a bold italic.
+`<text>` in the specification should be group delimited with braces.
+
+`\it`
+Switches to italics.
+
+`\rm`
+Switches to roman.
+
+`\bf`
+Switches to bold.
+
+`\rg`
+Switches to regular weight.
+
+`\sc`
+Switches to small capitals.
+
+`\lc`
+Switches to lower case (i.e. not small caps).
+
+`\ital <text>`
+Typesets <text> in italics.
+
+`\bold <text>`
+Typesets <text> in bold.
+
+`\scap <text>`
+Typesets <text> in small caps.
+
+`\rom <text>`
+Typesets <text> in roman.
+
+`\emph <text>`
+Typesets <text> in italics or roman, depending on whether the current
+font is roman or italics, respectively.
+
+`\underline <text>`
+Underlines <text>. Wow.
+
+`\small`
+Switches to small font.
+
+`\verysmall`
+Switches to very small font.
+
+`\big`
+Switches to big font.
+
+`\verybig`
+Got it?
+
+`\normalsize`
+Switches to default size.
+
+`\smaller`
+Switches to the font smaller than the current one (e.g. \normalsize if
+you're currently using \big).
+
+`\bigger`
+Same as \smaller, the other way around.
+
+`\color <color><text>`
+Typesets <text> with <color>, which should be a triplet "R G B" with
+each value between 0 and 1.
+
+# See also
+
+Documentation for [YaX](https://ctan.org/pkg/yax) for the YaX syntax to set up the fonts.
+
+Good luck and happy LuaTeXing,
+
+Luis Rivera
+
diff --git a/Master/texmf-dist/doc/luatex/blopentype/blottest.pdf b/Master/texmf-dist/doc/luatex/blopentype/blottest.pdf
new file mode 100644
index 00000000000..d5d3f2d9040
--- /dev/null
+++ b/Master/texmf-dist/doc/luatex/blopentype/blottest.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/luatex/blopentype/blottest.tex b/Master/texmf-dist/doc/luatex/blopentype/blottest.tex
new file mode 100644
index 00000000000..83d93d5547e
--- /dev/null
+++ b/Master/texmf-dist/doc/luatex/blopentype/blottest.tex
@@ -0,0 +1,82 @@
+\input blot
+\pdfpageheight 12 true in
+\vsize10in
+
+\hsize6.5in
+\footline{}
+
+\setfont\mainfont :
+ name = "Palatino Linotype"
+ size = 12pt
+ big = +2pt
+
+\baselineskip=1.5\baselineskip
+
+\patterns{1τ}
+
+\bf Two statements by Lincoln
+
+\rg
+
+Address delivered at the dedication of the cemetery at Gettysburg.
+
+November 19, 1863.
+
+Four score and seven years ago our fathers brought forth on this continent, a new nation, conceived in Liberty, and dedicated to the proposition that all men are created equal.
+
+Now we are engaged in a great civil war, testing whether that nation, or any nation so conceived and so dedicated, can long endure. We are met on a great battle-field of that war. We have come to dedicate a portion of that field, as a final resting place for those who here gave their lives that that nation might live. It is altogether fitting and proper that we should do this.
+
+But, in a larger sense, we can not dedicate—we can not consecrate—we can not hallow—this ground. The brave men, living and dead, who struggled here, have consecrated it, far above our poor power to add or detract. The world will little note, nor long remember what we say here, but it can never forget what they did here. It is for us the living, rather, to be dedicated here to the unfinished work which they who fought here have thus far so nobly advanced. It is rather for us to be here dedicated to the great task remaining before us—that from these honored dead we take increased devotion to that cause for which they gave the last full measure of devotion—that we here highly resolve that these dead shall not have died in vain—that this nation, under God, shall have a new birth of freedom—and that government of the people, by the people, for the people, shall not perish from the earth.
+
+—Abraham Lincoln
+
+\vskip\baselineskip
+
+Executive Mansion,
+
+Washington, Nov. 21, 1864.
+
+Dear Madam,
+
+I have been shown in the files of the War Department a statement of the Adjutant General of Massachusetts that you are the mother of five sons who have died gloriously on the field of battle.
+
+I feel how weak and fruitless must be any words of mine which should attempt to beguile you from the grief of a loss so overwhelming. But I cannot refrain from tendering to you the consolation that may be found in the thanks of the Republic they died to save.
+
+I pray that our Heavenly Father may assuage the anguish of your bereavement, and leave you only the cherished memory of the loved and lost, and the solemn pride that must be yours to have laid so costly a sacrifice upon the altar of Freedom.
+
+Yours, very sincerely and respectfully,
+
+A. Lincoln.
+
+Mrs. [Lydia Parker] Bixby.
+
+[Boston, MA]
+
+\vskip\baselineskip
+
+% \vfill\break
+
+\bf Some sound advice from Marcus Aurelius's \emph{τὰ πρός σεαυτόν}.
+
+\rg
+Ὅ τί ποτε τοῦτό εἰμι, σαρκία ἐστὶ καὶ πνευμάτιον καὶ τὸ ἡγεμονικόν. τῶν μὲν σαρκίων καταφρόνησον˙ λύθρος καὶ ὀστάρια καὶ κροκύφαντος, ἐκ νεύρων, φλεβίων, ἀρτηριῶν πλεγμάτιον. θέασαι δὲ καὶ τὸ πνεῦμα ὁποῖόν τί ἐστιν˙ ἄνεμος, οὐδὲ ἀεὶ τὸ αὐτό, ἀλλὰ πάσης ὥρας ἐξεμούμενον καὶ πάλιν ῥοφούμενον. τρίτον οὖν ἐστι τὸ ἡγεμονικόν. \emph{ἄφες τὰ βιβλία}˙ μηκέτι σπῶ˙ οὐ δέδοται. ἀλλ ὡς ἤδη ἀποθνῄσκων ὧδε ἐπινοήθητι˙ γέρων εἶ˙ μηκέτι τοῦτο ἐάσῃς δουλεῦσαι, μηκέτι καθ ὁρμὴν ἀκοινώνητον νευροσπαστηθῆναι, μηκέτι τὸ εἱμαρμένον ἢ παρὸν δυσχερᾶναι ἢ μέλλον ὑπιδέσθαι.
+
+Τὰ τῶν θεῶν προνοίας μεστά. τὰ τῆς τύχης οὐκ ἄνευ φύσεως ἢ συγκλώσεως καὶ ἐπιπλοκῆς τῶν προνοίᾳ διοικουμένων. πάντα ἐκεῖθεν ῥεῖ˙ πρόσεστι δὲ τὸ ἀναγκαῖον καὶ τὸ τῷ ὅλῳ κόσμῳ συμφέρον, οǷ μέρος εἶ. παντὶ δὲ φύσεως μέρει ἀγαθόν, ὃ φέρει ἡ τοῦ ὅλου φύσις καὶ ὃ ἐκείνης ἐστὶ σωστικόν. σῴζουσι δὲ κόσμον, ὥσπερ αἱ τῶν στοιχείων, οὕτως καὶ αἱ τῶν συγκριμάτων μεταβολαί. \emph{ταῦτά σοι ἀρκείτω˙ ἀεὶ δόγματα ἔστω. τὴν δὲ τῶν βιβλίων δίψαν ῥῖψον, ἵνα μὴ γογγύζων ἀποθάνῃς, ἀλλὰ ἵλεως ἀληθῶς καὶ ἀπὸ καρδίας εὐχάριστος τοῖς θεοῖς}.
+
+\vskip\baselineskip
+
+\it In case that was all Greek to you, then rather read:
+
+\rm
+
+Кио айн ми финфине естас, ми консистас де карно, ла спиро кай ла анимо. \emph{Форĵету виайн либройн}. Не есту дистрата - тио не естас пермесата; сед квазаŭ ви ям мортас, абомену ла карнон. Ĝи естас ненио кром санго, остетой кай рето де нервой, артериой кай вейной. Припенсу анкаŭ ла спирон. Киа материо естас ĝи? Аеро, киу не ĉиам естас ла сама, сед дум уну моменто естас вомата кай инспирата. До ла триан атентигу, ла анимон. Компрену, ке ви естас олдуло. Екде нун ви нек алласу, ке виа анимо фариĝас славон, нек алласу, ке ви каптиĝас де контраŭсоциай атакой, нек суферу де виа цирцумстанцаро нек тиму ла естонтецон.
+
+Кио девенас де ла диой, пленас э провиденцо. Кио девенас де ŝанцо естас парто де натуро кай интертексатас кун тиой, киой девенас де провиденцо. Де провиденцо флуас ĉиой. Ĉиой екзистас про утило кай про тио, ке ĝи естас плей бона пор ла универсо, де киу ви естас парто. Кио естас бона пор ла тута универсо, кай кио субтенас ла натурон де ла универсо, анкаŭ естас бона пор парто де ла универсо. \emph{Есту контента кун тиуй максимой. Сед ĉесу соифи пор либрой пор ке ви алвену мортон не мурмуранте сед вере, транквиле кай данкеме ал ла диой ел виа анимо}.
+
+\bye
+
+Kio ajn mi finfine estas, mi konsistas de karno, la spiro kaj la animo. \emph{Forĵetu viajn librojn}. Ne estu distrata - tio ne estas permesata; sed kvazaŭ vi jam mortas, abomenu la karnon. Ĝi estas nenio krom sango, ostetoj kaj reto de nervoj, arterioj kaj vejnoj. Pripensu ankaŭ la spiron. Kia materio estas ĝi? Aero, kiu ne ĉiam estas la sama, sed dum unu momento estas vomata kaj inspirata. Do la trian atentigu, la animon. Komprenu, ke vi estas oldulo. Ekde nun vi nek allasu, ke via animo fariĝas slavon, nek allasu, ke vi kaptiĝas de kontraŭsociaj atakoj, nek suferu de via circumstancaro nek timu la estontecon.
+
+Kio devenas de la dioj, plenas je providenco. Kio devenas de ŝanco estas parto de naturo kaj interteksatas kun tioj, kioj devenas de providenco. De providenco fluas ĉioj. Ĉioj ekzistas pro utilo kaj pro tio, ke ĝi estas plej bona por la universo, de kiu vi estas parto. Kio estas bona por la tuta universo, kaj kio subtenas la naturon de la universo, ankaŭ estas bona por parto de la universo. \emph{Estu kontenta kun tiuj maksimoj. Sed ĉesu soifi por libroj por ke vi alvenu morton ne murmurante sed vere, trankvile kaj dankeme al la dioj el via animo}.
+
+\bye \ No newline at end of file