文章目录
- 如何使用Hexo搭建个人博客
- 环境搭建
- 连接 Github
- 创建 Github Pages 仓库
- 本地安装 Hexo 博客程序
- 安装 Hexo
- Hexo 初始化和本地预览
- 部署 Hexo 到 GitHub Pages
- 开始使用
- 发布文章
- 网站设置
- 更换主题
- 常用命令
- 插件安装
- 解决成功上传github但是web不更新
- 不想上传文章处理方式
- 链接
如何使用Hexo搭建个人博客
环境搭建
Hexo 基于 Node.js,搭建过程中还需要使用 npm(Node.js 已带) 和 git,因此先搭建本地操作环境,安装 Node.js 和 Git。
- Node.js:https://nodejs.org/zh-cn
- Git:https://git-scm.com/downloads
下载 Node.js 和 Git 程序并安装,一路点 “下一步” 按默认配置完成安装。
安装完成后,Win+R 输入 cmd 并打开,依次输入 node -v
、npm -v
和 git --version
并回车,如下图出现程序版本号即可。
连接 Github
使用邮箱注册 GitHub 账户,选择免费账户(Free),并完成邮件验证。
右键 -> Git Bash Here,设置用户名和邮箱:
git config --global user.name "GitHub 用户名"
git config --global user.email "GitHub 邮箱"
创建 SSH 密匙:
输入 ssh-keygen -t rsa -C "GitHub 邮箱"
,然后一路回车。
添加密匙:
进入 [C:\Users\用户名.ssh] 目录(要勾选显示“隐藏的项目”),用记事本打开公钥 id_rsa.pub 文件并复制里面的内容。
登陆 GitHub ,进入 Settings 页面,选择左边栏的 SSH and GPG keys,点击 New SSH key。
Title 随便取个名字,粘贴复制的 id_rsa.pub 内容到 Key 中,点击 Add SSH key 完成添加。
验证连接:
打开 Git Bash,输入 ssh -T git@github.com
出现 “Are you sure……”,输入 yes 回车确认。
显示 “Hi xxx! You’ve successfully……” 即连接成功。
创建 Github Pages 仓库
GitHub 主页右上角加号 -> New repository:
- Repository name 中输入
用户名.github.io
- 勾选 “Initialize this repository with a README”
- Description 选填
创建后默认自动启用 HTTPS,博客地址为:https://用户名.github.io
本地安装 Hexo 博客程序
- 新建一个文件夹用来存放 Hexo 的程序文件,如 Hexo-Blog。打开该文件夹
- 右键 -> Git Bash Here。
安装 Hexo
使用 npm 一键安装 Hexo 博客程序:
npm install hexo-cli -g
Mac 用户需要管理员权限(sudo),运行这条命令:
sudo npm install hexo-cli -g
安装时间有点久(真的很慢!),界面也没任何反应,耐心等待,安装完成后如下图。
Hexo 初始化和本地预览
初始化并安装所需组件:
hexo init blog # 初始化
cd blog
npm install # 安装组件
完成后依次输入下面命令,启动本地服务器进行预览:
hexo g # 生成页面
hexo s # 启动预览
访问 http://localhost:4000
,出现 Hexo 默认页面,本地博客安装成功!
**Tips:**如果出现页面加载不出来,可能是端口被占用了。Ctrl+C 关闭服务器,运行 hexo server -p 5000
更改端口号后重试。
Hexo 博客文件夹目录结构如下:
部署 Hexo 到 GitHub Pages
本地博客测试成功后,就是上传到 GitHub 进行部署,使其能够在网络上访问。
首先安装 hexo-deployer-git:
npm install hexo-deployer-git --save
然后修改 _config.yml 文件末尾的 Deployment 部分,修改成如下:
deploy:type: gitrepository: git@github.com:用户名/用户名.github.io.gitbranch: master
完成后运行 hexo d
将网站上传部署到 GitHub Pages。
完成!这时访问我们的 GitHub 域名 https://用户名.github.io
就可以看到 Hexo 网站了。
开始使用
发布文章
进入博客所在目录,右键打开 Git Bash Here,创建博文:
hexo new "My New Post"
然后 source 文件夹中会出现一个 My New Post.md 文件,就可以使用 Markdown 编辑器在该文件中撰写文章了。
写完后运行下面代码将文章渲染并部署到 GitHub Pages 上完成发布。以后每次发布文章都是这两条命令。
hexo g # 生成页面
hexo d # 部署发布
也可以不使用命令自己创建 .md 文件,只需在文件开头手动加入如下格式 Front-matter 即可,写完后运行 hexo g
和 hexo d
发布。
---
title: Hello World # 标题
date: 2019/3/26 hh:mm:ss # 时间
categories: # 分类
- Diary
tags: # 标签
- PS3
- Games
---摘要
<!--more-->
正文
网站设置
包括网站名称、描述、作者、链接样式等,全部在网站目录下的 _config.yml 文件中,参考官方文档按需要编辑。
注意:冒号后要加一个空格!
更换主题
在Themes | Hexo选择一个喜欢的主题,比如 Ayer中文说明 | 岛 (gitee.io),进入网站目录打开 Git Bash Here 下载主题:
git clone https://github.com/Shen-Yu/hexo-theme-ayer.git themes/ayergit clone https://github.com/next-theme/hexo-theme-next themes/next
然后修改 _config.yml 中的 theme 为新主题名称 next,发布。(有的主题需要将 _config.yml 替换为主题自带的,参考主题说明。)
修改blog下的_config.ymltheme: landscape -> theme: ayer
常用命令
hexo new "name" # 新建文章
hexo new page "name" # 新建页面
hexo g # 生成页面
hexo d # 部署
hexo g -d # 生成页面并部署
hexo s # 本地预览
hexo clean # 清除缓存和已生成的静态文件
hexo help # 帮助
插件安装
- 搜索插件
npm install hexo-generator-searchdb --save
解决成功上传github但是web不更新
修改 github 设置
不想上传文章处理方式
直接在文件命名前面加一个 “_” 下划线即可
链接
-
Hexo 官网链接:文档 | Hexo
-
热门主题:Ayer中文说明 | 岛 (gitee.io)
-
Web开发技术 > CSS:层叠样式表