typing

简单的半静态博客系统，具有以下特性：

1. 无数据库，通过 Git 管理发布的内容；
2. 无分类，通过标签来归类；
3. 不区分页面和普通文章；
4. 可以实时搜索内容。

安装

1. 下载代码:go get github.com/caixw/typing；
2. 运行程序，使用 appdir 参数指定程序的工作目录；

源码目录下的 testdata 为一个完整的工作目录内容， 用户可根据自己的需求决定是否直接使用此目录，或是在其基础上作修改。

目录结构

appdir 的目录结构是固定的。 其中 conf 为程序的配置相关内容，包含了后台更新界面的密码，不能对外公开； data 为博客的实际内容，包含了文章，标签，友链以及网站名称等相关的配置， 所有针对博客内容的相关设置和内容发布，都直接体现在此目录下。

|--- conf 程序的配置文件
|     |
|     |--- logs.xml 日志的配置文件
|     |
|     |--- app.json 程序的配置文件
|
|--- data 程序的数据目录
      |
      |--- meta 博客的一些设置项
      |     |
      |     |--- config.yaml 基本设置项，比如网站名称等
      |     |
      |     |--- tags.yaml 标签的定义
      |     |
      |     |--- links.yaml 友情链接
      |
      |--- posts 文章所在的目录
      |
      |--- raws 其它可直接通过地址访问的内容可直接放在此处
      |
      |--- themes 自定义的主题目录
            |
            |--- default 默认的主题

conf 目录下内容

conf 目录下的为程序级别的配置文件，在程序加载之后，无法再次更改。其中：

• app.json 定义了诸如端口，证书等基本数据；
• logs.xml 定义了日志的输出形式和保存路径，具体配置可参考 logs 的相关文档。

app.json

data 目录下内容

涉及的时间均为 RFC3339 格式：2006-01-02T15:04:05Z07:00。

config.yaml

config.yaml 指定了网站的一些基本配置情况：

Author

RSS

Sitemap

Opensearch

Icon

links.yaml

links.yaml 用于指定友情链接，为一个数组。每个元素包含以下字段：

tags.yaml

tags.yaml 用于指定所有的标签内容。为一个数组，每个元素包含以下字段：

主题

data/themes 下为主题文件，可定义多个主题，通过 config 中的 theme 指定当前使用的主题。 主题模板语法为 html/template。

单一主题下，可以为文章详细页定义多个模板，通过每篇文章的 meta.yaml 可以自定义当前文章使用的模板， 默认情况下，使用 post 模板。

400 及以上的错误信息，均可以自定义，方式为在当前主题目录下，新建一个与错误代码相对应的 html 文件， 比如 400 错误，会读取 400.html 文件，以此类推。

开发

typing 以自用为主，暂时不支持新功能的 PR。 BUG 可在此处提交或是直接 PR。

版权

本项目采用 MIT 开源授权许可证，完整的授权说明可在 LICENSE 文件中找到。