updated blog post with link to Github pages, improved setup steps

This commit is contained in:
Brandon Mathis 2011-08-13 16:28:46 -04:00
parent 8600f3ac7e
commit f0f290795e
2 changed files with 7 additions and 7 deletions

View File

@ -7,7 +7,7 @@ comments: true
categories: release
---
Octopress is a framework designed by [Brandon Mathis](http://brandonmathis.com) for [Jekyll](http://github.com/mojombo/jekyll), the blog aware static site generator powering Github Pages.
Octopress is a framework designed by [Brandon Mathis](http://brandonmathis.com) for [Jekyll](http://github.com/mojombo/jekyll), the blog aware static site generator powering [Github Pages](http://pages.github.com).
To start blogging with Jekyll, you have to write your own HTML templates, CSS, Javascripts and set up your configuration. But with Octopress
All of that is already taken care of. Simply [clone or fork Octopress](https://github.com/imathis/octopress), install dependencies and the theme, and you're set.

View File

@ -20,7 +20,8 @@ repository is named `your_username.github.com` or `your_organization.github.com`
git push origin master
```
Next, if you're using Github pages for users or organizations, create a source branch and push to origin source.
Next, **if you're using [Github Pages](http://pages.github.com) to host a site for your user or organization**, create a source branch and push to origin source.
If you're using Github project pages, or hosting the site in a different way, skip this step.
``` sh
git checkout -b source
@ -28,17 +29,16 @@ Next, if you're using Github pages for users or organizations, create a source b
```
The `source` branch is created to have somewhere to store the source
of your site. GitHub expects the generated site to be pushed to the
for your site. GitHub user/organization pages expects the generated site to be pushed to the
`master` branch of your GitHub repository so that branch needs to stay
clean. As we will see later, in the [Deploying Octopress](/docs/deploying/)
section, a "link" to the `master` branch will be created in the
`_deploy` directory in which the generated site will end up.
clean. In [Deploying Octopress](/docs/deploying/) we'll setup the `master` branch for deployment.
Next, setup an [RVM](http://beginrescueend.com/) and install dependencies.
``` sh
rvm rvmrc trust
rvm reload
gem install bundler
bundle install
```
@ -50,7 +50,7 @@ Install the default Octopress theme,
### What to Commit?
Now that you've installed the `source` and `sass` directories add them to your git repository, commit and push.
With `rake install` you've setup the default Octopress theme in the `source` and `sass` directories. Add them to your git repository, commit and push. *Remember if you're hosting with Github user/organization pages, you'll want to commit these to the `source` branch.*
``` sh
git add .