Hexo搭建

安装软件

安装git

  • 官网下载git,确定好安装位置,无脑下一步即可。
  • 完成后右键菜单将出现 Git GUIGit Bash 两个新选项

安装Node.js

  • 官网下载 Node.js ,步骤同上。
  • 完成后 cmd 输入
    node -v

 没报错就说明成功

安装Hexo

  • 本地新建一个文件夹(取名以 hexo 为例)进入后右键打开 Git Bash
  • 进入 Hexo 官网 https://hexo.io/zh-cn/
  • 复制第一行指令,到 Bash 回车等待
    npm install hexo-cli -g 

 没有出现报错后会生成 blog 文件夹,输入

    cd blog 
  • 然后输入第四行的命令
    npm install
  • 然后输入第五行命令
    hexo server
  • 该命令未来可以化简为 hexo s 使用,用于运行 hexo 服务器

 随后出现一行

Hexo is running at http://localhost:4000/ . Press Ctrl+C to stop.
  • 用浏览器进入其中的地址即可进入博客页面,该页面他人无法访问

编辑文章

  • blog 文件夹内进入Git Bash ,键入
    hexo new "文章标题" 
  • 即可创建新文章于 _source/_posts 文件夹中,文件格式为md(markdown)格式

  • 关于文章md格式编写方法可参考官方文档(官网上有入口)的 写作、Front-matter、标签插件、资源文件夹 等部分内容,比较简单

  • 编辑完成文章,保存文件后再 Git Bash 依次输入

    hexo g
    hexo s
  • 以生成网页并运行,刷新网页即可发现文章已经在网页当中

主题

  • 官网底部和顶部有主题入口,可选择各式各样的主题,这里以 ayer 主题为例

  • 点击主题名字可跳转至其 GitHub 页面,下面通常有作者写的使用介绍和配置方法

  • 按照要求安装后,在 blog 目录下打开 _config.yml (建议备份),将 theme后面的主题更换为 ayer

  • 再通过 hexo ghexo s 更新网页主题就应用成功,在此之前应先停止服务器

主题配置

  • 也是根据作者给的配置说明进行配置,文件在 theme 文件夹下的 _config.yml 中(不要与之前的那个混淆,也建议备份)

  • 更改配置后保存后,进入 blog 文件夹的 _config.yml 中按需求配置 title、subtitle 等多个配置项目,即可更改网站标题,描述,作者名字等

  • 最后再次更新网页即可看到主题变化

通过Gitee联网

注册Gitee

  • 注册账号并登录 Gitee ,右上角个人界面内完成实名认证,这是使用联网功能的必要条件。记住个人空间的地址 https://gitee.com/xxx 的 xxx 部分

  • 在右上角 + 号处点击新建仓库,设置好名称和路径即可创建。

上传博客

  • 创建好后,会有一个教程界面,复制 Git全局设置 的两行代码到 Bash 运行

  • 将以下命令的 邮箱地址 换为自己的邮箱

    ssh-keygen -t rsa -C "邮箱地址"
  • 运行需三次回车,一直确认即可

  • 输入以下代码获取密钥

    cat ~/.ssh/id_rsa.pub
  • 复制显示出来的密钥,打开仓库在右上角设置,点击 SSH公钥 将刚才的密钥复制、命名并添加

  • 在 Bash 中输入

    ssh -T [email protected]
  • 返回 successfully 即配置成功

  • 打开根目录(blog)打开配置文件(_config.yml)到底部, type 设置为 ‘git’

  • 下一行输入 repository: (冒号后有一个空格)

  • 然后进入仓库界面代码栏,点击 SSH 复制后面的地址添加到*repository: *后,保存退出

  • 根目录运行以下命令将博客部署到 gitee

    npm install hexo-deployer-git --save
  • 运行 hexo g 然后运行 hexo d 可以将博客更新到 gitee 中,点击仓库的管理将仓库开源,勾选开源选项,打勾3项须知

  • 之后点击服务一栏的 Gitee Pages 服务,勾选下面的 强制使用HTTPS 点击 更新 即可启动

  • 接着会显示正在部署网站,完成后会给你网站地址,点击即可访问

更新博客

  • 每次写完博客在 Bash 运行 hexo ghexo s 后在本地地址先查看是否满意,再运行 hexo d 部署

  • 然后在 gitee 的 Pages 服务点击 更新 即可

  • 若网页未发生变化就运行

    hexo clean
  • 清理缓存后再部署
  • Copyrights © 2023-2025 LegendLeo Chen
  • 访问人数: | 浏览次数:

请我喝杯咖啡吧~

支付宝
微信