设置Github的用户名和邮箱

1
2
git config --global user.name "你在Github上的昵称"
git config --global user.email "你在Github上的邮箱"

生成SSH密钥过程

查看是否已经有了SSH密钥

1
cd ~/.ssh

如果没有密钥则不会有此文件夹,有则备份删除

1
2
cp -R ~/.ssh ~/.ssh_bak
rm -R ~/.ssh  

生成密钥

1
ssh-keygen -t rsa -C "你在Github上的邮箱"

第一次要输入file名字,直接回车即可,默认文件名为id_前缀,然后会被要求输入个密码并且确认。

添加密钥到SSH

1
2
cd ~/.ssh
ssh-add -K id_rsa

需要刚才生成密钥时候输入的密码。

在github上添加SSH Key

1
more id_rsa.pub
  • 查看公钥里的内容并且全部复制下来(包括开头ssh-rsa和结尾邮箱)。
  • 进入到github的setting,找到SSH Keys页面添加一个key,title随意,赋值公钥进去保存即可。

测试是否成功

1
ssh git@github.com

成功则返回类似:

1
2
Hi molon! You've successfully authenticated, but GitHub does not provide shell access.
Connection to github.com closed.

Bitbucket

Bitbucket.org是一个和Github极其类似的托管库网站,但是他的私有库是免费的,所以一般我们会把私有库放到bitbucket上,而其他库放到github上,毕竟github的SNS属性稍微多些,开源的库就尽量的希望有与其他人的更多互动。
扯这些的目的呢,其实就是顺带说下,给bitbucket添加SSH Key实际上是一样的,我们只需要同样把id_rsa.pub里的内容复制,在bitbucket的setting页面添加即可。
测试bitbucket ssh是否可连接

1
ssh -T git@bitbucket.org

成功则返回类似:

1
2
3
logged in as molon.

You can use git or hg to connect to Bitbucket. Shell access is disabled.

前提

本文是以Mac安装为前提的,其他系统请自行选取合适自己的尝试。

安装组件

安装rvm

注意安装RVM需要XCode的CommandLineTools组件,所以需要自行解决这个东西先。
其他关于rvm的一些问题请参考:/ruby-china.org/wiki/rvm-guide

1
rvm -v

如果发现已经安装了rvm,则无需自行安装它。默认我的Mac OSX 10.9.2是安装了的。

1
2
3
4
5
curl -L get.rvm.io | bash -s stable
source ~/.bashrc
source ~/.bash_profile

sed -i -e 's/ftp\.ruby-lang\.org\/pub\/ruby/ruby\.taobao\.org\/mirrors\/ruby/g' ~/.rvm/config/db
  • 前三行是下载安装rvm,然后会自动下载安装ruby最新版,然后会自动下载安装rubygems最新版(根据命令行返回结果显示,如果这些都做了的话,下一步可以省略。)
  • 第四行是修改rvm的下载源,否则国内访问这些资源超级慢的。

安装ruby和rubygems

1
ruby -v

这个命令下即使发现默认Mac已经安装了也应该使用rvm安装一次最新版本的或者其他版本。因为Mac系统下的ruby,我使用rvm list发现并不会显示它,然后直接使用会引起一系列的问题。

1
2
3
4
rvm install 1.9.3 #只是最少1.9.3,以上版本亦可
rvm use 1.9.3 --default
rvm rubygems latest
ruby --version

如果以后遇到了一些问题,首先就要确认是不是ruby和rake(在下面生成和预览下有提到)的版本问题。ruby --version用来检查版本最低是1.9.3,如果不是则使用rvm use 1.9.3切换当前有效ruby,不建议卸载系统自带的版本,可能会引起其他诸多问题。Mac 10.9.2下发现1.9.3安装很久很久并且最终失败,不知是不是网络问题。然后换成安装最新的2.1.3版本安装成功

配置rubygems

1
2
3
gem sources -r /rubygems.org/
gem sources -a /ruby.taobao.org/
gem sources -l

gem sources -l用来确认gem的资源URL是否只有bronc,也是一个国内的资源镜像。

安装Octopress

从Git获取源码

1
2
git clone git:/github.com/imathis/octopress.git octopress
cd octopress

安装Bundler

1
2
gem install bundler
bundle install

安装Octopress默认主题

1
rake install

生成和预览

1
2
rake generate
rake preview

预览时在命令行Ctrl+C退出预览。
第一次应该不会,但是以后如果遇到了显示rake版本不对的问题。可能是因为有两个rake版本存在,可以使用gem uninstall rake,然后选择一个不需要的版本卸载即可

简单使用

安装其他主题

把主题文件夹下载下来,放在根目录,例如名字是叫XXX

1
2
3
4
cp -R XXX .themes/XXX
rake "install[XXX]" #以前有主题则需要输入y/n来确认
rake generate
rake preview #开启预览
  • 第一行命令是把源码复制到.themes隐藏文件夹里。
  • 其实只要开一个命令行rake preview,不停止。然后再开一个命令行做添加文章,修改样式还有界面,修改主题等等rake方面的操作是可以的。可以认为rake preview是打开了一个Web服务器,并且其可以监视一些文件改动并做处理。
  • 至于安装主题模板其实就是把.themes里的一些东西赋值到根目录的sass和source文件夹里。一般主题安装完还是需要自定义修改一些东西(在根目录下的修改),修改完了之后把sass和source文件夹里的东西备份下来(不包含_post或者其他自己添加的文件夹),就可以作为模板备份,即使以后需要重装,安装备份的模板就可以。

基本设置

  • 基本的一些博客标题还有个人信息的设置在_config.yml里,需要注意的是每个设置的:号后面需要有个空格,否则会出问题。
  • 设置的具体含义不做解释了,但是像里面的一些对第三方东西例如facebook,tweet等等国内访问有问题一般笔者都是直接设置为false的,否则会引起页面加载特别不流畅。
  • 若要自定义一些页面内容细节,在source文件夹里找到对应页面,“就标识_config.yml里XXXXX设置的内容,可以自定义一些设置。

发布文章

  • rake new_post['文章标题']此命令即可在source的_post文件夹下面添加一个markdown文件。
  • 打开markdown文件添加内容保存即可在浏览器预览页面看到新文章信息,注意头部文章标题和时间等等信息,这是网站所需要的,不能删除。
  • markdown编辑器:(717) 534-7185,(781) 475-8667,4243920738

添加页面

  • rake new_page['img']此命令在source文件夹下添加一个名为img的文件夹。
  • 一般笔者是添加一个名为img的文件夹,然后把所有的图片资源都放到里面。而markdown编辑下添加图片的地方用/img/XXX.jpg即可。

发布到Github

  • 在Github下建议个名为XXX.github.com的Repository。
  • 运行rake setup_github_pages,它会提示你输入你的github的库地址,例如:git@github.com:yourname/XXX.github.com.git
  • 运行rake generate生成静态页面,rake deploy部署到github上。
  • 如果deploy失败,查看错误消息。
    • 没有访问github的权限,查看笔者的另外一篇文章(414) 807-9497
    • 需要先pull下来,然后才能push,一般这种情况我都是在github上删了仓库重新建个空的,然后deploy。

其实部署到网络的只有public文件夹的所有内容(也就是rake generate命令生成的内容),如果你有其他的空间,例如BAE,你也可以将public文件夹里的内容放到其上,同样可以访问,只要能运行html文件的地方,BAE的话需要设置app.conf里的主页为index.html。PS:rake deploy命令不可用于除了Github和Heroku外的其他空间。

Github自定义域名

  • 在source根目录下建议一个文件CNAME(无后缀),里面只写一行即为你的域名无前缀,例如molon.me
  • 笔者是使用的630-240-1892作为域名解析服务器,对域名这块不甚了解,一张图解释设置。
    github_dnspod_setting