blog-report

Hexo搭建个人博客使用总结

如图所示完成hexo搭建

遇到的问题

主要遇到的问题是公式显示和图片显示问题。

我选择的解决方案是：

公式：

• 卸载hexo-math：$ npm un hexo-math

• 替换渲染 $ npm un hexo-renderer-marked $ npm i hexo-renderer-pandoc

• 在hexo/_config.yml末尾添加一段代码

1
2
3
4
5
6

math:
 engine: 'mathjax' # or 'katex'
 mathjax:
   # src: custom_mathjax_source
   config:
     # MathJax config

• 修改next/_config.yml中mathjax的设置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# Math Formulas Render Support
math:
  # Default (true) will load mathjax / katex script on demand.
  # That is it only render those page which has `mathjax: true` in Front-matter.
  # If you set it to false, it will load mathjax / katex srcipt EVERY PAGE.
  per_page: false

  # hexo-renderer-pandoc (or hexo-renderer-kramed) required for full MathJax support.
  mathjax:
    enable: true
    # See: https://mhchem.github.io/MathJax-mhchem/
    mhchem: false

vendors:
  mathjax: //cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js?config=TeX-MML-AM_CHTML

最后$ hexo clean && hexo g -d# or hexo clean && hexo s，检验是否成功。

图片显示：采用site.url引用，例如![pipeline-tstcc]({{site.url}}/assets/img/pipeline-tstcc.png)

图片参考https://blog.csdn.net/2301_77285173/article/details/130189857 的方法二。

Jekyll直接作废了~~ 我只能做到本地部署成功，后面参考了多篇blog，但是个人界面一直显示404o(╥﹏╥)o

Jekyll 搭建个人博客使用总结

介绍

Jekyll 是一个简单的静态网站生成器，可以帮助快速搭建个人博客。它使用 Markdown 和 Liquid 模板语言来管理内容和页面布局，它具有以下优点：

1. 简单易用：Jekyll 使用 Markdown 和 Liquid 模板语言，使得创建和编辑内容变得简单而直观。Markdown 是一种轻量级标记语言，使得写作变得更加流畅；Liquid 则提供了灵活的模板语言，可以轻松管理网站的布局和内容。
2. 速度快：由于 Jekyll 是一个静态网站生成器，它在生成网页时不需要动态地构建页面，因此具有非常快的加载速度。这对于用户体验和 SEO 都非常有利。
3. 安全性高：与动态网站相比，静态网站具有更高的安全性。因为静态网站不涉及数据库或服务器端代码，所以减少了被攻击的风险。
4. 扩展性强：Jekyll 支持丰富的插件系统，可以通过插件扩展其功能。这意味着你可以根据自己的需求轻松地添加各种功能，如社交分享按钮、评论系统等。
5. 版本控制友好：由于 Jekyll 的网站是基于文件的，因此非常适合与版本控制系统（如 Git）一起使用。这使得团队合作变得更加轻松，可以轻松地管理和追踪网站内容的变更历史。
6. 易于部署：Jekyll 生成的网站是纯静态的 HTML、CSS 和 JavaScript 文件，可以轻松地部署到任何支持静态文件托管的平台上，如 GitHub Pages、Netlify 等。这意味着你无需担心服务器配置或数据库管理等复杂问题。

常规步骤

1. 安装 Jekyll

在安装 Jekyll 之前，安装了Ruby 和 RubyGems(https://rubyinstaller.org/downloads/),在弹出的命令行窗口中选择 “MSYS2 and MINGW development tool chain"。

然后执行以下命令安装 Jekyll：

1

gem install jekyll bundler

随后选择一个良好的blog模板，我选择Chirpy(https://github.com/cotes2020/jekyll-theme-chirpy/)，是因为它提供的多个元素满足了绝大多数blog的需求。

2. 主要可关注的内容

进入你的网站目录，编辑 _config.yml 文件以配置你的博客。你可以设置网站标题、描述、作者信息等。

3. 运行 Jekyll 服务器

在命令行中进入网站目录，并执行以下命令来启动 Jekyll 本地服务器：

1

bundle exec jekyll serve

这将启动一个本地服务器，即可访问 http://localhost:4000 来预览博客。

遇到的问题

主要遇到的问题是公式显示和图片显示问题。

我选择的解决方案是：

公式：下载mathjax(https://www.mathjax.org/ ) 并在文档头中署上 math: true

图片显示：采用site.url引用，例如![pipeline-tstcc]({{site.url}}/assets/img/pipeline-tstcc.png)

个人界面显示404：上传_site文件，url修改，清理缓存，重新生成均采用过，不知为何无法成功显示，故放弃jekyll。

Report — Apr 22, 2024