【Gitee + Hexo】从0开始搭建自己的博客网站

简介: 【Gitee + Hexo】从0开始搭建自己的博客网站

每一名开发者,都期望有属于自己的技术博客网站,这其中更多的人依赖CSDN、博客园、掘金等去分享技术性文章。本文的目的是带着大家快速搭建一个属于自己的免费博客网站,其实现原理:先用Hexo 把提前写好的 md 文档代码生成静态页面,然后利用码云 pages 这个静态网站托管功能,部署打包好的代码。

先上地址:http://magnumhou.gitee.io/magnum-blog/

99d595b90e944f23a1cf19d21d22df19.png

一、前期准备

1.1 注册 Gitee 账号

注册一个属于自己的 Github 或 Gitee 账号,本文采用 Gitee 演示。

Gitee,俗称 码云,是国内一个基于 Git 的代码托管 和 研发协作平台。

Gitee 官网地址:https://gitee.com/

Gitee 相对于 Github 的优势有以下几点:

由于大家都懂的原因,访问 Github 的速度会非常慢,有时候甚至出现访问失败的情况。而 码云 由于是国内的平台,能够让你体验飞一般的速度。

和GitHub相比,码云除了提供免费的Git仓库外,还集成了代码质量检测、项目演示等功能。对于团队协作开发,码云还提供了项目管理、代码托管、文档管理的服务,5人以下小团队免费。

注册及创建仓库过程大家可以百度,非常简单。

1.2 安装 Git

下载地址

选择对应的系统平台,下载后,傻瓜式安装即可。

安装完成后,打开运行 --> 输入CMD命令,回车打开命令行窗口

输入以下Git指令

git --version

出现版本号,即代表 git 安装成功

1.3 Git 和 Gitee 建立联系

任意目录下,打开 git bash 命令行,输入以下命令生成公钥:

ssh-keygen -t rsa -C 邮箱

回车出现 (y/n), 输入 y , 连续点击回车,即可生成。

打开目录 C:\Users\Dell.ssh 目录,找到 id_rsa.pub 文件,使用记事本打开:

注意:不同电脑,用户目录有所差异。

返回到浏览器中找到刚刚云端仓库创建完成的 gitee 页面,右上角找到个人信息点开,找到 ”设置“ 并打开,找到左侧栏 ”安全设置“ 中的 ”SSH公钥“

生成公钥的官方指导步骤

默认公钥数量为 0,在 ”添加公钥“ 栏目下,添加 ”标题“ 和 ”公钥“

注:标题名字为自定义 公钥为刚刚用记事本打开的 ”id_rsa.pub“ 文件中的内容

粘贴完成后,点击确定。此时就会显示 ” 您当前的SSH公钥数:1 “。

输入以下指令,进行全局配置:

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

将纳入版本库的文件,提交到 gitee 远程仓库:

git add .
git commit -m 'first commit'
git remote add origin 你的仓库地址
git push -u origin master

此时,提交完成,打开浏览器,输入你的仓库地址,刷新即可看到文件。

1.4 安装 Node

Node.js® 是一个开源、跨平台的 JavaScript 运行时环境。

Node.js (Node.js 版本需不低于 10.13,建议使用 Node.js 12.0 及以上版本)

Node 下载地址

中文地址

安装过程比较简单,傻瓜式安装即可。

安装完成,打开命令行执行以下命令

node  -v

出现版本号,即安装成功。默认自带包管理器 npm,可通过以下命令验证

npm -v

1.5 安装 Hexo

Hexo 是一个快速, 简洁且高效的博客框架. 让上百个页面在几秒内瞬间完成渲染. 具有强大的插件整合系统。

官网地址

全局安装

$ npm install -g hexo-cli

对于熟悉 npm 的进阶用户,可以仅局部安装 hexo 包

$ npm install hexo

在任意位置创建一个文件夹。打开文件夹后鼠标右键,选择Git Base -> Git Base Here

输入以下指令Hexo 即会自动在目标文件夹建立网站所需要的所有文件。

hexo init

刷新下文件夹 ,会有以下的目录

cb418d791f544d07908f7fca2b6c95b2.png

7916caebd12b49daa060ead36bbfdc14.png

红框内的文件是需要自己打包生成的

package.json 中的代码:

{
  "name": "magnum-blog",
  "version": "0.0.0",
  "private": true,
  "scripts": {
    "build": "hexo generate",
    "clean": "hexo clean",
    "deploy": "hexo deploy",
    "server": "hexo server"
  },
  "hexo": {
    "version": "6.3.0"
  },
  "dependencies": {
    "hexo": "^6.3.0",
    "hexo-deployer-git": "^4.0.0",
    "hexo-generator-archive": "^2.0.0",
    "hexo-generator-category": "^2.0.0",
    "hexo-generator-index": "^3.0.0",
    "hexo-generator-tag": "^2.0.0",
    "hexo-renderer-ejs": "^2.0.0",
    "hexo-renderer-marked": "^6.0.0",
    "hexo-renderer-stylus": "^2.1.0",
    "hexo-server": "^3.0.0",
    "hexo-theme-landscape": "^0.0.3"
  }
}

相关指令如下

# 安装依赖包
npm install
# 构建
npm run build
# 启动
npm run server

启动后 输入路径 localhost:4000 到游览器即可看到效果了,类似这样的网站

f86120da64324a2581c2932c9af00ceb.png

我这里替换了网站默认的主题,地址:https://hexo.io/themes/

ca942a9c49084b4a8e175f3251f7da9e.png

选中自己喜欢的主题了吗?这个时候可以进入到指定主题的 github 中,把它下载下来吧

3c7c75ac2e2240a1a6e2fa84258a84e8.png

把下载下来的压缩包解压,放到 hexo/themes 中

11940e3f60ba47e2ab2bb04ac5d33e91.png

返回上一级,打开_config.yml,将里面 theme 对应的值进行修改

05996a9c7619487296bd5e7cbe72c0ff.png

重新执行命令

npm run server

刷新页面,就出现你想要的主题啦!!!

Hexo 中_config.yml 文件的其他配置

二、开发

选择你习惯使用的 md 工具,去开始你的博客开发之旅吧。

需要注意的是,博客内部开头要加上这些哦!

---
# 文章标题
title: Hello My Bolg
# 文章日期格式:2018-05-30 15:20:36
date: 
# 文章标签
tags: 
# 文章分类
categories:  
---

写一个 home.md 内容如下:

---
title: '我的博客首页'
---
<pre>
     《春江晚景》
    竹外桃花三两枝,
    春江水暖鸭先知。
    茼蒿满地芦芽短,
    正是河豚欲上时。
</pre>

将写好的 .md 文件放入 hexo 文件夹下的 source 目录下的 _posts 文件夹中,可以看到里面有个hello-world.md 文件,这是默认的文章。

启动 npm run server ,刷新页面

4a60a78d64b04848ac51603800e6e71a.png

三、部署码云

博客目录内右键打开 PowerShell,执行以下命令

# 安装 hexo-deployer-git 插件(将代码推送到码云用)
npm install hexo-deployer-git --save

777c10ae266a40438e365c85575e21f3.png

打开 hexo 根目录的_config.yml 文件,修改 deploy 的值

17c8ad66d8e64fd793ce0230619600c6.png

执行如下命令,将代码部署至码云

hexo deploy 

推送完成,去你码云的项目地址,刷新看看,就有了刚刚上传的文件了

d67011485b05463681244932693b677c.png

点击“服务”,选择“Gitee Pages”

552bd77bc9c442db9a9f2586faec911f.png

注意:这一步出于监管原因需要实名认证(需要上传身份证),认证完成后,才可继续操作。

选择指定分支,启动服务,通过点击相关地址就可以查看你的博客啦!!!

32ccf970a30b43afa72c5af10910fe89.png


相关文章
|
5月前
|
人工智能 数据可视化 机器人
2026年萌新零基础部署OpenClaw(Clawdbot)接入钉钉保姆级教程
在2026年AI自动化办公爆发的时代,OpenClaw(原Clawdbot,曾用名Moltbot)作为阿里云生态下开源的AI自动化代理工具,凭借自然语言交互、全场景任务自动化、插件化扩展的核心优势,成为个人办公提效、企业轻量化数字化转型的核心选择。与传统聊天机器人不同,OpenClaw并非单纯的对话工具,而是能实现“需求解析-任务规划-工具调用-结果反馈”的完整自动化系统,可轻松完成邮件管理、日程规划、网页抓取、多平台协同等实操任务,真正实现解放双手、提升效率的核心需求。
1429 25
|
4月前
|
Web App开发 人工智能 固态存储
AI Vibe Coding不踩雷!OpenClaw阿里云+本地一键部署,规范编码配置与避坑指南
AI Coding已成为开发效率提升的核心工具,但实际使用中常面临三大痛点:模型信息滞后导致新技术栈适配出错、问题处理“头疼医头脚疼医脚”、代码规范缺失(如异常处理不完整)。OpenClaw作为开源AI代理平台,通过标准化部署与规则配置,可有效规避这些问题——结合2026年最新部署方案,搭配定制化编码原则,能让AI Coding既保持探索能力,又严格遵循项目规范。
1118 13
|
4月前
|
人工智能 自然语言处理 文字识别
阿里云AI产品免费试用:7000万Tokens+30款产品零成本体验!
阿里云推出“AI免费试用”活动:新用户享7000万Tokens、100张图+50秒视频生成额度,覆盖通义千问Qwen3、万相2.6等30+款AI产品。零门槛开通即用,支持Agent搭建、代码生成、NLP/视觉智能等全场景实践,助开发者低成本启航AI应用开发。
2054 7
|
9月前
|
人工智能 运维 Java
Spring AI Alibaba Admin 开源!以数据为中心的 Agent 开发平台
Spring AI Alibaba Admin 正式发布!一站式实现 Prompt 管理、动态热更新、评测集构建、自动化评估与全链路可观测,助力企业高效构建可信赖的 AI Agent 应用。开源共建,现已上线!
8140 117
|
10月前
|
JavaScript NoSQL 前端开发
搭建实时足球比分系统从零到一的实战指南
构建实时足球比分系统需聚焦数据流架构:从API/爬虫获取数据,经后端处理存储,通过REST/WebSocket提供接口,前端展示。推荐使用专业API保障稳定性,结合Python/Node.js、PostgreSQL/MongoDB、Redis缓存与WebSocket实现实时推送。优先考虑法律合规与高并发应对,建议逐步迭代开发,亦可借助现成插件或服务快速上线。(238字)
Fama-French模型,特别是三因子模型(Fama-French Three-Factor Model)
Fama-French模型,特别是三因子模型(Fama-French Three-Factor Model)
|
C++
spdlog 日志库部分源码说明——日志格式设定,DIY你自己喜欢的调试信息,你能调试的远比你想象的还要丰富
spdlog 日志库部分源码说明——日志格式设定,DIY你自己喜欢的调试信息,你能调试的远比你想象的还要丰富
2106 6
|
C# C++ 计算机视觉
在C#中使用OpenCV(使用OpenCVSharp)
在C#中使用OpenCV(使用OpenCVSharp) 1、什么是OpenCVSharp       为了解决在Csharp下编写OpenCV程序的问题,我做过比较深入的研究,并且实现了高效可用的方法(GOCW);这几天在搜集资料的时候,偶尔看见了OpenCVSharp,从时间上来看,它已经经过了更久的发展,应该有许多直接借鉴、或者直接使用的地方。
13296 0
|
Linux C++ Python
windows下安装node-gyp
什么是node-gyp? gyp是一种根据c++源代码编译的工具,node-gyp就是为node编译c++扩展的时候使用的编译工具。 最近在研究native script需要使用到node-gyp,遇到一些问题所以将解决方案记录在这里。
2416 0

热门文章

最新文章