Nodejs solo(独唱团)这是一个由Node构建的静态博客

Nodejs solo(独唱团)这是一个由Node构建的静态博客

  • 这个静态博客是用markdown来写文章，通过皮肤模板可以build出html页面。
  • 你可以将他提交至GithubPages或者云端（七牛）或者一个Node服务器。
  • 这里有示例:Pages七牛

为什么会有这样一个静态博客

  • 以前的博客不方便添加自己的demo例子页面(前端开发的童鞋应该会有强烈的认同感)
  • markdown语法简洁易用，所见即所得的html编辑器不好用也太重
  • 不依赖于数据库，所有的内容都是文本，方便管理和迁移
  • 不需要一个什么复杂的服务器，也不需要担心什么配额，可以托管html页面就可以
  • 不用为图片文件等外链来发愁，直接放到相应的目录下，一起上传即可

如何部署

  • 你可以在这里找到他。
  • 如果你熟悉Github Pages,可以直接Push到你的Pages仓库即可。
  • 如果有一个Node服务器，那么你可以部署至你的服务器,启动app.js即可。
  • 如果你有一个云端（七牛）服务，那么你可以上传至你的云端(运行lib/publish.js)。

如何使用

  • 你会发现根目录下md文件夹，这个里面存放的都是博客内容(markdown格式)。
  • md下有article和page两个文件夹，从字面上就很容易理解，分别是文章和页面。
  • md/article下面的文章在build之后会在article目录下生成同文件名的html页面
  • md/page下面的页面在build之后会在根目录下生成同文件名的html页面
  • 运行lib/build.js来build页面(请先安装Node,并安装依赖npm install)

###皮肤模板修改

  • 你会发现根目录下skin文件夹,这个文件夹里面存放的都是皮肤模板(html文件)。
  • 上面提到了article和page两种页面，那么皮肤模板也提供了article.html和page.html两个模板文件。
  • 如果两个页面用到了共同的内容那么你可以把共同的内容提取出来放到skin/slot文件夹下。
  • 在模板文件中${slot}就可以将这个文件引入到当前模板文件中。
  • ${article}这个变量用于引入文章或者页面的内容，即md文件夹下生成的内容。
  • 根目录下你还会发现css、image、javascript文件夹，这些是存放模板使用到的静态文件

###有疑问或者…

  • 如果你有疑问、建议、bug提交或者想说“我艹，这里怎么能这样”都可以找我。
  • 找我请这里新浪微博@金氧,或这里Github[@lambgao](/user/lambgao)

5 回复

Nodejs solo(独唱团) 这是一个由Node构建的静态博客

简介

Nodejs solo 是一个基于Node.js构建的静态博客系统。它允许用户使用Markdown编写文章，并通过皮肤模板生成HTML页面。这种静态博客系统具有轻量级、易于管理的特点。

示例代码

以下是一些关键文件和脚本的简要说明：

  1. 安装依赖

    npm install

  2. 构建博客

    node lib/build.js

    这个脚本会读取 md 目录下的Markdown文件，并根据皮肤模板生成HTML页面。

  3. 部署到GitHub Pages 如果你熟悉GitHub Pages，可以将项目推送到GitHub仓库：

    git push origin gh-pages

  4. 部署到云端（七牛） 你可以运行以下脚本来发布到七牛云存储：

    node lib/publish.js

  5. 启动Node服务器 如果你有一个Node服务器，可以启动应用：

    node app.js

为什么会有这样一个静态博客

  • 方便添加示例页面：对于前端开发者来说，添加示例页面非常方便。
  • Markdown语法简洁：Markdown语法简单易用，比传统的HTML编辑器更轻量。
  • 不依赖数据库：所有内容以文本形式存储，便于管理和迁移。
  • 轻量级服务器需求：无需复杂服务器配置，只需要托管HTML页面即可。
  • 外链管理方便：图片文件等可以直接放到相应目录，统一上传。

如何部署

  • 获取源码

    git clone https://github.com/lambgao/solo.git
cd solo

  • 部署到GitHub Pages

    # 克隆仓库
git clone https://github.com/yourusername/your-repo.git
cd your-repo
# 推送到GitHub Pages
git subtree push --prefix=public origin gh-pages

  • 部署到七牛

    node lib/publish.js

如何使用

  • 博客内容

    • md/article：存放文章的Markdown文件。
    • md/page：存放页面的Markdown文件。

  • 构建过程

    node lib/build.js

    构建后，md/article中的文章会生成对应的HTML文件，存放在article目录下；md/page中的页面会生成对应的HTML文件，存放在根目录下。

皮肤模板修改

  • 皮肤模板文件

    • skin/article.html
    • skin/page.html

  • 公共内容

    • 可以将公共内容提取到skin/slot目录下。
    • 在模板文件中使用${slot}引入公共内容。
    • ${article}变量用于引入Markdown文件转换后的HTML内容。

联系方式

希望这个介绍能帮助你更好地理解和使用Nodejs solo。如果有任何问题或建议，欢迎联系！


先赞一个。&#9786 今天突然也想到了用nodejs去做一个像jekyll一下的静态博客生成程序。

在这搜了一下，找到了你。哈哈。

先star一下，之后去好好看看。

赞~~ 七牛打不开？

正在找markdown写静态博客，还没看到博主的东西，先说说我的相法吧。

  1. 要轻量级，速度要快，要简单，这样才有竞争力，如果做得很重，竞争对手太多，做得也累。
  2. 最好是可以把现有的文章导入到并生成md，这个很容易
  3. 要处理图片和附件问题，最好的办法是可以把图表这些放到dropbox的public文件。也可以将图片放到某个文件夹，自动push到服务器上
  4. 文章索引，包括url最好可以设定规则
  5. 皮肤什么的没有太必要，可以自己改css就行了。
  6. 评论可以用新浪博客的评论功能，要是能集成twitter和腾讯微博就最好了
  7. 简单，再简单，快

关于 “Nodejs solo(独唱团)” 这个静态博客系统的介绍，可以从以下几个方面来回答：

  1. 功能特点：

    • 使用 Markdown 编写文章。
    • 支持多种部署方式，如 GitHub Pages、七牛云存储、Node 服务器。
    • 不依赖数据库，所有内容以文本形式存在，便于管理和迁移。

  2. 部署步骤：

    • 克隆项目源码：git clone https://github.com/lambgao/solo.git
    • 安装依赖：cd solo && npm install
    • 部署到 GitHub Pages：直接推送到对应的 GitHub 仓库。
    • 部署到 Node 服务器：运行 node app.js。
    • 部署到七牛云：运行 node lib/publish.js。

  3. 使用方法：

    • 文章存放在 md/article 文件夹下，页面存放在 md/page 文件夹下。
    • 运行 node lib/build.js 构建页面。

  4. 皮肤模板：

    • 皮肤模板位于 skin 文件夹下，支持 article.html 和 page.html 两种模板文件。
    • 共同使用的部分可以放到 skin/slot 文件夹中，通过 ${slot} 引入。
    • 文章内容可以通过 ${article} 变量引入。

示例代码：构建页面

# 克隆项目
git clone https://github.com/lambgao/solo.git
cd solo

# 安装依赖
npm install

# 构建页面
node lib/build.js

以上步骤可以帮助你快速部署和使用 solo 这个静态博客系统。如果有任何问题或建议，可以通过 Twitter 或 GitHub 联系作者。

回到顶部