/coil-site

Jekyll site for showcasing the projects and people that make up Census Open Innovation Labs

Primary LanguageSCSSOtherNOASSERTION

The Census Open Innovation Labs Website

This repo includes code for the COIL website. coil.census.gov

It is built with Jekyll using the uswds-jekyll theme


Dependencies

  1. Ruby v2.2.2+, Installation guides
  2. Node v4.2.3+, Installation guides
  3. Bundler v1.12.3+, Installation guides a. jekyll (gem install jekyll)
  4. Chrome v59 or higher (v60 if on Windows)

Getting Started

To work on the site, switch to your local copy of the repository in terminal then run the following command to install project dependencies:

npm install
bundle install

Now that all of your dependencies are installed, you can run your local server by running the following command:

npm start

Go to 127.0.0.1:4000 in your browser — you should be viewing a local instance

  • npm run watch: Runs a series of commands that watches for any changes in both USWDS node module and the root level asset folders in this repo.

  • npm start -- --incremental or npm run serve: Runs your local server with incremental regeneration enabled to greatly improve build time. Use instead of npm start.


Testing

HTML Validation

run npm run html-proofer to validate the site's HTML, check broken links, missing images & alts, etc with HTMLProofer.

run npm run html-proofer:skip-external to save time by skipping validating external links


Building with Federalist

This repository is hooked up to Federalist, an automatic build process used by many government websites. Whenever you push changes to Github, Federalist will make a new build (using the federalist command in package.json).

Federalist will then provide a URL for this build which you can use for user testing. To get the URL for the build, click on the green check-mark next to the build status for whatever branch you just pushed to, and then click the "Details" link.

When you merge a branch into main, Federalist will then make a new build with the same process and deploy it to opportunity.census.gov

When a build fails

If Federalist fails to build, the status dot on the branch in Github will change from yellow (in progress) to red (failed). If this happens, contact Logan Powell via Slack in the Census Bureau workspace to see the logs from the failed build. He has access to Federalist itself. We do not.