diff options
author | Karl Berry <karl@freefriends.org> | 2022-02-22 21:11:36 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-02-22 21:11:36 +0000 |
commit | b58ee08a4c930684f420d4f7cf5fca4b804f7744 (patch) | |
tree | 135720e6b67d62f2a76f7bf49f0a2b75ae3c3b3f /Master/texmf-dist/source/luatex | |
parent | 16e52a84e2d3fced8748b0a0c772c7772aaff173 (diff) |
lua-widow-control (22feb22)
git-svn-id: svn://tug.org/texlive/trunk@62144 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/luatex')
4 files changed, 36 insertions, 7 deletions
diff --git a/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.bib b/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.bib index 009c0e5cfa5..c705e871b41 100644 --- a/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.bib +++ b/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.bib @@ -1,7 +1,7 @@ % lua-widow-control % https://github.com/gucci-on-fleek/lua-widow-control % SPDX-License-Identifier: MPL-2.0+ OR CC-BY-SA-4.0+ -% SPDX-FileCopyrightText: 2021 Max Chernoff +% SPDX-FileCopyrightText: 2022 Max Chernoff @book{texbook, author = {Donald E. Knuth}, diff --git a/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.mkxl b/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.mkxl index a4489b2e705..0256bdd56a2 100644 --- a/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.mkxl +++ b/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.mkxl @@ -1,7 +1,7 @@ % lua-widow-control % https://github.com/gucci-on-fleek/lua-widow-control % SPDX-License-Identifier: MPL-2.0+ -% SPDX-FileCopyrightText: 2021 Max Chernoff +% SPDX-FileCopyrightText: 2022 Max Chernoff \startenvironment[lwc-documentation] \unprotect diff --git a/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.tex b/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.tex index 564f51618a5..bbee53cee14 100644 --- a/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.tex +++ b/Master/texmf-dist/source/luatex/lua-widow-control/lwc-documentation.tex @@ -3,7 +3,7 @@ % lua-widow-control % https://github.com/gucci-on-fleek/lua-widow-control % SPDX-License-Identifier: MPL-2.0+ OR CC-BY-SA-4.0+ -% SPDX-FileCopyrightText: 2021 Max Chernoff +% SPDX-FileCopyrightText: 2022 Max Chernoff % Warning: Compiles slowly @@ -37,12 +37,12 @@ \startdocument[ title=lua-widow-control, author=Max Chernoff, - version=1.1.5, %%version + version=1.1.6, %%version github=https://github.com/gucci-on-fleek/lua-widow-control, ctan=https://www.ctan.org/pkg/lua-widow-control, ] -\Lwc/ is a Plain~\TeX/\LaTeX/\ConTeXt{} package that removes \waos/ without any user intervention. Using the power of \LuaTeX{}, it does so \emph{without} stretching any glue or shortening any pages or columns. Instead, \lwc/ automatically lengthens a paragraph on a page or column where a \woo/ would otherwise occur. +\Lwc/ is a Plain~\TeX/\LaTeX/\ConTeXt{}/Op\TeX{} package that removes \waos/ without any user intervention. Using the power of \LuaTeX{}, it does so \emph{without} stretching any glue or shortening any pages or columns. Instead, \lwc/ automatically lengthens a paragraph on a page or column where a \woo/ would otherwise occur. \section{Quick Start} Ensure that your \TeX~Live/Mik\TeX{} distribution is up-to-date. Then, \LaTeX{} users just need to place \inlineTEX{\usepackage{lua-widow-control}} in the preamble of your document. For more details, see the \goto{Installation and Usage sections}[sec:install]. @@ -166,6 +166,9 @@ Run \type{tlmgr install lua-widow-control} in a terminal, or install using the \ \subsection{Mik\TeX} Run \type{mpm --install=lua-widow-control} in a terminal, or install using the \q{Mik\TeX{} Maintenance} \acronym{GUI}. +\subsection{\ConTeXt{} \acronym{MKIV} Standalone} +Run \type{first-setup.sh --modules="lua-widow-control"} in a terminal or install manually. + \subsection{Manual} Currently, \ConTeXt{} \acronym{MKXL} (\LuaMetaTeX{}) users must manually install the package. Most other users will be better served by using the \lwc/ supplied by \TeX~Live and Mik\TeX{}; however, all users may manually install the package if desired. The procedure should be fairly similar regardless of your \acronym{OS}, \TeX{} distribution, or format. @@ -190,7 +193,10 @@ Currently, \ConTeXt{} \acronym{MKXL} (\LuaMetaTeX{}) users must manually install \Lwc/ requires \LuaTeX{} ($\ge$ 0.85), \LaTeX{} ($\ge$ 2015/01/01), \sans{microtype} (any version), and \sans{etoolbox} (any version). Any version of \TeX~Live $\ge$ 2016 will meet these requirements. \subsection{\ConTeXt{}} -\Lwc/ requires \ConTeXt{} \acronym{MKXL} (\LuaMetaTeX{}). +\Lwc/ supports both \ConTeXt{} \acronym{MKXL} (\LuaMetaTeX{}) and \ConTeXt{} \acronym{MKIV} (\LuaTeX{}). + +\subsection{Op\TeX{}} +\Lwc/ works with any version of Op\TeX{} and has no dependencies. \section{Loading the Package} @@ -207,6 +213,10 @@ Currently, \ConTeXt{} \acronym{MKXL} (\LuaMetaTeX{}) users must manually install \inlineTEX{\usemodule[lua-widow-control]} +\subsection{Op\TeX{}} + +\inlineTEX{\load[lua-widow-control]} + \section{Columns} Since \TeX{} implements column breaking and page breaking through the same internal mechanisms, \lwc/ should remove \waos/ between columns just as well as it does with \waos/ between pages. This has been tested with the standard \LaTeX{} class option \type{twocolumn} and the two-column output routine from Chapter~23 of \cite[title][texbook].\cite[texbook] \Lwc/ should presumably work with any other multi-column implementation; however, due to the diversity and complexity of output~routines, this cannot be guaranteed. @@ -242,6 +252,14 @@ Since \TeX{} implements column breaking and page breaking through the same inter \NC \NC \inlineTEX{\prependtoks\lwc@patch@post\to\everyafterfoo} \NC\NR \stopTABLE +\subsection{Op\TeX{}} +\startTABLE +\NC Enable (default) \NC \inlineTEX{\lwcenable} \NC\NR +\NC Disable \NC \inlineTEX{\lwcdisable} \NC\NR +\NC \estretch/ \NC \inlineTEX{\lwcemergencystretch=3em} \NC\NR +\NC Selectively Disable \NC \emph{Not Implemented} \NC\NR +\stopTABLE + \subsection{\estretch/} You can configure the \estretch/ used when stretching a paragraph. The default value is 3~em. @@ -256,6 +274,9 @@ You could just disable then reenable \lwc/ every time that you use the command; \Lwc/ automatically patches the default \LaTeX{}, \ConTeXt{}, and Plain~\TeX{} section commands, so you shouldn't need to patch these yourself; however, \lwc/ does \bold{not} patch the non-standard section commands provided by \sans{memoir}, \sans{\acronym{KOMA}-script}, \sans{titlesec}, and others. You'll need to patch these yourself. Under \ConTeXt{}, you need to use a different method to selectively disable \lwc/. Instead of using \tex{lwcdisablecmd}, you should use one of the preexisting \tex{everyfoo} hooks as shown in the table above since patching commands is rarely advisable in \ConTeXt{} + +No commands are provided for selectively disabling \lwc/ with Op\TeX{}. Users must implement this functionality themselves. + \section[sec:issues]{Known Issues} \startitemize \item \Lwc/ will not expand the first paragraph of a document. @@ -336,6 +357,14 @@ Please note that a compiled document is \bold{not} considered to be an \q{Execut \typeTEXfile{../source/t-lua-widow-control.mkxl} +\subsection{t-lua-widow-control.mkiv} + +\typeTEXfile{../source/t-lua-widow-control.mkiv} + +\subsection{lua-widow-control.opm} + +\typeTEXfile{../source/lua-widow-control.opm} + \subsection{Demo from \in{Table}[tab:demo]} \typeTEXfile{lwc-documentation-demo-text.tmp} diff --git a/Master/texmf-dist/source/luatex/lua-widow-control/lwc-sample.tex b/Master/texmf-dist/source/luatex/lua-widow-control/lwc-sample.tex index 143f3cbc8c7..0ba9f17f76b 100644 --- a/Master/texmf-dist/source/luatex/lua-widow-control/lwc-sample.tex +++ b/Master/texmf-dist/source/luatex/lua-widow-control/lwc-sample.tex @@ -1,7 +1,7 @@ % lua-widow-control % https://github.com/gucci-on-fleek/lua-widow-control % SPDX-License-Identifier: MPL-2.0+ OR CC-BY-SA-4.0+ -% SPDX-FileCopyrightText: 2021 Max Chernoff +% SPDX-FileCopyrightText: 2022 Max Chernoff \startbuffer[demo-text] \definepapersize[smallpaper][ |