home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / news / 2510 / mhpsampl.sr_ / mhpsampl.sr
Text File  |  1994-06-02  |  8KB  |  242 lines

  1. .hpjopt title=MiniHelp Plus v3.1 Sampler
  2. .hpjopt compress=medium
  3. .hpjopt copyright=Copyright ⌐ 1994, Paul Arnote
  4. .hpjopt report=1
  5. .hpjopt warning=3
  6. .hpjopt contents=contents
  7. .hpjconfig CreateButton("btn_exit","E&xit","Exit()")
  8. .hpjconfig CreateButton("btn_print","&Print","Print()")
  9. .hpjconfig BrowseButtons()
  10. .hpjwin main = , , 1, , (192, 192, 192), 0 
  11. .topic contents
  12. .title Table of Contents
  13. .keyword Table of Contents
  14. .browse 0001
  15. .fontsize 24
  16. \keepn
  17. \sb300
  18. .bold Table of Contents
  19. \par
  20. \pard
  21.  
  22. .fontsize 10
  23. Here it is! 
  24. .bold MiniHelp Plus v3.1
  25. makes it easy to quickly write your own help files, without the cost of an expensive word processor (such as Microsoft Word for Windows) and without the frustration of an extensive learning curve just to operate it.
  26.  
  27.  
  28. .link %MH " MiniHelp"
  29. performs admirably, great for writing small or large Help files (this indicated a non-visible hotspot in the first occurrence of the word
  30. .bold MiniHelp
  31. in this paragraph).
  32.  
  33.  
  34. The command 
  35. .pop POPUP "pop"
  36. allows you to create popuplinks.
  37.  
  38.  
  39. .fontsize 15
  40. How do you make a bitmaplink?
  41.  
  42.  
  43. .fontsize 12
  44. Click on the disk 
  45. .bmlink DISK "disk.bmp"
  46.  and jump to another topic!
  47. .hpjbitmap disk.bmp
  48.  
  49.  
  50. .fontsize 10
  51. MiniHelp also does support the use of 
  52. .link *BROWSE "Browse indexing"
  53. directly with the use of the command,
  54. .bold .browse.
  55.  
  56.  
  57.  
  58. The following hot spot demonstrates the execution of a macro from the hot spot.  You declare these in MiniHelp Plus v3.1 with the ".macrolink" command. 
  59.  
  60.  
  61. .bold CAUTION: 
  62. Clicking on this hot spot will exit you from this Help file!
  63.  
  64.  
  65. \sb300
  66. .macrolink Exit() "Goodbye"
  67.  
  68. \sb300
  69. The following bitmaps were inserted using the MiniHelp Plus v3.1 ".bitmap" command.  Refer to the source file to see how to do it!
  70.  
  71.  
  72. .hpjbitmap btn_up.bmp
  73. .bitmap btn_up.bmp
  74.    This is a bitmap that does nothing but look good!
  75.  
  76.  
  77. \sb300
  78. \qr
  79.    This is a bitmap that does nothing but look good!  
  80. .bitmap btn_up.bmp
  81.  
  82.  
  83. \sb300
  84. \qc
  85. .bitmap btn_up.bmp
  86.    This is a bitmap that does nothing but look good!
  87. \par
  88. \pard
  89.  
  90.  
  91. The following demonstrates how to place a bitmap at the left margin and wrap the subsequent text around the right edge, using the MiniHelp Plus v3.1 command ".lbitmap."
  92.  
  93.  
  94. .hpjbitmap foot.bmp
  95. .lbitmap foot.bmp
  96. Now, this text should wrap around the right edge of the bitmapped image at the left margin, giving your document that professional, polished look!
  97.  
  98.  
  99.  
  100. And now we'll do the same thing, but place the bitmap at the right margin and wrap the subsequent text around the left edge, using the MiniHelp Plus v3.1 command ".rbitmap."
  101.  
  102.  
  103.  
  104. .rbitmap foot.bmp
  105. Now, this text should wrap around the left edge of the bitmapped image at the right margin, allowing you flexibility in bitmapped image placement using the MiniHelp Plus v3.1 command ".rbitmap."
  106.  
  107.  
  108.  
  109. Before, MiniHelp Plus users were unable to include "curly braces" in their text.  Whenever they attempted to do so, it corrupted their RTF output file.  Now, I have discovered a workaround to this.  If you find it necessary to include curly braces in your Help file, they
  110. .ulboldital must
  111. be entered as follows (click on the curly braces to see the solution!):
  112.  
  113.  
  114. .pop CURLY "\'7B \'7D  \'7B \'7D"
  115. \par\pard
  116.  
  117. ;.hpjopt bmroot=c:\helpbmp
  118.  
  119. Also new in MiniHelp Plus v3.1 is the
  120. .bold IMPROVED
  121. ".pop" and ".macrolink" commands, which detects whether you have entered the name of a bitmapped image to display on the screen as the hot spot, or whether you simply entered text to display as the hot spot.
  122.  
  123.  
  124. .pop POPUP2 ".pop"
  125.  
  126.  
  127. .pop BMPOPUP "key1.bmp" 
  128.  
  129.  
  130.  
  131. Plus, there are many, many more features of MiniHelp Plus v3.1.  To find out more, check out the extensive online Help file and the MiniHelp Plus v3.1 User's Manual!
  132.  
  133. .topic MH
  134. .title MiniHelp
  135. .keyword MiniHelp
  136. .keyword Help Authoring aid
  137. .browse 0002
  138. .tmacro About()
  139.  
  140. .fontsize 14
  141. This file was prepared with MiniHelp Plus v3.1, the easy and inexpensive approach to Help Authoring.
  142.  
  143. .topic POPUP
  144. .title Popuplinks
  145. .keyword popuplinks
  146. .keyword .pop
  147. .browse 0003
  148.  
  149. .fontsize 10
  150. That's right, provisions were made for popuplinks, something the original MiniHelp did not have.  To do one, simply issue the command
  151. .bold .pop,
  152. followed by the name of the topic to jump to, followed by the text to display on the screen set off in quotes.
  153.  
  154.  
  155. .topic DISK
  156. .title Bitmap Links
  157. .keyword Bitmap Links
  158. .browse 0004
  159.  
  160. .fontsize 10
  161. With the
  162. .bold .bmlink
  163. command, creating Hot Spots with bitmaps is very easy!  Issue the command 
  164. .bold .bmlink
  165. .italic TOPIC_NAME  "bitmapfile.bmp"
  166. and your chosen image will appear.  Then, whenever anyone clicks the mouse on it, they will be taken to another, pre-defined topic!
  167.  
  168. .topic BROWSE
  169. .title Browse Sequencing
  170. .keyword Browse
  171. .keyword Browse Sequencing
  172. .browse 0005
  173.  
  174. .fontsize 10
  175. You can use Browse Sequencing (which allows you to use the Browse Buttons) by simply using the command
  176. .bold .browse,
  177. followed by the appropriate parameters!  See the MiniHelp Plus v3.1 online Help File for documentation.
  178.  
  179. .topic POPUP2
  180. .title The Improved .pop Command: Text
  181. .keyword .pop;popuplinks;text
  182. .browse 0006
  183.  
  184. .fontsize 10
  185. This demonstrates the normal way of creating and displaying a popup link, using text as the hot spot on the screen.  Click on the image below to see the enhancement!
  186.  
  187. .topic BMPOPUP
  188. .title The Improved .pop Command: Bitmaps
  189. .keyword .pop;popuplinks;bitmaps;.macrolink
  190. .browse 0007
  191.  
  192. .fontsize 10
  193. This demonstrates the enhancement to the ".pop" command:  You may now define bitmap images as a hotspot for popup links!  MiniHelp Plus v3.1 checks the text you input to see if it is a bitmapped image file, ending in
  194. .bold .bmp.
  195.  The format is as follows:
  196.  
  197.  
  198. \qc
  199. .bold .pop BMPOP "key1.bmp"
  200.  
  201. .hpjbitmap key1.bmp
  202.  
  203. \par\pard
  204. MiniHelp Plus checks the last four (4) characters of the "text string" to see if it ends in
  205. .bold .bmp.
  206.  If it does, it branches off and reformats its RTF output.  If not, then it procedes on as normal, and formats text to display on the screen.  If your image is not in the standard Windows bitmap format (.bmp), you will need to convert it into one of these three acceptable formats using a format conversion utility, such as Paint Shop Pro (shareware program available for download everywhere or JASC, Inc., 17743 Evener Way, Eden Prairie, MN  55346 USA; $49.00 Registration plus $4.00 S&H).
  207.  
  208.  
  209. The same enhancement has been added to the
  210. .bold .macrolink
  211. command, allowing you to execute Help Macros from a bitmapped image defined as the hot spot.
  212.  
  213. .topic CURLY
  214. .title Curly Brace Bug Workaround
  215. .keyword Curly Brace;Bug Workaround;Special Symbols
  216. .browse 0008
  217.  
  218.  
  219. .fontsize 10
  220. You
  221. .boldital can not
  222. type curly braces directly from the keyboard in MiniHelp Plus v3.1.  Doing so
  223. .bold will
  224. corrupt your generated RTF file.  There is, however, a way to make them appear in your finished Help file.  Issue the following command:
  225.  
  226.  
  227. .bold \\ ' 7B for a left curly brace \tab \tab \tab \'7B
  228.  
  229. .bold \\ ' 7D for a right curly brace \tab \tab \tab \'7D
  230.  
  231.  
  232. Very simple!  Now, here are some other "special symbols" you might be interested in using:
  233.  
  234.  
  235. .bold \\ '95 to insert a bullet  \'95 \tab \tab \tab \\ '99 to insert a trademark  \'99
  236.  
  237. .bold \\ 'A9 to insert a copyright   \'A9 \tab \tab \tab \\ 'AE to insert a register   \'AE
  238.  
  239. .bold \\ 'B1 to insert a plus/minus   \'B1 \tab \tab \tab \\ 'BC to insert 1/4   \'BC
  240.  
  241. .bold \\ 'BD to insert a 1/2   \'BD \tab \tab \tab \\ 'BE to insert a 3/4   \'BE
  242.