summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/luatex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-06-30 21:21:36 +0000
committerKarl Berry <karl@freefriends.org>2020-06-30 21:21:36 +0000
commit8bb985021b2f40fd3c9ef24653decafda35a3592 (patch)
treef42b0c46f969ff3a9eada2fc099bd1992e25249b /Master/texmf-dist/doc/luatex
parent3188a1fa1e0a251e9952c526036a175b39a1cb3d (diff)
cloze (30jun20)
git-svn-id: svn://tug.org/texlive/trunk@55704 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/luatex')
-rw-r--r--Master/texmf-dist/doc/luatex/cloze/README.md105
-rw-r--r--Master/texmf-dist/doc/luatex/cloze/cloze.pdfbin0 -> 600199 bytes
-rw-r--r--Master/texmf-dist/doc/luatex/cloze/cloze.tex131
3 files changed, 236 insertions, 0 deletions
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 <josef@friedrich.rocks>
+------------------------------------------------------------------------
+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
--- /dev/null
+++ b/Master/texmf-dist/doc/luatex/cloze/cloze.pdf
Binary files 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 <josef@friedrich.rocks>
+%% ----------------------------------------------------------------------
+%% 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'.