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 serverhexo s
  • 新建文章:hexo new "文章名字"
  • 新建静态页面:hexo new page "页面名字"
  • 生成public文件夹:hexo generatehexo g
  • 清除public文件夹:hexo clean
  • 部署:hexo deployhexo 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替换为你在创建时的名字,一般现在的主题都带的有评论模版,如果没有就需要自己添加了,这个不同的主题不太相同,可以看下官方的安装模版进行修改
    在这里插入图片描述