home *** CD-ROM | disk | FTP | other *** search
/ Netscape Plug-Ins Developer's Kit / Netscape_Plug-Ins_Developers_Kit.iso / UTILS / WEBLINT / WEBLINT.ZIP / weblint / weblintrc < prev   
Encoding:
Text File  |  1996-02-03  |  14.2 KB  |  335 lines
  1. #
  2. # sample configuration file for weblint
  3. # distributed as part of weblint 1.014
  4. #
  5. # The settings in this file reflect the built-in defaults.
  6. # I.e. if a warning is enabled in this file, then it is enabled by
  7. # default, and you don't have to enable it in your .weblintrc.
  8. #
  9.  
  10. #========================================================================
  11. #    Weblint Variables
  12. #========================================================================
  13.  
  14. #
  15. # message-style: style of warning message to generate
  16. #    lint    generate warnings similar to traditional lint:
  17. #            file(line #): warning
  18. #        this is the default
  19. #    short    don't include the filename in the warning message:
  20. #            line #: warning
  21. #    terse    a style which is easy for another program to parse:
  22. #            file:line #:warning-identifier
  23.  
  24. set message-style = lint
  25.  
  26. #
  27. # url-get: a program which can be used to retrieve a URL
  28. #
  29.  
  30. set url-get = lynx -source
  31.  
  32. #
  33. # directory-index: list of filenames for directory indices
  34. #
  35. # If you server supports multiple index file names:
  36. #    set directory-index = index.html, welcome.html
  37. #
  38.  
  39. set directory-index = index.html
  40.  
  41. #========================================================================
  42. #    Extensions
  43. #========================================================================
  44.  
  45. #------------------------------------------------------------------------
  46. # Allow netscape HTML extensions, such as CENTER and FONT
  47. #------------------------------------------------------------------------
  48. # uncomment following line to enable the netscape extensions
  49. # extension netscape
  50.  
  51. #------------------------------------------------------------------------
  52. # Allow java HTML extensions: the APPLET and PARAM elements
  53. #------------------------------------------------------------------------
  54. # uncomment following line to enable the java extensions
  55. # extension java
  56.  
  57.  
  58. #========================================================================
  59. #    Weblint Warnings
  60. #========================================================================
  61.  
  62. #------------------------------------------------------------------------
  63. # By default, when recursing in a directory, weblint will check files
  64. # which are symlinks.  Uncomment the following line if you want weblint
  65. # to skip symlinks.  This is equivalent to the -l command-line switch
  66. #------------------------------------------------------------------------
  67. # ignore symlinks
  68.  
  69. #------------------------------------------------------------------------
  70. # There are two checks for the case of element tags:
  71. #    upper-case    all tags should be in upper case
  72. #    lower-case    all tags should be in lower case
  73. # If both are disabled, then case is ignored
  74. #------------------------------------------------------------------------
  75. disable upper-case lower-case
  76.  
  77. #------------------------------------------------------------------------
  78. # Bad style to use `here' as anchor text
  79. #------------------------------------------------------------------------
  80. enable here-anchor
  81.  
  82. #------------------------------------------------------------------------
  83. # Flag any elements which are not recognized.  This will catch mis-typed
  84. # elements (e.g. <TOTLE>, or <\BODY>).
  85. #------------------------------------------------------------------------
  86. enable unknown-element
  87.  
  88. #------------------------------------------------------------------------
  89. # check element attributes to see if they are legal
  90. #------------------------------------------------------------------------
  91. enable unknown-attribute
  92.  
  93. #------------------------------------------------------------------------
  94. # flag if no HEAD element in page
  95. #------------------------------------------------------------------------
  96. enable require-head
  97.  
  98. #------------------------------------------------------------------------
  99. # Flag elements which should only appear once on a page (eg TITLE)
  100. #------------------------------------------------------------------------
  101. enable once-only
  102.  
  103. #------------------------------------------------------------------------
  104. # Flag case where page has BODY element, but no HEAD defined
  105. #------------------------------------------------------------------------
  106. enable body-no-head
  107.  
  108. #------------------------------------------------------------------------
  109. # If you want outer element to be <HTML>
  110. #------------------------------------------------------------------------
  111. enable html-outer
  112.  
  113. #------------------------------------------------------------------------
  114. # Flag elements which are only allowed to appear in HEAD element
  115. #------------------------------------------------------------------------
  116. enable head-element
  117.  
  118. #------------------------------------------------------------------------
  119. # Flag elements which aren't allowed to appear in HEAD element
  120. #------------------------------------------------------------------------
  121. enable non-head-element
  122.  
  123. #------------------------------------------------------------------------
  124. # Flag obsolete elements, such as XMP and LISTING
  125. #------------------------------------------------------------------------
  126. enable obsolete
  127.  
  128. #------------------------------------------------------------------------
  129. # Flag mis-matched begin and end tags;  for example:
  130. #    <H1> ... </H2>
  131. #------------------------------------------------------------------------
  132. enable mis-match
  133.  
  134. #------------------------------------------------------------------------
  135. # Flag any IMG elements which don't have ALT text defined.
  136. #------------------------------------------------------------------------
  137. enable img-alt
  138.  
  139. #------------------------------------------------------------------------
  140. # Flag illegally nested elements (such as anchors).
  141. #------------------------------------------------------------------------
  142. enable nested-element
  143.  
  144. #------------------------------------------------------------------------
  145. # Check for those elements which have required context.
  146. # For example, the <CAPTION> element can only appear in <FIG> or <TABLE>
  147. #------------------------------------------------------------------------
  148. enable required-context
  149.  
  150. #------------------------------------------------------------------------
  151. # Check for mailto: LINK in header;  for example:
  152. #    <LINK REV=MADE HREF="mailto:neilb@khoral.com">
  153. # This lets at least lynx users comment on a page.
  154. #------------------------------------------------------------------------
  155. disable mailto-link
  156.  
  157. #------------------------------------------------------------------------
  158. # Flag overlapped elements.  For example:
  159. #    <A HREF="..."> <B> text </A> </B>
  160. #------------------------------------------------------------------------
  161. enable element-overlap
  162.  
  163. #------------------------------------------------------------------------
  164. # Generate a warning if closing tag is not seen for elements where
  165. # it is expected.  A common case is <A NAME="..."> ... </A>.
  166. #------------------------------------------------------------------------
  167. enable unclosed-element
  168.  
  169. #------------------------------------------------------------------------
  170. # Generate a warning if markup appears inside a comment.  This can
  171. # confuse quite a few browsers, so it's not a good idea to do it.
  172. #------------------------------------------------------------------------
  173. enable markup-in-comment
  174.  
  175. #------------------------------------------------------------------------
  176. # You are not allowed to have any whitespace between the opening
  177. # < and element name.
  178. #------------------------------------------------------------------------
  179. enable leading-whitespace
  180.  
  181. #------------------------------------------------------------------------
  182. # Flag potentially unclosed tags:
  183. #    < ... < ... >
  184. #------------------------------------------------------------------------
  185. enable unexpected-open
  186.  
  187. #------------------------------------------------------------------------
  188. # Elements which do not have any required attributes, but for which at
  189. # least one attribute is expected.  Anchors, for example.
  190. #------------------------------------------------------------------------
  191. enable expected-attribute
  192.  
  193. #------------------------------------------------------------------------
  194. # Required element attributes.  Eg IMG tag must have SRC attribute.
  195. #------------------------------------------------------------------------
  196. enable required-attribute
  197.  
  198. #------------------------------------------------------------------------
  199. # Currently just checks local links, to see if target file exists.
  200. # disabled at the moment, since it generates bogus warnings if the file
  201. # path included directories.
  202. #------------------------------------------------------------------------
  203. disable bad-link
  204.  
  205. #------------------------------------------------------------------------
  206. # Check for headings which are more than 1 level deeper than previous.
  207. # Example: <H1> followed by <H3>
  208. #------------------------------------------------------------------------
  209. enable heading-order
  210.  
  211. #------------------------------------------------------------------------
  212. # Check for odd number of double quotes in tag, to catch things like:
  213. #        <A HREF="url >
  214. #------------------------------------------------------------------------
  215. enable odd-quotes
  216.  
  217. #------------------------------------------------------------------------
  218. # Warn about closing tag for elements which don't take a closing tag.
  219. # For example: <IMG SRC="foo.gif" ALT="alt text"></IMG>
  220. #------------------------------------------------------------------------
  221. enable illegal-closing
  222.  
  223. #------------------------------------------------------------------------
  224. # Warn about unclosed comments.  For example:
  225. #    <!-- this comment is not correctly closed >
  226. # Legal SGML comments are:
  227. #    <!-- ... blah blah ... -->
  228. #------------------------------------------------------------------------
  229. enable unclosed-comment
  230.  
  231. #------------------------------------------------------------------------
  232. # Warning for use of physical font markup, rather than logical
  233. # For example:
  234. #    <B> where you should use <STRONG>
  235. #    <I> where you should use <EM>
  236. #    <TT> where you should use <CODE>, <KBD>, <VAR>, or <SAMP>
  237. #------------------------------------------------------------------------
  238. disable physical-font
  239.  
  240. #------------------------------------------------------------------------
  241. # Warning for repeated attributes within the same tag.  For example:
  242. #    <IMG SRC="foo.gif" SRC="bar.gif">
  243. #    <A NAME="fred" NAME="bloggs">
  244. #------------------------------------------------------------------------
  245. enable repeated-attribute
  246.  
  247. #------------------------------------------------------------------------
  248. # Warn against use of ' as a delimiter for attribute values.  E.g.:
  249. #    <A HREF='http://www.khoral.com/'>KRI</A>
  250. #------------------------------------------------------------------------
  251. enable attribute-delimiter
  252.  
  253. #------------------------------------------------------------------------
  254. # Warn against use of netscape-specific attributes for non netscape-specific
  255. # elements.  For example:
  256. #    <BODY BGCOLOR="#fefefe">
  257. #------------------------------------------------------------------------
  258. enable netscape-attribute
  259.  
  260. #------------------------------------------------------------------------
  261. # Warn about attributes on a closing tag of container element.  E.g.:
  262. #    <A HREF="foobar.html">click here!</A NAME="foobar">
  263. #------------------------------------------------------------------------
  264. enable closing-attribute
  265.  
  266. #------------------------------------------------------------------------
  267. # When recursing in a directory, check whether there is a directory
  268. # index file.  See also the variable `directory-index', which specifies
  269. # the name of index file to look for.
  270. #------------------------------------------------------------------------
  271. enable directory-index
  272.  
  273. #------------------------------------------------------------------------
  274. # Warn about empty container elements.  For example:
  275. #    <TITLE></TITLE>
  276. #------------------------------------------------------------------------
  277. enable empty-container
  278.  
  279. #------------------------------------------------------------------------
  280. # Warn about situations where one element is expected to immediately
  281. # follow another, with no tags or text between. For example:
  282. #    1) LH should be the first thing in a UL, if it appears at all
  283. #    2) should be nothing between </HEAD> and <BODY>
  284. #------------------------------------------------------------------------
  285. enable must-follow
  286.  
  287. #------------------------------------------------------------------------
  288. # Warn about IMG elements which don't have the WIDTH and HEIGHT
  289. # attributes set. Setting these attributes can improve page layout speed
  290. # on some browsers.
  291. #------------------------------------------------------------------------
  292. disable img-size
  293.  
  294. #------------------------------------------------------------------------
  295. # Warn about leading or trailing whitespace for certain container
  296. # elements: A, TITLE, H1 through H6.
  297. #------------------------------------------------------------------------
  298. disable container-whitespace
  299.  
  300. #------------------------------------------------------------------------
  301. # Warn if you don't have a DOCTYPE element as the first thing in
  302. # your document.
  303. #------------------------------------------------------------------------
  304. disable require-doctype
  305.  
  306. #------------------------------------------------------------------------
  307. # Warn if you a metacharacter is included literally, rather than using
  308. # the appropriate entity. Currently this just warns about use of >,
  309. # in which case you should use >
  310. #------------------------------------------------------------------------
  311. enable literal-metacharacter
  312.  
  313. # ========================================================================
  314. # Warnings added in the 1.014 release
  315. # ========================================================================
  316.  
  317. #------------------------------------------------------------------------
  318. # Warn if a heading is closed with a different level close tag than
  319. # the heading was opened with. For example:
  320. #    <H2>... blah blah ...</H1>
  321. #------------------------------------------------------------------------
  322. enable heading-mismatch
  323.  
  324. #------------------------------------------------------------------------
  325. # Warn if text is seen in unexpected context, such as inside a UL element
  326. # (rather than inside an LI, which is inside a UL. Or in the HEAD element.
  327. #------------------------------------------------------------------------
  328. enable bad-text-context
  329.  
  330. #------------------------------------------------------------------------
  331. # Warn about illegal attribute values, such as values in the wrong format.
  332. #------------------------------------------------------------------------
  333. enable attribute-format
  334.  
  335.