puzzle-draw is a library and command-line tool for drawing pencil puzzles using Diagrams. It aims to provide a utility layer on top of Diagrams to help with drawing arbitrary puzzles, as well as supporting several specific puzzle types directly. In addition, it includes functionality for parsing puzzle data from a YAML file format.
A liar slitherlink with solution:
This was rendered from the following YAML document:
type: slitherlinkliar puzzle: | 1..0.3 .03222 0....1 3....3 32202. 3.3..3 solution: loop: | .┌──┐┌┐ .│┌─┘││ .│└──┘│ ┌┘.┌─┐│ └┐┌┘.││ ┌┘│..││ └─┘..└┘ liars: | ...X.. .X.... X..... .....X ....X. ..X...
There is a demo web application at puzzle-draw-demo.herokuapp.com that provides some more examples and that can be used to generate SVG images from such puzzle descriptions.
Or see a puzzle set that covers the puzzle types that are supported as of 2014-05.
This is a brief overview of how to install the command line tool.
You'll need to get a Haskell environment, by installing the
Haskell Platform. Then install
puzzle-draw with cabal:
$ cabal install puzzle-draw
This will compile puzzle-draw against the SVG backend, and install
drawpuzzle that formats puzzles to SVG. Alternatively,
you can compile against the Cairo backend by passing
$ cabal install -fcairo puzzle-draw
This will enable PDF and PNG output. Be warned that getting Cairo installed can be tricky on non-Linux platforms.
As an example, suppose the Liar Slitherlink puzzle description above
is copied into a file
$ drawpuzzle slitherliar.pzl
This will generate two files
containing the puzzle and solved puzzle, respectively. Run
$ drawpuzzle -h
to see some command line options that allow modifying the program's behaviour, e.g., choosing the output format.
- Upgrade diagrams version.
- Add various new puzzle types.
- Add solution code markers.
- add installation and usage instructions to README
- merge puzzle-draw-cmdline
- update for diagrams 1.2 and ghc 7.8
- add new puzzle types: Bahnhof, Cave
- include and use a nicer font
- command-line option to list supported puzzle types
- various tweaks and fixes
add new puzzle types: Maximal Lengths, Prime Place, Magic Labyrinth
add new puzzle types: Japanese Sums, Coral
add new puzzle type: Tapa
- first release