Skip to content

ellyliang/TooSolo

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.jadepage.jadearticle.jade三个文件。
  • html\include用于存放被包含的公共部分,被包含的模板可以共享模板变量,且缩进必须重新开始计算(即从头开始缩进)
  • 其它目录,直接被复制到站点根目录。

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

About

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

Resources

Stars

Watchers

Forks

Packages

No packages published