Hexo搭建详细教程

初始化Hexo

  1. 首先需要以下安装环境，直接在官网下载即可
  1. 环境准备好后，安装Hexo npm install -g hexo-cli
  2. 安装后在指定文件夹创建项目
    hexo init <folder>
cd <folder>
npm install
  3. 选择主题

  • Hexo初始化成功后，然后需要选择一个漂亮的主题，这个推荐直接在官网上找，主题
    在这里插入图片描述

  • 选中主题后下载到项目themes文件夹

  • 然后修改根目录下的_config.yml文件

  • theme: '主题名,也就是themes文件夹里的名字'

  1. hexo最常用的有以下几个命令
  • 启动服务：hexo server 或 hexo s
  • 新建文章：hexo new "文章名字"
  • 新建静态页面：hexo new page "页面名字"
  • 生成public文件夹：hexo generate 或 hexo g
  • 清除public文件夹：hexo clean
  • 部署：hexo deploy 或 hexo d

部署到Github

Github有免费提供搭建静态网站的功能，所以hexo推荐直接放到GitHub Page，按照以下步骤进行部署。

  1. 首先新建一个源码repo，建议选择Private，这个用来放hexo项目代码，不对外开放
  2. 本地仓库运行以下命令提交代码
  • git init：git初始化
  • git add .: 将所有代码添加到暂存区
  • git commit -m "first commit"：提交本次commit
  • git remote add origin '远程仓库地址'：添加远程仓库地址
  • git push -u origin main：推送代码
  1. 然后再新建一个仓库，名字为 github名字.github.io，这个仓库用于放部署后的代码
  2. 安装Hexo部署插件 npm install hexo-deployer-git
  3. 修改根目录下的 _config.yml
    deploy:
  type: git
  repo: 部署仓库地址
  branch: main
  4. 最后执行hexo deploy命令就可以在github名字.github.io看到博客了

SSH + github Actions自动部署

  • Github Actions是github专用的持续集成脚本，用于自动执行工作流程，SSH可以通过建立密钥免密登录，这两个结合就能达到自动部署的效果

  1. 首先通过ssh-keygen生成密钥，ssh-keygen -t rsa -C "Github 的邮箱地址"

  2. 然后github配置ssh，配置路径：github -> Settings –> SSH and GPG keys
    在这里插入图片描述

  3. git仓库添加密钥私有变量，配置路径：repo -> Settings -> Secrets，点击New repository secret，name可以自定义，主要是接下来的deploy.yaml文件需要使用，Secret填写你生成的密钥
    在这里插入图片描述

  4. 然后根目录下新建.github/workflows/deploy.yaml，并填写以下内容

    name: Deploy
on:
  push:
    branches: [你需要自动化部署的分支]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Repository main branch
        uses: actions/checkout@main
      - name: Setup Node
        uses: actions/setup-node@v1
        with:
          node-version: 14.x
      - name: Setup Hexo Dependencies
        run: |
          npm install hexo-cli -g
          npm install
      - name: Setup Deploy
        env:
          HEXO_DEPLOY_PRIVATE_KEY: ${{ secrets.'你上一步自定义的变量名' }}
        run: |
          mkdir -p ~/.ssh/
          echo "$HEXO_DEPLOY_PRIVATE_KEY" > ~/.ssh/id_rsa 
          chmod 600 ~/.ssh/id_rsa
          ssh-keyscan github.com >> ~/.ssh/known_hosts
      - name: Setup Git Infomation
        run: |
          git config --global user.name "git名字"
          git config --global user.email "git邮箱"
      - name: Deploy Hexo
        run: |
          hexo clean
          hexo generate 
          hexo deploy

  5. 然后把代码push上去的时候，就可以在仓库的Actions上看自动工作流程的情况

谷歌收录

  1. 首先在Google Search Console登录谷歌账号

  2. 然后在网址前缀中填写网址，下载验证文件到主题文件夹的source目录
    在这里插入图片描述

  3. 下载后再重新部署一下，最后点击验证

添加站点地图

站点地图是一种文件，您可以在其中提供与您网站中的网页、视频或其他文件有关的信息，还可以说明这些内容之间的关系。Google 等搜索引擎会读取此文件，以便更高效地抓取您的网站。站点地图会告诉 Google 您认为网站中的哪些网页和文件比较重要，还会提供与这些文件有关的重要信息。

  1. 安装站点地图插件 npm install hexo-generator-sitemap --save

  2. 在hexo根目录的_config.yml修改以下内容

    url: 博客地址
sitemap:
 path: sitemap.xml

  3. 然后部署博客，输入博客地址/sitemap.xml能看见以下内容
    在这里插入图片描述

  4. 最后在Google Search Console上的站点地图上点击提交
    在这里插入图片描述

Disqus评论

Hexo可以搭载的评论系统有很多，比如Valine，Waline，Disqus等等，但是按颜值来看还是Disqus

  1. 首先在Disqus官网进行注册，然后点击“Get STARTED”，并选择 “I want to install Disqus on my site” 选项
  2. 然后在进入表单页按照提示进行填写即可，但是有两个地方需要注意，Website Name这个是你的专属网址的名字，需要记住，还有就是在“Select Plan”记得选“Basic”
  3. 最后修改_config.yml中把shortname替换为你在创建时的名字，一般现在的主题都带的有评论模版，如果没有就需要自己添加了，这个不同的主题不太相同，可以看下官方的安装模版进行修改
    在这里插入图片描述