Github+Hexo搭建个人博客

本文最后更新于：2021年8月5日 下午

Github+Hexo搭建个人博客

工具准备

  • git安装：直接官网下载即可

  • Node.js安装

  • Hexo安装

    1. 先创建一个文件夹blog，然后cd到这个文件夹下（或者在这个文件夹下直接右键git bash打开）。

    2. 输入命令

      1
      npm install -g hexo-cli

    3. 用hexo -v查看版本

博客初始化

  • 进入之前创建的文件夹blog，这个文件夹下直接右键git bash打开

  • 按顺序输入命令

    1
    2
    3
    hexo init
    hexo generate
    hexo serve

  • 浏览器输入地址 localhost:4000，网页如果成功显示，则说明成功

部署博客

  1. 配置博客部署地址

    • 先在Github上创建一个仓库名为<你的用户名>.github.io的仓库

    • 打开根目录下的_config.yml文件，找到 Deployment 这个地方，把刚才新建的 Repository 的地址贴过来，然后指定分支为 main 分支

      1
      2
      3
      4
      5
      6
      # Deployment
      ## Docs: https://hexo.io/docs/deployment.html
      deploy:
        type: git
        repo: {git repo ssh address}
        branch: main

  2. 安装一个支持 Git 的部署插件

    1
    npm install hexo-deployer-git --save

  3. 安装成功之后，执行部署命令。运行成功后，在仓库中就能看到有新文件上传

    1
    hexo deploy

配置站点信息

  1. 修改根目录下的 _config.yml 文件，找到 Site 区域，这里面可以配置站点标题 title、副标题 subtitle 等内容、关键字 keywords 等内容

    1
    2
    3
    4
    5
    6
    # Site
    title: <网站标签页名字>
    subtitle: xxxx
    description:
    keywords: "c++ 刷题，xxx"
    author:

  2. 设置一下语言，如果要设置为汉语的话可以将 language 的字段设置为 zh-CN，修改如下

    1
    language: zh-CN

主题相关配置

使用出现的问题

  • 如何上传带图片的博客？

    1. 修改根目录下_config.yam的配置项post_asset_folder为true
    2. 下载插件npm install https://github.com/CodeFalling/hexo-asset-image --save
    3. 添加md文件时，同时添加一个同名的文件夹，里面放图片，md里面使用![img](<文件夹名>/图片名)即可
    • 如果是通过npm镜像下，可能不是最新的，需要修改Blog\node_modules\hexo-asset-image\index.js里面var endPos=link.length-1
杂项
杂

本博客所有文章除特别声明外，均采用 CC BY-SA 4.0 协议 ，转载请注明出处！