Github Pages + Octopress


photo-credit: IconAarchive







GitHub Pages

GitHub Pagesを開く場合の注意点

1. メールアドレスの認証(verify)を事前に済ませておく必要がある。

2. ページの構築に、10分ほど時間がかかる可能性がある。

GitHub Pages

1. GitHubリポジトリを作成。 リポジトリ名は 「」です。


$ git clone

$ cd

$ echo "Hello World" > index.html

$ git add --all

$ git commit -m "Initial commit"

$ git push

2. ページにアクセスしてみます。


Octopress Setup

$ git clone

$ cd $!:t

$ gem install bundler

$ rbenv rehash    # If you use rbenv, rehash to be able to run the bundle command

$ bundle install

$ rake setup_github_pages

Octopress 初期設定


$ vim _config.yml

url:                # For rewriting urls for RSS, etc
title:              # Used in the header and title tags
subtitle:           # A description used in the header
author:             # Your name, for RSS, Copyright, Metadata
simple_search:      # Search engine for simple site search
description:        # A default meta description for your site
date_format:        # Format dates using Ruby's date strftime syntax
subscribe_rss:      # Url for your blog's feed, defauts to /atom.xml
subscribe_email:    # Url to subscribe by email (service required)
category_feeds:     # Enable per category RSS feeds (defaults to false in 2.1)
email:              # Email address for the RSS feed if you want it.

Jekyll & Plugins

root:               # Mapping for relative urls (default: /)
permalink:          # Permalink structure for blog posts
source:             # Directory for site source files
destination:        # Directory for generated site files
plugins:            # Directory for Jekyll plugins
code_dir:           # Directory for code snippets (for include_code plugin)
category_dir:       # Directory for generated blog category pages

pygments:           # Toggle python pygments syntax highlighting
paginate:           # Posts per page on the blog index
pagination_dir:     # Directory base for pagination URLs eg. /blog/page/2/
recent_posts:       # Number of recent posts to appear in the sidebar

default_asides:     # Configure what shows up in the sidebar and in what order
blog_index_asides:  # Optional sidebar config for blog index page
post_asides:        # Optional sidebar config for post layout
page_asides:        # Optional sidebar config for page layout

Octopress 記事作成

$ rake new_post\[title\]

$ vim source/_post/*.markdown

$ rake generate

$ rake preview

$ w3m http://localhost:4000/

Octopress テーマ変更


$ cd octopress

$ git submodule add .themes/foxslide

$ git submodule update --init

$ rake 'install[foxslide]'

$ rake generate

$ rake deploy

GitHub 記事投稿

$ rake gen_deploy

$ git add .

$ git commit -m 'your message'

$ git push origin source


1. メールアドレスの認証(verify)を事前に済ませておく必要がある。

2. ページの構築に、10分ほど時間がかかる可能性がある。