Home

How to Blog with Tappsi

• Clone the repository

    git@github.com:tappsi/tappsi.github.io.git

• Your git config:

[core]
	repositoryformatversion = 0
	filemode = true
	bare = false
	logallrefupdates = true
[remote "octopress"]
	url = git://github.com/imathis/octopress.git
	fetch = +refs/heads/*:refs/remotes/octopress/*
[branch "source"]
	remote = origin
	merge = refs/heads/master
[remote "origin"]
	url = git@github.com:tappsi/tappsi.github.io.git
	fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
	remote = octopress
	merge = refs/heads/master

• Switch to source branch.

• Install libs

    gem install bundle
    bundler install

• Create deployment directory:

    mkdir _deploy

• Set up Octopress site to publish to your projects gh-pages repository

$ rake setup_github_pages
Enter the read/write url for your repository
(For example, 'git@github.com:your_username/your_username.github.io.git)
           or 'https://github.com/your_username/your_username.github.io')
Repository url: https://github.com/tappsi/tappsi.github.io

• Create a new post

    rake new_post["title"]

• Generate & Preview

    rake generate   # Generates posts and pages into the public directory
    rake watch      # Watches source/ and sass/ for changes and regenerates
    rake preview    # Watches, and mounts a webserver at http://localhost:4000

• Deploy

    rake deploy

• Don't forget to commit the source for your blog

    git add .
    git commit -m 'your message'
    git push origin source

Possible error messages:

• Rejected: pushing error to GitHub

$ rake deploy
............
 ! [rejected]        master -> master (non-fast-forward)
error: failed to push some refs to 'https://github.com/tappsi/tappsi.github.io'
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. Integrate the remote changes (e.g.
hint: 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

Solution: http://stackoverflow.com/a/21371914/914332

Octopress Plugins - Usage & Examples

Insert image:

    {% img [class names] /path/to/image [width] [height] [title text [alt text]] %}

Blockquote:

    {% blockquote [author[, source]] [link] [source_link_title] %}
    Quote string
    {% endblockquote %}