karllhughes/personal-blog

个人博客系统 v4

这是托管于karllhughes.com的个人博客应用。因WordPress对简单需求而言过于繁琐，故开发此NodeJS应用作为替代。您可自由使用（需注明出处）或从中学习。

注：本网站旧版本维护于https://github.com/karllhughes/KH-Blog%E3%80%82

应用概述

核心功能

• 支持博客文章及分类、标签归档页面
• 简洁的响应式设计

技术栈

• https://nodejs.org/en/
• http://expressjs.com/en/resources/frameworks.html
• https://github.com/louischatriot/nedb
• https://github.com/scottwrobinson/camo
• Handlebars模板引擎
• https://github.com/chjj/marked
• https://github.com/dylang/node-rss
• https://webpack.github.io/
• https://milligram.github.io/
• Simple Line Icons图标库
• https://docs.docker.com/compose/

项目结构

• app/：NodeJS应用所需的控制器、路由、中间件、数据库连接等核心代码目录
• assets/：未构建的前端文件/脚本
• bin/www：应用启动文件（无需频繁修改）
• database/*：数据库内容存储目录（版本控制忽略）
• public/*：已构建的前端文件/脚本
• views/*：Handlebars视图模板
• app.js：Express应用入口文件
• entry.js：Webpack入口脚本

Docker部署配置

前提条件

• Docker已安装并运行
• Node v6+及NPM v4+已安装

开发环境部署

1. 运行npm run app:local:build构建Docker镜像
2. 运行npm run app:local:up启动应用
3. 访问localhost:43000，应用会监听Node及前端文件的变更

生产环境部署

1. 运行npm run app:prod:build构建生产环境Docker镜像
2. 运行npm run app:prod:up启动生产环境应用
3. 应用通过服务器地址的80端口提供服务

更新生产环境代码

SSH登录服务器后运行npm run -s app:prod:update；若配置了SSH密钥，可简化为单命令：

bash
npm run app:prod:deploy

数据导入

从服务器导入初始数据：

bash
scp -r <USER>@<IP>:/.data ./.data

许可证

Copyright 2017, Karl Hughes

本软件基于Apache License 2.0许可协议发布。您需遵守协议条款方可使用：

您可在http://www.apache.org/licenses/LICENSE-2.0%E8%8E%B7%E5%8F%96%E5%8D%8F%E8%AE%AE%E5%89%AF%E6%9C%AC%E3%80%82

除非另有书面约定或***规定，软件按"原样"分发，不提供任何明示或暗示的担保。协议条款将规范您对软件的使用权限及限制。