Contents

转载自:
http://geekontheway.github.com/blog/2011/12/03/octopress-for-freshman/
Octopress基于jekyll,刚开始使用起来也比较复杂:
Octopress会有两个分支:source(编写博客)和master(生成好的博客),就像这样:

git remote -v

octopress git://github.com/imathis/octopress.git (fetch)
octopress git://github.com/imathis/octopress.git (push)
origin    git@github.com:geekontheway/geekontheway.github.com.git (fetch)
origin    git@github.com:geekontheway/geekontheway.github.com.git (push)


git branch -a

* source
  remotes/octopress/HEAD -> octopress/master
  remotes/octopress/compass
  remotes/octopress/configuration
  remotes/octopress/edge
  remotes/octopress/generate_environment
  remotes/octopress/gh-pages
  remotes/octopress/master
  remotes/octopress/move_rakefile_configs
  remotes/octopress/post_names
  remotes/octopress/rake_minify_js
  remotes/octopress/refactor_code_highlight
  remotes/octopress/refactor_deployment
  remotes/octopress/refactor_js
  remotes/octopress/site
  remotes/octopress/site-deploy-test
  remotes/octopress/subdir
remotes/octopress/thor

其中只有origin仓库和source分支是必须的,其余分支或仓库建议删掉。

我们来看一下source分支都有什么:

CHANGELOG.markdown  
config.ru   
 _deploy  部署文件夹,在.gitignore中被设置了
.DS_Store 文件夹显示属性,在.gitignore中被设置了
Gemfile.lock  
.gitignore  
plugins  
.pygments-cache   
.rbenv-version Ruby版本有特殊要求 这个文件在.gitignore中被设置了   
.rvmrc   Ruby版本有特殊要求
.sass-cache  
source
config.rb           
_config.yml  
Gemfile  
.git          
.idea   Rubymine设置文件,在.gitignore中被设置了    
public  在.gitignore中被设置了  
Rakefile         
README.markdown  
sass    
.slugignore  
.themes

其中_deploy,source,public这三个文件夹很有趣:

如果你是和别人合作博客,或者自己同时在好几个电脑上写博客,每次开始之前,git pull origin source获得最新的文件,rake generate生成新的页面

我们在source分支做了博客的发布,或者改变了博客的设置之后,rake generate生成网站

rake watch+pow 或者rake review+http://localhost:4000就可以看到我们所做的变化

确认无误后,rake deploy文章就发布到了博客中

当然,不要忘了更新项目 git push origin source

特别的,如果你克隆了博客,记得在git checkout source,然后rake setup_github_pages执行初始化,当然,在那之前也需要bundle install,然后rake generate就生成页面了.

如果是新建的Repo ,记得


$ mkdir yourrepo
$ cd yourrepo
$ git init
# 其实这这时如果你多新建一个index.html文件的话,github会为你生成一个jekyll博客。
$ touch README
$ git add .
$ git commit -m 'first commit'
$ git remote add origin git@github.com:username/yourname.github.com.git
$ git push origin master

对于新手有几个提醒:
1.时常git status,git log避免误操作
2.不要在github上直接编辑文件
3.想清楚了再下手
4.github pages的 username 大小写敏感。如果用户名和username不一致的话,默认会生成这个Repo的project pages。

Contents