sudognu

No warranty

Before you proceed, note that I can't be held responsible for any damage this software may cause. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License Version 2 for more details.

Instructions

Install sudognu to /usr/local/bin/ (see INSTALL for details).
To get started look at the cgi scripts *.cgi in the cgi-bin folder (they are very short and written in bash) and see, if you need to modify anything. If you use the file locations from this example, they should work out-of-the box. There also is a more sophisticated perl script sudoku.pl in the contrib folder, kindly contributed by Todd Lyons.
Copy the cgi-scripts to a location, where your web server finds and can execute them (typically ~/public_html/cgi-bin/).
You also need a tmp directory in cgi-bin, where the user ID of your web server can temporarily store the pdf and html files, that sudognu creates. Be warned: The cgi scripts will delete old files from this directory without asking for confirmation, in order to preserve disk space on your server. You can turn this off in the cgi scripts if you want.
Copy this page to a directory below your document root (e.g. ~/public_html/sudoku/sudognu.html).
Make sure that your web server is set up properly and allows you to execute cgi scripts.
Navigate to http://your.server.host.name/~your-username/sudoku/sudognu.html and have fun with the examples below (opening ~/public_html/sudoku/sudognu.html as a file will probably not work).

Examples

Create four sudokus and print them to a pdf page
The sudokus will be assigned a difficulty rating from 'easy' to 'fiendish' .
'Easy', 'moderate' and 'hard' sudokus are solvable without guessing.

Explain solution steps for a sudoku
Please enter your sudoku as follows:
81 digits without empty space in between, line by line from top to bottom, empty fields as 0 (zero).
Example sudoku:
000000000000000001002034005000006240070005000800900000001000630009800000035700020

Print four sudokus to a pdf page
The text area below displays a few difficult sudokus with only 17 givens. Select an arbitrary number of sudokus (multiple selection by click and drag, "Control + left click" or "Shift + left click"). By pressing "Create pdf" the selected sudokus will be solved and rated before four of them will be written to a pdf page ready for printing.