# 注册一个美丽的 Github 账号
如果不会,自行百度搜索;搜狗搜索,本处不提供了。
注:本处教程为将 hexo 搭建到 GitHub 中,通过 GitHub pages 提供博客静态托管服务部署。
注:本处教程为将 hexo 搭建到 GitHub 中,通过 GitHub pages 提供博客静态托管服务部署。
注:本处教程为将 hexo 搭建到 GitHub 中,通过 GitHub pages 提供博客静态托管服务部署。
如果有自己的虚拟主机、服务器可以直接将生成的 public 文件夹部署到虚拟主机、服务器进行访问。
# 创建 Github.io 库
在这里创建 Github 库
库名为 <你的Github用户名>.github.io
(固定格式)
Description
处可随意
然后 Create repository 即可
# 安装 & 配置 Git
在此处下载系统对应版本的 Git
Linux 可直接通过包管理器安装
Linux: 在终端内输入
Windows: 打开 Git Bash 输入
git config --global user.name "<Your Github username here>" | |
git config --global user.email "<Your Github email here>" |
# 在 Github 中添加 ssh 密钥
# 创建 SSH 密钥
依旧是 Linux 终端或 Windows Git Bash
ssh-keygen -t rsa -C "<Your Github email here>" |
接着直接回车即可 我们无需设置密码
现在,SSH 密钥就已经存在于你的
Windows C:\Users\<Your user name>\.ssh\id_rsa.pub
Linux ~/.ssh/id_rsa.pub
# 在 Github 中添加
随便找一个文本编辑器打开你的 SSH 密钥文件
在这里点击”New SSH Key”
Title
可随意填写
下方的填写你的 SSH 密钥内容
最后点击 Add SSH Key
即可
# 测试是否正常
ssh git@github.com |
如果出现
Hi <username>! You've successfully authenticated, but Github does not provide shell access | |
Connection to github.com closed. |
说明成功配置 git
# 安装 / 配置 node.js 和 npm
# 安装 node.js
Windows 用户在这里下载 node.js
LTS 为长期支持版 Current 为普通版本
Linux 用户请在包管理器中安装
# 查看 node.js 是否正常安装
node -v | |
npm -v |
# 更改 npm 镜像源
我这里使用淘宝镜像源
你可以通过下面这两条命令更改镜像源
npm config set registry https://registry.npm.taobao.org | |
npm config get registry |
如果返回 https://registry.npm.taobao.org/
代表成功更改镜像源
# 安装 Hexo
创建一个文件夹 在里面打开终端
# 使用 npm 安装 Hexo
npm install -g hexo-cli |
安装完成 初始化博客
hexo init |
# 检查博客是否正常工作
hexo g //生成更改内容 | |
hexo s //运行本地网页服务器 |
如果不出意外 在你的 4000 端口上就已经有了 hexo 博客
你可以去康一下
按 Ctrl+C 停止本地服务器
# 推送 hexo 到 github.io 上
刚刚我们只是在本地运行了博客 其他人现在还无法访问
所以我们现在将博客推送到 github.io 上面供别人访问
# 修改本地博客配置文件
在本地博客中找到 _config.yml
使用文本编辑器打开它
找到 deploy
部分
修改为
deploy: | |
type: git | |
repo: <Your github repo here>.git | |
branch: master |
这里附上我的 deploy
以供参考
deploy: | |
type: git | |
repo: https://github.com/Gasolcloudteam/Gasolcloudteam.github.io.git | |
branch: man |
保存
# 推送博客
在最后的推送之前 我们还需要在 npm 中安装一个小插件
npm install hexo-deployer-git --save |
接着在命令行中输入
hexo clean //清除缓存 | |
hexo g //生成更改 | |
hexo d //推送到服务器 |
至此 你现在已经可以通过 <Your Github name here>.github.io
访问你的博客了
# 更换主题
# 更改主要的主题
应该都看到了 自带的主题非常难看
所以这步我们就要更换主题
在中找到你心仪的主题
一般主题点进去都会有自己主题的使用方式
大部分都是使用 git clone 将的主题下载下来
我这里使用 fluid
做演示
找到主题地址
git clone -b master https://github.com/fluid-dev/hexo-theme-fluid |
然后修改站点配置文件 _config.yml
找到 theme
更改为你下载到的主题名称
我这里改成 fluid
就可以了
不过有些主题需要一些依赖 缺啥补啥即可
# 更改网站基本信息
依旧是熟悉的 _config.yml
在 # Site
下方即可更改网站基本信息
# Site | |
title: 网站标题 | |
subtitle: 标题下方文字 | |
description: 描述 | |
keywords: | |
author: 作者 | |
language: 语言 | |
timezone: 时区 |
这里附上我的 # Site
部分 供参考
# Site | |
title: 枷锁云-星尘blog | |
subtitle: '' | |
description: 错过了满天繁星,可以期待落日余晖。 | |
keywords: | |
author: 星尘 | |
language: zh-CN | |
timezone: Asia/Shanghai |
# 对你的主题进行配置
每个主题都不一样 按照主题自己的 Doc 来肯定没错🤷♂️
# 最后
常用的 hexo 指令
hexo clean //清除hexo缓存 | |
hexo g //重新生成hexo | |
hexo s //运行本地服务器 | |
hexo d //将hexo推送到设置好的服务器上 | |
hexo new "<Your post name here>" //新建博文 | |
hexo new page "<Your page name here>" //新建页面 |
博文在新建后会存到 /<博客根目录>/source/_post中
采用 Markdown
语法格式
我个人建议使用 Typora
进行 Markdown
的编写