This converts MOTH categories into MOTH puzzle directories, or SCTR trainings.
Full documentation is in the docs directory.
This is also served under the URL /docs/ by pupate.
- Run the
cocooncommand - Open http://localhost:8080 and navigate to the 1-point puzzle in
the
countingcategory. - In your
Documentsfolder is a newcategoriesfolder. Opencategories/counting/1/puzzle.mdin a text editor like Visual Studio Code, vim, or emacs. - Add some text to the bottom of the file and save it.
- Check back in your web browser to see what it did.
cocoon is a web-based debugging tool to monitor and render collections of categories.
Run it with no options to get started.
By default, it will watch your filesystem for changes to your files.
If your filesystem does not support a notification mechanism (NFS, SMB),
you will need to provide a -poll option.
pupate is an interactive tool to convert puzzle directories.
moth2md converts legacy .moth files to modern .md files.
We (the Cyber Fire team) like writing puzzles in Markdown, and storing everything in version control. We also think it's handy to keep one puzzle's metadata tightly bundled with that puzzle.
For architectural reasons, both MOTH and SCTR pull various fields, such as what are the "answers", out of the puzzle itself. Pupate allows creators to focus on logically bundling things together, and letting the compile step worry about how to bring that into production.
Moths and butterflies go through four life stages: egg, larva (caterpillar), pupa (chrysalis or cocoon), and adult. Keeping with the moth theme, this program is used to transform puzzle source into a production puzzle.
The icon for this project is "silk-cocoon_2849891", created by "Eucalyp" on flaticon.com. It was provided for free personal and commercial use with attribution. It's not included in the source code, though, so if you want it, you'll have to go download your own copy.
Information Release Number PNNL-SA-221926