1 | Dust [![Build Status](https://secure.travis-ci.org/linkedin/dustjs.png)](http://travis-ci.org/linkedin/dustjs)
|
2 | ====
|
3 | This is the LinkedIn fork of Dust.
|
4 |
|
5 | ## Getting Started
|
6 | A quick tutorial for how to use Dust <https://github.com/linkedin/dustjs/wiki/Dust-Tutorial>
|
7 |
|
8 | More info <http://linkedin.github.io/dustjs/> and <http://linkedin.github.io/dustjs/#installation>
|
9 |
|
10 |
|
11 | ## More
|
12 | Read more here: <http://linkedin.github.com/dustjs/>.
|
13 |
|
14 | For LinkedIn dust-helpers: <https://github.com/linkedin/dustjs-helpers>.
|
15 |
|
16 | For LinkedIn secure-filters : <https://github.com/linkedin/dustjs-filters-secure>.
|
17 |
|
18 |
|
19 | ## Building Dust locally
|
20 | ### Grab a copy of the repo
|
21 | ```
|
22 | cd some_project_directory
|
23 | git clone https://github.com/linkedin/dustjs.git dustjs
|
24 | cd dustjs
|
25 |
|
26 | ```
|
27 |
|
28 | ### (Optional) Install Grunt-cli
|
29 | * Grunt-cli lets you run Grunt from within a subfolder see http://gruntjs.com/getting-started
|
30 | ```
|
31 | npm install -g grunt-cli
|
32 | ```
|
33 |
|
34 | ### fetch all the node dependencies
|
35 | ```
|
36 | npm install
|
37 | ```
|
38 | ### Run jshint and tests
|
39 | ```
|
40 | grunt test
|
41 | ```
|
42 |
|
43 | ## Contributing to Dust
|
44 |
|
45 | ### setup a branch for what you are working on
|
46 | ```
|
47 | git checkout -b myBranchName
|
48 | ```
|
49 |
|
50 | ### Run jshint and tests
|
51 | ```
|
52 | grunt test
|
53 | ```
|
54 |
|
55 | ### ... alternatively, run the watcher which hints and tests as you code
|
56 | ```
|
57 | grunt watch
|
58 | ```
|
59 |
|
60 | ### Add unit tests
|
61 | Unit tests can be found in the `test/jasmine-tests/spec` directory
|
62 |
|
63 | ### Add an issue and send a pull request
|
64 | Pull requests are easier to track if you also include an issue
|
65 | sending a pull request from a branch makes it easier for you to resolve conflicts in master
|
66 |
|
67 |
|
68 |
|