home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 25 / CDROM25.iso / Share / os2 / html / htmlwiz.INF (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1996-05-05  |  35.7 KB  |  1,031 lines

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