moth

puzzle.md

 1---
 2authors: 
 3  - neale
 4debug:
 5  summary: static puzzles
 6answers: 
 7  - puzzle.md
 8---
 9Puzzle categories are laid out on the filesystem:
10
11    example/
12    ├─1
13    │  └─puzzle.md
14    ├─2
15    │  ├─puzzle.md
16    │  └─salad.jpg
17    ├─3
18    │  └─mkpuzzle
19    ├─10
20    │  └─puzzle.md
21    └─100
22       └─mkpuzzle
23
24In this example,
25there are puzzles with point values 1, 2, 3, 10, and 100.
26
27Puzzles 1, 2, and 10 are "static" puzzles:
28their content was written by hand.
29
30Puzzles 3 and 100 are "dynamic" puzzles:
31their content is generated by `mkpuzzle`.
32
33To create a static puzzle, all you must have is a
34`puzzle.md` file in the puzzle's directory.
35This file is in the following format:
36
37    ---
38    pre:
39      authors:
40        - name of the person who wrote this puzzle
41    debug:
42      summary: brief description of the puzzle
43    answers: 
44      - answer to this puzzle
45      - second acceptable answer to this puzzle
46    ---
47    This is the puzzle body.
48    It is Markdown formatted:
49    you can read more about Markdown on the Internet.
50
51To move to the next puzzle in a category,
52someone on some team must provide an answer to the highest-point puzzle in that category.
53
54The answer to this puzzle is the name of the file required to make a static puzzle.