us_web_design_standards 0.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5b842b55143b3fa0155cc1de3763d1072e140533
+  data.tar.gz: 53472a7ec6a66c2238d29b9370b48dbd22ba2173
+SHA512:
+  metadata.gz: 09c4d440a3175823dce0018fa43f9152c8d75120d5b7b5adbea36ed0f75678beaea7cd096fa9fde2dd30f46073749e858dd198f958dbb47e2222037ee070ce16
+  data.tar.gz: 370238c4842779dea718c04dcf99c2a6969736a7280ea02d9769a8c685f657312e575a5c6a34c1d167ba1f683abb7500cceae0d26fe39ca6c5efd3a5f0819f28

data/CONTRIBUTING.md

@@ -0,0 +1,19 @@
+## Welcome!
+
+We're so glad you're thinking about contributing to an 18F open source project! If you're unsure about anything, just ask -- or submit the issue or pull request anyway. The worst that can happen is you'll be politely asked to change something. We love all friendly contributions.
+
+We want to ensure a welcoming environment for all of our projects. Our staff follow the [18F Code of Conduct](https://github.com/18F/code-of-conduct/blob/master/code-of-conduct.md) and all contributors should do the same.
+
+We encourage you to read this project's CONTRIBUTING policy (you are here), its [LICENSE](LICENSE.md), and its [README](README.md).
+
+If you have any questions or want to read more, check out the [18F Open Source Policy GitHub repository]( https://github.com/18f/open-source-policy), or just [shoot us an email](mailto:18f@gsa.gov).
+
+## Public domain
+
+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](https://creativecommons.org/publicdomain/zero/1.0/).
+
+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.

data/LICENSE.md

@@ -0,0 +1,31 @@
+As a work of the United States Government, this project is in the
+public domain within the United States.
+
+Additionally, we waive copyright and related rights in the work
+worldwide through the CC0 1.0 Universal public domain dedication.
+
+## CC0 1.0 Universal Summary
+
+This is a human-readable summary of the [Legal Code (read the full text)](https://creativecommons.org/publicdomain/zero/1.0/legalcode).
+
+### No Copyright
+
+The person who associated a work with this deed has dedicated the work to
+the public domain by waiving all of his or her rights to the work worldwide
+under copyright law, including all related and neighboring rights, to the
+extent allowed by law.
+
+You can copy, modify, distribute and perform the work, even for commercial
+purposes, all without asking permission.
+
+### Other Information
+
+In no way are the patent or trademark rights of any person affected by CC0,
+nor are the rights that other persons may have in the work or in how the
+work is used, such as publicity or privacy rights.
+
+Unless expressly stated otherwise, the person who associated a work with
+this deed makes no warranties about the work, and disclaims liability for
+all uses of the work, to the fullest extent permitted by applicable law.
+When using or citing the work, you should not imply endorsement by the
+author or the affirmer.

data/README.md

@@ -0,0 +1,60 @@
+## [`us_web_design_standards`](https://rubygems.org/gems/us_web_design_standards): U.S. Web Design Standards style assets gem
+
+Provides the style assets from the [U.S. Web Design
+Standards](https://playbook.cio.gov/designstandards) as a [Ruby
+Gem](https://rubygems.org/).
+
+Provides plugins for use with [Jekyll](https://jekyllrb.com/)-based web sites.
+Other frameworks may be supported in the future.
+
+### Usage
+
+In your [`Gemfile`](http://bundler.io/gemfile.html), include the following:
+
+```ruby
+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:
+
+```scss
+---
+---
+
+@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:
+
+```shell
+$ 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:
+
+```ruby
+group :jekyll_plugins do
+  gem 'us_web_design_standards_gem', :path => '../us_web_design_standards_gem'
+end
+```
+
+### Public domain
+
+This project is in the worldwide [public domain](LICENSE.md). As stated in [CONTRIBUTING](CONTRIBUTING.md):
+
+> 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](https://creativecommons.org/publicdomain/zero/1.0/).
+>
+> 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.

data/assets/_scss/components/_accordions.scss

@@ -0,0 +1,95 @@
+// Variables
+
+$accordion-border: 3px solid $color-gray-lightest;
+
+// Accordion Styles
+
+.usa-accordion,
+.usa-accordion-bordered {
+
+  + .usa-accordion,
+  + .usa-accordion-bordered {
+    margin-top: 1rem;
+  }
+
+  > ul {
+    color: $color-base;
+    margin: 0;
+    padding: 0;
+    width: 100%;
+
+    > li {
+      background-color: $color-gray-lightest;
+      font-family: $font-sans;
+      list-style: none;
+      margin-bottom: 6px;
+      width: 100%;
+    }
+  }
+
+  button[aria-expanded=false] {
+    background-image: url('../img/plus.png');
+    background-image: url('../img/plus.svg');
+    background-repeat: no-repeat;
+    background-size: 1.3rem;
+  }
+
+  button {
+    background-color: $color-gray-lightest;
+    background-image: url('../img/minus.png');
+    background-image: url('../img/minus.svg');
+    background-position: right 3rem center;
+    background-repeat: no-repeat;
+    background-size: 13px;
+    color: $color-base;
+    cursor: pointer;
+    display: inline-block;
+    font-family: $font-sans;
+    margin: 0;
+    padding: {
+      bottom: 1.5rem;
+      left: 3rem;
+      right: 5.5rem;
+      top: 1.5rem;
+    }
+    width: 100%;
+
+    &:focus {
+      box-shadow: $focus-shadow;
+    }
+
+    &:hover {
+      background-color: $color-gray-lighter;
+      color: $color-base;
+    }
+
+    h1, h2, h3, h4, h5, h6 {
+      margin: 0;
+    }
+  }
+}
+
+.usa-accordion-bordered {
+  .usa-accordion-content {
+    border: {
+      bottom: $accordion-border;
+      left: $accordion-border;
+      right: $accordion-border;
+    }
+  }
+}
+
+.usa-accordion-content {
+  display: block;
+  background-color: white;
+  overflow: auto;
+  padding: 3rem;
+
+  > *:first-child {
+    margin-top: 0;
+  }
+
+  > *:last-child {
+    margin-bottom: 0;
+  }
+}

data/assets/_scss/components/_alerts.scss

@@ -0,0 +1,78 @@
+.usa-alert {
+  @include media($medium-screen) {
+    background-size: 5.2rem;
+  }
+  background-color: #eeeeee;  
+  background-position: 1rem 2rem;
+  background-repeat: no-repeat;
+  background-size: 4rem;
+  margin-top: 1.5em;
+  padding: 1em;
+
+  ul {
+    margin: {
+      bottom: 0;
+      top: 1em;
+    }
+  }
+}
+
+.usa-alert-icon {
+  display: table-cell;
+  padding-right: 1rem;
+}
+
+.usa-alert-body {
+  @include media($medium-screen) {
+    padding-left: 5rem;
+  }
+  display: table-cell;
+  padding-left: 3.5rem;
+  vertical-align: top;
+}
+
+.usa-alert-heading {
+  @include media($medium-screen) {
+    margin-top: .3rem;
+  }
+  margin: {
+    bottom: .3rem;
+    top: 0;
+  }
+}
+
+.usa-alert-text {
+  font-family: $font-sans;
+  margin: {
+    bottom: 0;
+    top: 0;
+  }
+}
+
+.usa-alert-success {
+  background-color: #E5FCDE;
+  background-image: url('../img/alerts/success.png');  
+  background-image: url('../img/alerts/success.svg');  
+}
+
+.usa-alert-warning {
+  background-color: #FDF7DC;
+  background-image: url('../img/alerts/warning.png');  
+  background-image: url('../img/alerts/warning.svg');   
+}
+
+.usa-alert-error {
+  background-color: #F9DEDE;
+  background-image: url('../img/alerts/error.png');  
+  background-image: url('../img/alerts/error.svg');   
+}
+
+.usa-alert-info {
+  background-color: #E8F5FA;
+  background-image: url('../img/alerts/info.png');  
+  background-image: url('../img/alerts/info.svg');   
+}
+
+.usa-alert-no_icon {
+ background-image: none; 
+}

data/assets/_scss/components/_disclaimer.scss

@@ -0,0 +1,25 @@
+.usa-disclaimer {
+  @include media($small-screen) {
+    font-size: $h5-font-size;
+  }
+  background-color: $color-gray-lightest;
+  font-size: $h6-font-size;
+  padding: {
+    bottom: .5rem;
+    top: .5rem;
+  }
+}
+
+// This hides the stage note (i.e. alpha, beta, etc) of the disclaimer for 
+// anything smaller than large screen sizes
+.usa-disclaimer-stage {
+  @include media($large-screen) {
+    display: block;
+  }
+  display: none;
+  float: right;
+}
+
+.usa-flag_icon {
+  margin-right: .2rem;
+}

data/assets/_scss/components/_footer.scss

@@ -0,0 +1,292 @@
+.usa-footer {
+  .usa-unstyled-list {
+    display: block;
+  }
+
+  .usa-footer-primary-link {
+    @include media($medium-screen) {
+      border-top: none;
+    }
+    color: $color-base;
+    display: block;
+    font-weight: $font-bold;
+    margin-top: 0;
+    padding: {
+      bottom: 2rem;
+      top: 2rem;
+    }
+  }
+
+  a {
+    font-weight: normal;
+  }
+}
+
+.usa-footer-return-to-top {
+  padding: {
+    bottom: 2rem;    
+    top: 2rem;
+  }
+}
+
+.usa-footer-primary-section {
+  background-color: $color-gray-lightest;
+
+  .usa-footer-primary-content {
+    padding: {
+      left: 2.5rem;
+      right: 2.5rem;
+    }
+
+    li {
+      @include media($medium-screen) {
+        margin-left: 0;
+      }
+      margin-left: 1rem;
+    }
+
+    @include media($medium-screen) {
+      padding: {
+        left: 0;
+        right: 0;
+      }
+    }  
+  }
+
+  .usa-grid-full {
+    @include media($medium-screen) {
+      padding: {
+        left: 2.5rem;
+        right: 2.5rem;
+      }
+    }
+  }
+}
+
+.width-one-sixth {
+  @include media($medium) {
+    @include span-columns(2);
+  }  
+}
+
+.usa-footer-medium {
+  .usa-footer-primary-section {
+    padding: 0;
+    
+    @include media($medium-screen) {
+      padding: {
+        top: 1rem;
+        bottom: 1rem;
+      }
+    }
+  }
+
+  .usa-footer-nav ul {
+    @include media($medium-screen) {
+      align-items: center;
+      display: flex;  
+    }
+  }  
+}
+
+.usa-footer-slim {
+
+  .usa-footer-nav a {
+    display: block;
+  }
+
+  .usa-footer-primary-section {
+    padding-bottom: 2rem;
+    
+    @include media($medium-screen) {
+      padding: {
+        bottom: 1rem;
+        top: 1rem;
+      }
+
+      .usa-grid-full {
+        align-items: center;
+        display: flex;     
+      }      
+    }
+  }
+}
+
+ul.usa-footer-primary-content,
+li.usa-footer-primary-content,
+li.usa-footer-primary-content {
+  border-top: 1px solid $color-base;      
+
+  &:last-child {
+    border-bottom: 1px solid $color-base;
+    @include media($medium-screen) {
+      border-bottom: none;
+    }
+  }
+
+  @include media($medium-screen) {
+    border: none;
+  }
+}
+
+.usa-sign_up-block {
+  padding: {
+    bottom: 2rem;
+    left: 2.5rem;
+    right: 2.5rem;
+  }
+
+  label:first-of-type {
+    margin-top: 0;
+  }
+
+  button {
+    float: none;
+    margin: {
+      right: 0;
+      top: 1.5rem;
+    }
+  }
+
+  input {
+    width: 100%;
+  }
+
+  @include media($medium-screen) {
+    float: right;
+    padding: 0;
+  }  
+}
+
+.usa-footer-secondary_section {
+  background-color: $color-gray-lighter;
+  padding: {
+    top: 3rem;
+    bottom: 3rem;
+  }
+
+  a {
+    color: $color-base;
+  }
+}
+
+.usa-footer-big-secondary-section {
+  @include media($medium-screen) {
+    padding-top: 5rem;
+  }  
+}
+
+.usa-footer-contact-links {
+  @include media($medium-screen) {
+    text-align: right;
+  }
+}
+
+.usa-footer-big {
+  .usa-footer-primary-section {
+    @include media($medium-screen) {
+      padding: {
+        top: 3rem;
+        bottom: 4rem;
+      }      
+    }
+  }
+
+  ul {
+    padding-bottom: 2.5rem;
+
+    &:last-child {
+      border-bottom: 1px solid $color-base;
+
+      @include media($medium-screen) {
+        border-bottom: none;
+      }
+    }
+
+    li {
+      line-height: 2em;
+    }
+
+    @include media($medium-screen) {
+      padding-bottom: 0;
+    }    
+
+    .usa-footer-primary-link {
+      background-image: url('../img/arrow-down.png');
+      background-image: url('../img/arrow-down.svg');
+      background-position: 1.5rem center;
+      background-repeat: no-repeat;
+      background-size: 1.3rem;
+      padding-left: 3.5rem;
+
+      @include media($medium-screen) {
+        background: none;
+        padding-bottom: 0;
+        padding-left: 0;
+      }
+    }
+
+    &.hidden {
+      padding-bottom: 0;
+
+      .usa-footer-primary-link { 
+        background-image: url('../img/arrow-right.png');
+        background-image: url('../img/arrow-right.svg');
+        cursor: pointer;
+        margin: 0;
+
+        @include media($medium-screen) {
+          background: none;
+          padding-left: 0;
+        }        
+      }
+        
+      li { display: none; }
+    }
+  }
+}
+
+.usa-footer-topic {
+  margin: 0;
+  padding: 2rem 0;
+}
+
+.usa-sign_up-header {
+  @include media($medium-screen) {
+    margin: 0;
+    padding: 2rem 0;
+  }
+}
+
+.usa-footer-logo-img {
+  max-width: 14rem;
+}
+
+.usa-footer-slim-logo-img {
+  float: left;
+  max-width: 10rem; 
+}
+
+.usa-footer-logo-heading {
+  margin-top: 2rem;
+}
+
+.usa-footer-contact-heading {
+  margin-top: 0;
+  
+  @include media($medium-screen) {
+    margin-top: 1rem;  
+  }
+}
+
+.usa-footer-slim-logo-heading {
+  display: block;
+  padding-top: 1rem;
+
+  @include media($medium-screen) {
+    display: inline-block;
+    padding: {
+      left: 1em;
+    }
+  }
+}