Skip to content

gucci-on-fleek/lua-widow-control

Repository files navigation

lua-widow-control

Lua-widow-control is a Plain TeX/LaTeX/ConTeXt/OpTeX package that removes widows and orphans without any user intervention. Using the power of LuaTeX, it does so without stretching any glue or shortening any pages or columns. Instead, lua-widow-control automatically lengthens a paragraph on a page or column where a widow or orphan would otherwise occur.

Please see the package manual for usage details or the TUGboat or Zpravodaj articles for background information and discussion.

Usage

Installation

Lua-widow-control is included in TeX Live and MikTeX. Provided that you have an up-to-date installation, you should not need to explicitly install the package.

If you are using ConTeXt or want to manually install the package, you may download it from one of the below links:

Latest Release Other Releases
GitHub GitHub
CTAN
ConTeXt Garden

Usage

To load the package, add the relevant line to your preamble:

Macro Package Code
LaTeX \usepackage{lua-widow-control}
ConTeXt \usemodule[lua-widow-control]
Plain TeX \input lua-widow-control
OpTeX \load[lua-widow-control]

Contributing

Please see CONTRIBUTING.md.

Licence

Lua-widow-control is licensed under the Mozilla Public License, version 2.0 or greater. The documentation is additionally licensed under CC-BY-SA, version 4.0 or greater.

Please note that a compiled document is absolutely not considered to be an "Executable Form" as defined by the MPL. The use of lua-widow-control in a document does not place any obligations on the document's author or distributors. The MPL and CC-BY-SA licenses only apply to you if you distribute the lua-widow-control source code or documentation.


v3.0.1 (2024-03-11)