Skip to content

Commit 56e9f57

Browse files
author
mrmrs
committed
Updating Docs.
1 parent 6ac7355 commit 56e9f57

File tree

1 file changed

+29
-16
lines changed

1 file changed

+29
-16
lines changed

README.md

Lines changed: 29 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,45 @@
11
# NKD
22

3-
Barebones scaffolding for a new HTML5 Jekyll project.
3+
## Barebones scaffolding for a new Responsive HTML5 Jekyll project.
44

5+
You shouldn't have to create a bunch of files to get going. Everything should just work. NKD just works.
6+
Start developing your jekyll prototype without any of the boring setup fuss.
7+
8+
Site structure is as follows:
9+
10+
<pre>
511
nkd [Site root]
612
├── README.md [What you're reading now]
713
├── Rakefile [Rake sass, rake dev]
814
├── _config.yml [Config for site. Site will run without config in defulat mode]
915
├── _includes [Common includes I need for sites / pages]
10-
│ ├── _footer.html
11-
│ ├── _head.html
12-
│ ├── _js_includes.html
13-
│ └── _navigation_main.html
16+
│ ├── _footer.html [_BLANK_]
17+
│ ├── _head.html [Common header elements]
18+
│ ├── _js_includes.html [_BLANK_]
19+
│ └── _navigation_main.html [_BLANK_]
1420
├── _layouts [Two layout files: default and post. both are identical by default.]
15-
│ ├── default.html
21+
│ ├── default.html
1622
│ └── post.html
1723
├── _posts [Directory where you'd put posts...if you want any]
1824
├── _sass
1925
│ ├── _grid.scss [Blank media queries. Not included or compiled to css]
20-
│ ├── i.scss
26+
│ ├── i.scss [Includes normalize - compiles to i.css]
2127
│ └── normalize.scss
22-
├── _site [compiled website]
23-
│ ├── README.md
24-
│ ├── Rakefile
25-
│ ├── css
26-
│ │ ├── i.css
27-
│ │ └── normalize.css
28-
│ └── index.html
2928
├── css
3029
│ ├── i.css
31-
│ └── normalize.css
32-
└── index.html
30+
└── index.html [index file that's served up at root. The "homepage" if you will.]
31+
</pre>
32+
33+
As you can see a number of files are blank and not included by default. These are common assets I need to use.
34+
35+
36+
## Rake Tasks
37+
38+
### rake dev
39+
jekyll --auto --server
40+
Use this to start the jekyll server. It will auto generate a new site at _site every time you save a file.
41+
42+
43+
### rake sass
44+
sass --watch _sass:css
45+
Run this to start the sass autocompiler. Compiles to /nkd/css/i.css on save.

0 commit comments

Comments
 (0)