home *** CD-ROM | disk | FTP | other *** search
/ HTML - Publishing on the Internet / html_cdrom.iso / editoren / os_2 / htmlwiz / htmlwiz.inf (.txt) < prev    next >
OS/2 Help File  |  1995-12-19  |  32KB  |  905 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. HTML Wizard is an editor designed to make writing HTML documents for WWW pages 
  5. a lot easier. The original version was written purely for my own use and was 
  6. not distributed. The arrival of Web Explorer lead a lot of OS/2 users to ask 
  7. about a native HTML editor, so I released an early version of HTML Wizard that 
  8. showed signs of being a program written for one person's use (no way to resize 
  9. the window, almost no configurability, etc.). Since then, a lot has changed and 
  10. the program is now much more powerful and configurable. I thank the many users 
  11. of the program for their suggestions for improvements. 
  12.  
  13. Many people have asked about a preview function and support for rules.  Both of 
  14. these functions will require an enormous amount of coding. The preview function 
  15. is not hard to do when HTML Wizard is used in conjunction with Web Explorer as 
  16. explained in the "How Do I..." section. If you are online, you can have the 
  17. syntax of your document checked by the WebLint server. This is also explained 
  18. in the "How Do I..." section. 
  19.  
  20.  
  21. ΓòÉΓòÉΓòÉ 2. Installation ΓòÉΓòÉΓòÉ
  22.  
  23. Installation of HTML Wizard is simple and straightforward. Unzip the HTML 
  24. Wizard archive in its own directory. Then run install.cmd by typing "install". 
  25. The install program will create an HTML Wizard object on your desktop. To run 
  26. the program successfully, VROBJ.DLL has to either be in your HTML Wizard 
  27. directory or be in a directory specified in the LIBPATH statement in your 
  28. CONFIG.SYS file. What I do is make a directory called \USR\DLL and put all my 
  29. application dll's in there. Then all you have to do is add \USR\DLL to the 
  30. LIBPATH and reboot. If you don't like the idea of messing with CONFIG.SYS, just 
  31. copy VROBJ.DLL to the \OS2\DLL directory or leave it in your HTML Wizard 
  32. directory if you have no other applications built with VX-REXX. You can then 
  33. run HTML Wizard by double-clicking it or dropping an HTML document onto it. 
  34.  
  35.  
  36. ΓòÉΓòÉΓòÉ 3. Options Menu ΓòÉΓòÉΓòÉ
  37.  
  38. This section explains the various program settings in the "Options" menu. 
  39.  
  40.  
  41. ΓòÉΓòÉΓòÉ 3.1. Insert Tags as Uppercase ΓòÉΓòÉΓòÉ
  42.  
  43. This setting determines whether the tags that are inserted are done as upper or 
  44. lowercase text. Note that this does not apply to tags for special characters, 
  45. which are case sensitive. 
  46.  
  47.  
  48. ΓòÉΓòÉΓòÉ 3.2. Word Wrap ΓòÉΓòÉΓòÉ
  49.  
  50. Select this setting if you want long lines to be wrapped around the screen to 
  51. the next line. Deselect it if you want long lines to continue off the screen to 
  52. the right and be visible by using the horizontal scrollbar. 
  53.  
  54.  
  55. ΓòÉΓòÉΓòÉ 3.3. Auto-insert Paragraph Tags ΓòÉΓòÉΓòÉ
  56.  
  57. If this item is selected, text imported using the "Insert File" command will 
  58. have paragraph tags inserted automatically if: 
  59.  
  60.      A line is blank 
  61.  
  62.      A line begins with either a space or a tab 
  63.  
  64.  
  65. ΓòÉΓòÉΓòÉ 3.4. Insert <LI> Tags in Selected Lists ΓòÉΓòÉΓòÉ
  66.  
  67. This item controls whether <LI> tags will be automatically inserted in text 
  68. that is selected when using the OL or UL tag buttons (ordered or unordered 
  69. lists). If this option is selected, each line in the selected text will have 
  70. the <LI> inserted at the beginning. Note that "line" here means a true line 
  71. defined by a CR/LF pair. It is best to turn Word Wrap off to see true lines. 
  72.  
  73.  
  74. ΓòÉΓòÉΓòÉ 3.5. Vertical Tagbar ΓòÉΓòÉΓòÉ
  75.  
  76. Toggles the Tagbar between horizontal and vertical orientation. 
  77.  
  78.  
  79. ΓòÉΓòÉΓòÉ 3.6. Hide Tagbar ΓòÉΓòÉΓòÉ
  80.  
  81. Toggles the Tagbar between visible and hidden. 
  82.  
  83.  
  84. ΓòÉΓòÉΓòÉ 3.7. Translate Non-English Characters ΓòÉΓòÉΓòÉ
  85.  
  86. This feature enables users of non-English code pages to type HTML documents 
  87. with special characters directly from the keyboard, rather than having to use 
  88. the "Characters" menu or multiple keystrokes. With this feature enabled, all 
  89. files are passed through a translator program when opened or saved. On input, 
  90. HTML entities for special characters (e.g., ò) are converted into the 
  91. character appropriate for the user's code page and displayed as that character 
  92. in the editing window. On output, the characters are converted into the 
  93. corresponding HTML entity. The key file for this is "trans.def" in the HTML 
  94. Wizard directory. This file tells the program which characters in the user's 
  95. character set go with a particular HTML entity. I have supplied two files, 
  96. cp850.def (code page 850) and latin1.def (ISO Latin-1) which will cover the 
  97. people who have requested this feature. (The trans.def file that is in the ZIP 
  98. archive is for code page 850.) If you are using code page 850, copy cp850.def 
  99. to trans.def, or copy latin1.def to trans.def if you are using ISO Latin-1. If 
  100. you are using another code page, you will have to build a .def file for that 
  101. page. Look at the supplied files to see how it is done. Basically, the file has 
  102. two columns: the first is the character number on that code page, and the 
  103. second is the corresponding HTML entity. The included utility DefEdit is 
  104. designed for editing these files. It is a PM program that allows you to 
  105. create/modify .def files very easily. Start it up, and load a .def file, and it 
  106. will be pretty obvious how to use it. If you do create a .def file for another 
  107. code page, I would appreciate it if you would send me a copy, so that I can 
  108. include it in future releases of HTML Wizard. 
  109.  
  110.  
  111. ΓòÉΓòÉΓòÉ 4. How Do I... ΓòÉΓòÉΓòÉ
  112.  
  113. This section explains how to do various things with HTML Wizard. 
  114.  
  115.  
  116. ΓòÉΓòÉΓòÉ 4.1. Use HTML Wizard? ΓòÉΓòÉΓòÉ
  117.  
  118. Start the program by double-clicking the HTML Wizard icon or by dropping an 
  119. HTML document onto it. If you double-click the icon, the program will start up 
  120. and load an HTML skeleton template in the file DEFAULT.HTM and you can modify 
  121. that file to suit your needs. You can then write your HTML document by typing 
  122. in the edit window and using the Tagbar or Tags menu items to insert tags. If 
  123. you have some text that you would like to put inside a tag, select that text 
  124. with the mouse and click on the tag button or menu item. HTML Wizard will then 
  125. put the tag around the text. If you insert a tag with no text selected, HTML 
  126. Wizard will simply place the tag at the insertion point and place the cursor in 
  127. the appropriate place to enter text for the tag. Once you are done, you can 
  128. save the HTML file with the "Save" or "Save As" items under the "File" menu. If 
  129. you want to start a new HTML document choose "Close" under the "File" menu, and 
  130. a fresh template will be loaded. 
  131.  
  132.  
  133. ΓòÉΓòÉΓòÉ 4.2. Insert HTML tags? ΓòÉΓòÉΓòÉ
  134.  
  135. To insert tags, there are three options. First, you can insert tags by clicking 
  136. on the appropriate buttons in the Tagbar. Or, you can choose the tag you want 
  137. from the "Tags" menu. A final way is to right-click in the edit window, 
  138. bringing up the tags menu. In all cases if text is selected before the tag is 
  139. inserted, the tag will be placed around the selected text (where appropriate, 
  140. of course). Inserting a tag with no text selected places the tag at the 
  141. insertion point and puts the cursor at the place where text can be typed in the 
  142. tag. 
  143.  
  144.  
  145. ΓòÉΓòÉΓòÉ 4.3. Program the user-definable tags? ΓòÉΓòÉΓòÉ
  146.  
  147. To program a user button, right-click on it and a window will pop up. In the 
  148. top entry field enter the "Hint" text for that button. (This is the message 
  149. displayed in the status area at the bottom of the Tagbar when the mouse passes 
  150. over a button. Use this to remind yourself what the tag is for.) The bottom 
  151. entry field is the tag itself. If your tag should enclose text that has been 
  152. selected, move the cursor to the point in the tag where the selected text 
  153. should be placed. For example, let's say you have a tag like <tag></tag>. If 
  154. the user selects text in the editing window, and this text should go within the 
  155. tag, you would position the cursor like this: <tag>|</tag> before hitting the 
  156. OK button. You can then immediately begin to use your new tag by left clicking 
  157. on the button you just progammed. 
  158.  
  159.  
  160. ΓòÉΓòÉΓòÉ 4.4. Preview with Web Explorer? ΓòÉΓòÉΓòÉ
  161.  
  162. Previewing with Web Explorer is as simple as selecting "Preview Document" from 
  163. the "File" menu, or by pressing F10. If Web Explorer is not running, HTML 
  164. Wizard will start it and load the HTML document you are editing. If Web 
  165. Explorer is already running, HTML Wizard simply forces it to load the present 
  166. version of your HTML document (rather than starting another session of Web 
  167. Explorer). For this feature to work properly, the Web Explorer executable 
  168. (explore.exe) must be in your PATH. If you use the default Web Explorer 
  169. installation, it will be in \TCPIP\BIN. 
  170.  
  171. You can also preview your HTML document at any time by dragging the little 
  172. square where the vertical and horizontal scroll bars meet and dropping it on 
  173. the Web Explorer window. 
  174.  
  175.  
  176. ΓòÉΓòÉΓòÉ 4.5. Check the HTML syntax of my document with WebLint? ΓòÉΓòÉΓòÉ
  177.  
  178. If you are online, selecting "Check Document with Weblint" (or pressing F7) 
  179. will send your HTML document to the WebLint web site (www.unipress.com) for 
  180. syntax checking. If all goes well, the results of the syntax check will be sent 
  181. back and automatically loaded into Web Explorer. This function runs on a 
  182. separate thread, so you can continue to edit your document, but be aware that 
  183. the line numbers reported back by WebLint refer to the line numbers as they 
  184. were when you sent the file (Weblint will send back the HTML code you sent to 
  185. be checked with the line numbers labelled.). REMEMBER, THIS FUNCTION ONLY WORKS 
  186. IF YOU ARE CONNECTED TO THE NET! Eventually I will add the ability to run 
  187. WebLint locally for those people that have Perl installed (available from 
  188. hobbes.nmsu.edu in the Unix directory). 
  189.  
  190.  
  191. ΓòÉΓòÉΓòÉ 4.6. Insert accented/special character tags? ΓòÉΓòÉΓòÉ
  192.  
  193. There are three ways of inserting tags for accented/special characters if you 
  194. are not using the "Translate Non-English Characters" option (see the "Options" 
  195. section for more details). 
  196.  
  197.      Choose the character you want from the "Characters" menu. 
  198.  
  199.      Type the character you want to accent, say "a", then select the accent 
  200.       you want from the "Accents" menu. 
  201.  
  202.      Type the character you want to accent, then press: 
  203.  
  204.         -  Alt-a for acute 
  205.  
  206.         -  Alt-g for grave 
  207.  
  208.         -  Alt-u for umlaut 
  209.  
  210.         -  Alt-c for circumflex 
  211.  
  212.         -  Alt-s for slash 
  213.  
  214.         -  Alt-t for tilde 
  215.  
  216.  The general pattern for the hot keys is Alt for accents and Ctrl for inserting 
  217.  certain characters. (Like Ctrl-Shift-& for the ampersand). 
  218.  
  219.  
  220. ΓòÉΓòÉΓòÉ 4.7. Pay for this great program? ΓòÉΓòÉΓòÉ
  221.  
  222. HTML Wizard is distributed as shareware which means you have 25 free uses to 
  223. try it out and see how it works. If you want to continue to use it after that, 
  224. you must register the program. The registration fee is $20 US. I can accept 
  225. checks drawn on US banks, or International Money orders. Please include an 
  226. email address when you send in your registration so that I can put you on the 
  227. registered users' mailing list. The registration fee should be sent to: 
  228.  
  229. Dirk Terrell
  230. 510 SW 34th St. Apt. #6
  231. Gainesville, FL 32607
  232.     (USA)
  233.  
  234. If you receive HTML Wizard after August 1996, there is a distinct possibility 
  235. that I may have moved. The best thing to do is send e-mail to 
  236. algol@genie.geis.com (or ALGOL if you are on GEnie) and find out where I am. 
  237.  
  238. For those of you who would like to use a credit card for faster service, you 
  239. may order HTML Wizard from the fine folks at BMT Micro: 
  240.  
  241.          Mail Orders To: BMT Micro
  242.                  452 Horn Road
  243.                  Wilmington, NC 28412-2411
  244.                  U.S.A.
  245.  
  246.          Voice Orders: 9:00am - 7:00pm EST (-5 GMT)
  247.                  (800  414-4268 (orders only)
  248.                  (910) 791-7052
  249.  
  250.          Fax Orders: (910) 350-2937  24 hours / 7 Days
  251.  
  252.      Online Orders via modem: (910) 350-8061  10 lines, all 14.4K
  253.                  (910) 799-0923  Direct 28.8K line
  254.  
  255.    Ordering and general ordering questions:
  256.              Via AOL: bmtmicro
  257.          via Compuserve: Thomas Bradford, 74031,307
  258.           via Internet: tbrad@wilmington.net
  259.  
  260.    We accept Visa, Mastercard, Discover, American Express, Money Order,
  261.    Cashiers Check, Personal Check.  Please do not send cash in the mail.
  262.    Personal checks are subject to clearance.
  263.  
  264.  
  265. ΓòÉΓòÉΓòÉ 4.8. Contact the author of this program? ΓòÉΓòÉΓòÉ
  266.  
  267. If you have problems or suggestions for improvements, send them to 
  268. terrell@gnv.fdt.net (preferred address before August, 1996) or 
  269. algol@genie.geis.com (ALGOL if you are on GEnie). 
  270.  
  271.  
  272. ΓòÉΓòÉΓòÉ 5. Help on HTML Tags ΓòÉΓòÉΓòÉ
  273.  
  274. This section contains help on the HTML tags supported by HTML Wizard 
  275.  
  276.  
  277. ΓòÉΓòÉΓòÉ 5.1. Heading Tags ΓòÉΓòÉΓòÉ
  278.  
  279. The heading tags <H1></H1> ... <H6></H6> are used to separate an HTML document 
  280. into sections and subsections. <H1> is the topmost heading, with the next level 
  281. being <H2>, and so on. Text placed between the tags will be displayed as the 
  282. title text for that section. For example 
  283.  
  284. <H1>HTML Wizard for OS/2 Home Page</H1>
  285.  
  286. might be displayed as: 
  287.  
  288. HTML Wizard for OS/2 Home Page 
  289.  
  290.  
  291. ΓòÉΓòÉΓòÉ 5.2. Typeface tags ΓòÉΓòÉΓòÉ
  292.  
  293. These tags control the appearance of text in an HTML document by changing 
  294. fonts. 
  295.  
  296.  
  297. ΓòÉΓòÉΓòÉ 5.2.1. Bold ΓòÉΓòÉΓòÉ
  298.  
  299. Use this tag to cause the text to be displayed in a bold font. 
  300.  
  301. <B>This text is bold.</B>
  302.  
  303. might be displayed as: 
  304.  
  305. This text is bold. 
  306.  
  307.  
  308. ΓòÉΓòÉΓòÉ 5.2.2. Emphasis ΓòÉΓòÉΓòÉ
  309.  
  310. Use this tag to cause the text to be emphasized. This is usually preferable to 
  311. using the bold or italic tag. 
  312.  
  313. <EM>This text is emphasized.</EM>
  314.  
  315. might be displayed as: 
  316.  
  317. This text is emphasized. 
  318.  
  319.  
  320. ΓòÉΓòÉΓòÉ 5.2.3. Italic ΓòÉΓòÉΓòÉ
  321.  
  322. Use this tag to cause the text to be displayed in an italic font. 
  323.  
  324. <I>This text is in italics.</I>
  325.  
  326. might be displayed as: 
  327.  
  328. This text is in italics. 
  329.  
  330.  
  331. ΓòÉΓòÉΓòÉ 5.2.4. Underline ΓòÉΓòÉΓòÉ
  332.  
  333. Use this tag to cause the text to be underlined when rendered by the browser. 
  334.  
  335. <U>This text is underlined.</U>
  336.  
  337. might be displayed as: 
  338.  
  339. This text is underlined. 
  340.  
  341.  
  342. ΓòÉΓòÉΓòÉ 5.2.5. Typewriter ΓòÉΓòÉΓòÉ
  343.  
  344. Use this tag to cause the text to be displayed in a typewriter (fixed-width) 
  345. font. 
  346.  
  347. <TT>This text is rendered with a fixed-width font.</TT>
  348.  
  349. might be displayed as: 
  350.  
  351. This text is rendered with a fixed-width font.
  352.  
  353.  
  354. ΓòÉΓòÉΓòÉ 5.3. List tags ΓòÉΓòÉΓòÉ
  355.  
  356. The HTML list tags are used to create, amazingly enough, lists of items. There 
  357. are three list types in HTML: 
  358.  
  359.      Ordered (numbered) lists 
  360.  
  361.      Unordered (bulleted) lists 
  362.  
  363.      Descriptive lists 
  364.  
  365.  
  366. ΓòÉΓòÉΓòÉ 5.3.1. Ordered Lists ΓòÉΓòÉΓòÉ
  367.  
  368. The ordered list tags <OL></OL> are used to create lists that are numbered, 
  369. rather than bulleted as in the unordered list tags. These tags are used in 
  370. conjunction with the list item tag  <LI>. The <OL></OL> tags surround a series 
  371. of <LI> tags to produce the ordered list. For example: 
  372.  
  373. <OL>
  374. <LI>Item 1
  375. <LI>Item 2
  376. <LI>Item 3
  377. </OL>
  378.  
  379. might be displayed as 
  380.  
  381.    1. Item 1 
  382.  
  383.    2. Item 2 
  384.  
  385.    3. Item 3 
  386.  
  387.  You can also nest lists to make outlines as in: 
  388.  
  389.   <OL>
  390.   <LI>Item 1
  391.   <OL>
  392.   <LI>Sub-item 1
  393.   <LI>Sub-item 2
  394.   </OL>
  395.   <LI>Item 2
  396.   <LI>Item 3
  397.   </OL>
  398.  
  399.  which might be rendered as: 
  400.  
  401.    1. Item 1 
  402.  
  403.         a. Sub-item 1 
  404.  
  405.         b. Sub-item 2 
  406.  
  407.    2. Item 2 
  408.  
  409.    3. Item 3 
  410.  
  411.  Finally, if you would like to make the list more compact by eliminating the 
  412.  spaces between each item, as the COMPACT modifier to the <OL> tag like this: 
  413.  
  414.   <OL COMPACT>
  415.   <OL>
  416.   <LI>Item 1
  417.   <OL COMPACT>
  418.   <LI>Sub-item 1
  419.   <LI>Sub-item 2
  420.   </OL>
  421.   <LI>Item 2
  422.   <LI>Item 3
  423.   </OL>
  424.  
  425.  which might be rendered like this: 
  426.  
  427.    1. Item 1 
  428.         a. Sub-item 1 
  429.         b. Sub-item 2 
  430.    2. Item 2 
  431.    3. Item 3 
  432.  
  433.  HTML Wizard Time Saver: 
  434.  
  435.  If you already have the text for the items loaded into HTML Wizard (say, from 
  436.  a file import), you can create lists quickly by selecting the text (making 
  437.  sure that there is one list item per line), then choosing the <OL> Tagbar 
  438.  button or corresponding Tags menu option. If you have "Auto-insert <LI> tags 
  439.  in Lists" checked in the "Options" menu, HTML Wizard will place the outer <OL> 
  440.  and </OL> tags around the text and place the <LI> tag in front of each list 
  441.  item. 
  442.  
  443.  
  444. ΓòÉΓòÉΓòÉ 5.3.2. Unordered Lists ΓòÉΓòÉΓòÉ
  445.  
  446. The unordered list tags <UL></UL> are used to create lists that are bulleted, 
  447. rather than numbered as in the ordered list tags. These tags are used in 
  448. conjunction with the list item tag  <LI>. The <UL></UL> tags surround a series 
  449. of <LI> tags to produce the ordered list. For example: 
  450.  
  451. <UL>
  452. <LI>Item 1
  453. <LI>Item 2
  454. <LI>Item 3
  455. </UL>
  456.  
  457. might be displayed as 
  458.  
  459.      Item 1 
  460.  
  461.      Item 2 
  462.  
  463.      Item 3 
  464.  
  465.  You can also nest lists to make outlines as in: 
  466.  
  467.   <UL>
  468.   <LI>Item 1
  469.   <UL>
  470.   <LI>Sub-item 1
  471.   <LI>Sub-item 2
  472.   </UL>
  473.   <LI>Item 2
  474.   <LI>Item 3
  475.   </UL>
  476.  
  477.  which might be rendered as: 
  478.  
  479.      Item 1 
  480.  
  481.         -  Sub-item 1 
  482.  
  483.         -  Sub-item 2 
  484.  
  485.      Item 2 
  486.  
  487.      Item 3 
  488.  
  489.  Finally, if you would like to make the list more compact by eliminating the 
  490.  spaces between each item, as the COMPACT modifier to the <UL> tag like this: 
  491.  
  492.   <UL COMPACT>
  493.   <UL>
  494.   <LI>Item 1
  495.   <UL COMPACT>
  496.   <LI>Sub-item 1
  497.   <LI>Sub-item 2
  498.   </UL>
  499.   <LI>Item 2
  500.   <LI>Item 3
  501.   </UL>
  502.  
  503.  which might be rendered like this: 
  504.  
  505.      Item 1 
  506.         -  Sub-item 1 
  507.         -  Sub-item 2 
  508.      Item 2 
  509.      Item 3 
  510.  
  511.  HTML Wizard Time Saver: 
  512.  
  513.  If you already have the text for the items loaded into HTML Wizard (say, from 
  514.  a file import), you can create lists quickly by selecting the text (making 
  515.  sure that there is one list item per line), then choosing the <UL> Tagbar 
  516.  button or corresponding Tags menu option. If you have "Auto-insert <LI> tags 
  517.  in Lists" checked in the "Options" menu, HTML Wizard will place the outer <UL> 
  518.  and </UL> tags around the text and place the <LI> tag in front of each list 
  519.  item. 
  520.  
  521.  
  522. ΓòÉΓòÉΓòÉ 5.3.3. Descriptive Lists ΓòÉΓòÉΓòÉ
  523.  
  524. Descriptive (or definition) lists are useful when you want to make a list that 
  525. has item names and a description of each item, as in the following: 
  526.  
  527.  Item 1 
  528.  
  529.            This would be some text that describes item number 1. 
  530.  Item 2 
  531.  
  532.            This would be some text that describes item number 2. 
  533.  
  534.  Descriptive lists are created with the <DL></DL> tags surrounding a series of 
  535.  <DT> and <DD> tags with appropriate text. The <DT> tag marks the text that is 
  536.  to be shown as a list item (Think of it as descriptive title.), and the <DD> 
  537.  tag marks the descriptive text that goes with the preceding list item. The 
  538.  above example would be coded as: 
  539.  
  540.   <dl>
  541.   <dt>Item 1
  542.   <dd>This would be some text
  543.   that describes item number 1.
  544.   <dt>Item 2
  545.   <dd>This would be some text
  546.   that describes item number 2.
  547.   </dl>
  548.  
  549.  
  550. ΓòÉΓòÉΓòÉ 5.3.4. Directory Lists ΓòÉΓòÉΓòÉ
  551.  
  552. The directory tag <DIR></DIR> is used to create a directory list. Items within 
  553. the list are marked with the list item tag. The COMPACT modifier may be used 
  554. with this tag. 
  555.  
  556.  
  557. ΓòÉΓòÉΓòÉ 5.3.5. List Items ΓòÉΓòÉΓòÉ
  558.  
  559. The list item tag <LI> is used to mark the text in each item of an ordered, 
  560. unordered, or directory list. 
  561.  
  562.  
  563. ΓòÉΓòÉΓòÉ 5.4. Formatting tags ΓòÉΓòÉΓòÉ
  564.  
  565. These tags control the formatting of text in an HTML document. 
  566.  
  567.  
  568. ΓòÉΓòÉΓòÉ 5.4.1. Address ΓòÉΓòÉΓòÉ
  569.  
  570. The address tag <ADDRESS></ADDRESS> is used to mark text as being an email 
  571. address. It is frequently used to indicate the author of a Web page like this: 
  572.  
  573. This Web page produced by <ADDRESS>Dirk Terrell</ADDRESS> using HTML Wizard.
  574.  
  575. which might be rendered as: 
  576.  
  577. This Web page produced by Dirk Terrell using HTML Wizard. 
  578.  
  579.  
  580. ΓòÉΓòÉΓòÉ 5.4.2. Block Quote ΓòÉΓòÉΓòÉ
  581.  
  582. The block quote tag <BLOCKQUOTE></BLOCKQUOTE> is used to set off text that is 
  583. being quoted. Most browsers do this by indenting the text between the tags. 
  584.  
  585.  
  586. ΓòÉΓòÉΓòÉ 5.4.3. Line Break ΓòÉΓòÉΓòÉ
  587.  
  588. The line break tag <BR> is used to force the HTML browser to continue text on 
  589. the following line. This tag is very useful in Tables. 
  590.  
  591. HTML Wizard Time Saver: 
  592.  
  593. If you select text before pressing the line break Tagbar button, HTML Wizard 
  594. will insert line break tags in the selected text when: 
  595.  
  596.      A line is blank 
  597.      A line begins with a tab or a space 
  598.  
  599.  
  600. ΓòÉΓòÉΓòÉ 5.4.4. Paragraph ΓòÉΓòÉΓòÉ
  601.  
  602. The paragraph tag <P> is used to mark the beginning of a new paragraph. 
  603.  
  604. <P>Notice that this sentence is separated
  605. from the following one even though we typed
  606. all of the text together.<P>This is caused
  607. by the use of the paragraph tag.
  608.  
  609. might be rendered as: 
  610.  
  611. Notice that this sentence is separated from the following one even though we 
  612. typed all of the text together.
  613.  
  614. This is caused by the use of the paragraph tag. 
  615.  
  616. HTML Wizard Time Saver: 
  617.  
  618. If you select text before pressing the paragraph Tagbar button, HTML Wizard 
  619. will insert paragraph tags in the selected text when: 
  620.  
  621.      A line is blank 
  622.      A line begins with a tab or a space 
  623.  
  624.  
  625. ΓòÉΓòÉΓòÉ 5.4.5. Pre-formatted ΓòÉΓòÉΓòÉ
  626.  
  627. The pre-formatted tag <PRE></PRE> is used when you do not want the HTML browser 
  628. to change the formatting of the enclosed text. All spacing and line breaks will 
  629. be preserved, and most browsers will display the text in a fixed-width font. 
  630.  
  631. This text is not surrounded by pre-formatted tags, so
  632. line breaks and        spaces      are not
  633. preserved.
  634. <PRE> On the other hand, this text is
  635. enclosed in pre-formatted tags, so line
  636. breaks and        spaces       are preserved.</PRE>
  637.  
  638. might be rendered as: 
  639.  
  640. This text is not surrounded by pre-formatted tags, so line breaks and spaces 
  641. are not preserved. 
  642.  
  643. On the other hand, this text is
  644. enclosed in pre-formatted tags, so line
  645. breaks and        spaces       are preserved.
  646.  
  647.  
  648. ΓòÉΓòÉΓòÉ 5.5. Forms Tags ΓòÉΓòÉΓòÉ
  649.  
  650. These tags are used in creating HTML documents for Web pages with forms. Forms 
  651. enable you to create a Web page that allows users to fill out entry fields and 
  652. submit a document to your Web server for processing. You might use this if you 
  653. wanted to be able to allow searching of a database on your Web server. The user 
  654. would fill out the form and submit it. Your server would process the request 
  655. and send the results back to the user. 
  656.  
  657. The following tags are used to implement forms: 
  658.  
  659.      <FORM></FORM> 
  660.      <INPUT> 
  661.      <SELECT></SELECT> 
  662.      <OPTION> 
  663.      <TEXTAREA></TEXTAREA> 
  664.  
  665.  
  666. ΓòÉΓòÉΓòÉ 5.5.1. The <FORM> Tag ΓòÉΓòÉΓòÉ
  667.  
  668. The <FORM></FORM> tag is used to delineate a form within an HTML document. You 
  669. can have several forms within an HTML document, but forms cannot be nested 
  670. (i.e., a <FORM></FORM> tag sequence cannot be used with another <FORM></FORM> 
  671. pair. 
  672.  
  673. The <FORM> tag must have an ACTION modifier which is a URL that points a Web 
  674. server that will process the form. It must also have the METHOD modifier which 
  675. is either GET or POST, with the latter usually the preferred method for most 
  676. applications. 
  677.  
  678. HTML Wizard makes form creation much easier by providing a window that allows 
  679. you to enter the ACTION modifier value in an entry field. The METHOD modifier 
  680. is selected by choosing the desired radio button. 
  681.  
  682. Example: 
  683.  
  684. <FORM ACTION="http://www.unipress.com/cgi-bin/web-lint" METHOD=POST> ... 
  685. </FORM> 
  686.  
  687.  
  688. ΓòÉΓòÉΓòÉ 6. Program modification history ΓòÉΓòÉΓòÉ
  689.  
  690. This section lists the changes and bug fixes applied to the program over time. 
  691.  
  692.  
  693. ΓòÉΓòÉΓòÉ 6.1. Version 1.54 ΓòÉΓòÉΓòÉ
  694.  
  695.    1. Added the ability to specify a button label for the user-defined tags. 
  696.  
  697.    2. Cleaned up the Tags menu quite a bit, and added ... to menu items that 
  698.       lead to dialogs. 
  699.  
  700.    3. Added HTML, HEAD, BODY, DFN, CITE, CODE, and STRONG tags. 
  701.  
  702.    4. Corrected a bug in which the default document template was not being 
  703.       passed through the translator when "Translate Non-English Characters" was 
  704.       active. 
  705.  
  706.    5. Added/changed some hotkeys: 
  707.  
  708.           Ctrl+G is now > and Ctrl+L is < (This was done because the previous 
  709.            hotkeys were not available on some keyboard setups.) 
  710.  
  711.           Ctrl+P now inserts <P> 
  712.  
  713.           Ctrl+B now inserts <BR> 
  714.  
  715.           Alt+Backspace is Undo. 
  716.  
  717.    6. Added a "Replace/Find" button in the Search dialog. 
  718.  
  719.  
  720. ΓòÉΓòÉΓòÉ 6.2. Version 1.53 ΓòÉΓòÉΓòÉ
  721.  
  722.    1. Added the ability to recall the last five HTML documents edited with menu 
  723.       items in the File menu. 
  724.  
  725.    2. Added a new utility DefEdit that makes editing the translation files 
  726.       (.def) much simpler. 
  727.  
  728.    3. WPS objects that are images can now be dropped on the entry field for the 
  729.       image name in the Anchors and Images dialogs. If the image is in GIF or 
  730.       JPEG format, the program will automatically determine and set the WIDTH 
  731.       and HEIGHT parameters in the HTML tag. 
  732.  
  733.    4. Dropping an HTML file on the editing window will open that file. 
  734.  
  735.    5. Added command line options -grabfocus and -nosocket. Specifying 
  736.       -grabfocus in the parameters field of the HTML Wizard object will cause 
  737.       the program to grab the focus once it is set up and running. Some people 
  738.       were having problems running the program on OS/2 2.1 without TCP/IP 
  739.       installed. The command line option -nosocket disables the Preview with 
  740.       WebLint feature and allows the program run normally. 
  741.  
  742.    6. Modified the non-English character translation routines to ignore & when 
  743.       embedded in double quotes in a URL. 
  744.  
  745.    7. Stripping of HTML tags from files now supports the translation of &xxx; 
  746.       entities like &. Previously only <xxx> tags were removed. The file 
  747.       tstrip.def contains the entity definitions and should be modified to suit 
  748.       your needs. (See the section on translation of non-English characters for 
  749.       details.) 
  750.  
  751.    8. Numerous bug fixes involving problems with previewing and non-English 
  752.       character translation. 
  753.  
  754.  
  755. ΓòÉΓòÉΓòÉ 6.3. Version 1.52 ΓòÉΓòÉΓòÉ
  756.  
  757.    1. Alt-z repeats the last tag insertion. 
  758.  
  759.    2. Status information is displayed when importing a file so that you can 
  760.       tell that something is going on if the file is large. 
  761.  
  762.    3. The program now properly reports an error when saving a file is 
  763.       unsuccessful. 
  764.  
  765.    4. The help file is in the process of being expanded to include entries on 
  766.       the supported HTML tags. This work hasn't been completed, but you can 
  767.       bring up help on some tags by right- clicking on the buttons in the 
  768.       Tagbar. And you can still bring up the help file under "Help" in the main 
  769.       menu. 
  770.  
  771.    5. Fixed many annoying bugs such as: 
  772.  
  773.           Word wrap setting not properly saved upon exiting. 
  774.  
  775.           Incorrect syntax on the mailto: tag. 
  776.  
  777.           Timing problem with previewing when WE was already running. 
  778.  
  779.           Overwriting of clipboard during insertion of some tags. 
  780.  
  781.           Incorrect insertion point for user-programmable tags. 
  782.  
  783.           Save Without Tags wasn't working properly. 
  784.  
  785.           Incorrect result when inserting a list with only 1 line selected. 
  786.  
  787.           Files dropped onto the program object weren't being closed. 
  788.  
  789.           Minor little problems with focus when some windows were opened. 
  790.  
  791.  
  792. ΓòÉΓòÉΓòÉ 6.4. Version 1.51 ΓòÉΓòÉΓòÉ
  793.  
  794.    1. Added a nice splash screen while the program loads. 
  795.  
  796.    2. Fixed some bugs: 
  797.  
  798.           File saving was not done properly, and the new file was being 
  799.            appended to the old one rather than overwriting it. 
  800.  
  801.           Choosing "Close" from the "File" menu would not prompt the user to 
  802.            save changes if the file had been modified. 
  803.  
  804.           I had inadvertently removed the code to load the REXXUtil library, 
  805.            causing all sorts of problems with previewing and using the new 
  806.            WebLint feature. 
  807.  
  808.  
  809. ΓòÉΓòÉΓòÉ 6.5. Version 1.50 ΓòÉΓòÉΓòÉ
  810.  
  811.    1. You can now have your HTML document checked for syntax errors by clicking 
  812.       on "Check Document with WebLint" under the "File" menu. THIS ONLY WORKS 
  813.       IF YOUR NETWORK CONNECTION IS ACTIVE. What the program does is send your 
  814.       document to the WebLint web site (www.unipress.com) for syntax checking. 
  815.  
  816.    2. Added WIDTH, HEIGHT, and ALT entities to the IMG tag window. If you 
  817.       specify a GIF file, HTML Wizard will automatically fill in the WIDTH and 
  818.       HEIGHT entries with the correct values. 
  819.  
  820.    3. The Alt-z key sequence repeats the insertion of the last tag. This makes 
  821.       it a little easier when you have to add the same tag repeatedly (like the 
  822.       <P> tag). 
  823.  
  824.    4. Removed the dependency on RXEXTRAS.DLL. You can delete this file from 
  825.       your HTML Wizard directory. 
  826.  
  827.    5. Fixed some bugs: 
  828.  
  829.           The preview file is now saved in the working directory rather than 
  830.            the HTML Wizard directory. This enables Web Explorer to find images 
  831.            and linked items listed in your HTML file. 
  832.  
  833.           Alt-r now brings up the Characters menu. Previously this was set to 
  834.            Alt-h, conflicting with the Help menu hotkey. 
  835.  
  836.           The correct closing tag for the underline tag is now inserted when 
  837.            using the horizontal Tagbar. 
  838.  
  839.           The "Hide Tagbar" setting is now correctly stored in the .ini file, 
  840.            so that the proper setting is used when the program is restarted. 
  841.  
  842.  
  843. ΓòÉΓòÉΓòÉ 6.6. Version 1.40 ΓòÉΓòÉΓòÉ
  844.  
  845.    1. Support for some HTML 3 tags has been added, including tables and 
  846.       backgrounds. 
  847.  
  848.    2. Added a URL item for NAME=... links in an anchor. 
  849.  
  850.    3. Added the FONT tag 
  851.  
  852.    4. Fixed a problem that messed up previewing when Translate Non-English 
  853.       Characters was turned off. 
  854.  
  855.  
  856. ΓòÉΓòÉΓòÉ 6.7. Version 1.32 ΓòÉΓòÉΓòÉ
  857.  
  858.    1. Previewing with Web Explorer is now easier. To preview your HTML 
  859.       document, just select "Preview Document" from the "File" menu, or press 
  860.       F10. 
  861.  
  862.  
  863. ΓòÉΓòÉΓòÉ 6.8. Version 1.30 ΓòÉΓòÉΓòÉ
  864.  
  865.    1. A new "Options" item, "Translate Non-English Characters" allows you to 
  866.       edit HTML documents using non-English characters directly. This feature 
  867.       mainly benefits users of code pages whose non-English characters are 
  868.       available on their keyboards. HTML Wizard will (if this option is 
  869.       checked) pass files through a filter that converts these characters to 
  870.       and from their corresponding HTML entities when loading and saving the 
  871.       files. So, instead of seeing ö, you will see a single 'o' character 
  872.       with the umlaute accent. If you do not have your keyboard set up for a 
  873.       non-English character set, it is best to leave this option off. No harm 
  874.       will be done in using it, but file I/O will be slower because it has to 
  875.       pass through the translator. See the online help for more details on this 
  876.       feature. 
  877.  
  878.    2. Forms support has finally been added. 
  879.  
  880.    3. "Save Without Tags" is done through a C++ program rather than REXX, so it 
  881.       is much faster now. As of now, only <....> tags are removed. Character 
  882.       entities such as & are not converted. I hope to have this implemented 
  883.       soon. 
  884.  
  885.  
  886. ΓòÉΓòÉΓòÉ 6.9. Version 1.25 ΓòÉΓòÉΓòÉ
  887.  
  888.    1. Added automatic insertion of <P> tags when text files are imported. (Can 
  889.       be toggled in the Options menu) 
  890.  
  891.    2. Added automatic insertion of <P> and <BR> tags when blocks of text are 
  892.       selected. 
  893.  
  894.    3. Added an option to control whether <LI> tags are automatically inserted 
  895.       when lists are created. 
  896.  
  897.    4. Added a "Save Without Tags" feature to save an HTML file without the HTML 
  898.       tags so that it can be imported into other editors, or to send text by 
  899.       email without all the tags, etc. Right now, this is done in REXX, so it 
  900.       can be painfully slow for a large file. Experiment with small files first 
  901.       to find out what your patience limit is. I have already coded this up in 
  902.       C++ to be much faster, but it will take a little time to get it merged 
  903.       seamlessly with HTML Wizard. It should make the next release, so this is 
  904.       just to whet your appetite. :-) 
  905.