hexo+github pages部署博客

一、hexo环境配置

  • a. 安装Node.js环境

  • b. 安装Git环境

  • c. 安装Hexo npm install -g hexo-cli

  • d. hexo init 项目名

  • e. npm intsall

  • f. hexo generator 生成静态文件

  • g. hexo server 启动

  • h. npm install hexo-deployer-git --save 安装hexo-deployer-git

  • i.
    deploy

      type: git
      repository: git@github.com:YOUR_ID/YOUR_ID.github.io.git
      branch: master     

    在”_config.yml”配置中将deploy 的 type由github改为git

  • j. hexo deploy 实现自动部署到git

  • k. 替换主题的时候 下载对应的主题文件 放到themes文件目录下,修改_config.yml文件中的theme为该主题目录名

  • l.

    If your site is put in a subdirectory, set url as ‘http://example.com/child' and root as ‘/child/‘

    url: https://darlinghan.github.io/hlblog-pages
    root: /hlblog-pages/
    部署hexo到GitHub pages时样式错乱 要修改_config.yml下的url为(GitHub——settings——GitHub Pages)生成的路径,及root为路径地址

二、GitHub Pages配置

使用它部署静态资源,因为免费,不限容量大小,而且可以集成git,开发使用起来非常方便,虽然访问有点慢。

  • a. GitHub repository创建自己的仓库TESTXXX

  • b. 修改该仓库下的settings——》Github Pages——》Theme Chooser——》choose theme——》source 配置 master(或其他分支)

  • c. 配置公钥私钥
    Git Bash下 输入ssh-keygen -t rsa -C "XXXXX@qq.com"指令
    一路回车
    会在~/.ssh/下生成两个文件id_rsaid_rsa.pub
    GitHub 个人中心的 SSH and GPG keys下 新增SSH key
    复制id_rsa.pub下的内容

三、映射自己的专属域名

背景: 我是在阿里云oss购买的域名,10年199元hanling.fun的域名,便宜吧~

  • a. 方式一
    直接GitHub——》仓库的settings——》Github pages——》Custom Domain输入自己买的域名,
    然后一般要10分钟以后生效,我搭建的时候当天晚上没有生效,第二天早上看了下,还是没有生效,
    然后我又在Custom Domain里又重新输入了一下自己的域名,
    然后Github Pages下的域名地址就由原来Github默认提供的地址更新为了我自己的域名,
    并且提升30分钟至1小时后才会更新,所以再等等看吧~

  • b. 方式二
    Github博客部署hexo静态文件的那个repository(仓库)根目录下新建CNAME文件,里面放入自己的域名。
    购买的域名官方网站去解析,添加记录——》记录类型为CNAME,
    主机记录为@,解析线路默认,记录值为github的仓库名(也就是自己的GitHub地址),TTL可选默认10分钟。

四、过程中遇到的问题

  • 1.hexo deploy时CNAME文件会丢失
    直接hexo——》source目录下建CNAME文件——》hexo deploy时会将该文件生成到public下;
    该文件就是填写自己的域名,GitHub会自动读取这个文件里的内容把它映射到GitHub pages原本提供的地址。

  • 2.部署后样式错乱问题
    注意public打包后的文件,index.html中引入的样式路径是否正确,
    不正确的话对应的调整_config.yml中的url,root配置。

  • 3.开启搜索模式
    要实现站内搜索,必须在hexo目录下先安装 hexo-generator-json-content插件,然后设置_config.yml文件下的insight为true

  • 4.开启评论功能
    livere(来必力)网站注册账户
    选择来必力City版本——免费——安装——》生成了代码,复制其中的data-uid
    登录自己的账户(比如微信)
    修改hexo主题下的_config.yml文件中的livere_shortname字段为刚刚复制的内容
    就大功告成啦~

  • 5.引入图片资源
    安装cnpm install hexo-asset-image,修改_config.yml下的post_asset_folder属性为true。此时再执行命令 hexo n article_name 创建新的文章,在 source/_posts 中会生成文章 post_name.md 和同名文件夹 post_name,我们将文章中所使用到的将图片资源均放在 post_name 中,这时就可以在文章中使用相对路径引用图片资源了。
    ![img_name](img_name.jpg) #文章中的图片资源路径格式

    tips: 并没有生效……还没找到原因

五、hexo一些常见命令

    1. 新建草稿,不会出现在文章中 hexo new draft test2
    1. 将草稿中的文章发布到_post中hexo publish draft test2
    1. 清空hexo生成的public文件hexo clean
    1. 生成静态文件hexo g
    1. 部署文件hexo d

Powered by Hexo and Hexo-theme-hiker

Copyright © 2013 - 2024 HL's Blog All Rights Reserved.

UV : | PV :