home *** CD-ROM | disk | FTP | other *** search
- !========================================================================
- !
- ! DEMO0.hls A simple demonstration Help file for use with The Helper.
- ! Lines which start with ! in column 1 are commands. If they are not
- ! recognised as commands they are treated as comments (like these lines).
- !
- ! To compile and run this demonstration from The Helper, type
- ! Alt-R (type R while holding down the Alt key).
- !
- !========================================================================
- !
- ! All the information needed to create Help files can be found
- ! by pressing the F1 key for help. For starting off though, here
- ! are a few tips and pointers:
- !
- ! Structure of the Help files
- ! ----------------------------
- ! Help files are organised into Categories which must be numbered
- ! sequentially from 1. Each category has 1 or more pages.
- ! The "!category#" command (where ! is in column 1, and # is a number)
- ! defines the start of a new category and the first page of that
- ! category. Subsequent pages within each category are defined by the
- ! "!page2", "!page3", etc. commands.
- !
- ! Other commands starting with ! in column 1
- ! -------------------------------------------
- ! Other commands control things like window size, colors, the type of
- ! border around windows, conditional statements like "if...else...",
- ! including text from another disk file, overlays (for animating your
- ! Help files) and many more. Press F1 and select "Commands" from the
- ! main help menu to see them all.
- !
- ! Control character commands ^A, ^B, and ^C
- ! ------------------------------------------
- ! There are also three commands which can be imbedded into the text.
- ! ^A (pronounced "control A") is used to indicate where to place
- ! highlighted phrases in the file, and what to do when the Enter key
- ! is pressed on the highlighted phrase. ^B is used to change colors
- ! temporarily on the screen, and ^C is used for inserting a text
- ! memory which has been defined earlier with the "!define" command.
- !
- ! The commands are inserted into the text with the control characters
- ! ^A, ^B and ^C. To enter a control character into the text type ^P
- ! first, then the control character.
- ! e.g. To enter ^A hold down the Ctrl key and type "P" and "A", then
- ! release the Ctrl key. You will see an "A" in the text, but it
- ! will be displayed as a highlight to indicate that it is a
- ! control character, like this....
- !
- !========================================================================
- !----- The source code for this demo starts here...
- !
- !Category1 ----- Start the first category
- !Window 12 4 64 17 ----- Set window coordinates. Max=1 1 80 25.
- !Colors 79 79 78 48 7 7 15 112 ----- Specify default colors.....
- ! 4 for color screens, and 4 for mono screens:
- ! Border, text, highlight, cursor (color+mono)
- ! You can use 0 to leave some of them unchanged.
- ! Select "Color Table" from F1-Help to see colors
- !
- !----- Now start the text for the first page...
-
- (47,112) ─────────────────────────────────────────── (0)
- (47,112) DEMO0 - CONTENTS (0)
- (47,112) ─────────────────────────────────────────── (0)
-
- Use and <Enter> to select a topic.
- Type F1 from anywhere to return to this menu.
- Type Esc at any stage to Quit.
-
- (4,0) Open another window and clear this one
- (2,0+) Open another window over this one
- !
- !----- Note the use of ^A to mark highlighted phrases in some of the lines...
- !----- ^A(2,1) means go to category 2, page1.
- !----- ^A(2,0) goes to the page last displayed in category 2.
- !----- ^A(2,0+) is the same as ^A(2,0) except that the current screen will
- !----- not be cleared - screen(2,0) is overlayed onto the current screen.
- !----- Also note the use of ^B to temporarily change color.
- !----- ^B(47,112) sets color 47 if a color screen is being used, or 112 for
- !----- mono screens. ^B(0) returns the color to the default value.
- !----- will be printed as arrows. Type F8 to enter these and other
- !----- extended characters into the text.
- !Category2
- !Window 51 12 80 22
- !Colors 47 47 0 94 112 112 7 15
- !Border1 ----- Specify single border
-
- The calling screen remains
- displayed because of the +
- sign in the command
-
- ^A(2,0+) ... ^A
-
- (3,0+) Like this: Press Enter
- !Category3
- !Window 29 7 54 19
- !Colors 30 30 0 0 0 0 0 0
-
- The calling screen
- remains displayed
- because of the +
- sign in the command
-
- ^A(3,0+) ... ^A
-
- Type (128)F1(0) to return...
- !-----
- !----- Note the use of ^B(128) to start blinking, and ^B(0) to stop.
- !Category4
- !Window 4 5 75 12
- !Colors 96 96 0 0 0 0 0 0
- !Border2 ----- Specify double border
-
- Page 1. The calling screen is cleared, as there is no + sign in the
- command ^A(4,0) ... ^A
-
- Press (111,15)Backspace(0) or (111,15)F1(0) to return, or (111,15)PgDn(0) for page 2...
- !page2
- !Window 4 10 75 14
-
- Page 2. Backspace or (128)F1(0) to return, or PgUp to return to page 1...