JIGSAW-GENERATOR(1)

💖 JIGSAW-GENERATOR 💖

okay bestie, gather round, because we're about to talk about jigsaw-generator — yes it's a real command, yes it lives in section 1 of the manual (that's the "General Commands Manual" girlies), and yes it is iconic. she's a program that generates jigsaws and card sort activities. no cap.

✨ NAME ✨

jigsaw-generator — a program to generate jigsaws and card sort activities 🧩

🌸 SYNOPSIS 🌸

jigsaw-generator [options] puzzlefile[.yaml]

🦋 DESCRIPTION 🦋

So like, this manual page is a brief lil overview of the jigsaw-generator command. it's giving teaser trailer, not the whole cinematic universe, iykyk.

Here's the tea: jigsaw-generator is a program that reads a YAML data file and, from that file, creates a "jigsaw" puzzle or a card sorting activity. it's generally intended for classroom use, which means your teacher could literally be using this to make your worksheet. main character energy fr fr.

Want more deets? the full documentation lives at /usr/share/doc/jigsaw. go look, bestie, she's waiting 💅

💅 OPTIONS 💅

okay so these programs follow the usual GNU command line syntax, with long options starting with two dashes (-). yes the manual literally says "two dashes" and then shows one dash. she's quirky like that. 🙈

A summary of options is included below, and bestie, we are not skipping a single one of them:

• -h, --help — shows you a summary of the options. the "what is going ON" button 🫶
• -v, --version — shows version information. the "who even are you" button ✨
• -o OUTPUT, --output OUTPUT — use OUTPUT as the basename of the output files, instead of puzzlefile. like, rename your baby's output files, go off 👑
• --noclean, --no-clean — do NOT clean the auxiliary files which are created (such as the LaTeX file used to generate the PDF versions of the puzzle). messy girl behaviour, and honestly? valid 💀
• --clean — do clean the auxiliary files; this is the default behaviour. tidy icon, we love her 🌸
• --latex LATEX — the LaTeX variant to run. the default is pdflatex, but this default can be overridden by the template file used. so like, she'll do it her way unless the template says otherwise 🎀
• --nomakepdf, --no-makepdf — do NOT make PDF output files. no PDF for you 🚫
• --makepdf — make PDF output files; this is the default behaviour. PDFs stay winning 🔥
• --nomakemd, --no-makemd — do NOT make Markdown output files. the markdown stays in the drafts folder 😭
• --makemd — make Markdown output files; this is the default behaviour. markdown girlies rise ⭐
• --texfilter TEXFILTER — run the LaTeX file through TEXFILTER before running pdflatex (or whichever LaTeX variant is being used). this filter should accept the original LaTeX file on its standard input and output the filtered file on its standard output. like a little glow-up station for your LaTeX 💖
• --mdfilter MDFILTER — run the Markdown file through MDFILTER after producing it. this filter should accept the original Markdown file on its standard input and output the filtered file on its standard output. post-production filter, very editorial ✨

🎀 CONFIGURATION FILES 🎀

The program reads configuration files and template files when processing the template file. For full information, see the complete documention.

ok so real talk — that word is spelled documention in the original. that's the manual's own typo, not mine, and I'm not about to "fix" her. she said what she said 💀 keep it exactly as is, bestie.

🌈 SEE ALSO 🌈

The program is documented fully by the documentation included with the package, typically installed in /usr/share/doc/jigsaw-generator or /usr/local/share/doc/jigsaw-generator.

so if you need the full lore, check those two paths. one of them has your answers, I promise 🦋

and that's the whole page, bestie!! this one came from the General Commands Manual, dated December 18, 2015 — she's a vintage icon and she's still serving. go make some puzzles, ily, bye 💜✨🎀