抱歉,您的浏览器无法访问本站
本页面需要浏览器支持(启用)JavaScript
了解详情 >

梦开始的地方,Hexo基础搭建

在本地搭建 Hexo:

  • 确保本地安装了 Node.jsGit

    1
    2
    3
    4
    5
    6
    node -v
    npm -v
    pnpm -v
    git -v

    npm install -g hexo-cli # 安装 Hexo
  • 在一个空文件夹里运行

    1
    2
    3
    4
    hexo init my-blog    # 初始化一个 Hexo 项目 (my-blog为项目名,自行修改)
    cd my-blog
    pnpm install # 安装依赖
    hexo server # 启动服务
  • 在浏览器访问 http://localhost:4000 看到默认页面。

创建 GitHub 仓库:

  • 在 GitHub 上创建一个新的公开仓库(Public),名为 用户名.github.io,勾选 Public

部署 Hexo 到 GitHub Pages:

  • 在 Hexo 项目根目录下打开 _config.yml,找到 deploy 部分,改成:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    deploy:
    type: git
    repo: https://github.com/用户名/仓库名.git
    branch: main

    # 或者多仓库改为
    deploy:
    type: git
    message: "Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}" # 提交信息
    repo:
    github: https://github.com/用户名/仓库名.git,main # GitHub仓库地址
    gitee: https://gitee.com/用户名/仓库名.git,main # Gitee仓库地址

  • 安装部署插件(只需要执行一次):

    1
    pnpm install hexo-deployer-git --save
  • 每次写完文章后,运行:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    # 推送 public
    hexo clean
    hexo generate
    hexo deploy

    # 或缩写版:
    hexo clean
    hexo g
    hexo d

    # 或者一行
    hexo clean && hexo g && hexo d

    Hexo 会自动把生成的静态网页推送到你的 GitHub Pages 仓库。

  • 打开浏览器访问 https://仓库名 (Github仓库名需要为 用户名.Github.io) 会看到页面

Front-matter

设置 描述 默认值
layout 布局 config.default_layout
title 标题 文章的文件名
date 建立日期 文件建立日期
updated 更新日期 文件更新日期
comments 开启文章的评论功能 true
tags 标签(不适用于分页)
categories 分类(不适用于分页)
permalink 覆盖文章的永久链接。永久链接应该以 /.html 结尾 null
excerpt 纯文本的页面摘要。使用 该插件 来格式化文本
disableNunjucks 启用时禁用 Nunjucks 标签 {{ }} / {% %}标签插件 的渲染功能 false
lang 设置语言以覆盖 自动检测 继承自 _config.yml
published 文章是否发布 对于 _posts 下的文章为 true,对于 _draft 下的文章为 false

评论