home *** CD-ROM | disk | FTP | other *** search
/ ST-Computer Leser 2002 January / STC_CD_01_2002.iso / APP / HIREWIR2 / HIGHWIRE.DOC
Text File  |  2002-01-21  |  7KB  |  200 lines
  1. HighWire DocumentationHighWire Documentation
  2.  
  3.  
  4.  
  5.   Table of Content 
  6.     HighWire Release License 
  7.     What is HighWire? 
  8.     HighWire Development Team 
  9.     Use of HighWire 
  10.     Use of FontList 
  11.     Supported HTML tags 
  12.  
  13.  
  14. 1. HighWire Release License
  15.  
  16.   This software is provided 'as-is', without any express or implied
  17.   warranty. In no event will the authors be held liable for any damages
  18.   arising from the use of this software.
  19.   Permission is granted to anyone to use this software for any purpose,
  20.   including commercial applications, and to alter it and redistribute it
  21.   freely, subject to the following restrictions:
  22.   1. The origin of this software must not be misrepresented; you must not
  23.   claim that you wrote the original software. If you use this software
  24.   in a product, an acknowledgment in the product documentation would be
  25.   appreciated but is not required.
  26.   2. Altered source versions must be plainly marked as such, and must not be
  27.   misrepresented as being the original software.
  28.   3. This notice may not be removed or altered from any source distribution.
  29.   Anyone uses bits of the code for other reasons is welcome to, as long as they 
  30.   specifically
  31.   state that their work is based, in part, on the Project HighWire source 
  32.   release by Robert Goldsmith.
  33. 2. What is HighWire?
  34.  
  35. This is taken from the HighWire site written by the original author, Robert 
  36. Goldsmith. Some parts have been updated:
  37. For those of you who have not heard, HighWire is a new web-browser. It has been 
  38. in 'development' for over a year. I started HighWire in what I considered a 
  39. feeble attempt to discourage me from moaning about Cab. I figured that when I 
  40. proved my code was vastly slower than Cab at parsing and rendering a page I 
  41. would give up and accept that browsing on my Falcon would always be slow.
  42. Things did not turn out how I expected... 
  43. I think the big problem with my plan was that, unbeknownst to me at the time, I 
  44. had had a couple of rather good ideas. The result is HighWire.
  45. Ok, so can I download it? You cannot write a web-browser in a month. I know, I 
  46. tried :) HighWire is still very much in development. In fact, it is so unfit for 
  47. general release at this time. 
  48. Currently HighWire can do the following:
  49.   Load in an html3.2 page hard coded into the source 
  50.   Display this page multiple times in hard coded frames 
  51.   Redraw and scroll the frames and resize the window 
  52.   Quit 
  53. New items since it went open source:
  54.   Frameset Support (90%) 
  55.   Tables (80%) 
  56.   colour support (mapped to current system palette) 
  57.    html 4 compliant (90%) 
  58. It is currently missing:
  59.   user interface 
  60.   online module 
  61.   html forms 
  62.   graphics 
  63.   a working implementation of hyperlinks 
  64.   lots more... 
  65. So why all the fuss?
  66. Well, HighWire can load in, parse and render an html page in full 16 bit fonts 
  67. (for all the 'strange' characters such as ■) in about half the time of Cab. 
  68. Furthermore, once a page is pre-rendered (before the first time it is displayed) 
  69. it does not need further processing, making redraws and window resizes much much 
  70. faster. On a Hades machine the code was tested on, the page render including 
  71. font sizes, centering and lists redrew correctly in real time (with a slight 
  72. flicker...) as the window was resized.
  73.  
  74.  
  75.  
  76. 3. HighWire Development Team
  77. HighWire Code 
  78.   Robert Goldsmith 
  79.   Dan Ackerman (aka Baldrick) 
  80.   Mike De.Petris 
  81.   Matthias Jaap 
  82.   Denis Huguet (aka Stghost) 
  83.   Frank Naumann (original GCC modifications - non active) 
  84.   Ralph Lowinski (aka AltF4) 
  85.   David Leaver
  86.   John Kromylo 
  87. HighWire Documentation 
  88.   Rob Mahlert 
  89.   Edward Baiz Jr. (aka Gamer) 
  90. Fontlist Project
  91.   Joakim H÷gberg (aka GokMasE) 
  92.   Lonny Pursell (aka Lp) 
  93. Highwire Panel
  94.   Rafal Kawecki 
  95.  
  96. 4. Use of HighWire
  97.   System Requirements: 
  98.   Multitasking (preemptive multitasking) Atari OS - Magic or Mint 
  99.   NVDI or Speedo 
  100.  
  101. Hot Keys:
  102.   Control O - Open file selector 
  103.   Control I - About Highwire alert 
  104.   Control Q - Quit Highwire 
  105. HighWire can also display plain text files.
  106. HighWire.CFG File 
  107. READ FONTLIST BELOW
  108.  
  109. 5. Use of FontList
  110. FontList
  111. Coded in GFA by Lp and GokMasE for the Highwire Project
  112.  
  113. FontList is a small utility to change the font settings in the Highwire 
  114. configuration file.
  115.  
  116. Installation
  117.  
  118. Keep this binary in the HighWire directory. (Same directory as the highwire.cfg 
  119. file)
  120.  
  121. Usage
  122.  
  123. When the program is started, it tries to find out what fonts are currently 
  124. installed on your setup.
  125. The results will be presented in a GEM window, and for each font both the TYPE 
  126. and FONT ID will be listed.
  127.  
  128. The next step is to actually adjust the font settings in Highwire's config to 
  129. match your installed Speedo fonts.
  130. To change a particular font setting, you first select it in the GEM window (only 
  131. 1 font at a time when updating 
  132. the config!) and then use menubar to map the selected font to a certain setting 
  133. in Highwire. When
  134. selecting this in menubar, changes are carried out immediately.
  135.  
  136. It is important to point out that FontList does not *create* a config file. 
  137. Instead, it is capable of changing
  138. the font related entries that are *enabled* in the current configuration file. 
  139. (If those lines start with "#" it
  140. means they are disabled)
  141.  
  142. You can also use FontList to create a file listing all the fonts installed on 
  143. your system. The information
  144. is exactly the same as the one seen in the GEM window of FontList. To save such 
  145. a list to clipboard,
  146. press CTRL+A (to select all fonts) and then press CTRL+C (to write scrap.txt in 
  147. clipboard)
  148.  
  149. General Advice
  150.  
  151. It might be a good idea to keep a backup of latest working configuration file.
  152.  
  153.  
  154. 6. Supported HTML tags
  155. Here are some of the HTML tags that HighWire supports:
  156. Hopefully will be updated to list all supported tags.
  157.   A 
  158.   HREF 
  159.   NAME 
  160.   B (bold) 
  161.   BIG 
  162.   BODY 
  163.   bgcolor 
  164.   text 
  165.   alink 
  166.   BR 
  167.   DD (DL definition) 
  168.   DIR 
  169.   DIV 
  170.   DL (definition lists) 
  171.   DT (DL term) 
  172.   FONT 
  173.   size 
  174.   color 
  175.   H1,H2,H3,H4,H5,H6 
  176.   align 
  177.   HR 
  178.   size 
  179.   width 
  180.   NOSHADE 
  181.   I (italics) 
  182.   LI (list item) 
  183.   OL (numbered lists) 
  184.   P (with many of the supporting variables) 
  185.   PRE 
  186.   S (strike through) 
  187.   SMALL 
  188.   STRONG 
  189.   SUB 
  190.   SUP 
  191.   TABLE (with many of the supporting variables see parse.c) 
  192.   TH (Table Header Cell ... supporting variables...) 
  193.   TD (Table Data Cell ... Supporting variables...) 
  194.   TR (Table Row) 
  195.   TITLE 
  196.   TT (teletype font) 
  197.   U (underlined) 
  198.   UL (bulleted lists) 
  199.  
  200.