Hexo blog: guide & tips

用Hexo搭建了本博客,加入多说评论、Mathjax数学公式、目录支持,修正了语言显示,添加了图标。在此记录参考的链接、遇到的问题和解决方案。

UPDATE 2021/03/26 本文有很多过时的信息。

原理

Hexo结合模板,将用Markdown书写的文本转换成html,将html提交到Github。

命令

new

hexo n [layout] <title>

generate

hexo g

publish

hexo p [layout] <filename>

server

hexo s

网址:http://localhost:4000/

选项-s:只使用静态文件

deploy

hexo d

选项-g:部署之前先生成静态文件

clean

hexo clean

list

hexo l <type>

安装和初始化

文档 | Hexo

language设置为defaultthemes/landscape/languages中的那些,否则会显示法语。

评论

创建站点 - 多说,社会化评论框 Hexo使用多说教程

  • 文中提到的_config.yml是主目录下的,不是themes下的。
  • 修改_config.yml在重新hexo s后才生效。

图标

在主目录或对应主题的source目录下加入文件,设置主题_config.ymlfavicon

Mathjax

搭建一个支持LaTEX的hexo博客 - Platonic Time

摘要

在文本中使用<!--more-->标记摘要结束的地方。

目录

图灵社区:阅读:Hexo站点中添加文章目录以及归档

这篇文章有两个地方需要修正: - 用post替换item。 - item.toc !== false改为!index && post.toc。进入这个else子句时index可能为true,而我们通常不希望在首页生成目录。

页面

使用hexo n page <filename>命令,并在主题设置文件的menu中添加该页,以在header中显示。

其他

  • 文章标题中有井号等特殊字符,将整个标题用双引号引起来。