原创

Hexo + Github搭建个人博客

Hexo + Github搭建个人博客

Hexo简介

hexo是一款基于Node.js的静态博客框架,官网地址:https://hexo.io/zh-cn/

安装环境

安装Git

程序猿应该基本都会用git了,我在这里就不详细介绍了。

  • 建立新的Repository,仓库名为【your_user_name.github.io】
  • 后续想要把网站部署到Github上,需要在【your_user_name.github.io】此仓库下的Setting配置中添加一个Deploy keys

Generating a new SSH key可以参考:

安装NodeJS

  • 因为我是Mac笔记本,所以可以使用homebrew安装
  • 也可以下载并安装NodeJS,官网地址:https://nodejs.org/

安装Hexo过程

# 使用npm安装Hexo
$ npm install -g hexo-cli

# 初始化Hexo
$ hexo init

# 复制一个markdown文章到{Hexo}/source/_posts目录下
$ cp /Users/ben/Linux常用命令.md {Hexo}/source/_posts/Linux常用命令.md

# 生成静态页面
$ hexo generate

# 启动本地服务,浏览器访问:http://localhost:4000
$ hexo server

# 配置Hexo的_config.yml
deploy:
     type: git
     repo:https://github.com/birdben/birdben.github.io.git
     branch:master

# 要提交到Github上需要安装hexo-deployer-git插件 
$ npm install hexo-deployer-git --save

# 部署网站到Github上
$ hexo deploy

# 访问博客地址:http://birdben.github.io/
# 大功告成!!

部署步骤

每次部署的步骤,可按以下三步来进行。

  • hexo clean
  • hexo generate
  • hexo deploy

更换主题

# 从Github下载主题
$ git clone https://github.com/A-limon/pacman.git {Hexo}/themes/pacman

# 修改_config.yml中的theme配置
theme : pacman

# 重新生成静态页面
$ hexo generate

# 启动本地服务,浏览器访问:http://localhost:4000
$ hexo server

建站目录

# 初始化网站目录
$ hexo init <folder>
$ cd <folder>
$ npm install

# 执行完npm install命令后,会生成如下的目录结构
.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

_config.yml : 网站的配置信息
package.json : 应用程序的信息。EJS, Stylus 和 Markdown renderer 已默认安装
scaffolds   : 模版文件夹。当新建文章时,Hexo 会根据 scaffold 来建立文件。
source  : 资源文件夹是存放用户资源的地方。除 _posts 文件夹之外,开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。
themes  : 主题 文件夹。Hexo 会根据主题来生成静态页面。

配置

网站的具体配置,请参考官网:https://hexo.io/zh-cn/docs/configuration.html

命令

# init : 新建一个网站。如果没有设置folder,Hexo默认在目前的文件夹建立网站。
$ hexo init [folder]

# new : 新建一篇文章。如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。
$ hexo new [layout] <title>

# generate : 生成静态文件。
参数:
-d, --deploy : 文件生成后立即部署网站
-w, --watch : 监视文件变动
$ hexo generate

# publish : 发表草稿。
$ hexo publish [layout] <filename>

# server : 启动服务器。默认情况下,访问网址为: http://localhost:4000/。
$ hexo server
参数:
-p, --port : 重设端口
-s, --static : 只使用静态文件
-l, --log : 启动日记记录,使用覆盖记录格式

# deploy : 部署网站。
$ hexo deploy
参数:
-g, --generate : 部署之前预先生成静态文件

# render : 渲染文件。
$ hexo render <file1> [file2] ...
参数:
-o, --output : 设置输出路径

# migrate : 从其他博客系统迁移内容。
$ hexo migrate <type>

# clean : 清除缓存文件 (db.json) 和已生成的静态文件 (public)。
$ hexo clean

# list : 列出网站资料。
$ hexo list <type>

# version : 显示 Hexo 版本。
$ hexo version

# 安全模式,在安全模式下,不会载入插件和脚本。当您在安装新插件遭遇问题时,可以尝试以安全模式重新执行。
$ hexo --safe

# 调试模式,在终端中显示调试信息并记录到 debug.log。当您碰到问题时,可以尝试用调试模式重新执行一次,并 提交调试信息到 GitHub。
$ hexo --debug

# 简洁模式,隐藏终端信息。
$ hexo --silent

# 自定义配置文件的路径,执行后将不再使用 _config.yml。
$ hexo --config custom.yml

# 显示草稿,显示 source/_drafts 文件夹中的草稿文章。
$ hexo --draft

# 自定义 CWD,自定义当前工作目录(Current working directory)的路径。
$ hexo --cwd /path/to/cwd

参考文章:

正文到此结束
Loading...