Default Jekyll site settings can be found in _config.yml. Refer to Jekyll documentation for more information about configuration options.
To override settings in your lcoal environment, you can add a _config.dev.yml file to the root directory. Any settings in this file will override an equivalent setting in the base Jekyll _config.yml configuration. For example, you may want to configure Sass style to expanded to debug the non-minified styles, or temporarily disable non-English locales to improve rebuild times.
The Cloud.gov Pages administration dashboard allows us to override _config.yml settings for the live site and for preview branches.
Before managing site settings, you will need to request access from one of the existing Cloud.gov Pages organization managers. You will need to provide them with your email address and GitHub username.
Once you have access to Cloud.gov Pages:
- Sign in to Cloud.gov Pages
- After signing in, click the link for "identity-site" in the list of sites
- Click "Site settings" in the sidebar
- Expand "Advanced settings"
- Add or edit the settings under "Live site" or "Preview site", depending on where you want your configuration to apply
- Click "Save advanced settings"
Saving the settings will automatically trigger a rebuild of the main branch. If you also need to rebuild an in-progress branch, you can either push an empty commit to your branch, or find the branch on the "Build history" page and click the "Rebuild" button.