home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / htmlcon.zip / HTMLCON.INI < prev    next >
Text File  |  1995-06-03  |  7KB  |  199 lines
  1. ; HTMLCon Initialization File (current through version 2.1)
  2. ; ---------------------------------------------------------
  3. ;
  4. ; ----- ABOUT THE HTMLCON.INI CONTROL FILE -----
  5. ;
  6. ; Lines beginning with a semicolon are considered comments.
  7. ; All other lines are considered instructions and must exactly follow
  8. ; the format described in this sample file.  Arguments are seperated
  9. ; by an equal sign (=) which must not be preceeded or succeeded by
  10. ; a space or tab.
  11. ;
  12. ;
  13. ; ----- DEFINING THE OUTPUT LINE LENGTH -----
  14. ;
  15. ; Define the default point at which HTMLCon should attempt to break a
  16. ; line for the output file.  The break is not guaranteed to occur at
  17. ; this point, but as close to it as possible to retain the syntax of
  18. ; the input line.  Default=72.  You may also change this option when
  19. ; running HTMLCon in the interactive mode.
  20. ;
  21. ;linebreak=75
  22. ;
  23. ;
  24. ; ----- COLLECTING STATISTICS -----
  25. ;
  26. ; Statistics can be compiled and written to the output file.
  27. ; Use of this function does not increase the processing time and it does
  28. ; provide some interesting information in the output file.  In addition,
  29. ; by uncommenting the "showlinks=yes" command, HTMLCon will write all
  30. ; external URL links found in the input file as an appendix to the
  31. ; output file.  The "showlinks" option may be changed when running
  32. ; HTMLCon in the interactive mode.
  33. ;
  34. statistics=yes
  35. ;showlinks=yes
  36. ;
  37. ;
  38. ; ----- VIEWING OR PROCESSING THE OUTPUT FILE AUTOMATICALLY -----
  39. ;
  40. ; You may launch another program after HTMLCon finishes its work.  This
  41. ; may be an ASCII file viewer, editor, or whatever.  The launched program
  42. ; must be able to take the output file name as an argument.  In order to
  43. ; accomplish this you must provide the FULL PATH to your program.  This
  44. ; is a handy function to allow you to automatically and immediately see
  45. ; the results of the HTMLCon conversion process.
  46. ;
  47. ;launchprog=c:\utils\list.com
  48. ;
  49. ;
  50. ; ----- FINDING AND REPLACING THINGS -----
  51. ;
  52. ; Find and replace:  you may specify up to 50 strings to be located in
  53. ; the HTML file and replaced in the ASCII output file.  These will be a
  54. ; direct replacement using the two commands "find=" and "replace=".  Each
  55. ; "find" element will be replaced by a "replace" element, therefore you
  56. ; cannot have a "find=" statement without a following "replace=" statement.
  57. ; To specify leading or ending spaces in a statement, surround the statement
  58. ; with quotations (").  The strings cannot exceed 40 characters each.
  59. ;
  60. find=" -- "
  61. replace=--
  62. ;
  63. ; Here is an example replacing all HTMLCon reference symbols [*] with just *.
  64. ;
  65. ;find=[*]
  66. ;replace=*
  67. ;
  68. ; Or just ignore all references altogether...
  69. ;
  70. ;find=[*]
  71. ;replace=
  72. ;
  73. ; Some nice find/replace items to make the output look a bit better.
  74. ;
  75. ; [add whatever you would like here]
  76. ;
  77. ;
  78. ; ----- KEEPING THE AUTHOR'S ORIGINAL FORMATTING -----
  79. ;
  80. ; You may elect to keep the formatting characteristics of the original
  81. ; HTML file intact.  This will preserve white spaces, line breaks, etc. as
  82. ; originally constructed by the author of the HTML page.  This option
  83. ; can be changed when HTMLCon is run in the interactive mode.
  84. ;
  85. ;keepformatting=yes
  86. ;
  87. ;
  88. ; ----- IGNORING HTMLCON'S MARKERS IN THE OUTPUT FILE -----
  89. ;
  90. ; You may choose to have HTMLCon not replace certain HTML constructs
  91. ; with its own markers (for example, HTMLCon replaces URL references
  92. ; with the symbol [*]).  To have HTMLCon simply ignore its own symbols and
  93. ; not reference certain items in the original HTML file, uncomment the
  94. ; next line.  This option can be changed when HTMLCon is run in the
  95. ; interactive mode.
  96. ;
  97. ;ignoresymbols=yes
  98. ;
  99. ;
  100. ; ----- PRESERVING HREF MARKERS IN THE OUTPUT FILE -----
  101. ;
  102. ; You may instruct HTMLCon to preserve all <A HREF...> constructs when
  103. ; converting the HTML file.  These references will be preserved intact,
  104. ; without modification.  To use this feature, uncomment the next line.
  105. ; This option can be changed when HTMLCon is run in the interactive mode.
  106. ;
  107. ;keephref=yes
  108. ;
  109. ;
  110. ; ----- ELIMINATING ADVERTISEMENTS AND DELAYS -----
  111. ;
  112. ; Eliminate the advertisements and delays
  113. ; [available to registered users only]
  114. ;
  115. ;
  116. ; ----- PRINTING THE OUTPUT FILE ON LPT1 -----
  117. ;
  118. ; If you would like the option to send the processed file to LPT1
  119. ; then uncomment the next line.  This option can be changed when HTMLCon
  120. ; is run in the interactive mode.
  121. ;
  122. ;useprinter=yes
  123. ;
  124. ; Note that you may only send the processed file to a line printer
  125. ; attached to LPT1 and that HTMLCon assumes the printer is connected
  126. ; and operating properly.
  127. ;
  128. ;
  129. ; ----- SPEED PROCESSING MULTIPLE FILES -----
  130. ;
  131. ; Uncomment the following line to tell HTMLCon to NEVER pause for any
  132. ; prompt, including the call to your file viewer or other
  133. ; post-processor.  This option can be changed when HTMLCon is run in
  134. ; the interactive mode.
  135. ;
  136. ;nopause=yes
  137. ;
  138. ;
  139. ; ----- IGNORING CERTAIN FILE TYPES -----
  140. ;
  141. ; The following directive lists file extensions which should always be
  142. ; ignored by HTMLCon.  If an input file name contains one of these
  143. ; extensions than it will never be processed.  Note that the file
  144. ; extension must always include the "." in this directive:
  145. ;
  146. ignore=.ZIP.EXE.COM.LZH.GIF.LPG.ARC.ASC.SYS.INI.TXT.DOC
  147. ;
  148. ;
  149. ; ----- USING USER-DEFINED FILTERS -----
  150. ;
  151. ; Uncomment the next directive to have HTMLCon apply a set of filter
  152. ; replacements contained in the file HTMLCON.FIL in HTMLCon's default
  153. ; directory.  This filter file will find and replace HTML ENTITIES
  154. ; in your output file.  See any of the sample *.FIL files included with
  155. ; HTMLCon for more information.
  156. ;
  157. usefilter=yes
  158. ;
  159. ;
  160. ; ----- CHANGING THE DEFAULT OUTPUT FILE NAME EXTENSION -----
  161. ;
  162. ; HTMLCon normally uses the default file extension ".ASC" when multiple
  163. ; files are processed or the file extension is not specified.  You may
  164. ; specify your own default file extension using the following command.
  165. ; This file extension MUST be preceeded by a "." and contain no more than
  166. ; three characters.
  167. ;
  168. ;extension=.TXT
  169. ;
  170. ;
  171. ; ----- ADDITIONAL OUTPUT FORMAT OPTIONS -----
  172. ;
  173. ; In order to compress extra spaces in the output, uncomment this
  174. ; command.  To keep the original character spacing, ignore it.  You may
  175. ; change this option when running HTMLCon in the interactive mode.
  176. ;
  177. ;compress=yes
  178. ;
  179. ;
  180. ;
  181. ; ----- USER-DEFINED LINE BREAKS -----
  182. ;
  183. ; HTMLCon will always search for a space, comma or dash to break a
  184. ; line for output purposes.  You may also elect to add other characters
  185. ; for which HTMLCon will search to logically break a line.  You may
  186. ; specify up to 50 such characters in a single command using the option
  187. ; below.  Be careful doing this, however, so that you do not end up with
  188. ; illogically-truncated lines in your output.  If HTMLCon does not find
  189. ; one of the four characters mentioned above, it will seek out one of the
  190. ; characters you itemize in the command below.  The FIRST character it
  191. ; finds will cause HTMLCon to break the line if it is within the specified
  192. ; margin parameters established using the "linebreak=" command above:
  193. ;
  194. breakchars=:;=\|/
  195. ;
  196. ;
  197. ; End of file
  198.  
  199.