A Coronavirus FAQ for the United States of America.
A JSON API is available for site content. See the API documentation.
This website is developed using the U.S. Web Design System, is deployed on Federalist, search is provided by Search.gov, and analytics are provided by the Digital Analytics Program. This code uses the Jekyll site engine.
You may want to familiarize yourself with:
- Jekyll - The primary site engine that builds your code and content.
- Front Matter - The top of each page/post includes keywords within
--tags. This is meta data that helps Jekyll build the site, but you can also use it to pass custom variables. - U.S. Web Design System.
The _categories folder contains the question groups, or categories, which are displayed on the site. Its title property is what is visible on the site.
In the _content folder you’ll find a folder which matches the name property of a category for each category. Inside that folder is a file representing each question in that category, which has a categories property which also matches the category’s name property. Each question may belong to multiple categories, but the first category is considered its "primary category", which should correspond to its directory.
For more detailed coverage, see the Content management guide.
Content on this site is generated by federal government agencies who submit FAQ content to our team for publishing. To ensure we’re all using consistent voice and style, we have a content strategy guidance.
On the index.html you can add an urgent USWDS-style banner by changing the front matter. Turn the banner.display key to true to display the banner.
Adding an top questions icon - if you need to add an additional icon add it to the _assets/images/icons directory.
And then if you'd like to use in a top question - add it in the _data/homepage_promotion.yml.
The easiest way to get started locally, after the repository is forked, is to use Docker. After Docker is installed and running, run:
docker-compose build
docker-compose upThis will build and install all required dependencies, then compile the site, and finally start a development server which is accessible at localhost:4000. The server will recompile the site automatically as files change. Use CTRL + C to shutdown the server.
Do not edit files in the _site/ folder. These files are auto-generated, and any change you make in the folder will be overwritten.
To run without Docker, you’ll need the version of Ruby that’s specified in .ruby-version. Then, to install dependencies:
gem install bundler
bundle install
npm installFinally, to start the site, run:
npm startOpen your web browser to localhost:4000 to view your site. The server will recompile the site automatically as files change. Use CTRL + C to shutdown the server.
Tests are automatically run on commits and pull requests by CircleCI. They can be run manually:
npm testThe test suite includes:
- HTMLProofer, which looks for some basic accessibility issues, for broken links, and more. We’ve also extended it to check for well-formed links.
- jest, jest-puppeteer, and puppeteer for custom integration tests. See what’s tested in the test directory.
The jekyll template has a feature to support localization.
Languages supported will be added to the i18n portion of the site config in _config.yml.
To add in localization back into the hero component, uncomment the comment in the _includes/hero.html around the i18n-controls paragraph tag.
The plugin for parsing a the language of a file can be found in _plugins/jekyll_parse_language.rb
- Append
.lang-{2 character language code}to_contentfiles to indicate their language. - This creates a
/{2 character language code}/output directory in the site folder. - We can use
{{ post.lang }}in files to reference the current language and link to the right language in URLs. - The default language is
enfor files without the suffix.
This approach keeps each translation next to each other in directories, and allows us to filter based on page.lang on pages.
See SECURITY.
See CONTRIBUTING.
This project is in the worldwide public domain. As stated in CONTRIBUTING:
This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.
All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.