本地搭建个人博客

木易
原创
发布时间: 2025-06-11 10:04:18 | 阅读数 0收藏数 0评论数 0
封面
Hexo 是一个快速、简单且功能强大的博客框架。你用Markdown(或其他标记语言)写帖子,Hexo 会在几秒钟内生成带有漂亮主题的静态文件。
1

准备工作

在开始之前,确保已经准备好了:

  1. GitHub账号,可以直接去官网注册:GitHub
  2. 安装Git、Node.js环境
2

安装Hexo

win+r:输入cmd,打开命令窗口

cd Desktop // 进入桌面
mkdir Project //创建project文件夹
mkdir HexoBlog&&cd HexoBlog //创建HexoBlog并进入

安装Hexo

npm install -g hexo-cli
3

初始化HexoBlog

前面已经准备好了所有相关环境,接下来我们就正式来初始化一个Hexo博客吧~初始化的命令格式为hexo init <项目名称>

hexo init blog
  1. config.landscape.yml:主题配置文件,如果
  2. config.yml:站点配置文件,对站点进行配置。
  3. node_modules:用来存储已安装的各类依赖包。
  4. package-lock.json:包版本依赖锁文件。
  5. package.json:应用数据,Hexo的版本以及相关依赖包的版本等。
  6. scaffolds:博客模版文件夹,包含page.mdpost.mddraft.md三种。
  7. source:资源文件夹,存放静态资源如博客md文件、图片等。
  8. themes:主题文件夹,Hexo通过将网站内容与主题组合来生成静态网站。

4

本地预览Blog


cd blog //进入目录
hexo s // 启动项目

首先需要进入新建项目目录下,执行hexo s即可启动项目,访问http://localhost:4000即可查看

5

Hexo基本命令

hexo s // 本地启动项目 s表示server
// 创建新的博客 n表示new
hexo n [layout] <title>
// 示例
hexo new "我的第一篇博客 Hexo Hello!"

-p, --path

文章的路径。 自定义文章的路径。

-r, --replace

如果存在的话,替换当前的文章。

-s, --slug

文章别名。 自定义文章的 URL。

6

Hexo基本配置介绍修改

  1. 打开项目文件夹,找到名为 config.yml 的配置文件。这通常位于项目的根目录或特定的配置文件夹中。
  2. 使用文本编辑器打开 config.yml 文件。确保使用的是能够正确解析 YAML 格式的编辑器,以避免格式错误。
  3. 在文件中查找注释 #Site 或类似标识,它应该标记了站点设置部分的开始。
  4. 您将看到一系列键值对,它们定义了站点的不同属性。根据您的需求修改以下内容:
  5. 首页标题 (通常是 title): 修改为站点的主标题。
  6. 子标题 (可能标记为 subtitle, tagline 或其他类似的名称): 修改为描述性的副标题。
  7. 简介 (可能标记为 description): 修改为简短的网站介绍。
  8. 关键词 (可能标记为 keywords): 用英文逗号分隔的一系列关键词,有助于SEO。
  9. 作者 (可能是 author): 修改为您或网站所有者的名称。
  10. 语言 (通常是 language): 修改为站点的主要语言代码(例如 en 表示英语, zh 表示中文)。
  11. 时区 (可能是 timezone): 修改为站点所在的时区(例如 Asia/ShanghaiAmerica/New_York)。
7

将Hexo部署到GitHub

步骤 1: 创建 GitHub Pages 仓库

  1. 登录到你的GitHub账户。
  2. 点击“New repository”来创建一个新的仓库。
  3. 输入仓库名称为用户名.github.io(请将“用户名”替换为你自己的GitHub用户名)。
  4. 完成创建后,你会看到页面提供了HTTPS和SSH两种方式的URL,请选择SSH并复制URL。

步骤 2: 配置 Hexo 博客

  1. 打开你的Hexo博客项目的_config.yml文件。
  2. 在文件末尾找到或添加deploy部分,按照下面的格式填写:
# Deployment
## 更多信息请参考: https://hexo.io/docs/one-command-deployment
deploy:
type: git
repository: git@github.com:用户名/用户名.github.io.git # 将这里的用户名替换为你的GitHub用户名
branch: main # 如果你的默认分支不是main,请更改为此处对应的分支名

步骤 3: 安装 Git 部署插件

在命令行中进入你的Hexo博客目录,并执行以下命令以安装Git部署插件:

npm install hexo-deployer-git --save

步骤 4: 部署博客到 GitHub

现在你可以通过以下命令序列来清除缓存、生成静态文件并将它们部署到GitHub:

hexo clean # 清除缓存数据
hexo generate # 或者简写为 hexo g,用于生成静态文件
hexo deploy # 或者简写为 hexo d,用于部署网站

步骤 5: 访问你的博客

部署完成后,你可以通过访问https://用户名.github.io/(将“用户名”替换为你的GitHub用户名)来查看你的在线博客。

阅读记录0
点赞0
收藏0
禁止 本文未经作者允许授权,禁止转载
猜你喜欢
评论/提问(已发布 0 条)
评论 评论
收藏 收藏
分享 分享
pdf下载 下载