This repository contains the source code for the ARIA Authoring Practices Guide which is hosted as part of the Web Accessibility Initiative website.
The WAI website is built in Jekyll and brings together several git submodules into one website.
This project implements a pipeline to convert the aria-practices repository (which is currently a single static HTML file served by gh-pages which has been formatted and post-processed with ReSpec) into a multi-page static website to be served as a standalone resource on the wai-website.
- Ensure Ruby and Node (v14 or greater) are installed.
- Clone this repo:
git clone git@github.com:w3c/wai-aria-practices.git - Initialize or update submodules:
git submodule update --init --recursive - Install Jekyll:
bundle install. - Install ReSpec:
npm install --global respec - Run ReSpec:
respec2html --src ./_external/aria-practices/aria-practices.html --out ./_html/aria-practices.html - Install npm dependencies:
npm install -C scripts/pre-build - Run the pre-build script:
node ./scripts/pre-build - Run Jekyll:
bundle exec jekyll serve -w --livereload. (-w --livereload doesn't work on native Windows, OK in WSL) - View the webpage at http://localhost:4000/WAI/ARIA/apg/