ellyliang / toosolo

基于Node.js的静态博客系统

solo 是一个由Node构建的静态博客

• 这个静态博客是用markdown来写文章，通过皮肤模板可以build出html页面。
• 你可以将他提交至Github Pages等任何网站空间。
• 示例:http://solo.toobug.net

2.0 预览版特性

• 程序、源文件、构建结果完全分离，托管时只需要上传构建结果即可
• 全插件构架，可以任意扩展你需要的功能（标签、分类、RSS等等）

目前版本只供预览，尚有未开发完或者不稳定的部分。

用法说明

###　安装

npm install -g toosolo

准备源文件目录

请准备一个目录作为博客源文件，里面包含博客、pages、公用的文件等等，具体包含内容如下：

• blogs目录，用于存放博客文件（.md后缀），可以包含任意子目录。
• pages目录，用于存放pages（.md后续），可以包含任意子目录。
• global目录，用于存放其它放到站点根目录的文件，如robots.txt等。可包含子目录（比如文章中的图片放在images子目录，构建时会被复制为/images）。

准备config.json

{

	"blogName" : "SOLO",
	"blogSubTitle" : "Life is Solo...",
	"blogKeywords" : "SOLO,Blog,Node,博客",
	"blogDescription" : "TooBug - 专注前端开发",

	"domain" : "solo.toobug.net",

	"sourcePath" : "./source",
	"distPath" : "./dist"

}

其中domain不需要加http://和最后的/，sourcePath是上面准备的源文件的路径，distPath是构建结果的路径。所有路径相对于config.json。

编译

进入命令行，定位到config.json所在的目录，运行toosolo即可。

更多

以下部分尚属于不稳定阶段，稍后放出皮肤自定义的功能。

如果有需要可以自定义皮肤，运行如下命令将默认皮肤复制至source目录的skin子目录中

toosolo defineSkin

同时，config.json中会自动添加一个名为skinPath的配置指向皮肤目录。

皮肤目录下的子目录说明

• html目录，模板文件，使用jade模板引擎，目前包含index.jade，page.jade，article.jade三个文件。
• html\include用于存放被包含的公共部分，被包含的模板可以共享模板变量，且缩进必须重新开始计算（即从头开始缩进）
• 其它目录，直接被复制到站点根目录。

编写模板时请注意使用模板变量basePath来处理路径，目前该变量是按照index.html在根目录，文章和pages分别在/article和/page目录的规则输出。