Skip to content

Fix the manual

Fix the manual #302

# lua-widow-control
# https://github.com/gucci-on-fleek/lua-widow-control
# SPDX-License-Identifier: MPL-2.0+
# SPDX-FileCopyrightText: 2022 Max Chernoff
name: Build, Test, and Bundle
on:
push:
branches:
- master
workflow_dispatch:
pull_request:
jobs:
build:
runs-on: ubuntu-22.04
name: Build, Test, and Bundle
steps:
- name: Checkout the Repository
uses: actions/checkout@v2
- name: Install Dependencies
run: >
(sudo apt-get update &&
sudo apt-get install --no-install-recommends -y
poppler-utils
xsltproc
libcurl4-openssl-dev
moreutils
pandoc
) & disown
# From https://github.com/zauguin/install-texlive
- name: Generate unique ID
id: get-id
run: |
echo "id=$(cat /proc/sys/kernel/random/uuid)" >> $GITHUB_STATE
# From https://github.com/zauguin/install-texlive
- name: Load cache
uses: actions/cache@v3
with:
path: |
~/texlive
key: tex-v1-${{ steps.get-id.outputs.id }}
restore-keys: tex-v1-
- name: Install TeX Live
uses: zauguin/install-texlive@v1
continue-on-error: true
with:
packages: >
babel-czech
babel-slovak
beebe
biber
biblatex
biblatex-iso690
blindtext
collection-latexrecommended
context
csbulletin
hyperxmp
hyphen-czech
hyphen-slovak
ifmtarg
kantlipsum
l3build
latex-bin-dev
libertinus-fonts
linebreaker
luacode
luatex85
luatexbase
optex
path
pgfplots
plex
tex-gyre
tex-gyre-math
tugboat
- name: Set environment variables
run: |
echo "TEXMFHOME=$GITHUB_WORKSPACE/texmf" >> $GITHUB_ENV
mtxrun --generate
mtxrun --luatex --generate
tlmgr paper letter
- uses: actions/cache/save@v3
if: always()
with:
path: |
~/texlive
key: tex-v1-${{ steps.get-id.outputs.id }}
# - name: Install LuaMetaLaTeX
# run: |
# cd ~
# git clone --depth 1 https://github.com/zauguin/luametalatex.git
# cd luametalatex
# l3build install
# mktexlsr
# cd ~
# wget https://lmltx.typesetting.eu/installer-linux64.zip
# unzip installer-linux64.zip
# ./installer
# tlmgr paper letter
- name: Build Documentation
run: |
cd "$GITHUB_WORKSPACE"
l3build doc
- name: Test the package
run: |
# Temporary workaround; see latex3/l3build#232
sed -i '2i if os.getenv"TEXMFCNF"==".:"then os.setenv"TEXMFCNF"end' $(type -p mtxrun).lua
l3build check --show-log-on-error
- name: Bundle the package
run: |
# cd ~/luametalatex
# l3build uninstall
cd "$GITHUB_WORKSPACE"
l3build bundle
- name: Archive on failure
if: failure()
uses: actions/upload-artifact@v3
with:
path: |
.
!.git
- name: Generate Release
uses: ncipollo/release-action@v1
if: ${{ github.event_name == 'push' }}
with:
prerelease: true
artifacts: ./lua-widow-control.tds.zip, ./lua-widow-control.ctan.zip, ./texmf/doc/luatex/lua-widow-control/lua-widow-control.pdf, ./texmf/doc/luatex/lua-widow-control/tb133chernoff-widows.pdf, ./texmf/doc/luatex/lua-widow-control/lwc-zpravodaj.pdf
tag: release-${{github.sha}}
commit: ${{github.sha}}
name: Prerelease ${{github.sha}}
body: |
Automatically generated release for ${{github.sha}}
> 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. Instead, lua-widow-control automatically lengthens a paragraph on a page where a widow or orphan would otherwise occur.
Please note that this is a **prerelease** version of lua-widow-control. Most users should use the [latest release](https://github.com/gucci-on-fleek/lua-widow-control/releases/latest).
---
`lua-widow-control.tds.zip` is a [TDS](https://texdoc.org/serve/tds/0) archive that is designed to be unpacked directly in your `TEXMF/` directory tree. `lua-widow-control.pdf` is the compiled package documentation. `lua-widow-control.ctan.zip` is an archive designed to be uploaded to [CTAN](https://www.ctan.org/help/upload-pkg) by the author (me). `test-results.zip` is a zip archive containing the results of the automated tests.