OSv/blog

This project holds the source for blog.osv.io

blog.osv.io is base on Octopress and deployed on Github Project pages

This means:

blog source are on branch source
blog generated HTML/CSS are under branch gh-pages

Checking out the blog for the first time

Check out the source branch and update dependencies.

git checkout source
bundle install

You only need to do this once.

Update the blog

git clone https://github.com/osv-io/blog.git
cd blog
git checkout source
rake setup_github_pages Repository url: https://github.com/osv-io/blog.git
do the changes, additions (see below)
rake generate # Generates posts and pages into the public directory
rake preview # Watches, and mounts a webserver at http://localhost:4000
rake deploy # upload the generated site to branch gh-pages

In a case you have "Updates were rejected because the tip of your current branch is behind" on the deploy" error on deploy, you can bypass it with the following steps before you generate the site (step 6 above):

cd _deploy
git pull origin gh-pages
cd ..

Update the blog source

The above process only update the gh-pages branch. Once publishing done, remember to commit your source update to the source branch!

With out this, you changes will be lost when someone else update the blog.

Suggest updates without publishing

Fork the blog
Execute steps 1-7 above
Do a Pull Request to the source branch

How to add a new post / update a post?