从零开始用Hexo+GithubPage搭建个人网站(保姆级)

写在前面:猫世界-个人博客-GPT4订阅保姆级教程

1. 准备阶段

1.1 了解系统类型

按WIN+R,输入cmd,回车

输入以下内容并按下回车

复制代码
systeminfo

我的电脑就是 x64 系统

1.2 Git下载

点此处下载Git

根据系统类型选择,因此我选 64-bit Git for Windows Setup

注:下载后安装,安装过程除了安装路径外全默认,路径不能有中文

1.3 Git检查

在文件管理任意位置右键(win11-显示更多选项),点击Open Git Bash here

输入

复制代码
git -v

如果出现版本号即配置成功,如果没有,请搜索 Git 环境变量

1.4 NodeJS下载

点此处下载NodeJS

注:下载后安装,安装过程除了安装路径外全默认,路径不能有中文

默认情况下,我们利用 npm 包管理器用来安装依赖包时,包会默认存放在 C:\Users\用户名\AppData\Roaming\npm\node_modules 目录下

这样就存在一个问题,如果我们的依赖包很多的情况下,就会占用我们系统盘大量的空间,这时候我们如果不想让全局包放在这里,那么就可以自定义存放目录。修改的方式也很简单,只需要在控制台中执行如下两条命令即可:

swift 复制代码
npm config set prefix "D:\node\node_global"
swift 复制代码
npm config set cache "D:\node\node_cache"

代码内地址可修改

1.5 NodeJS检查

在刚刚打开的Git Bash或者cmd中,输入

复制代码
node -v
npm -v

如果出现版本号即配置成功,如果没有,请搜索 NodeJS 环境变量

接下来为了加快下载速度,切换镜像,继续输入(淘宝镜像站 2022.06.30 已停用 registry.npm.taobao.org )

arduino 复制代码
npm config set registry https://registry.npmmirror.com

1.6 注册Github账号

点此处前往Github

2. 本地Hexo部署

2.1 安装Hexo

在你的电脑任意位置新建一个文件夹"Hexo",然后右键(win11-显示更多选项),点击Open Git Bash here,依次输入

css 复制代码
npm i hexo-cli -g
csharp 复制代码
hexo init
复制代码
npm install

初始化后,目录结构为

text 复制代码
 .
 ├── _config.yml # 网站配置信息
 ├── package.json # 应用程序信息
 ├── scaffolds # 模板文件夹
 ├── source # 存放用户资源
 |   ├── _drafts
 |   └── _posts #你的博客文档
 └── themes # 主题文件夹

2.2 测试页面

输入以下代码,然后打开浏览器输入 **http://localhost:4000**查看你的博客

bash 复制代码
hexo g # 生成静态页面
hexo s # 打开本地服务器

查看后,输入CTRL+C 关闭本地服务器,继续命令输入

2.3 设置主题(可跳过)

以我使用的Stellar 主题为例,输入

点此处查看主题说明

css 复制代码
npm i hexo-theme-stellar

blog/_config.yml 文件中找到并修改:

makefile 复制代码
theme: stellar

然后输入以下内容查看本地效果

bash 复制代码
hexo clean # 切换主题后需要清理缓存
hexo g # 生成静态文件
hexo s # 打开本地服务器

查看后,输入CTRL+C 关闭本地服务器,继续命令输入

3.发布到GithubPage

3.1 本地SSH密钥

在刚刚的Git Bash中输入以下命令并回车

csharp 复制代码
 # 配置用户名和邮箱,注意填你自己的 Github用户名和邮箱
 git config --global user.name "你的github 用户名"
 git config --global user.email "你的github 注册邮箱"

然后继续输入以下代码,连续键入三次回车(即不设置密码)

bash 复制代码
# 生成 ssh 密钥,注意填你自己的 Github邮箱
 ssh-keygen -t rsa -C "github 注册邮箱"

然后在本地C:\Users\用户\ .ssh目录下,找到 id_rsa.pub (公钥)并以记事本打开并复制内容

注意:.xxx目录为隐藏目录,如果查看不到按以下图片步骤操作

3.2 新建GithubPage

点此处登录Github

登录Github后,新建一个仓库,名称**必须**为以下格式

bash 复制代码
#注意名称别填错了!!!
#例如abc.github.io
你的Github用户名.http://github.io

3.3 配置远程SSH

打开 GitHub-Settings-SSH Keys页面,创建一个新的 SSH key,填写 Title 和 Key,

Title可以随意,而 Key 的内容则是我们刚才复制的 id_rsa.pub 中的内容,最后点击 Add SSH key 即可;

3.4 设置配置文件

在创建的Hexo文件夹下有一个**_config.yml**文件,用记事本打开,在最后几行有如下内容

注意:在配置所有的_config.yml文件时(包括theme中的),在所有的冒号:后边都要加一个空格,否则执行hexo命令会报错。

bash 复制代码
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: ''

将其更改为

yaml 复制代码
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  #这里填入你之前在GitHub上创建仓库的完整路径
  repo: git@github.com:xxx/xxx.github.io.git
  branch: master

3.5 发布

输入以下代码,安装一个依赖包

css 复制代码
npm install hexo-deployer-git --save   

然后输入

bash 复制代码
hexo d -g #生成静态页面,并发布至远程仓库
#等同于下面这两行代码
#hexo g
#hexo d

然后就可以在浏览器输入你的xxx.github.io 查看你的网页了!

4. 发布文章

输入以下代码

arduino 复制代码
hexo n "文章名,中文也行"

然后在Hexo/source/_post 目录下就有你的文章,采用markdown格式

推荐使用Typora,由于最新版需要付费使用,因此请在搜索引擎搜索 Typora破解

文章内容写好后,输入以下代码发布至你的网页

bash 复制代码
hexo d -g #生成静态页面,并发布至远程仓库
#等同于下面这两行代码
#hexo g
#hexo d

如果你需要修改文章或删除文章,请在本地完成后发布到远程仓库即可

5. 图片问题

5.1 较少图片

使用相对路径 保存到Hexo下即可,请使用主题的懒加载 功能加快加载速度,例如,在使用Typora时,点击文件-偏好设置-图像

设置插入图片时复制到指定路径,并勾选下面的所有框

bash 复制代码
../assets/${filename}

这样你的剪贴板的图片和网络粘贴的图片复制到文章时会自动下载到Hexo/source/assets/文章名目录下,随着你的文章一起发布到网页

5.2 较多图片

图片过多会减慢静态网页速度,因此使用图床功能

例如使用Picgo,可以添加好你的图床token(例如SM.MS图床),然后在typora的偏好设置中设置PicGo.exe路径

验证图片上传通过后,将上面的 插入图片时 改为 上传图片 ,这样你的剪贴板的图片和网络粘贴的图片复制到文章时会自动上传到图床

访问网页时相当于在线访问你的图片,可以加快静态网页的访问速度

相关推荐
mldong5 小时前
你的 Vue3 项目也能有钉钉同款审批流设计器:npm 装包,10 分钟画出第一条审批流
前端·vue.js
2分钟速写快排5 小时前
什么是 RAG?如何用 RAG 实现一个用户记忆?
前端·后端·ai编程
passerby60616 小时前
如何自己造一个时间处理库
前端·javascript·github
走到天涯海角7 小时前
react里面的长列表渲染优化
前端·react.js·前端框架
小羊没烦恼!7 小时前
Hello Web API系列教程——Web API与国际化
java·服务器·前端·javascript·php
北岛贰7 小时前
迷茫焦虑期,我做了一个带支付带官网的 AI 聊天虚拟恋人 App
前端·人工智能·后端
mayaairi9 小时前
Vue2 组件通讯(三):全局事件总线、PubSub、插槽与组件实例属性
前端·javascript·vue.js
kyriewen9 小时前
面试官问我:AI 都能写代码了,前端凭什么还值 25K
前端·javascript·人工智能
风骏时光牛马10 小时前
AI源码分析:拆解模型底层实现逻辑
前端
IT_陈寒10 小时前
React子组件莫名其妙重渲染?你可能漏了这个Hook
前端·人工智能·后端