使用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为例（大多数情况下需要翻墙）：

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

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

  $vim config.json

  修改comment部分如下：

第四步：重新提交部署站点：
```
  $catsup build && catsup deploy
```

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