安装hexo
部署环境
- Node.js
- Git
Node.js 部署,建议版本大于 12.0
Node.js 安装中步骤中需要注意其中两处:
-
Add to PATH 选上,使其集成到系统环境中:
-
此处勾选会安装各种编程环境和软件,这对于安装hexo是不必要的:
Git 部署
所有安装步骤默认即可,若不需要右键菜单,取消如下勾选:
部署hexo
打开gitbash,将目录切换至预备安装hexo的文件夹。
npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo server
如果git安装时勾选了右键菜单,则可以直接在相应文件夹中右键启动gitbash。
至此hexo核心程序完成部署。
Github发布个人博客
-
安装 hexo-deployer-git.
npm install hexo-deployer-git --save
-
在hexo部署文件夹中打开
_config.yml
添加以下配置(如果存在请替换):deploy:type: gitrepo: git@github.com:<username>/<project>.git# example, hgit@github.com:hexojs/hexojs.github.io.gitbranch: main # 此处与github项目分支名相同
可以直接从Github项目主页直接复制需要的repo:
-
hexo文件夹处使用gitbash,执行以下命令(替换自己的用户名和邮箱)生成本地远程连接github项目的密钥:
git config --global user.name "<username>" git config --global user.email "<user@mail>"ssh-keygen -t rsa -C "<user@mail>"
-
部署项目(Github Page)及密钥
-
密钥文件生成后,使用记事本打开并复制id_rsa.pub内容
-
打开github,新建<username> .github.io项目
-
进入项目settings,打开如下页面:
-
-
hexo文件夹中打开gitbash,执行命令
hexo g # 将 _post 文件夹渲染成静态html hexo d # 发布至GitHub
若是第一次执行,按提示输入yes.
-
进入username.github.io查看博客是否部署完成
hexo 相关重要信息
hexo 常用命令
hexo g #完整命令为hexo generate,用于生成静态文件
hexo s #完整命令为hexo server,用于启动服务器,主要用来本地预览
hexo d #完整命令为hexo deploy,用于将本地文件发布到github等git仓库上
hexo n “my article” #完整命令为hexo new,用于新建一篇名为“my article”的文章,文件格式为md
hexo clean #清除已渲染html,将删除publish文件夹hexo d -g #发布文章二合一命令
hexo 常见前置信息
hexo 前置信息(front-matter)是放在文章前面,指定标签,分类,主题等文件变量信息,使用git命令生成文章文件会按命令内容生成前置信息,或者也可以自己编辑,格式如下:
---
layout: 页面布局(配合主题文档使用)
title: 文章名称
date: 文章日期
comments: 文章是否开启评论
photos: 文章封面图(仅部分主题支持)
tags: - 文章标签一- 文章标签二
categories: 文章分类
description: 文章描述,即要在首页显示的摘要(仅部分主题支持)
---
hexo 主题
个人喜欢简洁的主题,目前使用的是next主题。
其他
博主个人部署完毕的hexo博客可见。该博客使用公共图床,图片显示不能保证。
结语:初步部署完毕,之后准备完成前端美化,插件安装等更深入的功能探究。