Here're some examples:
Got some killer app, some neat project, a cool portfolio? Make an easy single-page site to show it all off. SinglePaged uses jekyll niceties to make a polished, modular, and beautiful single page site.
_config.yml to set the site title, description, etcSound good? Let's go!
There are three way to get started: (links jump to that section)
**username**.github.io. (click settings in the right column)git checkout publish && git branch -m master && git push -u origin master && git branch -D gh-pages to get the publish branch as master for a clean, empty starting point.git push origin --delete gh-pages to delete your remote's development branchNow hop over to Usage to get it running with your own stuff!
When you publish changes use git push -u origin master
whatever you want. (click settings in the right column)
git checkout publish && git branch -D gh-pages && git branch -m gh-pages && git push -uf origin gh-pages to swap the publish and gh-pages branch.Now hop over to Usage to get it running with your own stuff!
When you publish changes use git push -u origin gh-pages
This is the most complicated use-case .. but it's the coolest.
Say you've got your kickass project github.com/t413/kicker and want to have
some web presence to post about on hacker news.
This will create an orphan branch called gh-pages in your repository
where you can publish changes, posts, images, and such. It won't alter your code at all.
cd into your project on the command linegit remote add -t publish singlepage git@github.com:t413/SinglePaged.git to get access to this repository.git fetch singlepage publish:gh-pages to fetch the remote branchgit branch --set-upstream-to gh-pages singlepage/publish && git checkout gh-pages;
This creates and checks out an orphan branch called gh-pages that tracks the original and lets you make changes.git push origin gh-pages it'll be live at yourusername.github.io/repositoryNameNow hop over to Usage to get it running with your own stuff!
When you publish changes use git push -u origin gh-pages
Alright, you've got a clean copy and are ready to push some schmancy pages for the world to ogle at.
_config.yml to change your title, keywords, and description._posts/ called 2014-01-01-intro.md
Edit it, and add: ---
title: "home"
bg: white #defined in _config.yml, can use html color like '#010101'
color: black #text color
style: center
---
# Example headline!
and so on..2014-01-02-art.md with an divider image this time: ---
title: "Art"
bg: turquoise #defined in _config.yml, can use html color like '#0fbfcf'
color: white #text color
fa-icon: paint-brush
---
#### A new section- oh the humanity!Note: That part fa-icon: paint-brush will use a font-awesome icon of paint-brush. You can use any icon from this font-awesome icon directory.
sudo gem install github-pagesjekyll serve -w
bg: mycolor and color: myothercolor to change the background and text colors for that section.'#0fbfcf' or a key to a special color defined in _config.yml under 'colors'.
^C and jekyll serve -w.Nifty, right!
So you've got a copy running and there's some new update? Let's update!
git checkout gh-pages for a standalone or existing pagegit checkout master for a username.github.io pagegit remote | grep -q "singlepage" || git remote add -t publish singlepage https://github.com/t413/SinglePaged.git to be sure you have access to this repository (you can run this command at any time).git fetch singlepage to fetch-in-place new changes.git merge singlepage/publishgit rebase singlepage/publish