A program to lint (find problems) files submitted to the KtaneContent repo.
RepoLint <path>
Depending on what path points to, it'll be treated differently and use different rules.
- A directory will be linted like it's a copy of the KtaneContent repo.
- Excluded rules:
W3CValidator.
- An archive will be extracted and linted.
- Excluded rules: None.
- Just that file will be linted.
- Excluded rules:
ExpectedFilesandParentFolder.
Consecutive <br> tags should not be used. Instead use <p> tags for sections of text or add some margin: to space an element out.
Consecutive empty lines leads to inconsistent spacing between sections. Use one empty line.
HTML files without <!DOCTYPE html> can enable quirks mode. Add it to the top of the file.
Every module should have a Component SVG and JSON file. Make sure both are included and named the same as the module name.
Any font family used should be included by the CSS. Add a @font-face declaration for any new fonts used.
Graphics must be in the appropriate folder named for the module to keep graphics separated. Put the manual graphics into a folder with the same name as the module name.
To keep the format of manuals consistent, the tags in the head are kept consistent. The message should give the exact HTML that you can copy into the manual.
The html, head and body tags should be included and on separate lines to keep the format of manuals consistent. Either add the missing tag or make sure each tag is on it's own line.
JSON files must use a valid syntax. Fix the syntax error explained in the message.
To keep the size of component SVGs down, they should be minified. Minify them with SVGOMG.
The <div id="ManualContent"> wrapper element is a legacy from the original manuals. Remove it from the manual.
To keep things consistent spaces are used instead of tabs. Convert the tabs to spaces.
<text> elements can be displayed inconsistently depending on the fonts that the user has. They should be converted to <path> elements to make sure they're consistent.
.html, .json files should be in HTML and JSON folders respectively. .svg files can be anywhere under the img folder. Move each file is in it's correct folder.
If you include the ruleseed.js script or the setRules and setDefaultRules functions, you need to include the other if the manual supports ruleseed. Either add the one that's missing or remove it if the manual doesn't support ruleseed.
Template Manual files are only for demonstration purposes only. Remove them since they're not being used.
As for the Template Manual.html file itself, it should either be renamed to the name of the module or it should be removed if it's unused.
To keep indentation in JSON files consistent, all JSON files should use 2 space indentation. Fix the indentation of the JSON file to be using 2 spaces.
To make sure HTML is valid and well-written, it is run through the W3C Validator. Fix any problems with the HTML that's found.