home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 February / PCO2_97.ISO / filesbbs / os2 / htmlg120.arj / HTMLGEN.INF (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1996-03-18  |  19.3 KB  |  561 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. HTMLGen - An Overview ΓòÉΓòÉΓòÉ
  3.  
  4.  HTMLGen is a HTML script generator for OS/2. 
  5.  
  6. HTML scripts are used to generate Home Pages for World Wide Web browsers. 
  7.  
  8. HTMLGen provides a simple method for generating scripts.  By selecting the 
  9. appropriate tag, a dialog box will pop-up to gather data and fill in the 
  10. script. 
  11.  
  12.  
  13. ΓòÉΓòÉΓòÉ 2. Adding To Desktop ΓòÉΓòÉΓòÉ
  14.  
  15.  To place the program on your WPS Desktop use the following rexx script. 
  16.  
  17.   /* Place HTMLGen on Your Desktop */
  18.   rc = RxFuncAdd("SysLoadFuncs","RexxUtil","SysLoadFuncs")
  19.   rc = SysLoadFuncs()
  20.   rc = SysCreateObject("WPProgram","HTMLGen","","exename="||directory()||"\htmlgen.exe")
  21.   rc = SysSetIcon(directory()||"\htmlgen.exe","htmlgen.ico")
  22.  
  23.  
  24. ΓòÉΓòÉΓòÉ 3. Register ΓòÉΓòÉΓòÉ
  25.  
  26. REGISTRATION FORM FOR HTMLGen Version 1.20
  27.  
  28. Registration fee is $45.00 per copy.
  29.  
  30. North Carolina residents must include sales tax.
  31. In USA and Canada add $5.00 for shipping/handling.
  32. All other international shipments add $10.00.
  33.  
  34. See other documentation.
  35.  
  36. Send to: HTMLGen 1.20
  37.          American Coders, LTD
  38.          P.O. Box 97462
  39.          Raleigh, NC  27624
  40.  
  41. Name:______________________________________      Phone: ____________
  42. Company: ___________________________________     Phone: ____________
  43. Address: ___________________________________________________________
  44.          ___________________________________________________________
  45. City: _________________________    State: ______  Zip: _____________
  46.  
  47. InterNet ID: _____________________________________________________
  48.  
  49. Where did you find HTMLGen: _______________________________________
  50.  
  51. Registered users get a 30 day money back guarantee, 60 days free telephone
  52. support, unlimited support on CompuServe, free upgrades to the next release,
  53. and the VisPro/Rexx source code.
  54.  
  55. Internet: joe@usacoder.rtp.nc.us
  56.  
  57. CompuServe ID:  74150,2370
  58. CompuServe Support: GO OS2SHARE
  59.  
  60. Phone: (919) 846-2014.
  61.  
  62.  
  63. ΓòÉΓòÉΓòÉ 4. Cut and Paste ΓòÉΓòÉΓòÉ
  64.  
  65.  OS/2 Cut and Paste functions to the OS/2 clip-board are available. 
  66.  
  67. Cut       Press CTRL-Delete. To place mark text into the clipboard and remove 
  68.           it from the script area. Or use menu function from the Edit pull 
  69.           down. 
  70.  
  71. Copy      Press CTRL-Insert. To copy the marked area to the clip-board.Or use 
  72.           menu function from the Edit pull down. 
  73.  
  74. Paste     Press Shift-Insert to copy clip-board text at the cursors position. 
  75.           Or use menu function from the Edit pull down. 
  76.  
  77. Marking Text To Cut and Copy Press Shift and use the arrow keys to mark pieces 
  78.           of text in the script area. 
  79.  
  80.  
  81. ΓòÉΓòÉΓòÉ 5. Primary Window Menu ΓòÉΓòÉΓòÉ
  82.  
  83.  There are several window menus to simplify your job. 
  84.  
  85.  
  86. ΓòÉΓòÉΓòÉ 5.1. File ΓòÉΓòÉΓòÉ
  87.  
  88.  The file pull down provides access to OS/2 file system. 
  89.  
  90.  
  91. ΓòÉΓòÉΓòÉ 5.1.1. Open ΓòÉΓòÉΓòÉ
  92.  
  93.  Open will load the script area with an existing.  Any text in the script area 
  94. will be lost. 
  95.  
  96.  
  97. ΓòÉΓòÉΓòÉ 5.1.2. New ΓòÉΓòÉΓòÉ
  98.  
  99.  This will restart a script by removing existing text. 
  100.  
  101.  
  102. ΓòÉΓòÉΓòÉ 5.1.3. Save ΓòÉΓòÉΓòÉ
  103.  
  104.  This will save the script area to a file.  If a filename has not been defined 
  105. the File dialog will pop-up. 
  106.  
  107.  
  108. ΓòÉΓòÉΓòÉ 5.1.4. Save As ΓòÉΓòÉΓòÉ
  109.  
  110.  This will save the script area to a file. The File dialog will pop-up. 
  111.  
  112.  
  113. ΓòÉΓòÉΓòÉ 5.1.5. Insert Text ΓòÉΓòÉΓòÉ
  114.  
  115.  This will insert text from another file into the script area. Text in the 
  116. existing area will not be lost. 
  117.  
  118.  
  119. ΓòÉΓòÉΓòÉ 5.1.6. Browser ΓòÉΓòÉΓòÉ
  120.  
  121.  This will load the current text area to the defined file and call the Web 
  122. Browser you have defined on your system. 
  123.  
  124.  
  125. ΓòÉΓòÉΓòÉ 5.1.7. IPF Build ΓòÉΓòÉΓòÉ
  126.  
  127.  This will translate your HTML script into the IPF format. IPF is used by the 
  128. IBM IPFC compiler to generate INF and HLP files. 
  129.  
  130. IPFC compiler is not provide with HTLMGen. 
  131.  
  132.  
  133. ΓòÉΓòÉΓòÉ 5.1.8. Editor ΓòÉΓòÉΓòÉ
  134.  
  135.  This will load the current text area to the defined file and call an editor 
  136. you have defined. 
  137.  
  138.  
  139. ΓòÉΓòÉΓòÉ 5.1.9. Exit ΓòÉΓòÉΓòÉ
  140.  
  141.  This will exit the program.  Short-cut key is F3. 
  142.  
  143.  
  144. ΓòÉΓòÉΓòÉ 5.2. Edit ΓòÉΓòÉΓòÉ
  145.  
  146.  There are eight options provided to simplify editting the HTML text. 
  147.  
  148.  
  149. ΓòÉΓòÉΓòÉ 5.2.1. Copy ΓòÉΓòÉΓòÉ
  150.  
  151.  Copies marked text to clip board. 
  152.  
  153.  
  154. ΓòÉΓòÉΓòÉ 5.2.2. Cut ΓòÉΓòÉΓòÉ
  155.  
  156.  Copies marked text to clip board and deletes it. 
  157.  
  158.  
  159. ΓòÉΓòÉΓòÉ 5.2.3. Paste ΓòÉΓòÉΓòÉ
  160.  
  161.  Copies clip board to current cursor position. 
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ 5.2.4. Delete ΓòÉΓòÉΓòÉ
  165.  
  166.  Deletes marked  text. 
  167.  
  168.  
  169. ΓòÉΓòÉΓòÉ 5.2.5. Undo ΓòÉΓòÉΓòÉ
  170.  
  171.  Undoes last change to text.  One-level only 
  172.  
  173.  
  174. ΓòÉΓòÉΓòÉ 5.2.6. Search ΓòÉΓòÉΓòÉ
  175.  
  176.  Brings up Search dialog to find and change text. 
  177.  
  178.  
  179. ΓòÉΓòÉΓòÉ 5.2.7. Find Next ΓòÉΓòÉΓòÉ
  180.  
  181.  Find text as specified in search dialog. 
  182.  
  183.  
  184. ΓòÉΓòÉΓòÉ 5.2.8. Change Next ΓòÉΓòÉΓòÉ
  185.  
  186.  Changes text as specified as specified in search dialog. 
  187.  
  188.  
  189. ΓòÉΓòÉΓòÉ 5.3. Options ΓòÉΓòÉΓòÉ
  190.  
  191.  There are three options to provide HTMLGen with Browser/Editor and Text 
  192. prompting indicators. 
  193.  
  194.  
  195. ΓòÉΓòÉΓòÉ 5.3.1. Browser Defined ΓòÉΓòÉΓòÉ
  196.  
  197.  Will pop-up a dialog box asking for the command to load your Web browser. 
  198.  
  199.  
  200. ΓòÉΓòÉΓòÉ 5.3.2. Editor Defined ΓòÉΓòÉΓòÉ
  201.  
  202.  Will pop-up a dialog box asking for the command to load your editor. 
  203.  
  204.  
  205. ΓòÉΓòÉΓòÉ 5.3.3. Text Prompting ΓòÉΓòÉΓòÉ
  206.  
  207.  This will turn-on/off the dialog boxes when the Tagging functions are used. 
  208.  
  209.  
  210. ΓòÉΓòÉΓòÉ 5.3.4. IPF Conversion Options ΓòÉΓòÉΓòÉ
  211.  
  212.  There are three options available for the IPFC Conversion. 
  213. RES for Headings  Turn this on and a resource number will be assigned to each 
  214. heading. This is useful for creating HLP files.  HLP files work with PM Help 
  215. functions.  Resources are associated with PM items such when F1 is pressed when 
  216. the cursor is on a button, defining the HELP push button, etc... 
  217. Index for Headings  Turn this on and each heading will have a IPF index 
  218. assigned to it. For the Heading 1, only an I1 tag is created.  For all other 
  219. headings an I1 tag is created and an I2 tag with a reference to the previous I1 
  220. tag.  Indexes define what shows up in the INDEX for your both HLP and INF 
  221. files. 
  222.  
  223.  
  224. ΓòÉΓòÉΓòÉ 5.3.5. Edit Macros ΓòÉΓòÉΓòÉ
  225.  
  226.  This provides a dialog box to maintain your macros.  Prompts are shown in the 
  227. macro list and text is entered into the macro list when the prompt is 
  228. double-clicked. 
  229.  
  230. Macros are maintained an editable file HTMLGEN.MAC. The format is rather 
  231. simple.  A keyword "PROMPT:" is used to indicate a new macro. Text on the same 
  232. line as "PROMPT:" is used for the macro prompt. All text following the prompt 
  233. is considered to be macro "text" that is inserted into the HTML document when 
  234. the prompt is double-clicked. 
  235.  
  236.  
  237. ΓòÉΓòÉΓòÉ 5.4. Tags ΓòÉΓòÉΓòÉ
  238.  
  239.  Tags are the identifies for the browser on how to display and format text, 
  240. pull in external files, and layout the general document. 
  241.  
  242.  
  243. ΓòÉΓòÉΓòÉ 5.4.1. Headings ΓòÉΓòÉΓòÉ
  244.  
  245. Title  <Title> </Title> The Title Tag describes the title of the HTML Document 
  246.  
  247. Heading 1 <H1> </H1> The Heading 1 Tag marks the highest level sections in the 
  248.           document. Its text and font are the same size as the TITLES.  Think 
  249.           of Heading 1 Tags as chapter indicators. 
  250.  
  251.           Short-Cut Key is Ctrl-1. 
  252.  
  253. Heading 2 <H2> </H2> The Heading 2 Tag marks the second highest level sections 
  254.           within a Heading 1 section. Its text and font are smaller than a 
  255.           Heading 1.
  256.  
  257.           Short-Cut Key is Ctrl-2. 
  258.  
  259. Heading 3 <H3> </H3> The Heading 3 Tag marks the third highest level sections 
  260.           in a document and follows a Heading 2 section. Its text and font are 
  261.           smaller than a Heading 2.
  262.  
  263.           Short-Cut Key is Ctrl-2. 
  264.  
  265. Heading 4 <H4> </H4> The Heading 4 Tag marks the fourth highest level sections 
  266.           in a document and follows a Heading 3 section. Its text and font are 
  267.           smaller than a Heading 3.
  268.  
  269.           Short-Cut Key is Ctrl-3. 
  270.  
  271. Heading 5 <H5> </H5> The Heading 5 Tag marks the fifth highest sections and 
  272.           second lowest in a document and follows  a Heading 4 section. Its 
  273.           text and font are smaller than a Heading 4.
  274.  
  275.           Short-Cut Key is Ctrl-5. 
  276.  
  277. Heading 6 <H6> </H6> The Heading 6 Tag marks the lowest sections in a document 
  278.           and follows a Heading 5 section. Its text and font are smaller than a 
  279.           Heading 5.
  280.  
  281.           Short-Cut Key is Ctrl-6. 
  282.  
  283.  
  284. ΓòÉΓòÉΓòÉ 5.4.2. Lists ΓòÉΓòÉΓòÉ
  285.  
  286. Unordered Lists <UL> </UL> Unordered lists provide the ability to set off lists 
  287.           of text that are prefixed by bullets, dashes and filled circles. 
  288.           Unordered lists may be contained within other list types and may 
  289.           contain other list types.
  290.  
  291.           Short-cut key is Alt-u. 
  292.  
  293. Ordered Lists <OL> </OL> Ordered lists provide the ability to set off lists of 
  294.           text that are prefixed by a sequence of numbers.  Ordered lists may 
  295.           be contained within other list types and may contain other list types.
  296.  
  297.           Short-cut key is Alt-o. 
  298.  
  299. List Item (Order/Unordered List) <LI> </LI> List Item Tag provides an item 
  300.           within an Unordered or Order list. List Items must appear within an 
  301.           <UL> </UL> or <OL> </OL> block.
  302.  
  303.           Short-cut key is CTRL-i. 
  304.  
  305. Descriptive Lists <DL> </DL> Provides a list that contains a title and a 
  306.           description items.
  307.  
  308.           Short-cut key is Alt-d. 
  309.  
  310. Descriptive Title and Description. Descriptive Titles and Descriptions are used 
  311.           to mark informative areas of text. Descriptive Title and Text appear 
  312.           in pairs with in a <DL> </DL> block.
  313.  
  314.           Short-cut key is Ctrl-d. 
  315.  
  316.    Descriptive Title <DT> </DT> This provides for title for the following 
  317.              descriptive text. 
  318.  
  319.    Descriptive Description <DD> </DD> This provides a description used with the 
  320.              Descriptive Title. It may contain paragraphs, other lists and 
  321.              other information. 
  322.  
  323.  
  324. ΓòÉΓòÉΓòÉ 5.4.3. Blocks ΓòÉΓòÉΓòÉ
  325.  
  326. Preformatted Text <PRE> </PRE> The preformatted tag marks text for fixed-width 
  327.           font with carriage returns, spaces and tabs kept in place.  This 
  328.           section may contain other tags.
  329.  
  330.           Short-cut key is Alt-p. 
  331.  
  332. Quoted Text <BLOCKQUOTE> </BLOCKQUOTE> The block quote tag marks text for 
  333.           fixed-width font with carriage returns, spaces and tabs kept in 
  334.           place.  This section may contain other tags.
  335.  
  336.           Short-cut key is Alt-q. 
  337.  
  338. Address <ADDRESS> </ADDRESS> The address tags is used to describe the author of 
  339.           the document.  It is usually the last item in the document.  This 
  340.           section may contain other tags.
  341.  
  342.           Short-cut key is Alt-a. 
  343.  
  344. Anchor Name <A> </A> The anchor name text provides to ability for other 
  345.           sections of the document to refer back to this section of text. 
  346.  
  347.           Short-cut key is Alt-n. 
  348.  
  349. Anchor Reference <A HREF=> </A> The anchor name text provides to ability to 
  350.           refer back to another section of text mark by an anchor name. 
  351.  
  352.           Short-cut key is Alt-r. 
  353.  
  354.  
  355. ΓòÉΓòÉΓòÉ 5.4.4. Formats ΓòÉΓòÉΓòÉ
  356.  
  357.  Formats provide changing the fonts of text.
  358.  
  359. o ITALICS 
  360.  
  361.    - Italics <I> </I> - Short-cut key is Ctrl-i. 
  362.  
  363.    - Emphasized Italics <em> </em> - Short-cut key is Ctrl-e. 
  364.  
  365.    - Citation <cite> </cite> - Short-cut key is Ctrl-c. 
  366.  
  367.    - Variable <var> </var> - Short-cut key is Ctrl-i. 
  368.  
  369. o BOLDS 
  370.  
  371.    - Bold <b> </b> - Short-cut key is Ctrl-b. 
  372.  
  373.    - Strong bold <strong> </strong> - Short-cut key is Ctrl-s. 
  374.  
  375. o MONO-SPACED 
  376.  
  377.    - Typewriter <TT> </TT> - Short-cut key is Ctrl-t. 
  378.  
  379.    - Code <CODE> </CODE> - Short-cut key is Ctrl-C. 
  380.  
  381.    - Sample <SAMP> </SAMP> - Short-cut key is Ctrl-s.. 
  382.  
  383.    - Keyboard <KDB> </KBD> - Short-cut key is Ctrl-k. 
  384.  
  385. o Definition <DFN> </DFN> - Short-cut key is Ctrl-d. 
  386.  
  387.    May not work with some Mosaic browsers. 
  388.  
  389.  
  390. ΓòÉΓòÉΓòÉ 5.4.5. Special Characters ΓòÉΓòÉΓòÉ
  391.  
  392. o 'Less Than' character '<' is <. 
  393.  
  394. o 'Greater Than' character '>' is >. 
  395.  
  396. o 'Ampersand' character '&' is &. 
  397.  
  398. o The paragraph marker indicates a new paragraph. <P> </P> - can be used to 
  399.   indicate an end of a paragraph block. Short-cut key is Ctrl+Enter. 
  400.  
  401.  
  402. ΓòÉΓòÉΓòÉ 5.4.6. Images ΓòÉΓòÉΓòÉ
  403.  
  404. Inline Images <IMG SRC=...> Provides inline GIF or x-systems XBM pictures to 
  405.           display within your the document. 
  406.  
  407.           Short-cut key is ALT-SHIFT-I. 
  408.  
  409. External Images <A HREF = ...>link anchor</A> Refers to GIF or XBM files that 
  410.           reside elsewhere. It also provides for referencing. See Anchors. 
  411.           Short-cut key is ALT-SHIFT-E. 
  412.  
  413.  
  414. ΓòÉΓòÉΓòÉ 6. Dialog Boxes ΓòÉΓòÉΓòÉ
  415.  
  416.  There are several dialog boxes to assist you in generating your HTML script. 
  417. These boxes can be disabled by turning off the Text Prompting off of options. 
  418. When Text Prompting is turned off, you are not prompted for text and the tag is 
  419. immediately inserted into the script.
  420.  
  421.  The titles of the dialog boxes will change depending on the tag being 
  422. generated and what type of work it is doing. 
  423.  
  424.  
  425. ΓòÉΓòÉΓòÉ 6.1. Desc Dialog Box ΓòÉΓòÉΓòÉ
  426.  
  427.  This box is used to define both the Descriptive Item Heading and Descriptive 
  428. Item Text.  This will generate the <DT> and </DD> tags.  If text is not entered 
  429. into either fields the tagged items are added to the script only, respectfully. 
  430.  
  431.  
  432. ΓòÉΓòÉΓòÉ 6.2. Ext Dialog Box ΓòÉΓòÉΓòÉ
  433.  
  434.  This box is used to define an external file anchor.  The dialog will generate 
  435. the <A HREF=xxxxx#yyyyy>zzzzz</A> tag.  Where xxxxx is the name of the external 
  436. (referenced) file, yyyyy is the named anchor and zzzzz is the text that will be 
  437. highlighted and provide linking. 
  438.  
  439.  
  440. ΓòÉΓòÉΓòÉ 6.3. Extern Dialog Box ΓòÉΓòÉΓòÉ
  441.  
  442.  This box is used to define an external image file and reference text. The 
  443. dialog will generate the <A HREF=xxxxx>zzzzz</A> tag.  Where xxxxx is the name 
  444. of the external(image file and zzzzz is the text that will be highlighted and 
  445. provide linking.
  446.  
  447.  The FIND button starts the PM Find File dialog to help you search for a file.
  448.  
  449.  Supported image files are 
  450.  
  451. o GIF 
  452.  
  453. o TIFF 
  454.  
  455. o JPEG 
  456.  
  457. o RGB 
  458.  
  459. o HDF 
  460.  
  461.  
  462. ΓòÉΓòÉΓòÉ 6.4. Inline Image Dialog Box ΓòÉΓòÉΓòÉ
  463.  
  464.  This box provides the IMG tag to alloc for XBM and GIF format images inside 
  465. your HTML document.  This tag is not recognized by all browsers. 
  466.  
  467. The FIND button starts the PM Find File dialog to help you search for a file. 
  468.  
  469.  
  470. This window is also used to define files for browsers and editors. We took a 
  471. short cut here. This dialog box is multipurpose. 
  472.  
  473.  
  474. ΓòÉΓòÉΓòÉ 6.5. Single Line Dialog Box ΓòÉΓòÉΓòÉ
  475.  
  476.  This box is used for tags that use a single line of text, such as headers and 
  477. the address tags. 
  478.  
  479.  
  480. ΓòÉΓòÉΓòÉ 6.6. Anchor Dialog Box ΓòÉΓòÉΓòÉ
  481.  
  482.  The box will allow you to define an anchor title and text. It generates an <A> 
  483. </A> tag. 
  484.  
  485.  
  486. ΓòÉΓòÉΓòÉ 6.7. Simple Text Dialog Box ΓòÉΓòÉΓòÉ
  487.  
  488.  This box is used for tags that use multiple lines of text, such as tagging 
  489. formatted text or defining block quotes. The dialogs main item is a multi-line 
  490. edit field.  This field supports most of OS/2 cut and paste functions. 
  491.  
  492.  
  493. ΓòÉΓòÉΓòÉ 6.8. Tables ΓòÉΓòÉΓòÉ
  494.  
  495.  Several functions are available to assist in creating tables. 
  496.  
  497. Create    This kicks off a dialog for creating a complete definition for a 
  498.           table. All rows and columns are filled in based on response to the 
  499.           dialog. 
  500.  
  501. Header    This creates a tag for specifying a column heading in a table. <TH> 
  502.           </TH> 
  503.  
  504. Data      This creates a tag to indicate data in a column row. <TD> </TD> 
  505.  
  506. Row       This inserts a new row tag in the dialog <TR>. 
  507.  
  508.  
  509. ΓòÉΓòÉΓòÉ 7. History Of Changes ΓòÉΓòÉΓòÉ
  510.  
  511.  HTMLGen 1.20  A HTML Script Generator 
  512.  
  513.  History of changes. 
  514.  
  515.  1. Version 1.20 Mar. 15, 1996 
  516.  
  517.    o Improved editor 
  518.  
  519.    o Added tables to tags. 
  520.  
  521.    o Rearranged screen layout. 
  522.  
  523.  2. Version 1.10 Aug. 15, 1995 
  524.  
  525.    o Added user-defined macro support. 
  526.  
  527.    o Added a backslash to the end of the special characters & . 
  528.  
  529.  3. Version 1.05 Jan. 31, 1995 
  530.  
  531.    o Corrected problem with data entry fields being too short or not usable. 
  532.  
  533.    o Improved help. 
  534.  
  535.    o Allowed both HTML script and IPF script screens to be re-sizable. 
  536.  
  537.  4. Version 1.04 Jan. 25, 1995 
  538.  
  539.    o Corrected problem with files, i.e. your browser, being corrupted 
  540.  
  541.    o Enlarged field lengths. 
  542.  
  543.    o Corrected problem with some tags. 
  544.  
  545.  5. Version 1.03 Jan. 21, 1995 
  546.  
  547.    o Integrated Browser/Editor programs. 
  548.  
  549.    o Added INI file. 
  550.  
  551.    o Improved IPF converter. 
  552.  
  553.  6. Version 1.02 Jan. 14, 1995 
  554.  
  555.    o First general release. 
  556.  
  557.  
  558. ΓòÉΓòÉΓòÉ 8. Author's Address and Information. ΓòÉΓòÉΓòÉ
  559.  
  560.  American Coders, LTD  joe@usacoder.rtp.nc.us (919) 846-2014 Copyright 1995 - 
  561. All rights reserved