NOTE: Node.js, Node Package Manager and Harp.js must be installed before proceeding. Resources are available at foot of page.
-
Create repository in GitHub / initialize with readme
-
Terminal: Clone Repository to your local machine using either HTTPS (first option) or SSH (SSH must be set up first)
- $ git clone https://github.com/[username]/[repository]
- $ git clone git@github.com:[username]/[repository].git
- Go to repo directory
- $ cd repository
- Create new branch "gh-pages"
- $ git checkout --orphan gh-pages
- Remove all files in folder
- $ git rm -rf . [don't forget the dot at the end!]
- Init standard harp app
- $ harp init _harp
OR
Init harp app with a random example blog template
- $ harp init _harp --boilerplate harp-boilerplates/hb-blog
- Compile harp app
- $ harp compile _harp ./
- Git add changed files
- $ git add -A
- Commit Git changes
- $ git commit -a -m "insert commit message here"
- Git push changes to repository
- $ git push origin gh-pages
- Your page can be found at [username].github.io/[repository].
If problems arise, go to 'branches' in your repo and delete your gh-pages branch and start again from Step 1!