• GitHub+Hexo博客搭建


    本文主要分为三部分,安装前准备,Hexo配置以及关联GitHub。简单说明一下,安装前准备就是博客需要的一些配置,Hexo是静态博客托管平台,我们在本地可以编辑博客,更换主题等。本地更改之后网站是没法变化的(因为就是在本地编辑的,不是编辑的网站),我们需要将与本地博客相关联的那个仓库更新,然后网页的那个博客才能更新

    安装前准备

    1. GitHub账号
    2. 安装Git
    3. 安装nodejs
    4. 安装hexo

    GitHub账号

    GitHub官网申请账号,并新建一个和自己名字相同的github.io仓库,比如我这里叫harrytea,就新建一个名为harrytea.github.io的仓库。仓库主要用来存储自己的博客文件

    安装Git

    这个大家自行搜索安装即可

    安装nodejs

    hexo是基于nodejs写的,这里安装nodejs,官方网站

    sudo apt-get install nodejs
    sudo apt-get install npm
    
    • 1
    • 2

    安装完后运行下面命令检查是否安装成功node -v npm -v

    安装hexo

    hexo是个人博客网站的框架,可以创建文章,修改主题等,官方网站

    npm install hexo-cli -g
    
    • 1

    这个命令可能会报错,如果报错根据错误提示命令改为sudo npm install hexo-cli --location=global,然后输入hexo -v检查是否安装成功

    Hexo配置

    本地基本设置

    在本地创建一个叫做blog文件夹(其他名字也可以),并用hexo初始化此文件夹

    hexo init hexo-blog
    cd hexo-blog
    npm install
    
    • 1
    • 2
    • 3

    安装完后启动hexo,查看当前网页主题

    hexo g
    hexo server
    
    • 1
    • 2

    此时会打开http://localhost:4000网页,你就能看到你本地的网页了(注意只是本地网页的效果)

    更换主题

    配置完hexo之后,我们需要更换主题,有很多主题的选择,官网主题,这里介绍两个主题的使用NexT以及Fluid

    NexT

    主题安装

    cd hexo-blog
    git clone https://github.com/iissnan/hexo-theme-next themes/next
    
    • 1
    • 2

    主题使用

    打开hexo-blog的_config.yml文件进行配置theme:next

    启动主题

    hexo g -d
    hexo s
    
    • 1
    • 2

    Fluid

    主题安装

    主题网站: 安装方法

    官网给了两种安装方法,命令行安装和手动安装,这里将手动安装方法copy了过来

    下载最新release版本解压到themes目录,并将解压出的文件重命名为fluid

    指定主题

    修改hexo博客目录中的_config.yml

    theme: fluid # 指定主题
    language: zh-CN # 指定语言,会影响主题显示的语言,按需修改
    
    • 1
    • 2

    创建「关于页」

    首次使用主题的「关于页」需要手动创建

    hexo new page about
    
    • 1

    创建成功后,编辑博客目录下/source/about/index.md,添加layout属性

    修改后的文件示例如下:

    ---
    title: about
    layout: about
    ---
    
    这里写关于页的正文,支持Markdown,HTML
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6

    启动主题

    hexo g -d
    hexo s
    
    • 1
    • 2

    编写自己的文章

    继续上面的fluid主题,修改hexo博客目录中的_coonfig.yml,这个配置是为了在生成文章的时候生成一个同名的资源目录用于存放图片文件

    post_assert_folder: true
    
    • 1

    例如创建一篇文章名为test

    hexo new post test
    
    • 1

    然后进入到source/_post目录下找相应的md和test文件夹即可,md写内容,test文件夹放图片

    下面演示三种图片引用方式: 官方推荐方式,markdown语法以及第三种,第三种和前两种的图片存放方式不同,图片是在/source/images目录下,并且在md文件中无法显示,在页面上可以正常显示,图片引用参考

    {% asset_img test.png 图片引用方法一 %}
    
    ![图片引用方法二](test.png)
    
    ![图片引用方法三](/images/test.png)
    
    • 1
    • 2
    • 3
    • 4
    • 5

    主题启动

    hexo g -d
    hexo s
    
    • 1
    • 2

    个性化页面展示

    浏览器Tab名称

    修改_config.ymltitle字段

    # Site
    title: Hexo
    subtitle: ''
    description: ''
    keywords:
    author: John Doe
    language: en
    timezone: ''
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8

    博客标题

    修改themes\fluid_config.ymlblog_title字段

    主页正中间的文字

    主题目录themes\fluid_config.ymltext字段

    添加阅读量统计

    注册leancloud账号并实名认证等

    然后在应用选项处点击创建应用,选择开发版,在设置-应用凭证处找到AppID和AppKey记录下来以后使用

    修改fluid设置

    themes\fluid下的_config.yml文件下修改下面配置

    web_analytics:
      enable: true # 改为true
      
      leancloud:
        app_id: xxx # 把刚才的appid复制过来
        app_key: xxx # 把刚才的appkey复制过来
        
        views:
          enable: true
          source: "leancloud" # 改为leancloud
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10

    修改网站底部的PV UV统计数

      statistics:
        enable: true
        source: "leancloud"
        pv_format: "总访问量 {} 次"
        uv_format: "总访客数 {} 人"
    
    • 1
    • 2
    • 3
    • 4
    • 5

    添加评论

    修改themes\fluid下的_config.yml文件

      comments:
        enable: true
        type: valine
    
    • 1
    • 2
    • 3

    配置leancloud的appid和appkey

    valine:
      appId: xxx
      appKey: xxx
    
    • 1
    • 2
    • 3

    发布到GitHub Pages

    部署

    下面用netlify部署

    首先在GitHub上创建一个仓库,随后复制刚才的GitHub地址,进入到本地的blog根目录,将二者关联起来

    # https://github.com/name/your-Repository.git
    git init
    git remote add origin https://github.com/name/your-Repository.git
    
    • 1
    • 2
    • 3

    然后在.gitignore中写我们不想推送的文件

    .DS_Store
    Thumbs.db
    db.json
    *.log
    node_modules/
    public/
    .deploy*/
    themes/
    _multiconfig.yml
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9

    之后推送即可,然后在hexo的_config.yml中找到deploy项,并添加分支run-page

    deploy:
      type: git
      repository: git@github.com:name/your-Repository.git
      branch: run-page
    
    • 1
    • 2
    • 3
    • 4

    退出重新执行一下

    hexo clean # 清理各种缓存和旧文件
    hexo g # 生成静态文件
    # 同步到github的run-page分支
    hexo d # 部署应用
    
    # 出现如下错误
    # $ ERROR Deployer not found: git
    # 安装依赖解决错误
    npm install hexo-deployer-git --save
    hexo d # 重新部署
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10

    此时进入github,你的仓库就会多出一个分支run-page

    托管到netlify

    这一步是最关键的,首先进入到netlify官网注册一下账号

  • 相关阅读:
    【已解决】CentOS7 启动tomcat服务器,提示Tomcat started,但实际服务未启动成功(失败原因与图片服务器配置和用户权限有关)
    低代码招投标应用:全程不见面,一次都不跑,快速优化招投标流程
    leetcode:面试题 08.13. 堆箱子【自顶而下的dfs + memory or 自底而上的排序 + dp】
    网络编程socket相关错误号及信息的获取
    c语言从入门到实战——函数递归
    Flink Hive Catalog操作案例
    R语言ggplot2可视化:使用ggpubr包的ggline函数可视化折线图(点线图、line plot)、同一水平的多个点用线连接起来
    力扣第332题 重新安排行程 c++ 难
    简单、安全高效的数字文档管理解决方案让您的财务部门摆脱压力
    一文读懂RPA是什么?互联网运营如何学习RPA
  • 原文地址:https://blog.csdn.net/weixin_41978699/article/details/126261808