           -= skWare's HTML Next Card Game Online Documentation =-



skWare's HTML Next Card Game Online Documentation


Release 1.00b

-----------------------------------------------------------------------------


Introduction

   skWare's HTML Next Card Game (skNextCard) is a HTML Next Card Game written
   in wcCode. This is a game where the user bets on whether the next card
   drawn is higher, lower or the same as the card currently shown. This game
   is totally HTML driven and the Sysop can totaly customise the HTML display.
   You can also customise the total games per day and the number of points
   that the user can start with. 
   
   Usage of this software is covered by skWare's Software License which you
   should read at some stage and you should also check out skWare's Software
   Warranty. You may also want to check out the Trademarks page at some stage.
   
   
   You should definately read the Software History page. 
   
   You can also check out skWare Online for the latest information on this
   program and also the others written by skWare. 
   
   In this documentation we have assumed that Wildcat! has been installed on
   drive d: in the directory wc5 resulting in the fact that the default
   wildcat directory is d:\wc5, as this is how our development system is set
   up. Your system may not be set up like this. 




Upgrading to v1.00b

   To upgrade from v1.00a to v1.00b you should proceed as follows:- 
      
          * Copy the file html-skncard.wcx to your default wildcat
            directory. 
          * Copy the help.htm file to http\skware\template\ncard\help.htm. 
      
   
   
   
   
   Installation
   
      To install skNextCard you should follow these steps.
      
         
             * Unzip the package sknc100b.zip into a temporary directory
               with a 32 bit unzip program such as unzip as shipped with
               WildCat.
               
             * Move the following files to your default WildCat directory
               (eg: d:\wc5). 
                  
                * html-skncard.wcx 
               
             * The rest of the files supplied in the package are in
               relative directories and should be moved as follows:- 
                  
                  Source Directory            Example Destination Directory 
                                                                            
                  data                        d:\wc5\data                   
                  http\skware\ol_docs\ncard   d:\wc5\http\skware\ol_docs\nca 
                  http\skware\images          d:\wc5\http\skware\images     
                  http\skware\images\cards    d:\wc5\http\skware\images\card 
                  http\skware\template\ncard  d:\wc5\http\skware\template\nc 
                  
               
             * Next you should edit the configuration file skware.cfg as
               explained in the section on the configuration file. 
               
             * Add one or more links to the game on the pages that you
               want. An example of the link required is as follows:-
               
                  <a href="/code/html-skncard.wcx?Mode=Deal"<b>Skware's HTML
                  Next Card Game</b></a> 
               
               
         
      
   
   
   
   
   Configuration File
   
      The operation of the game is controlled by the configuration file. This
      configuration file is called skware.cfg and must be in your WildCat data
      directory (d:\wc5\data). This file is in the process of being setup so
      that it is shared by all of skWare's programs as the single source of
      configuration information. An example file has been shipped with the
      package called skware.cfg.dist which can be used as an example. 
      It is an 'ini' type file the contents for the [sknextcard] section are
      described in the following table. 
         
         Parameter      Description                                         
         RegCode        Once registered this parameter should contain your  
                        registration code as supplied by skWare. In the     
                        shareware version this should contain the word      
                        "SHAREWARE" without the quotes.                     
         StartPoints    This is the number of points given to a new player. 
                        It is also the number of points given to a player   
                        when they start a new day with no points.           
         GamesPerDay    This is the number of games a player is allowed per 
                        day. If this is set to 0 then the games allowed per 
                        day is unlimited.                                   
         HomePageLink   This is the link to your home page. It is used by   
                        the Home button so that the user can return quickly 
                        to you home page.                                   
         BackPageLink   This is the link used by the back button so the     
                        user can return quickly to the page that called the 
                        query program.                                      
         
      
   
   
   
   
   HTML Template Customisation
   
      All of the templates used by the game are totally customisable. The
      templates supplied are in the http\skware\template\ncard directory and
      are used as per the following table. 
         
         Template File  Used By                                            
         help.htm       This template is the help paged displayed to the   
                        user when they use the help button.                
         main.htm       This template is the main template used by the     
                        game.                                              
         nogames.htm    This template is used when the user has no more    
                        games left for the day.                            
         nopoints.htm   This template is used when the user has no more    
                        points left for the day.                           
         over.htm       This template is used when a game is over and the  
                        user did not make it to the top ten.               
         over10.htm     This template is used when a game is over and the  
                        user has made it to the top ten.                   
         topten.htm     This template is used when displaying the top ten. 
                                                                           
         
      
   




Changing the Graphics

   If you want you can change the graphics used by the program by either
   modifying the supplied gif's or creating your own and replacing the
   supplied gif's. All of the gifs for the cards are in the directory
   http\skware\images\cards. 





Registration

   To Register skNextCard print the file register.txt fill it in, and send it
   and the required amount to the following address:-
   
      skWare
      PO Box 9559
      Wellington
      NEW ZEALAND
      
   If you want to pay by Credit Card (either Mastercard or Visa) to can either
   print the file ccreg.txt fill it in and send to the address above or fill
   in the form and email it to skWare. 
   
   You can also register online at skWare Online - Online Registration. 


-----------------------------------------------------------------------------

                Copyright (c) 1998 skWare, All Rights Reserved
                                       

