个人网站搭建：Hexo + Kaze + Gitee Pages

最新推荐文章于 2024-08-10 20:45:34 发布

北游学Java

最新推荐文章于 2024-08-10 20:45:34 发布

阅读量1.4k

点赞数 1

文章标签： git github linux hexo

本文链接：https://blog.csdn.net/fly1north/article/details/122171427

版权

本文介绍了如何使用Hexo、Kaze主题和Gitee Pages搭建个人静态博客。首先，文章详细阐述了Hexo的安装步骤，包括前置要求（Git和Node.js）和安装过程。接着，讲解了Hexo的基本操作，如初始化站点、本地启动、核心配置等。随后，文章推荐了Kaze主题，并展示了如何安装和配置。最后，讨论了选择Gitee Pages作为托管服务的原因及操作步骤，包括创建仓库、连接仓库和手动更新。

摘要由CSDN通过智能技术生成

前言

建网站本身是一个很大的工程，涉及前端页面的搭建，网站数据的存储，还要购置服务器资源，甚至是后期的维护，过程相当繁琐。

不过如果仅仅是想搭建个人的网站，写写博客，想要美观，又不想操心太多和写博客无关的事情。那么，Hexo + Kaze + Gitee Pages 的方式就很适合你。

本文就讲下如何借助这三样免费的技术或服务，来搭建一个可访问的静态博客网站。

一个参考例子和大段代码文章里就不贴了，免得又说我水字数，需要的同学点击文档获取

Hexo 简介

Hexo 是什么？

Hexo[1] 是一个快速，简单且功能强大的博客框架。如果你用 Markdown 写博客，Hexo 可以在几秒内生成带有精美主题的静态文件。

Hexo 安装

前置要求

Node.js（版本 10.13 以上，建议使用 12.0 以上版本）
Git

安装 Git

Windows：下载并安装 git[2] 。
Mac：使用 Homebrew[3] 安装。
Linux（Ubuntu，Debian）：sudo apt-get install git-core
Linux（Fedora，Red Hat，CentOS）：sudo yum install git-core

安装 Node.js

Node.js 为大多数平台提供了 官方安装程序[4] 。

替代安装方法：

Windows：使用 nvs[5] 安装它。
Mac：使用 Homebrew[6] 安装。
Linux（基于 DEB / RPM）：与 NodeSource[7] 一起安装。
其他：通过相应的软件包管理器进行安装。请参阅 Node.js 提供的指南[8] 。

安装 Hexo

用 npm 安装 Hexo。

npm install -g hexo-cli

使用以下指令查看是否安装成功。

hexo version

如果你想卸载 Hexo，使用以下指令：

npm uninstall -g hexo-cli

运行 hexo

安装后，你可以通过 hexo 运行 Hexo。比如通过 hexo help 指令来获取使用帮助。

hexo help

帮助里提到 hexo init 命令可以创建一个新的 Hexo 文件夹，这个文件夹其实就是利用 Hexo 生成的站点信息了。接下来讲下怎么建站。

Hexo 建站

初始化操作

使用 hexo init 指令就可以在指定文件夹下建立站点信息：

hexo init java4u.cn

站点初始化中：

站点初始化完成，会生成指定的文件夹：

目录结构

进入该站点，我们看下目录结构，如下：

这些文件有着各自的职责：

_config.landscape.yml：自定义的主题配置文件，此处的 landscape 是默认主题。配置其他主题可以参考这种方式。
_config.yml：站点全局的配置文件。
node_modules：node 模块文件夹。包含可执行文件和依赖的资源。
package-lock.json：node_modules 文件中所有模块的版本信息，模块来源。
package.json：Hexo 框架的基本参数信息以及它所依赖的插件。
scaffolds：scaffolds 原意是脚手架，这里可以理解为模板文件夹。当你创建新的文章时，Hexo 会根据该文件夹下的对应文件进行初始化构建。
source：资源文件夹。这里是你放自己资源比如博文和图片的地方。_posts 文件夹下的 Markdown 和 HTML 文件会被解析并放到 public 文件夹下。其他文件或文件夹，如果开头命名不是 _ (下划线)，也都会被拷贝过去。
themes：主题文件夹。Hexo 会根据主题来生成静态页面。

基于这样的结构，Hexo 就具备了生成静态网站的能力。