基于Node.js的静态博客系统
JavaScript CSS
Pull request Compare This branch is 116 commits ahead, 6 commits behind lamb:gh-pages.
Failed to load latest commit information.
lib
skin
README.md
package.json Merge branch 'develop' into release/2.0.10 Mar 3, 2014
toosolo.js

README.md

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

  • 这个静态博客是用markdown来写文章,通过皮肤模板可以build出html页面。
  • 你可以将他提交至Github Pages等任何网站空间。
  • 提供在线编译功能,可尝试集成github,完成自动编译并推送到pages分支功能
  • 示例:http://solo.toobug.net

2.0 预览版特性

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

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

用法说明

 安装

npm install -g toosolo

初始化

切到用于存放博客文件的目录(最好是空目录),然后执行以下命令进行初始化:

toosolo --init

或者

toosolo -i

初始化后的目录如下:

  • source/blogs目录,用于存放博客文件(.md后缀),可以包含任意子目录。
  • source/pages目录,用于存放pages(.md后续),可以包含任意子目录。
  • source/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 --skin

或者

toosolo -s

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

皮肤目录下的子目录说明

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

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