diff options
author | Karl Berry <karl@freefriends.org> | 2024-04-03 21:18:05 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2024-04-03 21:18:05 +0000 |
commit | b282536869578c1e5d5d3778bb846f63aca46c95 (patch) | |
tree | ff58393133e93f57d37f3000246b06c5985c06af /Master/texmf-dist/doc/lualatex | |
parent | b033809ee9e0148a20f37328bb519f0cd0afbb0a (diff) |
lua-placeholders (3apr24)
git-svn-id: svn://tug.org/texlive/trunk@70850 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/lualatex')
-rw-r--r-- | Master/texmf-dist/doc/lualatex/lua-placeholders/README.md | 1 | ||||
-rw-r--r-- | Master/texmf-dist/doc/lualatex/lua-placeholders/lua-placeholders-example/example.pdf | bin | 66376 -> 66214 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/lualatex/lua-placeholders/lua-placeholders-manual.pdf | bin | 269309 -> 269558 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/lualatex/lua-placeholders/lua-placeholders-manual.tex | 12 |
4 files changed, 7 insertions, 6 deletions
diff --git a/Master/texmf-dist/doc/lualatex/lua-placeholders/README.md b/Master/texmf-dist/doc/lualatex/lua-placeholders/README.md index 6859910816b..b1b43e23b98 100644 --- a/Master/texmf-dist/doc/lualatex/lua-placeholders/README.md +++ b/Master/texmf-dist/doc/lualatex/lua-placeholders/README.md @@ -1,5 +1,6 @@ # Lua(TeX) Placeholders ![CTAN Version](https://img.shields.io/ctan/v/lua-placeholders) +[![build](https://github.com/Xerdi/lua-placeholders/actions/workflows/build.yml/badge.svg)](https://github.com/Xerdi/lua-placeholders/actions/workflows/build.yml) A LaTeX package for specifying and inserting document placeholders with JSON or YAML formats. diff --git a/Master/texmf-dist/doc/lualatex/lua-placeholders/lua-placeholders-example/example.pdf b/Master/texmf-dist/doc/lualatex/lua-placeholders/lua-placeholders-example/example.pdf Binary files differindex 979941c7022..a91d000cdd1 100644 --- a/Master/texmf-dist/doc/lualatex/lua-placeholders/lua-placeholders-example/example.pdf +++ b/Master/texmf-dist/doc/lualatex/lua-placeholders/lua-placeholders-example/example.pdf diff --git a/Master/texmf-dist/doc/lualatex/lua-placeholders/lua-placeholders-manual.pdf b/Master/texmf-dist/doc/lualatex/lua-placeholders/lua-placeholders-manual.pdf Binary files differindex 2054633991b..6a5c5860ad6 100644 --- a/Master/texmf-dist/doc/lualatex/lua-placeholders/lua-placeholders-manual.pdf +++ b/Master/texmf-dist/doc/lualatex/lua-placeholders/lua-placeholders-manual.pdf diff --git a/Master/texmf-dist/doc/lualatex/lua-placeholders/lua-placeholders-manual.tex b/Master/texmf-dist/doc/lualatex/lua-placeholders/lua-placeholders-manual.tex index 210270b9390..ff078470c16 100644 --- a/Master/texmf-dist/doc/lualatex/lua-placeholders/lua-placeholders-manual.tex +++ b/Master/texmf-dist/doc/lualatex/lua-placeholders/lua-placeholders-manual.tex @@ -91,13 +91,12 @@ For proper number formatting package \texttt{numprint}\cite{numprint} is required. \subsubsection{YAML Support} - If you're using JSON as \meta{recipe} and \meta{payload} format, the following requirements are no longer needed, since Lua\TeX{} already supports JSON formats out of the box. + Starting from version 1.0.2, the preferred YAML implementation has changed from \texttt{lyaml}\cite{lyaml} to \texttt{lua-tinyyaml}\cite{lua-tinyyaml}. + The reason for this change is that \texttt{lua-tinyyaml} doesn't require any platform-specific dependencies, such as \texttt{libYAML}\cite{libYAML}. + + The older YAML implementation will still function for older installations that do not have \texttt{lua-tinyyaml}. + As before, when no YAML implementation is found, \texttt{lua-placeholders} will fall back to JSON support. - For YAML support, however, this package requires the \texttt{lyaml}\cite{lyaml} Lua module for parsing the YAML files. - This also includes the \texttt{libYAML}\cite{libYAML} platform dependent library and optionally LuaRocks for installing \texttt{lyaml}. - Another requirement is Lua, which version meets the Lua version used by Lua\TeX{}. - If no \texttt{LUA\_PATH} is set, and you use LuaRocks, this package tries to call the LuaRocks executable to find the \texttt{LUA\_PATH}. - If \texttt{lyaml} can't be loaded, this package will first try to fall back with \texttt{lua-tinyyaml}\cite{lua-tinyyaml} for lesser YAML support and secondly fall back on accepting JSON files only. \clearpage \section{Usage} @@ -115,6 +114,7 @@ \DescribeMacro{\loadpayload} The same behaviour counts for \cmd{\loadpayload}\oarg{namespace}\marg{filename}. The order of loading \meta{recipe} and \meta{payload} files doesn't matter. If the \meta{payload} file got loaded first, it will be yielded until the corresponding \meta{recipe} file is loaded. + When a file is loaded, a \LaTeX\ hook will trigger once for \texttt{namespace/\meta{namespace}} and once for \texttt{namespace\meta{namespace}/loaded}, respectively. All other macros of this package also take the optional \meta{namespace}, which by default is equal to \cmd{\jobname}. \DescribeMacro{\setnamespace} This default \meta{namespace} can be changed with \cmd{\setnamespace}\marg{new default namespace}.\\ |