软件简介

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: 378999587@qq.com  //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，并开启文件监听器