chca

CHCA

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

安裝

go get -v github.com/ghaoo/chca/chca

使用

 # 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 // 首页文章行数
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/ghaoo  //github主页
weibo : http://weibo.com/golune  //微博主页
mail : [email protected]  //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資料夾來存放範本文件

模板資料夾結構

• blog 模版資料夾
• -- assets 資源資料夾
• -- -- css
• -- -- js
• -- layout 佈局資料夾
• -- -- main.html 公共佈局
• -- -- index.html 首頁
• -- -- post.html 文章頁
• -- -- archive.html 歸檔導航頁
• -- -- category.html 分類導覽頁
• -- -- tag.html 標籤導覽頁
• -- -- page.html 標籤和分類清單頁面

模板語法參考：template

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，並開啟檔案監聽器

License

etcd is under the Apache 2.0 license. See the LICENSE file for details.