cfla's blog

配置博客

发表于 更新于 分类于 阅读次数： Valine：

博客配置 & 使用教程

简介

该博客使用Hexo框架，部署在GitHub Pages上，使用的主题为nexmoe。

本文章记录了配置博客和使用博客的一些细节，供以后的我参考。

持续更新中 ……

工作原理

在本地书写博客，使用hexo生成静态网页，部署到GitHub上，即可使用GitHub访问生成的静态网页。即我们看到的博客。

基本命令

  • 调试：

    hexo server --debug 在本地运行服务器程序，并将目录输出在shell中。该命令可用于在本地预览页面

  • 修改/发布博客 进行更新：

    hexo clean 清理缓存和public文件夹

    hexo g generate，生成静态页面，该操作之后即可在本地预览。

    hexo d deploy，部署，即部署到GitHub上，该操作之后可以使用浏览器访问。

  • 发布博客

    hexo new [layout] [title] 使用layout，在_post/title.md 的文件。使用这个命令而不是直接在文件夹里新建文件，是因为这样新建的文件有初始化的布局。

配置文件

  • 可以在 _config.yml 里配置Hexo，在 _config.nexmoe.yml 里配置nexmoe主题。

_config.yml :

  1. 配置 网站的标题、副标题、关键词、作者、语言、时区image-20220821111147069

  2. 部署设置，其中repository可以填ssh的链接（执行git clone 的链接），也可以填https的链接，https的链接在国内特别慢，一定要使用ssh的链接。image-20220821111400429

_config.nexmoe.yml：

  1. 网站的默认头图，头像，图标等均在这里配置。
  2. 如果要使用本地相对路径，./ 的绝对路径即博客根目录下的source文件夹。

front-matter

在这里可以配置文件的变量。

hexo 的文档：Front-matter | Hexo

nexmoe 的私有 front-matter 文档：Front-matter | Hexo Theme Nexmoe

  1. 如果需要配置文章头图，可以在markdown文件开始加上以下代码，图片大小为1600 * 900

    1
    2
    3
    4
    5
    6
    --
    title: <title>
    others...

    cover: 图片链接
    ---

  2. 配置分类和标签要像这样配置：

    1
    2
    3
    4
    5
    categories:
    - Diary
    tags:
    - PS3
    - Games

    其中分类categories最好明确且只有一个，而标签tags可以有多个且没有顺序，详情请见这里

widgets

  1. 关于 “文件归档”：归档页面 | Hexo Theme Nexmoe
  2. 关于 “关于博客”：是./ 目录下的一个markdown文件，与其他博文相同。
  3. 其他部件可以在_config.nexmoe.yml 里配置

评论系统

nexmoe 支持几种评论系统，其中利用GitHub issue的gitment和gitalk，都因为墙的问题无法使用，所以本博客使用 Valine ，使用方法非常简单，按照Valine的官方手册一步步操作即可。

资源

iconfont-阿里巴巴矢量图标库

使用mathjax渲染inline latex

(1条消息) 在HEXO博客中使用LaTeX公式的简单方法_Loy_Fan的博客-CSDN博客

参考文档

Hexo参考文档

Nexmoe 参考文档

nexmoe GitHub地址

从零开始搭建个人博客（超详细） - 知乎 (zhihu.com)

Hexo-Next主题配置教程 | Ben’s Blog (benn314.github.io) （2023/3/23添加）