[toc]

chca是一個使用golang開發的靜態博客生成器，簡單、方便、快捷，拋棄每次都需要使用命令編譯文件，采用文件監聽方式編譯，作者只需把markdown文件放到配置中的markdown文件夾下就能自動生成html了。

chca源碼地址: https://github.com/num5/chca

如果你是個不懂程序的小白，chca更加適合你，只需要修改少量配置就可以搭建一個屬于自己的博客了。最重要的是，如果你沒有自己的服務器，可以將其搭建在github pages上，完全免費的哦。

關于為什么要開博客？可以看看這篇文章《為什么你要寫博客？》

關于如何在github上搭建博客，網上有很多教程，就不在贅述了。

必要步驟

下載chca

Windows：http://golune.qiniudn.com/chca-win64.tar.gz

Linux：http://golune.qiniudn.com/chca-linux64.tar.gz

Mac：http://golune.qiniudn.com/chca-darwin64.tar.gz

下載平臺對應的程序，新建一個文件夾來存放chca所有的文件，并將chca解壓到本文件夾下

如果打算將博客搭建在github上，還需要下載git和申請一個github賬號

go 源碼安裝

go get -v github.com/num5/chca

下載chca模板

下載地址：http://golune.qiniudn.com/default-theme.tar.gz

關于模板語法說明，請參照：chca模板語法說明

使用步驟

chca只需要兩步就可以創建一個帶有獨立web服務器的博客

第一步：初始化

打開命令終端，出入命令：

chca init

這一步會創建 markdown 文件夾和 config.yml 文件，markdown 文件夾用于存放博客的源markdown文件，config.yml是配置文件

config.yml配置內容如下：

# config.yml

# 站點信息
title: 我的網站
subtitle: 網站標題
description: mate-description
keywords: mate-keywords
summary_line: 10 // 首頁文章行數
home_art_num: 30 // 首頁文章數量

# 文件夾相關
theme: theme/blog //網站模板
markdown: markdown //博客markdown文件存放文件夾
html: /data/www/html //博客html文件存放文件夾
storage: storage //數據存放文件夾，暫時未用到

# 作者信息
author: your name
avatar: /assets/avatar.png  //頭像連接，一般放到assets或者avatar文件夾里
github: https://github.com/num5  //github主頁
weibo: http://weibo.com/golune  //微博主頁
mail: 378999587@qq.com  //email 地址
zhihu: https://www.zhihu.com/people/golune  //知乎主頁
 
# 監聽信息配置
paths:  // 監聽文件夾
  - markdown
exts:  // 監聽后綴名
  - md

# 上傳信息
upload_theme: theme/upload  // 上傳模版地址

# 自定義標題，可不配置，使用chca設置好的標題
home_title:     //主頁標題
archive_title:  //文章歸檔標題
tag_title:      //標簽導航頁面標題
cate_title:     //分類導航頁面標題
about_title:    //簡歷頁面標題
article_title:  //文章標題標頭

根據自己需求修改配置文件

初始化以后需要在config.yml文件同目錄下創建theme文件夾用于存放模板文件

第二步：運行chca

chca run [port]

打開chca服務，這一步自動打開監聽器和內置webserver，默認webserver端口9900，端口可自定義，瀏覽器輸入 http://localhost:9900 就能訪問博客了。
監聽器監聽markdown文件夾下的以 .md 為后綴的文件，可配置（參照上一步配置中監聽信息配置）。當markdown文件夾下的md文件有變動時就會觸發編譯命令，自動將自動編譯markdown文件，生成靜態頁面。

其他命令

新建 markdown 文件

chca new filename

markdown文件需要以 --- 開頭進行說明：

---
date: 2017-01-01
title: 我的第一篇博客
categories:
- 技術
tags:
- golang
- chca
---

建議使用 chca new 命令創建markdown文件

about.md文件是存放作者簡歷的文件，存放在markdown文件夾，另外readme.md和about.md不會被文章解析器解析

生成靜態頁面

chca complate (或chca c)

這條命令用于編譯markdown文件生成靜態html頁面

開啟文件監聽器

chca watch (或者chca w)

開啟文件監聽器，監聽文件夾和文件后綴名在config.yml里配置

打開內部服務器

chca http [port]

打開內部服務器，端口可選，默認監聽端口9900

Markdown語法參考鏈接: Markdown 語法說明 (簡體中文版)