git clone [email protected]:HackYourFutureBelgium/template-markdown.git
cd template-markdown
npm install
npm run format
: Makes sure all the code in this repository is well-formatted (looks good).npm run lint:md
: Will lint all of the Markdown files in this repository.npm run lint:css
: Will lint all of the CSS files in this repository.npm run validate:html -- ./path/to/file.html
: Validates all HTML files in the path provided.npm run spell-check
: Goes through all the files in this repository looking for words it doesn't recognize. Just because it says something is a mistake doesn't mean it is! It doesn't know every word in the world. You can add new correct words to the ./.cspell.json file so they won't cause an error.npm run accessibility -- ./path/to/file.html
: Runs an accessibility analysis on all HTML files in the given path and writes the report to/accessibility_report
When you open a PR to main
/master
in your repository, GitHub will
automatically do a linting check on the code in this repository, you can see
this in the./.github/workflows/lint.yml file.
If the linting fails, you will not be able to merge the PR. You can double check
that your code will pass before pushing by running npm run lint:md
locally.
- Give each member write access to the repo (if it's a group project)
- Turn on GitHub Pages and put a link to your website in the repo's description
- Turn on GitHub Actions
- in the Branches section of your repo's settings make sure:
- The repository requires a review before pull requests can be merged.
- The
master
/main
branch must "Require status checks to pass before merging" - The
master
/main
branch must "Require require branches to be up to date before merging"