使用CHCA搭建靜態博客

[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 語法說明 (簡體中文版)