如何使用 Gitee Pages 建立免费博客网站

Admin

2025-2-25

其他学习资源

一、Gitee Pages 简介

Gitee Pages 是 Gitee 提供的静态网页托管服务，可以通过 Git 仓库托管 HTML、Markdown（借助静态站点生成器）等静态资源，并自动生成可访问的博客或网站。适用于个人博客、技术文档、项目主页等。

二、准备工作

注册 Gitee 账号：如果没有 Gitee 账号，请前往 Gitee 官网注册。
安装 Git：确保本地已安装 Git（可通过 git --version 检查）。
选择站点生成工具（可选）：
- 纯 HTML/CSS：适用于手写网页。
- Hugo：静态博客生成器，适合技术博客。
- Hexo：Node.js 驱动的博客框架，适合 Markdown 写作。

三、创建 Gitee 仓库

新建仓库
- 进入 Gitee 主页，点击右上角“+” > “新建仓库”。
- 仓库名称建议使用 yourname.gitee.io（如 myblog.gitee.io）。
- 选择公开（Gitee Pages 仅支持公开仓库）。
- 选中 初始化 README.md，然后点击创建。
克隆仓库到本地git clone https://gitee.com/yourname/yourname.gitee.io.git cd yourname.gitee.io

四、创建静态页面

方式 1：手动编写 HTML（适合简单站点）

在 yourname.gitee.io 目录下创建 index.html：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>我的博客</title>
</head>
<body>
    <h1>欢迎来到我的 Gitee Pages 博客！</h1>
</body>
</html>

然后提交并推送代码：

   git add .
   git commit -m "初始化博客主页"
   git push origin master

方式 2：使用 Hexo 或 Hugo（适合 Markdown 写作）

Hexo 部署示例

安装 Hexo（需 Node.js）npm install -g hexo-cli hexo init blog cd blog npm install
生成静态文件hexo generate
部署到 Gitee
- 在 blog/_config.yml 中设置 deploy 选项：deploy: type: git repo: https://gitee.com/yourname/yourname.gitee.io.git branch: master
- 安装 Hexo Git 部署插件并执行部署：npm install hexo-deployer-git --save hexo deploy