Skip to content
This repository has been archived by the owner. It is now read-only.
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
go
 
 

This gem has been deprecated.

us_web_design_standards: U.S. Web Design Standards style assets gem

Provides the style assets from the U.S. Web Design Standards as a Ruby Gem.

Provides plugins for use with Jekyll-based web sites. Other frameworks may be supported in the future.

Usage

This gem is compatible with Jekyll. If you are looking for a Ruby on Rails version, please see the USWDS Rails gem.

Jekyll

In your Gemfile, include the following:

group :jekyll_plugins do
  gem 'us_web_design_standards'
end

Add a uswds.scss file to your project in the asset directory of your choosing that contains at least the following:

---
---

@import "us_web_design_standards";

Integrate the generated uswds.css file and its styles into your project's layouts and templates, build the site per usual, and observe the results.

Development

First, choose a Jekyll site you'd like to use to view the impact of your updates and clone its repository; then clone this repository into the same parent directory. For example, to use the 18F Guides Template:

$ git clone git@github.com:18F/guides-template.git
$ git clone git@github.com:18F/us_web_design_standards_gem.git

In the Gemfile of the Jekyll site's repository, include the following:

group :jekyll_plugins do
  gem 'us_web_design_standards', :path => '../us_web_design_standards_gem'
end

Public domain

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.

About

Packages the U.S. Web Design Standards assets as a Ruby Gem for use in a Jekyll project

Resources

License

Packages

No packages published