From 8bb985021b2f40fd3c9ef24653decafda35a3592 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 30 Jun 2020 21:21:36 +0000 Subject: cloze (30jun20) git-svn-id: svn://tug.org/texlive/trunk@55704 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/luatex/cloze/README.md | 105 +++++++++++++++++++++ Master/texmf-dist/doc/luatex/cloze/cloze.pdf | Bin 0 -> 600199 bytes Master/texmf-dist/doc/luatex/cloze/cloze.tex | 131 +++++++++++++++++++++++++++ 3 files changed, 236 insertions(+) create mode 100644 Master/texmf-dist/doc/luatex/cloze/README.md create mode 100644 Master/texmf-dist/doc/luatex/cloze/cloze.pdf create mode 100644 Master/texmf-dist/doc/luatex/cloze/cloze.tex (limited to 'Master/texmf-dist/doc/luatex') diff --git a/Master/texmf-dist/doc/luatex/cloze/README.md b/Master/texmf-dist/doc/luatex/cloze/README.md new file mode 100644 index 00000000000..d6919d4c8dc --- /dev/null +++ b/Master/texmf-dist/doc/luatex/cloze/README.md @@ -0,0 +1,105 @@ +# Description + +EN: `cloze` is a LuaLaTeX/LaTeX package to generate cloze. It uses the +capabilities of the modern TeX engine LuaTex. + +DE: `cloze` ist a LuaLaTeX/LaTeX-Paket zum Erstellen von Lückentexten. +Es nutzt die Möglichkeiten der modernen TeX-Engine LuaTeX. + +# License + +Copyright (C) 2015-2020 by Josef Friedrich +------------------------------------------------------------------------ +This work may be distributed and/or modified under the conditions of +the LaTeX Project Public License, either version 1.3 of this license +or (at your option) any later version. The latest version of this +license is in: + + http://www.latex-project.org/lppl.txt + +and version 1.3 or later is part of all distributions of LaTeX +version 2005/12/01 or later. + +# CTAN + +Since July 2015 the cloze package is included in the Comprehensive TeX +Archive Network (CTAN). + +* TeX archive: http://mirror.ctan.org/tex-archive/macros/luatex/latex/cloze +* Package page: https://www.ctan.org/pkg/cloze + +# Repository + +https://github.com/Josef-Friedrich/cloze + +# Installation + +Get source: + + git clone git@github.com:Josef-Friedrich/cloze.git + cd cloze + +Compile: + + make + +or manually: + + luatex cloze.ins + lualatex --shell-escape cloze.dtx + makeindex -s gglo.ist -o cloze.gls cloze.glo + makeindex -s gind.ist -o cloze.ind cloze.idx + lualatex --shell-escape cloze.dtx + +# Development + +First delete the stable version installed by TeX Live. Because the +package `cloze` belongs to the collection `collection-latexextra`, the +option `--force` must be used to delete the package. + + tlmgr remove --force cloze + +## Deploying a new version + +Update the version number in the file `cloze.dtx` on this locations: + +### In the markup for the file `cloze.sty` (approximately at the line number 30) + + %<*package> + [2020/05/20 v1.4 Package to typeset cloze worksheets or cloze tests] + %<*package> + +Add a changes entry (approximately at the line 90): + +```latex +\changes{v1.4}{2020/05/20}{...} +``` + +### In the package documentation `documentation.tex` (approximately at the line number 125) + +```latex +\date{v1.6~from 2020/06/30} +``` + +### In the markup for the file `cloze.lua` (approximately at the line number 1900) + +```lua +if not modules then modules = { } end modules ['cloze'] = { + version = '1.4' +} +``` + +### Update the copyright year: + +``` +sed -i 's/(C) 2015-2020/(C) 2015-2021/g' cloze.ins +sed -i 's/(C) 2015-2020/(C) 2015-2021/g' cloze.dtx +``` + +### Command line tasks: + +``` +git tag v1.4 +make +make ctan +``` diff --git a/Master/texmf-dist/doc/luatex/cloze/cloze.pdf b/Master/texmf-dist/doc/luatex/cloze/cloze.pdf new file mode 100644 index 00000000000..5901e8dd851 Binary files /dev/null and b/Master/texmf-dist/doc/luatex/cloze/cloze.pdf differ diff --git a/Master/texmf-dist/doc/luatex/cloze/cloze.tex b/Master/texmf-dist/doc/luatex/cloze/cloze.tex new file mode 100644 index 00000000000..c3d1f86e124 --- /dev/null +++ b/Master/texmf-dist/doc/luatex/cloze/cloze.tex @@ -0,0 +1,131 @@ +%% +%% This is file `cloze.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% cloze.dtx (with options: `plaintex') +%% +%% This is a generated file. +%% +%% Copyright (C) 2015-2020 by Josef Friedrich +%% ---------------------------------------------------------------------- +%% This work may be distributed and/or modified under the conditions of +%% the LaTeX Project Public License, either version 1.3c of this license +%% or (at your option) any later version. The latest version of this +%% license is in: +%% +%% http://www.latex-project.org/lppl.txt +%% +%% and version 1.3c or later is part of all distributions of LaTeX +%% version 2008/05/05 or later. +%% +\directlua{ + cloze = require('cloze') +} +\newif\ifclozeshow\clozeshowtrue +\def\ClozeSetToGlobal{% + \directlua{cloze.set_is_global(true)}% +} +\def\ClozeSetToLocal{% + \directlua{ + cloze.unset_local_options() + cloze.set_is_global(false) + }% +} +\def\ClozeGetOption#1{% + \directlua{ + tex.print(cloze.get_value('#1')) + }% +} +\def\ClozeColor#1{\csname\string\color@#1\endcsname} +\def\ClozeStartMarker#1{% + \strut\directlua{ + cloze.register('#1') + cloze.marker('#1', 'start') + }% +} +\def\ClozeStopMarker#1{% + \strut\directlua{ + cloze.marker('#1', 'stop') + }% +} +\def\ClozeMargin#1{% + \directlua{cloze.margin()}% + #1% + \directlua{cloze.margin()}% +} +\def\clozesetoption#1#2{% + \ClozeSetToGlobal% + \directlua{cloze.set_option('#1', '#2')}% +} +\def\clozereset{% + \ClozeSetToGlobal% + \directlua{cloze.reset()}% +} +\def\clozeshow{% + \clozeshowtrue% + \ClozeSetToGlobal% + \clozesetoption{show}{true}% + \clozesetoption{hide}{false}% +} +\def\clozehide{% + \clozeshowfalse% + \ClozeSetToGlobal% + \clozesetoption{hide}{true}% + \clozesetoption{show}{false}% +} +\def\clozefont{\it} +\def\clozesetfont#1{% + \def\clozefont{% + #1% + }% +} +\def\cloze#1{% + \ClozeStartMarker{basic}% + {% + \clozefont\relax% + \ClozeMargin{#1}% + }% + \ClozeStopMarker{basic}% +} +\def\clozefix#1{% + \ClozeStartMarker{fix}% + {% + \clozefont\relax% + \ClozeMargin{#1}% + }% + \ClozeStopMarker{fix}% +} +\def\clozenol#1{% + \clozesetoption{thickness}{0pt}% + \ClozeStartMarker{basic}% + {% + \clozefont\relax% + \ClozeMargin{#1}% + }% + \ClozeStopMarker{basic}% +} +\def\clozeline{% + \directlua{cloze.line()}% +} +\def\clozelinefil{% + \strut% + \directlua{cloze.linefil()}% + \strut% +} +\def\clozefil#1{% + \cloze{#1}\clozelinefil% +} +\def\clozeparcmd#1\par {% + \par% + \ClozeStartMarker{par}% + \clozefont\relax% + #1% + \ClozeStopMarker{par}% + \par% + \directlua{cloze.unregister('par')}% +} +\endinput +%% +%% End of file `cloze.tex'. -- cgit v1.2.3