Browse Source

updated readme

unreleased_contents
Brandon Mathis 13 years ago
parent
commit
eba8e7f5f7
  1. 33
      README.markdown

33
README.markdown

@ -18,9 +18,9 @@ repository is named `your_username.github.com` or `your_organization.github.com`
git remote add origin (your repository url) git remote add origin (your repository url)
git push origin master git push origin master
# If you're using Github user or organization pages, # Next, if you're using Github user or organization pages,
# rename the master branch to source and then push # Create a source branch and push to origin source.
git branch -m master source git branch source
git push origin source git push origin source
@ -40,7 +40,7 @@ Next, setup an [RVM](http://beginrescueend.com/) and install dependencies.
rake generate # Generates your blog into the public directory rake generate # Generates your blog into the public directory
rake watch # Watches files for changes and regenerates your blog rake watch # Watches files for changes and regenerates your blog
rake preview # Watches, regenerates, and mounts a webserver at http://localhost:4000 rake preview # Watches, and mounts a webserver at http://localhost:4000
Jekyll's built in webbrick server is handy, but if you're a [POW](http://pow.cx) user, you can set it up to work with Octopress like this. Jekyll's built in webbrick server is handy, but if you're a [POW](http://pow.cx) user, you can set it up to work with Octopress like this.
@ -48,29 +48,28 @@ Jekyll's built in webbrick server is handy, but if you're a [POW](http://pow.cx)
ln -s /path/to/octopress ln -s /path/to/octopress
cd - cd -
Now you'll just run `rake watch` and load up `http://octopress.dev` instead. Now that you're setup with POW, you'll just run `rake watch` and load up `http://octopress.dev` instead.
## Writing A Post ## Writing A Post
While running `rake preview` or `rake watch`, open a new terminal session and start a Hello World post. Create your first post.
rake post['hello world'] rake post['hello world']
This will create a new post named something like `2011-06-17-hello-world.markdown` in the `source/_posts` directory. This will put a new post in source/_posts with a name like like `2011-07-3-hello-world.markdown` in the `source/_posts` directory.
Open that file in your favorite text editor and you'll see a block of [yaml front matter](https://github.com/mojombo/jekyll/wiki/yaml-front-matter) Open that file in your favorite text editor and you'll see a block of [yaml front matter](https://github.com/mojombo/jekyll/wiki/yaml-front-matter)
which tells Jekyll how to processes posts and pages. which tells Jekyll how to processes posts and pages.
--- ---
title: Hello World title: Hello World
date: 2011-06-17 14:34 date: 2011-07-03 5:59
layout: post layout: post
--- ---
Now, go ahead and type up a sample post, or use some [inspired filler](http://baconipsum.com/). Save and refresh your browser, and you Now beneath the yaml block, go ahead and type up a sample post, or use some [inspired filler](http://baconipsum.com/). If you're running the watcher, save and refresh your browser and you
should see the new post show up in your blog index. should see the new post show up in your blog index.
Octopress does more than this though. Check out [Blogging with Octopress](#include_link) to learn about cool features which Octopress does more than this though. Check out [Blogging with Octopress](#include_link) to learn about all the different ways Octopress makes blogging easier.
help make blogging easier and more beautiful.
## Configuring Octopress ## Configuring Octopress
@ -106,18 +105,18 @@ If you're using Github user or organization pages, clone the repository `git@git
# For Github project pages: # For Github project pages:
git clone git@github.com:username/project.git _deploy git clone git@github.com:username/project.git _deploy
rake init_deploy[gh-pages] rake config_deploy[gh-pages]
# For Github user/organization pages: # For Github user/organization pages:
git clone git@github.com:username/username.github.com _deploy git clone git@github.com:username/username.github.com _deploy
rake init_deploy[master] rake config_deploy[master]
# Now to deploy, you'll run # Now to deploy, you'll run
rake push rake deploy
The `init_deploy` rake task takes a branch name as an argument and creates a [new empty branch](http://book.git-scm.com/5_creating_new_empty_branches.html), adds an initial commit, and pushes it to the origin remote. The `config_deploy` rake task takes a branch name as an argument and creates a [new empty branch](http://book.git-scm.com/5_creating_new_empty_branches.html), and adds an initial commit.
This prepares your branch for easy deployment. The `rake push` task copies the generated blog from the `public` directory to the `_deploy` directory, adds new files, removes old files, sets a commit message, and pushes to Github. This prepares your branch for easy deployment. The `rake deploy` task copies the generated blog from the `public` directory to the `_deploy` directory, adds new files, removes old files, sets a commit message, and pushes to Github.
Then Github will queue your site for publishing (which usually occurs within minutes). Github will queue your site for publishing (which usually occurs instantly or within minutes if it's your first commit).
## License ## License
(The MIT License) (The MIT License)

Loading…
Cancel
Save