Skip to content

Commit 0207b83

Browse files
committed
contributing file
1 parent 4f9c50b commit 0207b83

File tree

6 files changed

+35
-17
lines changed

6 files changed

+35
-17
lines changed

CHANGELOG

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,11 @@
11
THIS CHANGELOG IS AN ATTEMPT TO DOCUMENT CHANGES TO THIS PROJECT.
22

3+
PL-node-v0.1.1
4+
- FIX: Removed View All Pattern SubItem Link Logic, no longer in reference implementation
5+
- ADD: Flag for generating debug file
6+
- ADD: Travis CI test support!
7+
- ADD: Contributing file
8+
39
PL-node-v0.1.0
410
- FIX: Links to patterns did not work when visited from a server
511
- FIX: Patterns with hyphens in the name were breaking the iframe messaging

CONTRIBUTING.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
#Contributing to Patternlab - Node
2+
If you'd like to contribute to patternlab - node, please do so! There is always a lot of ground to cover, with patternlab - php being so feature-rich.
3+
4+
No pull request is too small.
5+
6+
##Guidelines
7+
1. Please keep your pull requests concise
8+
2. _ALWAYS_ submit it against the [dev branch](https://github.com/pattern-lab/patternlab-node/tree/dev). If this does not occur, I will first, try to redirect you gently, second, port over your contribution manually if time allows, and/or third, close your pull request.

Gruntfile.js

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,10 @@ module.exports = function(grunt) {
33
// Project configuration.
44
grunt.initConfig({
55
pkg: grunt.file.readJSON('package.json'),
6-
clean: ['./public/patterns'],
6+
clean: {
7+
options: { force: true },
8+
files: ['./public/patterns']
9+
},
710
concat: {
811
options: {
912
stripBanners: true,

README.md

Lines changed: 4 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,6 @@
22

33
The Node version of Pattern Lab is, at its core, a static site generator. It combines platform-agnostic assets, like the [Mustache](http://mustache.github.io/)-based patterns and the JavaScript-based viewer, with a Node-based "builder" that transforms and dynamically builds the Pattern Lab site. By making it a static site generator, the Node version of Pattern Lab strongly separates patterns, data, and presentation from build logic. The Node version is a work in progress, the [PHP version](https://github.com/pattern-lab/patternlab-php) should be seen as a reference for other developers to improve upon as they build their own Pattern Lab Builders in their language of choice.
44

5-
## Under Active Development
6-
7-
[![Build Status](https://travis-ci.org/pattern-lab/patternlab-node.png?branch=master)](https://travis-ci.org/pattern-lab/patternlab-node) The Node version of Pattern Lab is under active development by [@bmuenzenmeyer](https://twitter.com/bmuenzenmeyer). Contributions welcome!
8-
95
### Getting Started
106

117
To run patternlab-node, just do the following from the command line at the root of patternlab-node:
@@ -18,15 +14,14 @@ This creates all patterns, the styleguide, and the patternlab site. `patternlab.
1814

1915
To have patternlab-node watch for changes to either a mustache template, data, or stylesheets, run `grunt watch`. The `Gruntfile` governs what is watched. It should be easy to add scss or whatever preprocessor you fancy.
2016

17+
### Under Active Development
18+
19+
[![Build Status](https://travis-ci.org/pattern-lab/patternlab-node.png?branch=master)](https://travis-ci.org/pattern-lab/patternlab-node) The Node version of Pattern Lab is under active development by [@bmuenzenmeyer](https://twitter.com/bmuenzenmeyer). Contributions welcome, but please take a moment to read the [guidelines](https://github.com/pattern-lab/patternlab-node/blob/master/CONTRIBUTING.md).
20+
2121
#### Watching Progress
2222

2323
Patternlab Node has reached [minimum viable product](http://en.wikipedia.org/wiki/Minimum_viable_product) status. The main branch will always have the most up to date version of patternlab-node. Watch the dev branch for what it coming next!
2424

25-
#### Roadmap
26-
* DRY & Testing.
27-
* Lineage
28-
* Documentation
29-
3025
**THE FOLLOWING IS FROM THE PATTERNLAB-PHP PROJECT. A LOT STILL APPLIES TO PATTERNLAB-NODE, BUT IT HAS NOT BEEN ADAPTED YET. USE AT YOUR OWN PERIL**
3126

3227

builder/patternlab.js

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
/*
2-
* patternlab-node - v0.1.0 - 2014-01-21
2+
* patternlab-node - v0.1.1 - 2014-04-18
33
*
44
* Brian Muenzenmeyer, and the web community.
55
* Licensed under the MIT license.
@@ -57,7 +57,9 @@ var mustache = require('./lib/Mustache/mustache.js');
5757
module.exports = function(grunt) {
5858
grunt.registerTask('patternlab', 'create design systems with atomic design', function(arg) {
5959

60+
6061
var patternlab = {};
62+
patternlab.package = grunt.file.readJSON('package.json');
6163
patternlab.data = grunt.file.readJSON('./source/_data/data.json');
6264
patternlab.listitems = grunt.file.readJSON('./source/_data/listitems.json');
6365
patternlab.header = grunt.file.read('./source/_patternlab-files/pattern-header-footer/header.html');
@@ -286,6 +288,8 @@ module.exports = function(grunt) {
286288

287289
}
288290

291+
}
292+
289293
};
290294

291295
//the patternlab site requires a lot of partials to be rendered.
@@ -323,9 +327,10 @@ module.exports = function(grunt) {
323327
});
324328
grunt.file.write('./public/index.html', patternlabSiteHtml);
325329

326-
//debug
327-
var outputFilename = './patternlab.json';
328-
grunt.file.write(outputFilename, JSON.stringify(patternlab, null, 3));
329-
330+
//debug file can be written by setting flag on package.json
331+
if(patternlab.package.debug){
332+
var outputFilename = './patternlab.json';
333+
grunt.file.write(outputFilename, JSON.stringify(patternlab, null, 3));
334+
}
330335
});
331336
};

package.json

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "patternlab-node",
33
"description": "Pattern Lab is a collection of tools to help you create atomic design systems. This is the node command line interface (CLI).",
4-
"version": "0.1.0",
4+
"version": "0.1.1",
55
"devDependencies": {
66
"grunt": "~0.4.0",
77
"grunt-contrib-watch": "~0.2.0",
@@ -27,5 +27,6 @@
2727
},
2828
"engines": {
2929
"node": ">=0.8"
30-
}
30+
},
31+
"debug": false
3132
}

0 commit comments

Comments
 (0)