×

HEXO搭建静态网站

ldpc520 ldpc520 发表于2025-04-25 07:19:42 浏览34 评论0

抢沙发发表评论

搭建准备

  1. GitHub账号，需要注册一个账号（必须）

  2. Cloudflare Dashboard | Manage Your Account，需要注册一个账号

  3. 准备一个域名

软件下载/安装

  1. Git

  2. Node.js — Run JavaScript Everywhere

  3. 代码编辑：1. Visual Studio Code - Code Editing. Redefined、2.Notepad++

Git安装

软件下载完成–>一直点默认进行安装，（根据自己电脑情况，选择安装位置）

安装完成开始菜单可以查看到如下三个程序：Git CMD、Git Bash、Git GUI

  • Git CMD 是windows 命令行的指令风格

  • Git GUI是图形化界面

  • Git Bash 是linux系统的指令风格（常用）

Node安装

软件下载完成–>一直点默认进行安装，（根据自己电脑情况，选择安装位置）

cmd命令测试是否安装完成，命令执行之后，出现相关的版本信息说明安装成功了。



node -v


修改npm源，配置成华为云镜像源，加速下载。



npm config set registry https://mirrors.huaweicloud.com/repository/npm/


配置Git ssh密钥并连接Github

打开 Git Bash 程序，输入如下命令

git config --global user.name "github的用户名" 
git config --global user.email "github的注册邮箱"



检查是否配置成功


git config -l

命令如下显示，说明配置成功了

.....
user.name="github的用户名"
user.email="github的注册邮箱"

生成ssh的公/私钥

输入命令，一直点回车（也是可以设置密码）

ssh-keygen -t rsa -C "github的注册邮箱"


密钥生成的位置：C:\Users\用户名\.ssh\

  • id_rsa私钥

  • id_rsa.pub公钥

连接github

  1. 将id_rsa.pub公钥的文件内容复制一下。

  2. 访问github网站，点击右上角头像–>设置（settings)–>在左侧边， SSH and GPG keys –>在SSH keys选项中，点击NEW SSH KEY按钮

  3. Title的内容自定义–>在 Key 的输入框中，粘贴复制的公钥文件内容 –>最后点击 ADD SSH KEY 的按钮。

连接测试

ssh -T git@github.com


第一次连接，会出现Are you sure you want to continue connecting (yes/no/[fingerprint])?的提示，输入yes就可以了。
如果，你设置了密码还会在有Enter passphrase for key '/c/Users/用户名/.ssh/id_rsa':的提示，输入你设置的密码即可。

创建GitHub.io仓库

项目命名要求<用户名>.github.io

在Git BASH输入如下命令安装 Hexo


npm install -g hexo-cli && hexo -v


验证是否安装成功。

hexo -v

初始化

hexo init hexo
cd hexo
npm i


文件描述：

  • node_modules：依赖包

  • scaffolds：生成文章的一些模板

  • themes：主题

  • source：用来存放你的文章

  • .npmignore：发布时忽略的文件（可忽略）

  • _config.landscape.yml：主题的配置文件

  • _config.yml：博客的配置文件

  • package.json：项目名称、描述、版本、运行和开发等信

启动项目

hexo cl && hexo s

静态博客挂载到 GitHub Pages

安装 hexo-deployer-git

npm install hexo-deployer-git --save


修改 _config.yml 文件
修改最后一行的配置，将repository修改为你自己的github项目地址即可，还有分支要改为main代表主分支（注意缩进）。

deploy:  
  type: git  
  repository: git@github.com:skilladd-demo/skilladd-demo.github.io.git  
  branch: main

执行下面命令推送到Github
hexo clean && hexo generate && hexo deploy

或

hexo cl; hexo g; hexo d

  • hexo clean：删除之前生成的文件，可以用hexo cl缩写。

  • hexo generate：生成静态文章，可以用hexo g缩写

  • hexo deploy：部署文章，可以用hexo d缩写

如果出现Deploy done，则说明部署成功了。

静态博客挂载到 Cloudflare Pages

在 Workers 和 Pages 中选择 Pages 的 连接到 Git

  1. 点击连接github的按钮，然后登录你仓库对应的GitHub帐号

  2. 点击install & Authorize

  3. 选择你要存储的库，<用户名>.github.io

  4. 点击开始设置

  5. 点击保存并部署后，等待项目部署完成即可。

将仓库设置私用

返回刚才部署的github仓库

  1. 点击设置（settings)

  2. 往下拉，找到Danger Zone，点击 Change visibility

  3. 点击 Change to private，弹出的窗体，一直点击即可设置仓库私用

hexo如何使用

可以查看文档 | Hexo官网
语法：

hexo new [layout] <title>
hexo new 测试


运行

hexo cl; hexo s


上传到github项目

hexo cl; hexo g; hexo d