- Sign-up for the [Digital.gov newsletter »]({{< ref "/about/subscribe.md" >}})
- Follow us on Twitter »
- Like our page on Facebook »
Want to learn more about how we work? Check out our Wiki page »
Digital.gov is built with Hugo and hosted by Federalist and Cloud.gov.
npm install
Read the HUGO quickstart guide »
For OSX:
brew install hugo
see https://gohugo.io/getting-started/installing/ for other OSs
- Run
hugo serve
in the terminal - wait 5-6 secs
- visit http://localhost:1313/
Other helpful HUGO commands:
hugo serve --templateMetricsHints
— for seeing where you can apply caching in templates and speed up the build time See more »
- Read through the recent releases
- Run
brew upgrade hugo
to upgrade your local copy (docs). - Set the version in the
.hugo-version
file. This is only used for telling Federalist which version of Hugo they should checkout and use.
We follow the WCAG2AA standard, and one of the ways we check that we're following the right rules is through automated tools, like pa11y. For more info on the rules being tested checkout the pa11y wiki.
To run a web accessibility test on digital.gov do the following:
- Check out the site from GitHub https://github.com/GSA/digitalgov.gov/
- Install and run the site locally following the
Install
andRun
instructions above. Site must be running locally to perform the scan.
- If this is your first time running pa11y, then you'll need to run
npm install
to make sure pa11ly is installed.
- In a separate terminal window, run
npm run test:pa11y
to initiate the accessibility checker.
Note: Currently, this only runs accessiblity checks on the site home page as a Proof of Concept demonstration.
Accessibility testing configuration is located in the .pa11yci file.
{{< legacy-img src="/\d+/\d+/\d{2,4}[-x]+\d{2,4}[_-]*(.+?)\.[pngje]+"( alt=".+?")* >}}
{{< img src="$1"$2 >}}
{{< legacy-img src="/(\d{4,4})
{{< legacy-img src="$1
^url: .+/([^/]+)\.md
slug: $1