43 lines
1023 B
Markdown
43 lines
1023 B
Markdown
# Crossword Builder — Usage
|
|
|
|
Generate a maths crossword PDF from a list of number words.
|
|
|
|
## Basic Usage
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
python3 crossword_builder.py 6
|
|
```
|
|
|
|
## Examples
|
|
|
|
```bash
|
|
# 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
|
|
```
|