home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / smehtm11.zip / smehtm.hlp (.txt) < prev    next >
OS/2 Help File  |  1996-12-02  |  37KB  |  827 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Smalled HTML Extensions ΓòÉΓòÉΓòÉ
  3.  
  4. SMEHTM 1.00
  5.  
  6. The Smalled HTML Extensions are written as extensions for the Smalled editor. 
  7. However, SMEHTM can be used with any other MLE based editor, such as the OS/2 
  8. system editor or Zed. The Extensions act as a floating toolbar in the form of a 
  9. notebook. Also included in this package is an HTML example page that shows some 
  10. useful samples of HTML tags. 
  11.  
  12.      Disclaimer Registering/Shareware 
  13.      Using SMEHTM 
  14.      The Pages 
  15.      What's New/History 
  16.      Future Attractions 
  17.      About the Author 
  18.      Smalled 
  19.      Thanks 
  20.      Registering 
  21.  
  22.  
  23. ΓòÉΓòÉΓòÉ 1.1. Using the Smalled HTML Extensions ΓòÉΓòÉΓòÉ
  24.  
  25.  When you start using SMEHTM, the first thing you should do is give the main 
  26. window the dimensions and place you prefer on the screen. These will be 
  27. remembered. (The SMEHTM controls may have different sizes for different screen 
  28. resolutions.) 
  29.  
  30. The next thing to do is to decide which editor you will use. SMEHTM was built 
  31. with Smalled in mind, but it will function with any MLE based editor, such as 
  32. the system editor (E.EXE). The first time SMEHTM is started, it will 
  33. automatically start the system editor. It's fairly certain that everyone has 
  34. this editor. If another editor is preferred, use the Config page to tell the 
  35. Smalled HTML Extensions to use that editor. (SMEHTM can be started from within 
  36. Smalled v1.4 or higher. In that case this setting doesn't have any meaning.) 
  37.  
  38. Every time a button in SMEHTM is pressed a tag will be entered in the editor, 
  39. and the focus is then returned to the editor. All the HTML tags supported by 
  40. SMEHTM are explained in the sections about the SMEHTM pages. 
  41.  
  42. Most of the time an HTML tag consists of two pieces, between which is text that 
  43. will  be formatted. For example, <H1>formatted text</H1>. You can press the 
  44. Heading 1 key on the SMEHTM Font page and these tags will be entered in the 
  45. text as <H1></H1> with the cursor between them. You can then start typing right 
  46. away. This method is mostly used for writing an HTML page from scratch. 
  47. Another method for entering HTML tags is to select the text you want to format 
  48. and then hit the appropriate button in SMEHTM. The tags will be placed around 
  49. the selected text and the selected text will stay intact. This method is used 
  50. when adding tags to already existing text. 
  51.  
  52. The exception to this rule is the Char page which can be used to add accents to 
  53. letters. If this is desired, you must select exactly one letter, or (since 
  54. 1.10) place the cursor right after the letter you want to accent and hit the 
  55. accentbutton of choice. If more than one character is selected nothing will 
  56. happen. 
  57.  
  58. Many of the pages in SMEHTM contain controls other than buttons. These controls 
  59. are always grouped together with at least one button. If these controls (most 
  60. of them are spinbuttons) don't contain a value or show the value 0, nothing 
  61. will be inserted in their place in the tag. Many tags can have different forms. 
  62. The <HR> tag, for example, has many possible combinations. Here are some of 
  63. them: 
  64.  
  65. Example 
  66.  
  67. <HR>
  68. <HR NOSHADE>
  69. <HR WIDTH=66% NOSHADE>
  70. <HR ALIGN=right SIZE=4 WIDTH=66 NOSHADE>
  71.  By using the extra controls described above, any of these combinations can be 
  72. made very quickly. 
  73.  
  74. SMEHTM supports fast keys to access the several pages and controls. This is 
  75. described in the section Moving around. Most things should be pretty intuitive, 
  76. but it wouldn't hurt to read this section. 
  77.  
  78.  
  79. ΓòÉΓòÉΓòÉ 1.1.1. Moving Around ΓòÉΓòÉΓòÉ
  80.  
  81.  All the controls in SMEHTM support shortcuts. Take a look at the buttons and 
  82. tags and you will see some of the letters are underlined. This means these 
  83. controls can be activated with the push of just one button. You can jump from 
  84. page to page by typing just the first letter of the tag. The same goes for the 
  85. buttons. They can be accessed with the ALT key in combination with the 
  86. underlined letter on the button. 
  87. Another way to access the SMEHTM function quickly is to use the possibility to 
  88. define hotkeys. See the hotkeys page for more information 
  89.  
  90. There is one snag though. These keys only act on the active window. With a 
  91. notebook there are always two possibilities. 
  92.  
  93.      The notebook window is active. If this is the case, an emphasis rectangle 
  94.       is drawn in the current active tab and you can move to other pages just 
  95.       by pressing the first letter of the tab or by using the left/right 
  96.       arrows. If this window isn't active (emphasis rectangle isn't showing), 
  97.       just click on the status line to activate it. The status line is the area 
  98.       next to the two arrow pushbuttons. 
  99.      The dialog in one of the notebook pages is active. You can tell if this 
  100.       is the case by looking at the controls in the dialog. One of these 
  101.       controls should have the focus. Another way of detecting this is to look 
  102.       at the notebook control. When this doesn't have the focus, the dialog 
  103.       probably will. (Of course the frame needs to be selected.)  When this is 
  104.       the case, buttons can be activated with the ALT-letter combination. If 
  105.       this is done, the function associated with the button will be executed. 
  106.  
  107.  Another way of moving between controls is the tab key. If this key is pressed, 
  108.  the next control will be made active. Pressing Return will activate the 
  109.  current control. 
  110.  
  111.  
  112. ΓòÉΓòÉΓòÉ 1.2. The Smalled HTML Extensions Pages ΓòÉΓòÉΓòÉ
  113.  
  114.  All controls in SMEHTM are ordered in a notebook. Every page in this notebook 
  115. handles a different aspect of the HTML tagging language. (This means the number 
  116. of pages will certainly grow in the future.)  In the help description of each 
  117. page, a short explanation of the HTML code which is handled by that page 
  118. appears. Also in the SMEHTM package is an example HTML page which contains a 
  119. number of samples. 
  120.  
  121.      Main 
  122.      Font 
  123.      Page 
  124.      Char 
  125.      List 
  126.      Link 
  127.      Table 
  128.      Image 
  129.      Templates 
  130.      Tools 
  131.      Usertags 
  132.      Config 
  133.      Register 
  134.  
  135.  
  136. ΓòÉΓòÉΓòÉ 1.2.1. Page 1 (Main) ΓòÉΓòÉΓòÉ
  137.  
  138.  The Main page is used to set up the mandatory items for a basic HTML document. 
  139. By pressing the Basic button on this page, the mandatory HTML tags are added to 
  140. the text editor window. It doesn't matter how much text already exists in the 
  141. editor, this command will add the necessary codes at the top and bottom of the 
  142. text. 
  143.  
  144. If the two entry fields on the Main page are not filled, the Smalled HTML 
  145. Extensions will add the mandatory codes in their simplest form. In this case, 
  146. the following will be added: 
  147.  
  148. Basic code 
  149.  
  150. <!DOCTYPE HTML "-//IETF//DTD HTML//EN">
  151. <!--Smalled HTML Extensions-->
  152. <HTML>
  153. <HEAD><TITLE></TITLE></HEAD>
  154. <BODY>
  155. </BODY>
  156. </HTML>
  157. The first two lines in this sample are Comment lines. They are added to 
  158. identify the document. Some browsers like to see the first line. The second 
  159. line is added to show that the document was created with the Smalled HTML 
  160. Extensions. 
  161. The next statement is the first real HTML statement, <HTML>. The <HTML> tag 
  162. defines that the document is an HTML page. Note that the document is closed at 
  163. the end with </HTML>, nothing beyond </HTML> will show up in your document. 
  164.  
  165. The <HEAD> element contains information about the document. The <HEAD></HEAD> 
  166. combination must be between the <HTML> and the <BODY> tags. In most cases it 
  167. will only contain the <TITLE> tag. 
  168. With the <TITLE> tag, a line can be entered that describes the document. This 
  169. title will appear in the titlebar of the browser you're using when viewing an 
  170. HTML document. This text can be entered in the Title text field on the Main 
  171. page. SMEHTM will automatically enter this text between the <TITLE> and 
  172. </TITLE> tags. 
  173.  
  174. In most HTML pages, a background image is used. To accomplish this, the <BODY> 
  175. tag has to be modified. This tag uses a BACKGROUND= statement to accomplish 
  176. this. Behind this statement the name of an image file (GIF, JPG...) must be 
  177. entered between quotes. If the name of an image file is entered in the 
  178. Background image field, SMEHTM will change the <BODY> statement appropriately 
  179. when the basic code is entered. 
  180.  
  181.  
  182. ΓòÉΓòÉΓòÉ 1.2.2. Page 2 (Font) ΓòÉΓòÉΓòÉ
  183.  
  184.  An HTML document doesn't have the capability to handle text that a word 
  185. processor has. It can only display one font at a time, but it can do a lot with 
  186. that one font. In the Font page most of the possibilities are available (not 
  187. all though: things like color, etc. aren't yet supported by SMEHTM). 
  188.  
  189. The page is divided into logical groups. Some tags listed in this page will 
  190. have the same effect. This will depend on the browser you are using. 
  191.  
  192. The tags in the Heading section display the six Heading style possibilities. 
  193. The heading dictates the size of the text formatted with it. Heading tags look 
  194. like: <H#></H#> 
  195.  
  196. The Font Style section gives access to tags that will format the font style of 
  197. your text. The most commonly used are Italic, Bold and Underline. The following 
  198. tags are supported by SMEHTM (note that some of these tags might not be 
  199. supported by all browsers): 
  200.  
  201.      I  Italic 
  202.      B  Bold 
  203.      U  Underline 
  204.      S  Strikeout 
  205.      BL Blink 
  206.      TT TeleType (code sample) 
  207.  
  208.  The Font  section gives the opportunity to set the size of the font that will 
  209.  be displayed. In HTML, it is possible to work with a base font size and define 
  210.  derivatives from that size. The philosophy of SMEHTM is to use the default 
  211.  font size and customize it when needed with the heading tag, or to set the 
  212.  font size by using the size button. 
  213.  
  214.  HTML defines several ways to include code  Samples and quotations. SMEHTM 
  215.  supports four of these tags. 
  216.  
  217.      Code Sample - This is used to display a code sample in a fixed-width 
  218.       font. This usually has the same effect as TT. 
  219.      Block Quote - This produces a text quote usually right and left indented. 
  220.      Citation - Also used to display citations or quotes but gives the text 
  221.       inline in Italics. 
  222.      Sample - Is also used to show a code sample and has the same effect as 
  223.       Code in most browsers. 
  224.  
  225.  HTML has the ability to give certain lines of text an Emphasis. In most cases 
  226.  Normal emphasis has the same effect as Italic and Strong emphasis has the same 
  227.  effect as Bold. 
  228.  
  229.  Sub/Super-script tags are also possible. However, not all browsers support 
  230.  them. 
  231.  
  232.  
  233. ΓòÉΓòÉΓòÉ 1.2.3. Page 3 (Page) ΓòÉΓòÉΓòÉ
  234.  
  235.  The Page page contains a number of items that are useful in doing layout work. 
  236. Besides that, it contains the Comment tag (I didn't know where else to put it). 
  237. This page is divided in two sections. 
  238.  
  239. The Layout section contains the following tags: 
  240.  
  241.      Center - This button will insert the <CENTER></CENTER> tags. All text, 
  242.       links, tables, images, etc. that are between these tags will be displayed 
  243.       centered on the screen or in the current indent. 
  244.      Line Break - This forces a 'Hard return' in the text. 
  245.      Paragraph - The <P></P> tags are used to format text into paragraphs. 
  246.       Between two paragraphs there will be a blank line. The <P> tag is one of 
  247.       the tags that don't need a closing tag. SMEHTM will only insert a closing 
  248.       tag is the <P></P> pair is placed around a selection. If no selection is 
  249.       made only the <P> tag will be inserted. 
  250.  
  251.  The Horizontal line section will create a <HR> tag. This tag creates a line on 
  252.  the web page which by default will span the page within the current indents. 
  253.  There are several ways this line can be modified. For this, the other controls 
  254.  in this section can be used. If there aren't any values filled in, SMEHTM will 
  255.  generate a plain <HR> tag. Depending on the settings in the other controls, 
  256.  this tag will be modified as follows: 
  257.  
  258.      Noshade - The Noshade option turns off the bevelling effect added in some 
  259.       browsers. 
  260.      Align - Justifies the line to the left, right or center (default). 
  261.      Size - Sets the thickness of the line. 
  262.      Width - Sets the line length in pixels or as a percentage of the page 
  263.       width (within the current indents). 
  264.  
  265.  The Comment tag is somewhat special. It doesn't have anything to do with page 
  266.  layout whatsoever. It simply allows you to add comment statements to your HTML 
  267.  text that won't show up in the web page when viewed on a WWW browser. This 
  268.  statement can be used for personal documentation. 
  269.  
  270.  
  271. ΓòÉΓòÉΓòÉ 1.2.4. Page 4 (Char) ΓòÉΓòÉΓòÉ
  272.  
  273.  Computers can write characters with accents, and a number of sign characters. 
  274. However, because of codepages, these characters can be located in very 
  275. different places within the extended ASCII table. HTML has a solution for this; 
  276. these characters are replaced by an HTML tag. 
  277.  
  278. The first section of this page, Accenting , takes care of various accents on 
  279. characters. To place an accent on a character simply place the cursor after the 
  280. letter you whish to handle, or select it (select exactly one character) and 
  281. press the button (or hotkey) with the desired accent. If that accent is 
  282. supported for the selected character, this character will be replaced with the 
  283. HTML equivalent. If the accent isn't supported for that character, nothing 
  284. happens. 
  285. Note: This is changed since version 1.10. The fact that you can leave the 
  286. cursor after the letter and then accent it, means that you can keep on typing 
  287. if you also use Hotkeys. The cursor will be placed after the inserted tag when 
  288. it is set. 
  289.  
  290. Some characters, like the > and < characters, are reserved because they are 
  291. part of the HTML tagging language. If you want to use these characters in your 
  292. document, use the corresponding buttons in the Reserved area. 
  293.  
  294. In the Characters area a number of character and symbols, such as the copyright 
  295. symbol, can be selected. Pressing one of these buttons will cause the HTML tag 
  296. for that symbol to be inserted in the text. 
  297.  
  298.  
  299. ΓòÉΓòÉΓòÉ 1.2.5. Page 5 (List) ΓòÉΓòÉΓòÉ
  300.  
  301.  A powerful feature of HTML is the ability to use lists in a number of ways. 
  302. This is a very commonly used feature on the WWW. Almost every web page that has 
  303. a list of links to favorite pages uses this statement. In the example HTML page 
  304. provided with SMEHTM a number of list samples can be found. 
  305. One of the most attractive features of these lists is that they can be nested. 
  306.  
  307. Note:  not all browsers support all the possibilities that HTML offers. 
  308.  
  309. HTML supports three different types of lists. 
  310.  
  311.      Ordered lists 
  312.      Unordered lists 
  313.      Definition lists 
  314.  
  315.  Ordered lists display a list with numbered items. By default the list is 
  316.  numbered with normal (Arabic) numbers. If you want to use another type, select 
  317.  it in the Type spinbutton. The following types are supported: 
  318.  
  319.      1, 2, 3 (default) 
  320.      A, B, C 
  321.      a, b, c 
  322.      I, II, III 
  323.      i, ii, iii 
  324.  
  325.  For every ordered list a starting number can be defined. By default a list 
  326.  will start at 1 (or A, a, I or i). By using the Start spinbutton, you can 
  327.  change this value. If, for example, a 5 is added, the list will start 
  328.  numbering the elements with 5. If this spinbutton is set to 0, the Start 
  329.  option will be ignored. 
  330.  
  331.  Unordered lists are lists in which every element has a bullet. Every time a 
  332.  new nested list (a list which is an item in another list) is created, the 
  333.  bullet will change. It is also possible to select the type of bullet for any 
  334.  list with the Type spinbutton. 
  335.  
  336.      disc 
  337.      circle 
  338.      square 
  339.  
  340.  If this spinbutton is left blank the default type will be used. Note that not 
  341.  all browsers support all three bullet types. 
  342.  
  343.  Definition lists are a special type of list used to combine a term and a 
  344.  definition. These form coupled pairs in which the term is displayed on one 
  345.  line and the definition is indented on the next line(s). For an example of 
  346.  Definition lists see the HTML file included in this package. 
  347.  
  348.  
  349. ΓòÉΓòÉΓòÉ 1.2.6. Page 6 (Link) ΓòÉΓòÉΓòÉ
  350.  
  351.  Links... Well, these are what a Hypertext document is all about. With links, 
  352. you're able to jump to other places on the Web or within your document, display 
  353. pictures, start an e-mail session, retrieve a file, etc. HTML supports many 
  354. different types of links. The most important (and most used) are supported by 
  355. SMEHTM. 
  356.  
  357. Looking more precisely at links, we see that what is defined is the beginning 
  358. or end of a link. In most cases it will be the beginning. In such a link 
  359. (anchor) we define a URL (Unique Resource Locator) and the access method for 
  360. that URL. The URL for a given access method can be typed in the entryfield 
  361. beside the desired access method. Clicking on the appropriate button causes the 
  362. link to be inserted. After this, we simply type the text that will be 
  363. highlighted as a link in the web page. SMEHTM supports the following access 
  364. methods: 
  365.  
  366.      http:// - This link will give a connection to another web page. The URL 
  367.       expected is another page on the web (for example, 
  368.       http://www.wilmington.net/bmtmicro/). 
  369.      ftp:// - This will give a connection to an FTP site (for example, 
  370.       ftp://hobbes.nmsu.edu). You can also add a direct download link to an FTP 
  371.       site (for example, ftp://hobbes.nmsu.edu/os2/editors/smaled13.zip). 
  372.      mailto: - This is a very nice feature. When this link is added to a page, 
  373.       the WWW browser will display a form from which a user can send an e-mail 
  374.       message to the given address. 
  375.      file: - This link isn't used very much. It creates a link to a local file 
  376.       (one on the hard drive of the user). 
  377.      HTML ref - This button exists because HTML supports a number of access 
  378.       methods that aren't available in SMEHTM. A plain <A HREF=""> tag is added 
  379.       to which the user can add access methods like news, gopher, wais, etc. 
  380.  
  381.  Besides these links, HTML also allows the possibility to provide NAME labels. 
  382.  A NAME label is a point in your text marked with a certain name. You can add a 
  383.  link anywhere that will take you directly to this label (a jump if you like). 
  384.  A label is added with the NAME button. A reference to this label is added with 
  385.  the # button. The example HTML page in this package shows a number of label 
  386.  possibilities. 
  387.  
  388.  The Link page also has another convenient feature. For every type of link 
  389.  there is a four store memory available. The contents of each listbox can be 
  390.  accessed by pressing the little button on the right of the entryfield or by 
  391.  using the up/down cursor keys. 
  392.  Every listbox can store four memory items. These can be filled by typing in 
  393.  the link name and hitting the Enter key on the keyboard. An audio signal will 
  394.  notify you that a new item is stored in memory. If a new item is added and the 
  395.  store already contains four items, the top-most item is discarded. 
  396.  The stored items will be remembered by SMEHTM between sessions. 
  397.  
  398.  
  399. ΓòÉΓòÉΓòÉ 1.2.7. Page 7 (Table) ΓòÉΓòÉΓòÉ
  400.  
  401.  A powerful but underestimated feature of HTML is the capability to build 
  402. attractive tables. A nice example how tables can be built is Gary Hammer's Must 
  403. Have Utilities List. The Table page is the most crowded page in SMEHTM. This 
  404. gives an indication of what can be done with tables. This page has two main 
  405. sections, one for creating a table and one for adding table items. 
  406.  
  407. With the table section, all kinds of tables can be set up. As within all SMEHTM 
  408. pages, if a spinbutton doesn't show any value or is filled with a 0, the 
  409. corresponding attributes won't be added to the tag. The <TABLE> tag can have 
  410. the following attributes: 
  411.  
  412.      Border - Including this attribute will draw borders around all cells. The 
  413.       border thickness can be specified in pixels. 
  414.      Spacing - The cell spacing gives the amount of space in pixels between 
  415.       individual cells. 
  416.      Padding - This sets the space in pixels between the border of the cell 
  417.       and the contents of the cell. 
  418.      Width - The width sets  the desired width of the table. This can be in 
  419.       pixels or in a percentage (% checkbox) of the page width. 
  420.  
  421.  The Caption button is a special case. With the caption tag you can add a title 
  422.  to the table. Use the spinbutton to set the placement to top or bottom. 
  423.  
  424.  The Cell/Row section contains buttons for adding rows, cells and headers. 
  425.  
  426.      Row - This is a mandatory element in a table. It tells the browser to 
  427.       start a new row in the table. Every time a new row is desired, this tag 
  428.       should be added. To modify the row element use the Align and Valign 
  429.       spinbuttons. These tell the browser how to align (and vertically align) 
  430.       the text in the row. 
  431.      Data - This button will start a new cell. If data (text, graphics, etc.) 
  432.       is to be added, this tag is mandatory. The cells can be tailored to suit 
  433.       different needs; for this the following attributes are used : 
  434.         -  Width - Gives the width of the cell either in pixels or in 
  435.            percentage (use the % checkbox) of the table. 
  436.         -  Colspan - Specifies how many columns a cell should span. 
  437.         -  Rowspan - Specifies how many rows a cell should span. 
  438.      Header - This button adds a table heading tag. This tells the browser to 
  439.       start a heading cell. Such a cell is the same as a normal (data) cell, 
  440.       but the contents are usually centered and bold. 
  441.      Clear - The clear button doesn't add an HTML tag. It is only added for 
  442.       convenience and will clear the spinbuttons in the Cell/Row section. 
  443.  Note: The <TD>, <TH> and <TR> tags don't need a closing tag. (Although it 
  444.  might be needed to get the desired effect). SMEHTM will only insert a closing 
  445.  tag for these tags if they are placed upon a selection. Is no selection 
  446.  active, only the opening tag is placed. 
  447.  
  448.  When the Data, Header or Row buttons are used, SMEHTM takes only those 
  449.  attributes from the page that are valid for the chosen button. The Header tag 
  450.  may have all the attributes, the Row tag only the Valign and Align attributes 
  451.  and the Data tag can only have those attributes not used by Row. 
  452.  
  453.  
  454. ΓòÉΓòÉΓòÉ 1.2.8. Page 8 (Image) ΓòÉΓòÉΓòÉ
  455.  
  456.  Most web pages contain a wealth of images. (Don't overdo this though, it will 
  457. make loading the page relatively slow.)  With the Image page, an image can be 
  458. added to an HTML page. Note that an image can also be used as a link or as part 
  459. of a table. 
  460.  
  461. Images in HTML pages are usually .gif or .jpg files. In the entryfield beside 
  462. the Image button the name of such a file can be entered. This can be just a 
  463. file name or a complete URL for the image. With images, a large number of 
  464. attributes are possible. 
  465.  
  466.      Alt - With the Alt attribute, alternate text can be added in case the 
  467.       browser can not display the image. I strongly recommend including 
  468.       alternate text. 
  469.      Height/Width - These attributes can scale the image. If only one of them 
  470.       is filled in, the other will be scaled accordingly. It's a very good idea 
  471.       to specify these values. This allows browsers to format and display text 
  472.       before images and so create the feel of a quicker loading time. 
  473.      Align - Will align the picture on the page. 
  474.      Hspace/Vspace - Will set the horizontal and vertical space around the 
  475.       image. 
  476.      Border - When an image is included in a link, the border indicating this 
  477.       can be re-sized. 
  478.  
  479.  
  480. ΓòÉΓòÉΓòÉ 1.2.9. Page 9 (Templates) ΓòÉΓòÉΓòÉ
  481.  
  482.  The Templates function of the Smalled HTML Extensions can be very useful. 
  483. SMEHTM allows 6 templates to be entered and remembered. 
  484.  
  485. What is a template?  Well, it's simply the name of a file somewhere on the 
  486. system that contains text that can be inserted at the current cursor position 
  487. in the editor. Certain constructions that are used very often can be placed in 
  488. such a file. This way they will only be one button click away. 
  489.  
  490.  
  491. ΓòÉΓòÉΓòÉ 1.2.10. Page 10 (Usertags) ΓòÉΓòÉΓòÉ
  492.  
  493.  The User tags  page is added in version 1.10. This page enables the user to 
  494. create a number of tags that arent suported by SMEHTM. Because HTML is 
  495. constantly changing, this is a method to keep SMEHTM more or less up to date. 
  496.  
  497. Six tags can be inserted and remembered. Fill in the opening tag in the left 
  498. entryfield and the closing tag in the right entryfield. It is advised to enter 
  499. the tags in UPPERCASE. This way the tags will be consistant with the rest of 
  500. SMEHTM. If Insert tags in lowercase is choosen in the config-page, SMEHTM will 
  501. convert the uppercase tags to lowercase. 
  502.  
  503.  
  504. ΓòÉΓòÉΓòÉ 1.2.11. Page 11 (Tools) ΓòÉΓòÉΓòÉ
  505.  
  506.  The tools page doesn't contain any HTML tagging functions. It contains three 
  507. functions that can make editing an HTML document a lot easier. All three 
  508. functions only work with selected text, so if there isn't any text selected in 
  509. the editor, the buttons in this page won't function. Also the functions only 
  510. work with tags in the form <......>. This means tags like :Aacute; won't be 
  511. touched. 
  512.  
  513.      Strip removes all the HTML tags from the currently selected text. 
  514.      Lower converts all the tags in the selected text to lower case. 
  515.      Upper converts all the tags in the selected text to Upper case. 
  516.  
  517.  
  518. ΓòÉΓòÉΓòÉ 1.2.12. Page 12 (Config) ΓòÉΓòÉΓòÉ
  519.  
  520.  This page contains a number of settings that can change the operation modus of 
  521. SMEHTM. In version 1.10 this page is expanded with three items that were pages 
  522. in release 1.00. This was done to speed up the startup of SMEHTM. 
  523.  
  524. Editor - This field will indicate which editor should be used by SMEHTM. 
  525. Preferably this will be Smalled. If Smalled v1.4 or higher is used, this field 
  526. doesn't have much value because SMEHTM can be started from within Smalled. 
  527. If nothing is entered here, SMEHTM will use the E.EXE editor. If you would like 
  528. to use another editor, fill in the entire path to that editor. Every editor 
  529. based on the MLE control should work. 
  530.  
  531. Startup page - In this spinbutton the page that will be displayed when SMEHTM 
  532. is started can be set. The default for this setting is the About page. 
  533.  
  534. Change Font This option is added for users who use DBCS character sets (for 
  535. example Japanese or Chinese). This option changes all the entryfields to the 
  536. selected font. If you don't need to change from the default Helv.8 font, don't 
  537. use this option. It will slow down the startup of SMEHTM considerably. If you 
  538. like to experiment with this, selecting the Helv.8 font will reset SMEHTM to 
  539. default. 
  540. (Note: It might be neccesary to restart SMEHTM to get the desired effect on all 
  541. the pages.) 
  542.  
  543. Set Hotkeys This option opens a dialog that will enable you to define the 
  544. hotkeys 
  545.  
  546. Registering can be done by pressing the button with the key on it. This will 
  547. open the register dialog. 
  548.  
  549. The Help dialog is available by the questionmark button. This will open a 
  550. dialog that lets you acccess several parts of this help-file quickly. 
  551.  
  552. Float on top - SMEHTM can remain on top of the editor after a button in SMEHTM 
  553. is pushed. Pressing a button will, in most cases, cause a tag to be inserted in 
  554. the editor. After this action the editor usually regains the focus. SMEHTM can 
  555. react in two possible ways. 
  556.  
  557.      It can stay on top of the editor after a tag is inserted. If you want 
  558.       this behavior, the Float on top button should be checked. If you want the 
  559.       editor to be on top, just click on the menubar, the toolbar or activate a 
  560.       menu option. If this is done, SMEHTM assumes you want the editor on top 
  561.       and will go to the background. 
  562.      After the insertion of a tag, SMEHTM will always place the editor on top. 
  563.       If you want this behavior, make sure the checkbutton is not flagged. 
  564.  
  565.  This floating behavior can be changed on the fly. If the state of the check 
  566.  button is changed, the new behavior becomes active immediately. This setting 
  567.  is remembered between sessions. 
  568.  
  569.  Use bitmaps in tabs - When first started, SMEHTM will display text in the tabs 
  570.  that are used to select the various pages. It is also possible to use bitmaps 
  571.  in the tabs. The advantage of doing this is that more tabs can be displayed in 
  572.  less space. This makes more pages rapidly accessible. If you like bitmaps on 
  573.  the tabs, flag this checkbutton. 
  574.  For this option to become active, SMEHTM must be restarted. 
  575.  
  576.  Insert tags in lowercase - By default SMEHTM uses upper case characters to 
  577.  insert HTML tags. However some people like them in lower case. If you prefer 
  578.  tags inserted in lower case, flag this checkbutton. 
  579.  There is one situation though, where this may be a disadvantage. If Templates 
  580.  are being inserted, SMEHTM will try to convert the tags in the templates to 
  581.  lower case. This may take some time (5 seconds for 10Kb on a 486 DX2), while 
  582.  not having the lower-case conversion selected will insert the template 
  583.  instantly. 
  584.  Lower/Upper case conversion can also be invoked after tags have been entered 
  585.  with the controls on the Tools page. 
  586.  
  587.  Close editor lets you modify the shutdown behaviour of the editor you're 
  588.  using. If this button is checked, the editor will be closed when SMEHTM is 
  589.  closed. If the button is unchecked, the editor will stay open. 
  590.  
  591.  
  592. ΓòÉΓòÉΓòÉ 1.2.12.1. Hotkeys ΓòÉΓòÉΓòÉ
  593.  
  594. The Hotkeys dialog is added in version 1.10. This is a unique function that 
  595. adds hotkeys to the editor you're using with SMEHTM. These hotkeys can trigger 
  596. function within SMEHTM. 
  597. Before you begin adding hotkeys, there's one important thing, SMEHTM hotkeys 
  598. won't overrule the keys defined for your editor. So if you're using e.exe, 
  599. defining a CTRL-F hotkey won't do you any good. This will still trigger the 
  600. find dialog in e.exe! 
  601.  
  602. The listbox in the hotkeys definition dialog displays how the hotkeys are 
  603. defined. On the left of the listbox, you'll find the function the hotkey will 
  604. insert. Next to that a C or/and an A will be displayed. The A stands for ALT 
  605. and the C stands for CTRL. If a line is hilited, this setting can also be read 
  606. by looking at the ALT. CTRL and Key controls. 
  607.  
  608. Hotkeys must be defined with at least the CTRL or the ALT button. If you don't 
  609. check at least the CTRL or the ALT checkbutton it won't give you a valid 
  610. hotkey. SMEHTM will tell you if it can accept a hotkey. If you entered a valid 
  611. key, a * will appear in the listbox. 
  612. Double keydefinitions aren't accepted in SMEHTM, so if you define a key and a * 
  613. won't appear, chances are you already defined this key. 
  614.  
  615. The keys defined in SMEHTM are case sensitive! This means that a CTRL-s is 
  616. different form a CTRL-S. The choice was made not to add a SHIFT checkbox 
  617. because of characters like *^%$ which are usually shifted characters. So pay 
  618. attention to the Caps-Lock. 
  619.  
  620. For the keys to be saved and become active, the Save button has to be pressed. 
  621. If you press Cancel, al changes are discared! 
  622.  
  623.  
  624. ΓòÉΓòÉΓòÉ 1.2.12.2. Register dialog ΓòÉΓòÉΓòÉ
  625.  
  626.  The registration fee for the Smalled HTML Extensions is $15 (use the 
  627. PURCHASE.EXE program to create a order form). You may use SMEHTM for a trial 
  628. period of 40 days before registering it. During the use of the unregistered 
  629. version, every time SMEHTM is started a dialog box will be displayed for a 
  630. number of seconds to point out that the program is shareware. After 40 days, 
  631. the Link page and the Hotkeys will be locked. When you're not registered, 
  632. you'll always be bothered by the startup dialog which will hold you for 10 
  633. seconds. 
  634.  
  635. To register SMEHTM you first have to produce a Personal key. This is a 
  636. numerical value derived from your name. When you enter your first- and 
  637. last-name in the Name entryfields, the Personal key value should show 
  638. automatically. If you've obtained a registration key, it can be entered in the 
  639. Register key entryfield. If this key is valid, the Register button will become 
  640. available. By pressing this button, you will register. This means the nagging 
  641. dialog-box at startup will disappear and the lockup for the Link page will not 
  642. happen. 
  643.  
  644. Registering SMEHTM costs only $15. Check out the combined package of Smalled 
  645. and SMEHTM for only $25. 
  646.  
  647.  
  648. ΓòÉΓòÉΓòÉ 1.3. Disclaimer ΓòÉΓòÉΓòÉ
  649.  
  650.  ====DISCLAIMER==== 
  651.  
  652. This package is provided "as is", without any guarantees or warranties 
  653. whatsoever. Eric Slaats / Bianchi Software are not liable or responsible for 
  654. any loss or damage of any kind, including, but not limited to, losses of a 
  655. financial, physical, emotional, marital, social, or mental nature, that may 
  656. result from the use or the purported use of anything in this package, for any 
  657. purpose whatsoever. 
  658.  
  659. You may distribute this shareware version of Smalled if the following 
  660. conditions are met: 
  661.  
  662.    1. The distributed archive must contain ONLY the files OS2_2xx.ZIP, 
  663.       WARP.ZIP, SMEHTM.DLL, SMEHTM.HLP, README.SMH, FILE_ID.DIZ, EXAMPLE.ZIP, 
  664.       PURCHASE.EXE, PURCHASE.APP, PURCHASE.ICO 
  665.  
  666.    2. The contents of this archive are NOT MODIFIED in any way. 
  667.  
  668.    3. This version is not to be sold. However, a reasonable disk copying fee is 
  669.       permitted. 
  670.  
  671.  ====REGISTERING==== 
  672.  
  673.  If you like SMEHTM and want to keep using it after the 40 day trial period, 
  674.  you must register it. In the case of the Smalled HTML Extensions, this means 
  675.  you must buy a registration key and enter it in the Register dialog (Press the 
  676.  register button in the config page.) 
  677.  
  678.  There is an extra program added to produce an order form. This is the 
  679.  purchase.exe file. If this file is executed, you can enter your personal data 
  680.  and print it, or send it by E-mail. The working of this program is 
  681.  self-explaining. 
  682.  
  683.  Registering SMEHTM costs $15. (Take a look at the BMT micro 
  684.  (http://www.wilmington.net/bmtmicro/) site for a combined offer of SMEHTM and 
  685.  Smalled for $25.) 
  686.  
  687.  You may register by sending the order form, produced by purchase.exe, by mail 
  688.  to: 
  689.  
  690.       BMT Micro 
  691.       PO Box 15016 
  692.       Wilmington, NC  28408 
  693.       U.S.A. 
  694.  
  695.       Bianchi Software 
  696.       Tongelresestraat 61 
  697.       5613 DB Eindhoven 
  698.       The Netherlands 
  699.  
  700.  Ordering by fax or e-mail (credit card) can only be done through BMT Micro. 
  701.  
  702.  Enjoy and SUPPORT SHARE/FREEWARE! 
  703.  
  704.  For support, please do not contact BMT Micro. Contact Bianchi Software, 
  705.  preferably through e-mail at (Eric.Slaats@pi.net). 
  706.  
  707.  
  708. ΓòÉΓòÉΓòÉ 1.4. What's New/History ΓòÉΓòÉΓòÉ
  709.  
  710.  New/Changed 
  711.  
  712. SMEHTM 1.10 Dec 96 
  713.  
  714.      Configurable hotkeys 
  715.      Configurable edit shutdown 
  716.      Support for scandinavian characters 
  717.      Easier accented character insert 
  718.      Easier list insert 
  719.      Usertags page 
  720.      Double tag support for <P> and <TD><TH><TR> 
  721.      Installable font for entryfields 
  722.  
  723.  SMEHTM version 1.00 June 1996 
  724.  Initial release 
  725.  
  726.  
  727. ΓòÉΓòÉΓòÉ 1.5. Future Attractions ΓòÉΓòÉΓòÉ
  728.  
  729.      HTML previewer in Smalled 
  730.      Color page 
  731.      Forms page 
  732.      Counter page 
  733.      Clickable map page 
  734.      Drag and Drop for images 
  735.      Configurable floating toolbar 
  736.      DDE support 
  737.      Page order configurable 
  738.      Float properties configurable 
  739.  
  740.  
  741. ΓòÉΓòÉΓòÉ 2. Support ΓòÉΓòÉΓòÉ
  742.  
  743.  SMEHTM is a Bianchi Software product. If you have any problems, wishes, etc., 
  744. please contact Bianchi Software (preferably through e-mail) at: 
  745.  
  746.       Bianchi Software 
  747.       Tongelresestraat 61 
  748.       5613 DB Eindhoven 
  749.  
  750.       e-mail: Eric.Slaats@pi.net 
  751.  
  752.  
  753. ΓòÉΓòÉΓòÉ 2.1. About the Author ΓòÉΓòÉΓòÉ
  754.  
  755.  If you feel the need to contact me, please send your comments, criticism, 
  756. wishes, bugs and postcards (keep 'em comin' :) ) to: 
  757.  
  758.       E. Slaats 
  759.       Tongelresestraat 61 
  760.       5613 DB Eindhoven 
  761.       The Netherlands 
  762.  
  763.       e-mail: Eric.Slaats@pi.net 
  764.  
  765.  
  766. ΓòÉΓòÉΓòÉ 2.2. Thanks ΓòÉΓòÉΓòÉ
  767.  
  768.                                     !Thanks!
  769.  
  770. I've got a number of people to thank for their help while I was building this 
  771. applet. I'm thankful it's finished (and so are my wife and kids). Thanks to: 
  772.  
  773.      Paulo Mario dos S. D. de Moraes for his truly great remarks. 
  774.      Trevor Smith of Haligonian Media for putting the finishing touches on 
  775.       this help file. 
  776.  
  777.  
  778. ΓòÉΓòÉΓòÉ 3. Smalled ΓòÉΓòÉΓòÉ
  779.  
  780.  SMEHTM is built for the Smalled editor. Smalled is a high powered, 
  781. multi-threaded, 32-bit, OS/2 PM editor. It is small in size (88 Kb for Warp), 
  782. very fast and comes with lots of extras compared to the E.EXE editor. Smalled 
  783. takes full advantage of OS/2 specialties like Drag-n-Drop (fully DragText 
  784. compatible), EA's, multi-threading, ATM font support, etc.  Also, from version 
  785. 1.4 on, SMEHTM can be started from within Smalled and an HTML Previewer is 
  786. being built for Smalled. This means you will be able to view HTML pages from 
  787. within Smalled. 
  788.  
  789. Some of the current Smalled features are: 
  790.  
  791.      Full Drag-n-Drop interface for whole or selected text, meaning: 
  792.         -  Open 
  793.         -  Save 
  794.         -  Printing 
  795.         -  Shredding 
  796.         -  Copy 
  797.         -  Move 
  798.         -  Changing fonts 
  799.         -  Changing colors 
  800.         -  Understands the DragText rendering method, so it's fully DragText 
  801.            compatible 
  802.      WYSIWYG printing 
  803.      Backup facility 
  804.      Text file settings (like fonts, etc.) are saved in the EA's, so the text 
  805.       is pure ASCII 
  806.      Toolbar with bubble help 
  807.      Highly configurable (Toolbar, Drag-n-Drop, Dialogs, Default dir, etc.) 
  808.      File-find and File-history in file-dialog 
  809.      File information 
  810.      Find, replace and goto dialogs with memory 
  811.      ATM font support (also for printing) 
  812.      Line Break (formatting) 
  813.  
  814.  If you would like to try Smalled, look for the file Smaledxx.zip (or SMLEDXXXX 
  815.  for intermediate releases) on Hobbes in the editors directory or at the BMT 
  816.  Micro site (ftp://ftp.wilmington.net/bmtmicro/smled141.zip). 
  817.  
  818.  Smalled can be bought in a package deal with SMEHTM for a reduced price. Check 
  819.  out the BMT Micro site at http://www.wilmington.net/bmtmicro/ for more 
  820.  details. 
  821.  
  822.  
  823. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  824.  
  825. If you need help polishing your documentation or if you need .INF or .HLP files 
  826. created for your applications, contact Haligonian Media at 
  827. editor@haligonian.com or (902) 461-2266.