LandRegistry/lr-style-guide

Name: lr-style-guide

Owner: HM Land Registry

Description: Land Registry Style Guide

Created: 2015-06-11 09:29:31.0

Updated: 2016-12-16 13:41:20.0

Pushed: 2015-07-31 12:50:46.0

Homepage: http://lr-style-guide.herokuapp.com/

Size: 1576

Language: JavaScript

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Land Registry style guide

Derived from GOV.UK Elements, this style guide aims to produce consumable static assets for public facing applications.

How can my app consume this style guide?

Everything you?re aiming to consume is in the `lr-styleguide` directory.

Simple consumption

If you have no need to compile sass / js assets, and want to keep it very simple, simply pop the following into `/static/`:

styleguide
/css
    styleguide-ie6.css
    styleguide-ie7.css
    styleguide-ie8.css
    styleguide.css
/images
    * all files
/js
    styleguide.min.js

The following code in your `<head>` will give you the styles:

[if gt IE 8]><!--><link href="/static/lr-styleguide/css/styleguide.css" media="screen" rel="stylesheet" type="text/css" /><!--<![endif]-->
[if IE 8]><link href="/static/lr-styleguide/css/styleguide-ie8.css" media="screen" rel="stylesheet" type="text/css" /><![endif]-->
[if IE 7]><link href="/static/lr-styleguide/css/styleguide-ie7.css" media="screen" rel="stylesheet" type="text/css" /><![endif]-->
[if IE 6]><link href="/static/lr-styleguide/css/styleguide-ie6.css" media="screen" rel="stylesheet" type="text/css" /><![endif]-->

Then, just before your closing `</body>` tag, add the following:

ipt type="text/javascript" src="/static/lr-styleguide/js/styleguide.min.js"></script>

Note that `styleguide.js` includes:

All assets are concatenated and minified.

More complex consumption
Git Submodule

You could include the style guide as a git submodule:

 to the individual files as above.

 Flask + Flask Assets (+ web-assets)

ou want to incorporate the style guide files into an asset pipeline, some considerations...

# SASS

 sure you've sorted out your scss load paths, for example: ```static/lr-styleguide/sass```

also need to make sure you've set up a load path to GOV.UK frontend toolkit stylesheets - which you need to have installed seperately. It?s a dependency. For example: ```static/govuk_frontend_toolkit/stylesheets```

in ```lr-styleguide/sass``` are 4 stylesheets:

yleguide.scss
yleguide-ie8.scss
yleguide-ie7.scss
yleguide-ie6.scss

e files ```@import``` everything in the GOV.UK frontend toolkit and ```partials```

e are the files you need to output to the frontend as css (see simple method above). Create your bundles accordingly.

# Javascript

?s an example bundle for concatenated and minified js output:

js = Bundle('govuk_frontend_toolkit/javascripts/vendor/polyfills/bind.js',

        'govuk_frontend_toolkit/javascripts/govuk/selection-buttons.js',
        'govuk_frontend_toolkit/javascripts/govuk/stick-at-top-when-scrolling.js',
        'govuk_frontend_toolkit/javascripts/govuk/stop-scrolling-at-footer.js',
        'lr-styleguide/js/vendor/polyfills/details.polyfill.js',
        'lr-styleguide/js/vendor/jquery/jquery-1.11.3.js',
        'lr-styleguide/js/components/buttons-actions.js',
        'lr-styleguide/js/components/case-list.js',
        'lr-styleguide/js/components/inits.js',
        filters='rjsmin', output='lr-styleguide/js/styleguide.min.js')

assets.register('styleguide_js', js)

orking on this style guide

Getting started

style guide itself has a Node / Grunt workflow to produce assets.

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.