CHCA

一個使用 golang 開發的博客生成器。

使用

#?chca?command?[args...]

#?初始化博客文件夾
????chca?init

#?新建?markdown?文件
????chca?new?filename

#?編譯博客
????chca?compile/c
????
#?打開文件監聽器
????chca?watch/w

#?打開文件服務器，?默認端口9900
????chca?http?[port]
????
#?運行chca，?默認端口9900
????chca?run?[port]

chca init

chca init 用于初始化博客，會自動生成config.yml

#?config.yml

#?站點信息
title:?我的網站
subtitle:?網站標題
description:?mate-description
keywords:?mate-keywords
summary_line:?10

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

#?作者信息
author:?your?name
avatar:?/assets/avatar.png??//頭像
github:?https://github.com/num5??//github主頁
weibo:?http://weibo.com/golune??//微博主頁
mail:[email protected]??//email?地址
zhihu:?https://www.zhihu.com/people/golune??//知乎主頁
?
#?監聽信息
paths:??//?監聽文件夾
??-?markdown
exts:??//?監聽后綴名
??-?md
??-?yml

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

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

模板文件夾結構

• blog 模版文件夾

• -- assets 資源文件夾

• -- -- css

• -- -- js

• -- layout 布局文件夾

• -- -- main.html 公共布局

• -- -- index.html 主頁

• -- -- post.html 文章頁

• -- -- archive.html 導航導航頁

• -- -- category.html 分類導航頁

• -- -- tag.html 標簽導航頁

• -- -- page.html 標簽、導航和分類列表頁面

chca new filename

新建markdown文件

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

---
date:?2017-01-01
title:?我的博客
categories:
-?技術
tags:
-?golang
---

建議使用chca創建markdown文件

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

chca compile

生成html文件

chca watch/w

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

//?監聽文件夾
paths:
??-?markdown
?
//?監聽后綴名
exts:
??-?md??//?監聽?markdown?文件（以.md為后綴的文件）

以上配置：監聽器監聽markdown文件夾下的以.md為后綴的文件，當文件夾下的.md文件新增或者發生改變時，chca則會自動編譯博客

chca http 8800

打開內部服務器，監聽端口8800

chca run 8800

打開內部服務器，監聽端口8800，并開啟文件監聽器