CHCA靜態(tài)博客生成器

CHCA

一個使用 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]
    
# 運行chca， 默認(rèn)端口9900
    chca run [port]

chca init

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

# config.yml

# 站點信息
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ù)存放文件夾，暫時未用到

# 作者信息
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  //知乎主頁
 
# 監(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文件需要以 --- 開頭進行說明：

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

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

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

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ā)生改變時，chca則會自動編譯博客

chca http 8800

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

chca run 8800

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