moth/example-puzzles/example/1/puzzle.md

55 lines
1.3 KiB
Markdown
Raw Normal View History

2020-09-11 17:33:43 -06:00
---
authors:
- neale
2020-09-11 17:33:43 -06:00
debug:
summary: static puzzles
answers:
- puzzle.md
---
2016-11-28 16:28:27 -07:00
Puzzle categories are laid out on the filesystem:
example/
├─1
2020-09-11 17:33:43 -06:00
│ └─puzzle.md
2016-11-28 16:28:27 -07:00
├─2
2020-09-11 17:33:43 -06:00
│ ├─puzzle.md
2016-11-28 16:28:27 -07:00
│ └─salad.jpg
├─3
2020-09-11 17:33:43 -06:00
│ └─mkpuzzle
2016-11-28 16:28:27 -07:00
├─10
2020-09-11 17:33:43 -06:00
│ └─puzzle.md
2016-11-28 16:28:27 -07:00
└─100
2020-09-11 17:33:43 -06:00
└─mkpuzzle
2016-11-28 16:28:27 -07:00
In this example,
there are puzzles with point values 1, 2, 3, 10, and 100.
Puzzles 1, 2, and 10 are "static" puzzles:
2016-11-28 16:28:27 -07:00
their content was written by hand.
Puzzles 3 and 100 are "dynamic" puzzles:
2020-09-11 17:33:43 -06:00
their content is generated by `mkpuzzle`.
2016-11-28 16:28:27 -07:00
To create a static puzzle, all you must have is a
2020-09-11 17:33:43 -06:00
`puzzle.md` file in the puzzle's directory.
2016-11-28 16:28:27 -07:00
This file is in the following format:
2020-09-11 17:33:43 -06:00
---
pre:
authors:
- name of the person who wrote this puzzle
debug:
summary: brief description of the puzzle
answers:
- answer to this puzzle
- second acceptable answer to this puzzle
---
2016-11-28 16:28:27 -07:00
This is the puzzle body.
It is Markdown formatted:
you can read more about Markdown on the Internet.
To move to the next puzzle in a category,
someone on some team must provide an answer to the highest-point puzzle in that category.
The answer to this puzzle is the name of the file required to make a static puzzle.