summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/gene/crossword/README
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/gene/crossword/README
Initial commit
Diffstat (limited to 'macros/latex/contrib/gene/crossword/README')
-rw-r--r--macros/latex/contrib/gene/crossword/README88
1 files changed, 88 insertions, 0 deletions
diff --git a/macros/latex/contrib/gene/crossword/README b/macros/latex/contrib/gene/crossword/README
new file mode 100644
index 0000000000..c9c50b9133
--- /dev/null
+++ b/macros/latex/contrib/gene/crossword/README
@@ -0,0 +1,88 @@
+
+ cwpuzzle.sty
+ -
+ a LaTeX package for typesetting crossword puzzles and more
+
+ Gerd Neugebauer
+
+
+CROSSWORD PUZZLES
+
+Since I know only of one additional package for typesetting crossword
+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
+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.
+
+I have generalized this requirement by allowing arbitrary rectangles
+to be left free. Thus it is possible to typeset puzzles which have no
+rectangular border (See the documentation for examples).
+
+Another idea was to have different types of puzzles generated from the
+same source:
+
+- The classical puzzle contains numbers for the words and clues for
+ the words to be filled in.
+
+- The numbered puzzle contains numbers in each cell where identical
+ numbers represent identical letters. The goal is to find out which
+ number corresponds to which letter.
+
+- 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.
+
+The input for both packages is completely different. crosswrd assumes
+that a user uses this package to develop a puzzle. Thus it is tailored
+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
+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.
+
+cwpuzzle currently assumes that words are terminated by a black block
+(or the border of the puzzle). crosswrd also supports also the variant
+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
+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
+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
+
+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
+
+cwpuzzle is located in the CTAN directory
+
+ 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.