diff options
author | Karl Berry <karl@freefriends.org> | 2020-05-25 21:11:36 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2020-05-25 21:11:36 +0000 |
commit | 21d4905152277092f61802441a6fea00547ee13b (patch) | |
tree | 86450643c32b2bf7c46835b494a6bc61ef7711ee /Master/texmf-dist/doc/latex/crossword | |
parent | 17a62a7784449c098bd7350b94b79c2d34d0a70f (diff) |
crossword (25may20)
git-svn-id: svn://tug.org/texlive/trunk@55271 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/crossword')
-rw-r--r-- | Master/texmf-dist/doc/latex/crossword/LICENSE | 9 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/crossword/README.md (renamed from Master/texmf-dist/doc/latex/crossword/README) | 87 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/crossword/cwpuzzle.pdf | bin | 363016 -> 337589 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/crossword/makefile (renamed from Master/texmf-dist/doc/latex/crossword/Makefile) | 13 |
4 files changed, 83 insertions, 26 deletions
diff --git a/Master/texmf-dist/doc/latex/crossword/LICENSE b/Master/texmf-dist/doc/latex/crossword/LICENSE new file mode 100644 index 00000000000..0f678870219 --- /dev/null +++ b/Master/texmf-dist/doc/latex/crossword/LICENSE @@ -0,0 +1,9 @@ +cwpuzzle.dtx is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY. No author or distributor accepts +responsibility to anyone for the consequences of using it or for +whether it serves any particular purpose or works at all, unless +he says so in writing. + +Everyone is granted permission to copy, modify and redistribute +cwpuzzle.dtx, provided this copyright notice is preserved and +any modifications are indicated. diff --git a/Master/texmf-dist/doc/latex/crossword/README b/Master/texmf-dist/doc/latex/crossword/README.md index c9c50b91333..df4d3a67b17 100644 --- a/Master/texmf-dist/doc/latex/crossword/README +++ b/Master/texmf-dist/doc/latex/crossword/README.md @@ -1,20 +1,20 @@ - cwpuzzle.sty - - - a LaTeX package for typesetting crossword puzzles and more +# cwpuzzle.sty +--- +a LaTeX package for typesetting crossword puzzles and more - Gerd Neugebauer +Gerd Neugebauer -CROSSWORD PUZZLES +## Crossword Puzzles Since I know only of one additional package for typesetting crossword -puzzles on CTAN -- named crosswrd.sty -- I will compare it against +puzzles on CTAN -- named `crosswrd.sty` -- I will compare it against this package to show the advantages and disadvantages of both packages. -I have developed cwpuzzle.sty because I needed to typeset a puzzle -which required more features than those provided by crosswrd. The +I have developed `cwpuzzle.sty` because I needed to typeset a puzzle +which required more features than those provided by `crosswrd`. The feature I was missing was the inclusion of rectangular regions in the puzzles containing ads or other texts not directly related to the characters to be filled in. @@ -36,8 +36,8 @@ same source: - The fill-in type of puzzle consists of a grid and a list of words. The goal is to place all words in the grid. -crosswrd supports the first type of puzzle only. cwpuzzle supports all -of them. +`crosswrd` supports the first type of puzzle only. c wpuzzle supports +all of them. The input for both packages is completely different. crosswrd assumes that a user uses this package to develop a puzzle. Thus it is tailored @@ -45,7 +45,7 @@ towards a human user. It checks for consistency and requires non-redundant input. (As a unpleasant side effect fragile macros used in clues have to be protected) -cwpuzzle needs some redundancy in the input for the sake of +`cwpuzzle` needs some redundancy in the input for the sake of flexibility. But it seems quite natural to specify the frame of the puzzle and the clues separately. Especially for those types where no clues are needed at all. @@ -55,34 +55,77 @@ cwpuzzle currently assumes that words are terminated by a black block where words are terminated by a thicker border. This might also be incorporated into a future release of cwpuzzle. -In cwpuzzle it is also possible to specify whether the crossword +In `cwpuzzle` it is also possible to specify whether the crossword puzzle or it's solution should be produced (from the same source). Thus it is possible to include the puzzle in one issue of a journal and the solution into another, or to typeset the solution several pages after the puzzle. -cwpuzzle provides a larger number of options and hooks which can be +`cwpuzzle` provides a larger number of options and hooks which can be used to customize the result. E.g it is possible to modify the size of the boxes or the fonts used as well as the appearance of graphical elements like the black blocks. -MORE CELL-BASED PUZZLES +## More Cell-based Puzzles -In addition to crossword puzzles Sudoku and Kakuro are supported. They -are also grid-based. Thus it was easy to facilityte the infrastructure -already in place for them. +In addition to crossword puzzles **Sudoku** and **Kakuro** are +supported. They are also grid-based. Thus it was easy to facilityte +the infrastructure already in place for them. There is a package for sudoku on CTAN. But it does not support solutions yet. -LOCATION +## Location cwpuzzle is located in the CTAN directory - tex-archive/macros/latex/contrib/gene/crossword + https://ctan.org/tex-archive/macros/latex/contrib/gene/crossword -Run tex on cwpuzzle.ins to produce the package and (pdf)latex on -cwpuzzle.dtx to get the documentation (or the Makefile to do both). -Per default the Makefile produces the documentation as PDF. +The source repository can be found under + + https://sourceforge.net/p/gene-tex-lib/svn/HEAD/tree/cwpuzzle + + +## Installation + +### ... in TeX distributions + +If you are lucky then cwpuzzle is already installed in your TeX +distribution or available via the package manager: + +- in TeX Live as `crossword` +- in MiKTeX as `crossword` + + +### ... manually + +Run tex on `cwpuzzle.ins` to produce the package and latex and +makeindex on `cwpuzzle.dtx` to get the documentation + +``` + tex cwpuzzle.ins + lualatex cwpuzzle.dtx + lualatex cwpuzzle.dtx + makeindex -s gind.ist cwpuzzle + makeindex -s gglo.ist -o cwpuzzle.gls cwpuzzle.glo + lualatex cwpuzzle.dtx + +``` + +Or use the `Makefile` to do both. +Per default the `Makefile` produces the documentation as PDF. + +``` + make -f Makefile +``` + +Finally move the file `cwpuzzle.sty` into a directory where your TeX +distribution searches for style files. + + +## Version and copyright + +The relevant information about version and copyright are contained in +the file `cwpuzzle.dtx`. diff --git a/Master/texmf-dist/doc/latex/crossword/cwpuzzle.pdf b/Master/texmf-dist/doc/latex/crossword/cwpuzzle.pdf Binary files differindex 5c53aff07fb..965b3b67aff 100644 --- a/Master/texmf-dist/doc/latex/crossword/cwpuzzle.pdf +++ b/Master/texmf-dist/doc/latex/crossword/cwpuzzle.pdf diff --git a/Master/texmf-dist/doc/latex/crossword/Makefile b/Master/texmf-dist/doc/latex/crossword/makefile index 663c0467680..1fbd0c19c5b 100644 --- a/Master/texmf-dist/doc/latex/crossword/Makefile +++ b/Master/texmf-dist/doc/latex/crossword/makefile @@ -8,8 +8,9 @@ INSTALLDIR = /usr/local/lib/texmf/tex/latex/cwpuzzle FILES = cwpuzzle.dtx \ cwpuzzle.ins \ - Makefile \ - README + makefile \ + README.md \ + LICENSE LATEX = latex PDFLATEX = pdflatex @@ -43,8 +44,12 @@ cwpuzzle.pdf pdf: cwpuzzle.sty cwpuzzle.gls cwpuzzle.gls: zip dist: ${FILES} cwpuzzle.pdf - zip cwpuzzle-` perl -n -e 'print $$1 if m/\\\\def\\\\fileversion[{](.*)[}]/' cwpuzzle.dtx`.zip \ - ${FILES} cwpuzzle.pdf + rm -rf crossword + mkdir crossword + cp ${FILES} cwpuzzle.pdf crossword + zip crossword-` perl -n -e 'print $$1 if m/\\\\def\\\\fileversion[{](.*)[}]/' cwpuzzle.dtx`.zip \ + crossword/* + rm -rf crossword clean: $(RM) cwpuzzle.log cwpuzzle.aux cwpuzzle.glo cwpuzzle.gls \ |