How YourSudoku Works

Behind the scenes, YourSudoku is a conversation between a Python program, a set of LibreOffice templates, and you.

Step 1 – You choose the basics

When you start the Puzzle Creator, you’ll be prompted for a few simple choices:

Step 2 – The Python core builds the puzzles

A Python “core” program does the heavy lifting. It generates full Sudoku grids, blanks out cells according to the difficulty rules, and assigns IDs so each puzzle has a matching answer key.

The program also tracks metadata such as difficulty, puzzle ID, and player/club name. That data later feeds the templates, the keys, and eventually the book layout.

Step 3 – Templates turn data into pages

Once a puzzle is ready, the core passes the details into a set of LibreOffice templates. Those templates control page layout:

The same mechanism also builds the compact key pages, so every puzzle has a clearly labeled solution stored in one place.

Step 4 – You print, share, or bind

The result is a set of puzzle pages and answer keys you can:

Over time this page will grow into a full “under the hood” tour, including diagrams and technician notes for anyone who wants to extend or maintain the system.

Current status: Documentation in progress

Next milestone target date: 12/18/2025
Focus: Capturing the full puzzle-to-template pipeline