Giter Club home page Giter Club logo

mdcss-theme-jigsass's Introduction

jigSass mdcss

NPM Version Build Status

jigSass mdcss is a theme for mdcss based on Jonathan Neal's own mdcss GitHub theme.

Usage

Add mdcss and jigSass mdcss to your build tool:

npm install mdcss --save-dev
npm install mdcss-theme-jigsass --save-dev

Whenever mdcss is used, reference this theme.

require('mdcss')({
	theme: require('mdcss-theme-jigsass')({ /* options */ })
})

Features

Example

The example keyword is used to render living examples of code in iframes.

```example
<button>This is a button</button>
```

Specifying a language like example:html generates an example that is then followed by the original code block.

```example:html
<button>This is a button</button>
```

Arguments that follow ,name:value may be used to customize the example iframes. For instance, the width or height of an example might be specified so that its contents adhere to a particular breakpoint.

```example,width=1024px
<p>The desktop view.</p>
```

```example,width=768px
<p>The tablet view.</p>
```

```example,width=320px
<p>The mobile view.</p>
```

Color

The color keyword is used to generate a visual palette of colors. Arguments that follow @name: value may be used to provide any additional details about a color.

```example:color
@color: #ffffff @name: White
@color: #f8f8f8 @name: White Smoke
@color: #e7e7e7 @name: Whisper
@color: #777777 @name: Grey
@color: #565454 @name: Matterhorn
@color: #4078c0 @name: Steel Blue
@color: #333333 @name: Night Rider
```

Order

The order heading detail is used to control the order of sections in the generated style guide. A negative order value will shift the item before non-ordered items, while a positive order value will push the item after non-ordered values.

/*---
section: First Section
order: -1
---

Attached to a subsection, the order detail will control the position of the subsection inside the section.

/*---
title:   Last Subsection
section: Third Section
order: 1
---

Options

Options control the look and feel of the JigSass mdcss theme, as well as any iframe examples that may be used.

title

Type: String
Default: 'Style Guide'

The page title to be used by the style guide.

logo

Type: String
Default: 'jigsass-logo.png'

The page logo to be used by the style guide.

css

Type: Array
Default: ['style.css']

A list of CSS files to be used by the theme.

js

Type: Array
Default: []

A list of JavaScript files to be used by the theme.

examples.base

Type: String
Default: null

The base URL to use for all relative URLs contained within an example, including CSS and JavaScript references.

examples.target

Type: String
Default: '_self'

The frame to open example hyperlinks from within an example.

examples.css

Type: Array
Default: ['style.css']

A list of CSS files to be used by examples.

examples.js

Type: Array
Default: null

A list of JavaScript files to be used by examples.

examples.bodyjs

Type: Array
Default: null

A list of JavaScript files to be used by examples, inserted after the example.

examples.htmlcss

Type: String
Default: 'background:none;border:0;clip:auto;display:block;height:auto;margin:0;padding:0;position:static;width:auto'

A string of styles applied to the <html> wrapping the example. These default styles are used to create a seamless effect with the styleguide.

examples.bodycss

Type: String
Default: 'background:none;border:0;clip:auto;display:block;height:auto;margin:0;padding:16px;position:static;width:auto'

A string of styles applied to the <body> wrapping the example. These default styles are used to create a seamless effect with the styleguide.

mdcss-theme-jigsass's People

Contributors

txhawks avatar jonathantneal avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.