使用catsup快速建立个人博客

一.安装

• time: 2016-01-2 20:30

1.使用pip安装catsup：(sudo) pip install catsup
从旧版本升级到新版本：(sudo) pip install catsup —upgrade

2.用git安装catsup：

$git clone git://github.com/whtsky/catsup.git
$cd catsup
# 当前使用git submodule 来管理主题（当前版本是 sealscript,主题可以自由更换 ）
$git submodule init
$git submodule update
$python setup.py install

二.快速建站

1.建立新站点

安装完catsup之后根目录下会出现一个目录 catsup，进入catsup目录

$cd catsup
$mkdir site
$cd site
$catsup init

接着site目录下会自动穿件配置文件 config.json 和一个空白的文章目录posts

2.配置新站点

$ vim config.json 

• insert键进入编辑模式，Mac电脑 i 键进入编辑模式；
• 修改完成esc退出编辑模式，:q! 直接退出 | :wq 保存后退出（具体vim的使用方法可百度）
• site.name : 站点的名字
• site.description : 站点的描述
• site.url : 站点的 URL 。比如 http://example.com
• author.name : 你的名字

3.创建文章

$cd posts
$vim helloworld.md

一个名为 Hello World 文章应该是这样的(格式要严格遵守)

# Hello world(文章标题)
－ time：2016-01-02 20:30
－ tags：hello world

---

文章内容（具体markdown的书写语法参照：http://www.appinn.com/markdown/index.html）

然后，写一个独立页面来介绍你的站点

$vim posts/about.md

一个「关于」页面应该是这样的（严格遵守格式）

# 名字

－ time：2016-01-02 21:00
－type：page

---
具体介绍内容

4.生成站点

$catsup server（预览，打开浏览器http://127.0.0.1:8888 .）
$catsup build（生成站点）

站点生成成功后，site的文件里会多一个 deploy文件

$ls
config.json deploy posts

三.部署站点

1.首先你要有一个Github账号，如果没有请去创建一个（https://github.com），
然后配置ssh,详情参看教程：http://blog.csdn.net/keyboardota/article/details/7603630,（已经有Github并且配置过ssh可忽略这两步）
最后要在Github里面新建一个repository,如下：

2.然后修改本机site目录下的配置文件deploy

$vim config.json

在这之后可以预览站点

$catsup server
然后在浏览器输入 http://127.0.0.1:8888即可预览新站点

最后把站点部署到 GitHub Pages 上

$catsup build && catsup deploy(以后每一次修改配置提交到要执行这步)

3.在浏览器上打开http://your_github_name.github.io 可以看到你的新站点

---

后记

1.修改主题：

• 第一步：可以自己写一个主题或者Github上克隆大神们已经写好的主题；

• 第二步：修改配置文件

    $cd site
    $vim config.json
    然后将theme下的"name"修改为你的主题名称，然后重新提交部署站点
    $catsup build && catsup deploy
  

2.设置评论平台： (多说或者dispus等等)

以dispus为例（大多数情况下需要FQ）：

• 第一步：dispus官网注册一个账号（https://disqus.com/）
• 第二步：点击settings下的Add dispus to site，

• 第三步，回到本地site目录修改配置文件，

    $vim config.json
    修改comment部分如下：
  

  

• 第四步：重新提交部署站点：

    $catsup build && catsup deploy
  

3.还有就是好好充实博客内容啦噜＋＋