math-puzzle/USAGE.md

Crossword Builder — Usage

Generate a maths crossword PDF from a list of number words.

Basic Usage

python3 crossword_builder.py EIGHT THREE NINE SEVEN TEN FOUR

Options

Flag	Description	Default
--output <file>	Output PDF filename	crossword.pdf
--clues "WORD:eq,..."	Custom equations per word	Auto-generated
--seed <int>	Random seed for reproducible layouts	None

Pass a single integer to pick that many random number words:

python3 crossword_builder.py 6

Examples

# Basic
python3 crossword_builder.py EIGHT THREE NINE SEVEN

# Custom output file
python3 crossword_builder.py --output my_puzzle.pdf EIGHT THREE NINE SEVEN

# Custom clues
python3 crossword_builder.py --clues "EIGHT:4+4,THREE:9-6" EIGHT THREE NINE

# Reproducible layout
python3 crossword_builder.py --seed 42 EIGHT THREE NINE SEVEN

# Combined
python3 crossword_builder.py --output my_puzzle.pdf --seed 42 EIGHT THREE NINE SEVEN