[toc]

chca是一個(gè)使用golang開(kāi)發(fā)的靜態(tài)博客生成器，簡(jiǎn)單、方便、快捷，拋棄每次都需要使用命令編譯文件，采用文件監(jiān)聽(tīng)方式編譯，作者只需把markdown文件放到配置中的markdown文件夾下就能自動(dòng)生成html了。

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

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

關(guān)于為什么要開(kāi)博客？可以看看這篇文章《為什么你要寫(xiě)博客？》

關(guān)于如何在github上搭建博客，網(wǎng)上有很多教程，就不在贅述了。

必要步驟

下載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

下載平臺(tái)對(duì)應(yīng)的程序，新建一個(gè)文件夾來(lái)存放chca所有的文件，并將chca解壓到本文件夾下

如果打算將博客搭建在github上，還需要下載git和申請(qǐng)一個(gè)github賬號(hào)

go 源碼安裝

go get -v github.com/num5/chca

下載chca模板

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

關(guān)于模板語(yǔ)法說(shuō)明，請(qǐng)參照：chca模板語(yǔ)法說(shuō)明

使用步驟

chca只需要兩步就可以創(chuàng)建一個(gè)帶有獨(dú)立web服務(wù)器的博客

第一步：初始化

打開(kāi)命令終端，出入命令：

chca init

這一步會(huì)創(chuàng)建 markdown 文件夾和 config.yml 文件，markdown 文件夾用于存放博客的源markdown文件，config.yml是配置文件

config.yml配置內(nèi)容如下：

# config.yml

# 站點(diǎn)信息
title: 我的網(wǎng)站
subtitle: 網(wǎng)站標(biāo)題
description: mate-description
keywords: mate-keywords
summary_line: 10 // 首頁(yè)文章行數(shù)
home_art_num: 30 // 首頁(yè)文章數(shù)量

# 文件夾相關(guān)
theme: theme/blog //網(wǎng)站模板
markdown: markdown //博客markdown文件存放文件夾
html: /data/www/html //博客html文件存放文件夾
storage: storage //數(shù)據(jù)存放文件夾，暫時(shí)未用到

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

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

# 自定義標(biāo)題，可不配置，使用chca設(shè)置好的標(biāo)題
home_title:     //主頁(yè)標(biāo)題
archive_title:  //文章歸檔標(biāo)題
tag_title:      //標(biāo)簽導(dǎo)航頁(yè)面標(biāo)題
cate_title:     //分類導(dǎo)航頁(yè)面標(biāo)題
about_title:    //簡(jiǎn)歷頁(yè)面標(biāo)題
article_title:  //文章標(biāo)題標(biāo)頭

根據(jù)自己需求修改配置文件

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

第二步：運(yùn)行chca

chca run [port]

打開(kāi)chca服務(wù)，這一步自動(dòng)打開(kāi)監(jiān)聽(tīng)器和內(nèi)置webserver，默認(rèn)webserver端口9900，端口可自定義，瀏覽器輸入 http://localhost:9900 就能訪問(wèn)博客了。
監(jiān)聽(tīng)器監(jiān)聽(tīng)markdown文件夾下的以 .md 為后綴的文件，可配置（參照上一步配置中監(jiān)聽(tīng)信息配置）。當(dāng)markdown文件夾下的md文件有變動(dòng)時(shí)就會(huì)觸發(fā)編譯命令，自動(dòng)將自動(dòng)編譯markdown文件，生成靜態(tài)頁(yè)面。

其他命令

新建 markdown 文件

chca new filename

markdown文件需要以 --- 開(kāi)頭進(jìn)行說(shuō)明：

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

建議使用 chca new 命令創(chuàng)建markdown文件

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

生成靜態(tài)頁(yè)面

chca complate (或chca c)

這條命令用于編譯markdown文件生成靜態(tài)html頁(yè)面

開(kāi)啟文件監(jiān)聽(tīng)器

chca watch (或者chca w)

開(kāi)啟文件監(jiān)聽(tīng)器，監(jiān)聽(tīng)文件夾和文件后綴名在config.yml里配置

打開(kāi)內(nèi)部服務(wù)器

chca http [port]

打開(kāi)內(nèi)部服務(wù)器，端口可選，默認(rèn)監(jiān)聽(tīng)端口9900

Markdown語(yǔ)法參考鏈接: Markdown 語(yǔ)法說(shuō)明 (簡(jiǎn)體中文版)