Skip to content

CityOfPhiladelphia/patterns

Repository files navigation

patterns [DEPRECATED]

The City of Philadelphia has released new guidelines surrounding digtal standards that includes design, code, and content. Learn more at http://standards.phila.gov/.

This repository will remain intact, but will no longer be updated.

Local Setup

Phila.gov Patterns uses Jekyll to generate pattern files. Jekyll requires the following dependencies:

Getting Started

  1. Install Jekyll $ gem install jekyll
  2. Install Pygments $ gem install pygments.rb
  3. Clone this repository
  4. cd into the patterns directory
  5. Install additional dependencies $ npm install
  6. Start the Jekyll development server $ jekyll serve
  7. Navigate to http://localhost:4000/patterns

To watch your local files for changes and update the compressed code being used on the Jekyll site:

  1. Open a second Terminal window
  2. Navigate into the root of the patterns directory
  3. Run $ grunt watch

Versioning

Phila.gov Patterns will be maintained under the Semantic Versioning guidelines as much as possible. Releases will be numbered with the following format:

{major}.{minor}.{patch}

Guidelines

  1. Breaking backward compatibility bumps the major (and resets the minor and patch)
  2. New patterns (without breaking backward compatibility) bumps the minor (and resets the patch)
  3. Bug fixes and misc changes bumps the patch

For more information on SemVer, please visit http://semver.org.

New in 1.0

  • Foundation 6!
  • Added grunt-postcss to dev process.

Upgrading to 1.0

There have been a number of markup changes in foundation 6, which developers will need to be aware of when updating to Patterns 1.0. Here is the list of elements to watch out for:

Sites using the Phila.gov Pattern Portfolio

Site Source Version
alpha.phila.gov repo 1.2.1
analytics.phila.gov repo 1.1.2
Bullet Voting repo 0.12.1
Crashboard: Service Monitor Status repo 1.4.0
Community Health Explorer repo 1.4.0
Jekyll Patterns Template repo 1.4.0
Make a Payment repo 0.1.1
Metadata Catalog repo 0.12.6
Open Budget repo 0.1.1
Open Contract Data repo 0.2.0
Phila.gov Patterns repo 1.2.0
Property repo 1.2.1
ROWS repo 0.8.1
Street Closures repo
Trashday repo 0.12.5