CHCA

一個(gè)使用 golang 開發(fā)的博客生成器。

使用

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

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

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

#?編譯博客
????chca?compile/c
????
#?打開文件監(jiān)聽器
????chca?watch/w

#?打開文件服務(wù)器，?默認(rèn)端口9900
????chca?http?[port]
????
#?運(yùn)行chca，?默認(rèn)端口9900
????chca?run?[port]

chca init

chca init 用于初始化博客，會(huì)自動(dòng)生成config.yml

#?config.yml

#?站點(diǎn)信息
title:?我的網(wǎng)站
subtitle:?網(wǎng)站標(biāo)題
description:?mate-description
keywords:?mate-keywords
summary_line:?10

#?文件夾相關(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??//頭像
github:?https://github.com/num5??//github主頁
weibo:?http://weibo.com/golune??//微博主頁
mail:?378999587@qq.com??//email?地址
zhihu:?https://www.zhihu.com/people/golune??//知乎主頁
?
#?監(jiān)聽信息
paths:??//?監(jiān)聽文件夾
??-?markdown
exts:??//?監(jiān)聽后綴名
??-?md
??-?yml

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

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

模板文件夾結(jié)構(gòu)

• blog 模版文件夾

• -- assets 資源文件夾

• -- -- css

• -- -- js

• -- layout 布局文件夾

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

• -- -- index.html 主頁

• -- -- post.html 文章頁

• -- -- archive.html 導(dǎo)航導(dǎo)航頁

• -- -- category.html 分類導(dǎo)航頁

• -- -- tag.html 標(biāo)簽導(dǎo)航頁

• -- -- page.html 標(biāo)簽、導(dǎo)航和分類列表頁面

chca new filename

新建markdown文件

markdown文件需要以?---?開頭進(jìn)行說明：

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

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

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

chca compile

生成html文件

chca watch/w

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

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

以上配置：監(jiān)聽器監(jiān)聽markdown文件夾下的以.md為后綴的文件，當(dāng)文件夾下的.md文件新增或者發(fā)生改變時(shí)，chca則會(huì)自動(dòng)編譯博客

chca http 8800

打開內(nèi)部服務(wù)器，監(jiān)聽端口8800

chca run 8800

打開內(nèi)部服務(wù)器，監(jiān)聽端口8800，并開啟文件監(jiān)聽器