Download Instructions

Customization Instructions

S_Options
S_Options defines the options for how the puzzle will be started and what menu items will be shown. The format is tag: ["value"] or tag: ["value", "last"] where tag is an internal tag used to identify the option and "value" is one of the predefined values for this option. The "last" tag defines whether the last selected value by the user should be used the next time the puzzle is loaded. If "last" is specified the value is stored in a cookie and retrieved during loading. The format is IMPORTANT, please note the brackets and commas and the fact that the last entry does not have a comma. All entries are case sensitive and should be lower case letters.

• Startup Options.
  StartupPuzzleDifficulty: ["1", "last"], // startup puzzle difficulty where 1=easy, 2=difficult, 3=fiendish and 4=superior
  StartupPuzzleSize: ["2", "last"], // startup puzzle size where 1=very small, 2=small, 3=medium and 4=large
  ShowCellCandidates: ["all", "last"], // Possible values are "all" , "single" or "none" for showing cell candidates when menu selected
  AutoUpdateCellCandidates: ["yes", "last"], // Automatically update cell candidates when entry made. Values are "yes" or "no"
  FlyoverCellEntryHints: ["yes", "last"], // Show entry option hints for cells. Values are "yes" or "no"
  FlyoverHintTechniques: ["yes", "last"], // Show flyover hint techiques when hint requested. Values are "yes" or "no"
  RandomSeed: ["date"], // Random number generator seed, either "random", "today" or 6 digit number. "last" not a useful option here
  HelpFile: ["Sudoku_Help.html"], // The name of the Sudoku help file ... "last" not a useful option here
  HintDelay: [2000] // delay for showing hints in milliseconds. "last" not a useful option here
  
• Menu Options.
  ShowMenu:["yes"], // Show menu - option to not show menu at all ... "last" not a useful option here
  ShowMenuControls:["yes"], // Show "Controls" menu item ... "last" not a useful option here
  ShowMenuCreate: ["yes"], // Show "Create New Puzzle" menu item ... "last" not a useful option here
  ShowMenuReset: ["yes"], // Show "Reset" menu item ... "last" not a useful option here
  ShowMenuHints: ["yes"], // Show "Hints" menu item ... "last" not a useful option here
  ShowMenuValidate: ["yes"], // Show "Validate" menu item ... "last" not a useful option here
  ShowMenuCandidates: ["yes"], // Show "Cell Candidates" menu item ... "last" not a useful option here
  ShowMenuSolution: ["yes"], // Show "Solution" menu item ... "last" not a useful option here
  ShowMenuSolutionSteps: ["yes"], // Show "Solution Steps" menu item ... "last" not a useful option here
  ShowMenuPrint: ["yes"], // Show "Print" menu item ... "last" not a useful option here
  ShowMenuKeypad: ["yes"], // Show "Keypad" menu item ... "last" not a useful option here
  ShowMenuOptions:["yes"], // Show "Options" menu item ... "last" not a useful option here
  ShowMenuPuzzleSize: ["yes"], // Show "Puzzle Size" menu item ... "last" not a useful option here
  ShowMenuCandidateOptions:["yes"], // Show "Show Candidates " menu item ... "last" not a useful option here
  ShowMenuFlyoverOptions:["yes"], // Show "Show Flyover Hints " menu item ... "last" not a useful option here
  ShowMenuTimer:["yes"], // Show timer ... "last" not a useful option here
  

S_Puzzle
S_Puzzle defines the formatting of the Sudoku Puzzle. The format is tag: "style" where tag is internal label for attribute and "style" is the pseudo "CSS" attribute Styles must be enclosed in quotes and followed by a comma, except for the last entry in the S_Puzzle object

• General style sample.
  fontFamily: "arial, helvectia", // any font family or group of font families generally available on the web may be specified
  backgroundColor: "white", // any valid html,css color definition for a border is permissible.
  InitialValuesColor: "blue", // the font color used to render the initial puzzle values.
  EnteredValuesColor: "black", // the font color used to render the entered puzzle values.
  puzzleBorderWidth: "10px", // puzzle border width must be specified in pixels, the default is one pixel border
  puzzleBorderStyle: "solid", // any valid html,css style definition for a border is permissible.
  puzzleBorderColor: "#DADAB2 #FAFAD2 #FAFAD2 #DADAB2", // any valid html,css color definition for a border is permissible.
  focusCellColor: "RGB(208,208,224)", // the background color used to show focus on cell.
  
• Odd block attributes.
  oddBlockAttributes: // odd block attributes.
  {backgroundColor: "#E8F8FF", // any valid html,css color definition for a border is permissible.
  blockBorderWidth: "3px", // puzzle border width must be specified in pixels, the default is one pixel border
  blockBorderStyle: "outset", // any valid html,css style definition for a border is permissible.
  blockBorderColor: "#CACAA2" // any valid html,css color definition for a border is permissible.
  },
• Even block attributes.
  evenBlockAttributes: // even block attributes.
  {backgroundColor: "white", // any valid html,css color definition for a border is permissible.
  blockBorderWidth: "3px", // puzzle border width must be specified in pixels, the default is one pixel border
  blockBorderStyle: "outset", // any valid html,css style definition for a border is permissible.
  blockBorderColor: "#CACAA2" // any valid html,css color definition for a border is permissible.
  },
• Cell attributes.
  cellAttributes: // cell attributes.
  {backgroundColor: "transparent", // any valid html,css color definition for a border is permissible.
  cellBorderWidth: "1px", // puzzle border width must be specified in pixels, the default is one pixel border
  cellBorderStyle: "solid", // any valid html,css style definition for a border is permissible.
  cellBorderColor: "RGB(224,224,160)" // any valid html,css color definition for a border is permissible.
  },
• Subcell attributes (for cell candidates).
  subCellAttributes: // sub cell attributes.
  {backgroundColor: "transparent", // any valid html,css color definition for a border is permissible.
  subCellBorderWidth: "1px", // puzzle border width must be specified in pixels, the default is one pixel border
  subCellBorderStyle: "solid", // any valid html,css style definition for a border is permissible.
  subCellBorderColor: "RGB(224,224,240)" // any valid html,css color definition for a border is permissible.
  },
• Floating window attributes.
  floatingWindow: // Popup window attributes.
  {backgroundColor: "yellow", // any valid html,css color definition for a border is permissible.
  fontColor: "red" // any valid html,css color definition for a border is permissible.
  }
• Hint attributes.
  hintAttributes: // flyover hint attributes.
  {backgroundColor: "yellow", // any valid html,css color definition for a border is permissible.
  fontColor: "red" // any valid html,css color definition for a border is permissible.
  }

S_MenuCSS
S_MenuCSS defines the options for how the menu will be formatted and displayed. The format is tag: "style" where tag is internal label for attribute and "style" is the pseudo "CSS" attribute Styles must be enclosed in quotes and followed by a comma, except for the last entry in the S_MenuCSS object. Please note that some of these entries may not be changed but are required for the menu generator.

• General formatting.
  backgroundColor: "RGB(250,250,210)", // background color must be specified in RGB format... sorry about that...
  menuAlignment: "vertical", // should not be changed"
  menuSize: "100%", // should not be changed
  menuItemWidth: "fit", // should not be changed
  borderSize: "2px", // border size around main menu
  fontSize: "14px", // should not be changed.. set by program
  fontFamily: "arial, helvectia", // any font family or group of font families generally available on the web may be specified
  textAlign: "center", // alignment may be "left", "center" or "right"
  
• Formatting of menu headings.
  headingAttributes: // heading attributes... defaults to 1px border if not specified
  {backgroundColor: "#FAFAD2",// any valid html,css color definition is permissible.
  fontWeight: "bold", // any valid css fontWeight definition
  fontColor: "black" // any valid html,css color definition
  },
• Formatting of default menu buttons.
  defaultAttributes: // default menu attributes.
  {backgroundColor: "#FAFAD2",// any valid html,css color definition for a border is permissible.
  fontWeight: "normal", // any valid css fontWeight definition
  fontColor: "black" // any valid html,css color definition is permissible.
  },
• Formatting of active menu buttons.
  activeAttributes: // active menu attributes.
  {backgroundColor: "#E8E8BA", // any valid html,css color definition is permissible.
  fontWeight: "bold", // any valid css fontWeight definition
  fontColor: "black" // any valid html,css color definition is permissible.
  },
• Formatting of hover menu buttons.
  hoverAttributes: // hover menu attributes.
  {backgroundColor: "#F2F2D0", // any valid html,css color definition is permissible.
  fontWeight: "bold", // any valid css fontWeight definition
  fontColor: "#1A1A00" // any valid html,css color definition is permissible.
  },
• Formatting of flyover hints.
  hintAttributes: // sub cell attributes.
  {backgroundColor: "yellow", // any valid html,css color definition is permissible.
  fontWeight: "normal", // any valid css fontWeight definition
  fontColor: "red" // any valid html,css color definition is permissible.
  },
• Sub Menus formatting.
  These entries are used internally by the menu subsystem and should not be modified
  subMenus:[ // left square bracket begins definition of sub menu unique elements
  {menuSuffix: "", // the suffix used to define a sub menu
  textAlign: "center", // alignment may be "left", "center" or "right"
  menusPerRow: "1" // any number of menus may be placed on row but usually only one
  },
  {menuSuffix: "_N", // sub menu used for keypad
  textAlign: "center", // alignment may be "left", "center" or "right"
  menusPerRow: "3" // any number of menus may be placed on row but usually only one
  },
  {menuSuffix: "_N1", // sub menu used for keypad
  textAlign: "center", // alignment may be "left", "center" or "right"
  menusPerRow: "1" // any number of menus may be placed on row but usually only one
  },
  {menuSuffix: "_C1",
  textAlign: "center", // alignment may be "left", "center" or "right"
  menusPerRow: "4" // any number of menus may be placed on row but usually only one
  },
  {menuSuffix: "_C2",
  textAlign: "center", // alignment may be "left", "center" or "right"
  menusPerRow: "2" // any number of menus may be placed on row but usually only one
  },
  {menuSuffix: "_S",
  textAlign: "left", // alignment may be "left", "center" or "right"
  menusPerRow: "1" // any number of menus may be placed on row but usually only one
  }
  ] // right square bracket ends definition of sub menu unique elements
  

S_Messages
S_Messages is an object to facilitate message translation and contains all of the menu and message text in the program. The format for Sudoku messages is tag: "text" where tag is an internal label for the message text. All "text" must be enclosed in quotes and followed by a comma, except for the last entry in message object The percent sign(%) followed by a number are parameters that are replaced in the translation process. These placeholders should be kept in any translated version of these messages.

Change Log