Hexo搭建自己的博客

搭建博客

安装node.js

打开下面的nodejs官网下载安装

1
https://nodejs.org/e

安装git

终端输入，回车运行

1
brew install git

初始化博客

到你想放置博客的目录，打开终端运行指令

1
hexo init

安装Node.js相关依赖包

终端输入，回车运行
[备注：在你的项目的根目录下运行这个命令，npm将会查看你的package.json文件，然后安装所有列出的依赖项。这是在克隆他人的项目或部署自己的项目到新环境时非常有用的命令。]

1
npm install

创建github仓库

首先，点击“New repository”创建一个仓库

image-20230430130341447

Repository填自己用户名.github.io（自己用户名就是隔壁那个owner的名字)

勾选“Add a README file”

点击“Create repository”

CleanShot 2023-05-13 at 12.58.21

Hexo配置_config.yml

语法

在你的博客文件夹中，打开**_config.yml文件。找到deploy**部分，并配置为以下内容：

1
2
3
4
5
ymlCopy code
deploy:
  type: git
  repository: <https://github.com/{github用户名}/{github用户名}.github.io.git>
  branch: main

举例

1
2
3
4
5
ymlCopy code
deploy:
  type: git
  repository: <https://github.com/xiang0731/xiang0731.github.io.git>
  branch: main

安装部署插件

1
npm install hexo-deployer-git --save

设置github

要打开guthub page，不然也不会显示的

CleanShot 2023-05-31 at 00.54.44

到这里基本上就搞定了。

博客创作

主要在source文件夹里放文章的markdown文件，所有在排除规则以外的md文件都会被解析发布

1
2
3
├── source         # 源文件
|   ├── _posts     # 用来发布的文件，需确保文件头至少包含 title 的 Front-matter，否则可能出错
|   ├── _drafts    # 临时的草稿文件

查看与部署

本地查看博客

通过在博客根目录打开终端，运行以下命令，就可以在http://localhost:4000/查看你自己的博客

1
2
3
hexo clean
hexo generate
hexo server

部署到github page查看

同样地，通过在博客根目录打开终端，运行以下命令，再等一会，就能在你的github page（{github用户名}.github.io）上查看博客了

1
2
3
hexo clean
hexo generate
hexo deploy

hexo常用命令与解析

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 清理静态文件
hexo clean
# 生成静态文件
hexo generate
# 打开本地服务器
hexo server
# 部署
hexo deploy


hexo --safe                # 安全模式，不会载入插件和脚本
hexo --debug               # 调试模式。在终端中显示调试信息并记录到`debug.log`
hexo --silent              # 简洁模式。隐藏终端信息
hexo --config custom.yml   # 自定义配置文件的路径
hexo --draft               # 显示`source/_drafts`文件夹中的草稿文章
hexo --cwd /path/to/cwd    # 自定义当前工作目录的路径

报错解决

安装git时，报错xcrun解决

报错，这是缺失xcode里的xcrun

1
xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools), missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun

终端输入，回车

1
xcode-select --install

运行npm install报错 - 权限不够

1
2
3
4
5
6
7
8
9
10
11
12
13
npm ERR! syscall open
npm ERR! path /Users/stevechen/.npm/_cacache/index-v5/eb/09/73610e3cf2505a235bd57082230cf2f67f6032bb62939ab9ccb1c60b06cb
npm ERR! errno EACCES
npm ERR!
npm ERR! Your cache folder contains root-owned files, due to a bug in
npm ERR! previous versions of npm which has since been addressed.
npm ERR!
npm ERR! To permanently fix this problem, please run:
npm ERR!   sudo chown -R 501:20 "/Users/stevechen/.npm"

npm ERR! A complete log of this run can be found in:
npm ERR!     /Users/stevechen/.npm/_logs/2023-04-08T18_23_54_991Z-debug-0.log
sudo chown -R 501:20 "/Users/stevechen/.npm"

运行npm install报错 - cuid2

1
2
3
4
5
6
7
npm WARN deprecated cuid@2.1.8: Cuid and other k-sortable and non-cryptographic ids (Ulid, ObjectId, KSUID, all UUIDs) are all insecure. Use @paralleldrive/cuid2 instead.
npm WARN deprecated source-map-resolve@0.6.0: See <https://github.com/lydell/source-map-resolve#deprecated>

added 240 packages, and audited 241 packages in 11s

22 packages are looking for funding
  run `npm fund` for details

这个报错信息表明您正在安装的软件包中有两个被认为是过时的（deprecated）软件包。警告建议使用新的软件包来代替它们。

对于cuid软件包，警告建议使用@paralleldrive/cuid2软件包替换它。它是一个更安全的替代品，提供类似的功能。

对于source-map-resolve软件包，警告建议查看官方文档中提供的替代方案。

这些警告不一定是致命的，但是值得关注。建议您检查您的软件包依赖项并更新它们，以便您的应用程序保持最新的和安全的状态。同时，您可以通过运行**npm fund**来了解您正在使用的软件包是否需要赞助。

对于cuid软件包，您可以遵循警告中的建议并将其替换为@paralleldrive/cuid2软件包。要安装该软件包，可以使用以下命令：

1
2
cssCopy code
npm install --save @paralleldrive/cuid2

对于source-map-resolve软件包，您可以参考官方文档中提供的替代方案。具体来说，您可以考虑使用resolve-url-loader或者resolve-url。如果您需要继续使用source-map-resolve软件包，则需要了解并接受其过时的状态可能会带来的风险。

如果您使用的是package-lock.json文件来管理您的软件包依赖项，那么在安装新的软件包或更新现有软件包时，npm会尝试保持与当前的package-lock.json文件一致。这样，您可以确保所有的开发人员在使用相同的软件包版本，从而避免由于不同版本的软件包而导致的问题。

最后，当您安装新的软件包时，一定要确保阅读软件包的文档，并遵循它们的最佳实践和安全建议，以确保您的应用程序的安全性和稳定性。

运行hexo deploy之后报错 ERROR Deployer not found: git

这个错误表明在尝试使用 Hexo 部署您的网站时，找不到 git 部署器。要解决这个问题，请按照以下步骤操作：

确保您已经安装了 hexo-deployer-git 插件。如果尚未安装，请在命令行中运行以下命令：

1
2
cssCopy code
npm install hexo-deployer-git --save

这将安装 git 部署器并将其添加到您的 package.json 文件中。

接下来，打开您的 Hexo 博客根目录下的 _config.yml 文件。找到 deploy 部分，确保您已经正确配置了 git 部署器。配置示例如下：

1
2
3
4
5
yamlCopy code
deploy:
  type: git
  repo: <repository_url>
  branch: <branch_name>

将 <repository_url> 替换为您要部署的 Git 仓库 URL，将 <branch_name> 替换为您要部署到的分支名称。通常，对于 GitHub Pages，分支名应为 **gh-pages**；对于 GitLab Pages，分支名应为 **master**。

例如，如果您使用的是 GitHub Pages，您的配置可能如下所示：

1
2
3
4
5
yamlCopy code
deploy:
  type: git
  repo: <https://github.com/yourusername/yourusername.github.io.git>
  branch: gh-pages

保存 _config.yml 文件并重新运行 **hexo deploy**。这次应该不会再出现错误。

如果您仍然遇到问题，请确保您的 Git 配置正确（包括 SSH 密钥和/或凭据），并检查网络连接。如果问题仍未解决，您可以查阅 Hexo 官方文档以获取更多帮助。

报错cannot get

如下，一般是缺少index.md导致的。

image-20230513124910085

需要到gallery目录下创建index.md，对应front-matter放上

1
title: gallery

参考资料

https://www.cnblogs.com/baiqiantao/p/10538926.html