TitanPages是一个静态博客生成器, 可以配合githubpages轻松的搭建自己的博客。
展示网站请转到: https://qibin0506.github.io/
如何使用
step 1.
下载源码编译源码(linux用户, 可以直接下载tt文件;windows用户可直接下载tt.zip解压使用)
step 2.
创建文件, 在你的工作空间用命令行运行以下命令:
tt -type create -file 你的文件名称
例如: tt -type create -file 我的第一篇博客
step 3.
写作, 打开/raw/你的文件名称文件, 进行文章的书写(注意: 文章的格式必须是markdown的)
step 4.
编译markdown文件,写作完成后, 运行命令:
tt -type build -file 你的文件名称 [-author 作者] [-tmpl 要使用的模板文件]
例如: tt -type build -file 我的第一篇博客 -author 亓斌 -tmpl ./content.html
(注意: []中的参数为可选参数, 具体content.html模板如何书写会在下面介绍)
现在在/html目录下会生成对应文件名的html文件.
step 5.
生成目录, 运行命令:
tt -type cate
运行该命令, 在/html目录中会生成一个category.auto.js的javascript文件.
step 6.
文章模板文件content.html的书写:
-
使用占位符{{.Title}}表示文章的标题
-
使用占位符{{.Date}}表示文章的日期
-
使用占位符{{.Author}}表示文章的作者
-
使用占位符{{.Desc}}表示文章的描述
-
使用占位符{{.Content}}表示文章内容
注意: 关于占位符{{.desc}}的说明: 建议将这个描述放在中,这样,在生成目录的时候才会产生摘要信息.
step 7.
关于自动生成的category.auto.js文件的说明, 这个文件是关于文章索引信息的, 我们需要在目录页调用这个文件里的函数:
-
pageCount() 函数会返回分页页码总数(默认分页大小为5)
-
getQueryString(query) 函数可以获取指定的querystring参数, 通常我们用来获取当前页码
-
get(currentPage) 函数会根据当前页码返回数据数组, 该数组中包含了索引页需要的信息
索引信息数组中包含的信息如下:
-
title 文章的标题
-
date 文章生成的时间
-
desc 文章的简要描述
demo中的例子:
window.onload = function() { var page = getQueryString("page") var count = pageCount() if (page == null) { page = 1 }else { page = parseInt(page) } if(page > 1) { document.getElementById("nav").innerHTML += "← Newer Posts" } document.getElementById("nav").innerHTML += "Page "+page+" of "+count+"" if(page < count) { document.getElementById("nav").innerHTML += "← Older Posts" } if (page <= count) { var result = get(page) for (var i=0;i"+result[i].title+"
" } } } "+result[i].desc+"