Wintersmith setup - Silversmith

There are some excellent tutorials for setting up Wintersmith out there. This is a summary for a quick and easy setup with Github Pages.

Enter your GitHub username:

Steps

Create a GitHub repo for your user. As the name, type in: {{username || 'username'}}.github.io.

Clone this repo to your local folder

git clone git@github.com:{{username || 'username'}}/{{username || 'username'}}.github.io.git ~/blog
cd ~/blog

Install wintersmith
```
npm install wintersmith -g
```
Make sure GitHub doesn’t treat is as a Jekyll project and ignore node modules:
```
touch .nojekyll
echo "node_modules" > .gitignore
```
Create your blog in folder src/
```
wintersmith new src/
cd src/
```

In this folder you will find the source of your blog. Edit the start of config.json:

{
  "output": "./../",
  "locals": {
    "url": "http://{{username || 'username'}}.github.io",
    "name": "Wintersmith meets {{username || 'username'}}"
    "owner": "{{username || 'username'}}"
    "description": "This is the blog of {{username || 'username'}}"
    //..

Write articles, change templates, do whatever you like to it. To preview in localhost:8080:
```
wintersmith preview
```

Once you are done, you can build it and push it online

wintersmith build

git add ../.
git commit -m "finished setup for first blog release"
git push -u origin master

It may take GitHub a bit to update your page, but once it’s done you can visit it at http://{{username || ‘username’}}.github.io