基于Hexo+GitHub Pages 的个人博客搭建

基于Hexo+GitHub Pages 的个人博客搭建

搭建基于 Hexo 和 GitHub Pages 的个人博客需要一些基本的步骤,下面是详细的步骤:

步骤一:安装 Node.js 和 Git

确保你的电脑上已经安装了 Node.js 和 Git。你可以从官方网站下载并安装它们:

下载:

安装:

步骤二:创建Github Pages 仓库

步骤二:安装 Hexo

Hexo官网:https://hexo.io/zh-cn/index.html

打开终端(或命令行窗口),运行以下命令来安装 Hexo:

bash 复制代码
npm install  hexo-cli -g

步骤三:创建 Hexo 项目

在你选择存储博客文件的目录中,执行以下命令来创建一个新的 Hexo 项目:

bash 复制代码
hexo init blog
cd blog
npm install

步骤四:配置 Hexo

首先安装 hexo-deployer-git:

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

编辑 _config.yml 文件,配置你的博客信息、GitHub Pages 信息和其他相关设置。例如:

yaml 复制代码
#_config.yml
title: 你的博客标题
subtitle: 你的博客副标题
description: 你的博客描述
author: 你的名字
language: en
timezone: Auto

deploy:
  type: 'git'
  repo: https://github.com/<username>/<project>.git
  # example, https://github.com/hexojs/hexojs.git
  #(可复制HTTPS协议或者SSH协议)
  branch: main

或者直接从GitHub项目中复制HTTPS协议或者SSH协议

步骤五:创建新文章

使用以下命令创建新的博客文章:

bash 复制代码
hexo new "My First Post"

这将在 source/_posts 目录下创建一个 Markdown 文件,你可以在其中编写你的博客内容。

步骤六:生成静态文件

在博客根目录下执行以下命令生成静态文件:

bash 复制代码
hexo generate 
简写:hexo g

步骤七:本地预览

运行以下命令启动本地服务器进行预览:

bash 复制代码
hexo server
简写 hexo s

然后在浏览器中打开 http://localhost:4000,查看博客的本地预览效果

步骤八:部署到 GitHub Pages

运行以下命令将生成的静态文件部署到 GitHub Pages:

bash 复制代码
hexo deploy
简写:hexo d

如果出现以下情况,直接授权就行

步骤八:访问你的博客

等待部署完成后,你的博客就可以通过 https://yourusername.github.io 访问了,其中 yourusername 是你的 GitHub 用户名。或者 https://yourusername.github.io/仓库名/

如果出现以下情况:静态资源未加载

解决办法:修改hexo 中 _config.yml文件

原文件的 root:/ 指向的是根目录,在后面添加上仓库名

即修改为 root:/仓库名

保存,重新使用上传到github

bash 复制代码
hexo clean   # 清除缓存文件等
hexo g       # 生成页面
hexo d       # 部署发布

最后访问成功。

步骤九:写作和发布

从现在开始,你可以通过创建新的 Markdown 文件并使用 hexo generatehexo deploy 命令来更新你的博客内容。每次更新后,运行 hexo deploy 将新内容发布到 GitHub Pages 上

Markdown 文件在source/_posts 目录下

也可以不使用命令自己创建 .md 文件,只需在文件开头手动加入如下格式 Front-matter 即可,写完后运行 hexo g 和 hexo d 发布。

bash 复制代码
---
title: Hello World # 标题
date: 2023/12/24 hh:mm:ss # 时间
categories: # 分类
- Diary
tags: # 标签
- 笔记
- win
---

摘要
<!--more-->
正文

常用命令

bash 复制代码
hexo new "name"       # 新建文章
hexo new page "name"  # 新建页面
hexo g                # 生成页面
hexo d                # 部署
hexo g -d             # 生成页面并部署
hexo s                # 本地预览
hexo clean            # 清除缓存和已生成的静态文件
hexo help             # 帮助

更换主题(扩展)

步骤一:选择 Hexo 主题

在 Hexo 官方网站或 GitHub 上,有许多免费和开源的 Hexo 主题可供选择。选择一个你喜欢的主题并记住它的名称。

主题下载:https://hexo.io/themes/

点击喜欢的主题

步骤二:安装主题

两种方法一种克隆下载,一种直接下载压缩包

在博客根目录下执行以下命令,安装你选择的主题:
theme-name 你的主题名

bash 复制代码
git clone https://github.com/yourfavorite/theme-name.git themes/theme-name

步骤三:配置主题

编辑 _config.yml 文件,将主题设置为你选择的主题:

yaml 复制代码
# _config.yml
theme: theme-name

步骤四:重新生成和部署

重新生成静态文件并部署到 GitHub Pages:

bash 复制代码
hexo g
hexo d

现在,你的博客应该使用新的主题了。根据主题的文档,你可能需要进一步的配置来自定义博客的外观和功能。

相关推荐
TDengine (老段)18 分钟前
TDengine 时间函数 TODAY() 用户手册
大数据·数据库·物联网·oracle·时序数据库·tdengine·涛思数据
悟乙己1 小时前
数据科学家如何更好地展示自己的能力
大数据·数据库·数据科学家
东哥说-MES|从入门到精通1 小时前
Mazak MTF 2025制造未来参观总结
大数据·网络·人工智能·制造·智能制造·数字化
盟接之桥2 小时前
盟接之桥说制造:在安全、确定与及时之间,构建品质、交期与反应速度的动态平衡
大数据·运维·安全·汽车·制造·devops
金融数据出海2 小时前
黄金金融期货数据API对接技术文档
开发语言·金融·github
链上日记2 小时前
STC携手VEX发起全球首个碳资产RWA生态,泰国峰会即将引爆绿色金融
大数据
用户Taobaoapi20143 小时前
京东商品列表API(JD.item_search)
大数据·数据挖掘·数据分析
hfd19903 小时前
GitHub 宕机自救指南:保障开发工作连续性
github
用户Taobaoapi20143 小时前
京东商品评论API开发指南
大数据·数据挖掘·数据分析
微三云-轩3 小时前
小程序:12亿用户的入口,企业数字化的先锋军
大数据·小程序·开源软件