使用Hexo搭建个人博客

本文最后更新于:2023年1月20日 下午

配置使用环境

  1. 安装npm
  2. 安装git
  3. 配置Github pages

一键部署hexo博客

1.安装 hexo-deployer-git

npm install hexo-deployer-git --save

2.修改配置

deploy:
  type: git
  repo: <repository url> # github pages 仓库地址
  branch: [branch] # 分支名称 gh-pages (GitHub) 、coding-pages (Coding.net) 、master (others)
  message: [message] # 自定义提交信息

3.执行 hexo clean && hexo deploy,生成站点文件并推送至远程库。

4.登入 Github,在库设置(Repository Settings)中将Github page服务的分支设置为_config.yml配置中的分支名称。稍等片刻,您的站点就会显示在您的Github Pages中。

设置hexo支持Latex公式

网页上对Latex的支持需要借助能够解析Latex语法的插件引擎,将Latex语法转成HTML元素,常用的Latex公式引擎有Katex,mathjax引擎等,如CSDN使用的就是Katex,我们选择mathjax,这样渲染的公式更加好看。

1.删除原有的渲染引擎,改为pandoc,并安装mathjax插件

npm uninstall hexo-renderer-marked
npm install hexo-renderer-pandoc
npm install hexo-filter-mathjax

2.安装pandoc

3.修改站点_config.yaml文件,注意不是themes中的_config.yaml

mathjax:
  tags: none # or 'ams' or 'all'
  single_dollars: true # enable single dollar signs as in-line math delimiters
  cjk_width: 0.9 # relative CJK char width
  normal_width: 0.6 # relative normal (monospace) width
  append_css: true # add CSS to pages rendered by MathJax
  every_page: false # if true, every page will be rendered by MathJax regardless the `mathjax` setting in Front-matter

5.在需要使用latex的页面.md头部加入mathjax: true


使用Hexo搭建个人博客
http://agustletmen.github.io/2023/01/11/hexo/
作者
Agust
发布于
2023年1月11日
更新于
2023年1月20日
许可协议