如何在新的Jekyll中使用Latex？ （基于宝石的主题最小值）

Question

https://jekyllrb.com/docs/extras/和http://www.gastonsanchez.com/visually-enforced/opinion/2014/02/16/Mathjax-with-jekyll/都需要_layout目录，该目录不能找到。 尽管已在_config.yml中设置了Kramdown https://kramdown.gettalong.org/syntax.html#block-boundaries也不起作用。

有人可以帮忙吗？

Answer 1

在Jekyll中，_layout是Jekyll网站布局的存储位置。 使用主题时，它将使用该主题的布局文件。 您在_layout文件夹中添加的任何文件都将覆盖主题布局文件。

1. 要修改主题所用的默认布局，您需要首先创建一个_layout文件夹，然后创建一个空白的default.html。
2. 然后找到您主题的github存储库并将html从_layout / default.html复制到您的文件中
3. 将所需的LaTex脚本代码添加到标题中。

有关自定义Jekyll主题的github文档。 https://help.github.com/articles/customizing-css-and-html-in-your-jekyll-theme/#customizing-your-jekyll-themes-html-layout

Answer 2

到目前为止，我知道包括LaTeX类似的最佳解决方案（这不是真正的TeX代码）是MathJax和KaTeX。 我喜欢后者，但这显然是个人品尝的问题。

如Tim的回答所述，对于这两个文件，您都需要修改_layout文件夹中的_layout文件。 假设当前使用的是最小模板，只需将_layout文件夹复制到项目文件夹中，然后进行所需的修改即可。 要找到最小模板的位置，只需在项目文件夹中运行以下命令

bundle show minima

为了使用MathJax，您可以按照入门指南进行操作 。 也就是说，只需将以下内容放在脑海中。

<script src='https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.4/latest.js?config=TeX-MML-AM_CHTML' async></script>

显然，您可以对其进行配置以具有更多功能，但这足以使您入门。

相反，包含KaTeX会比较麻烦，因为公式通常是在服务器端呈现的。 因此，您必须在Jekyll内部执行它。 有几个插件可以简化包含过程。 就我而言，效果最好的是jekyll-katek-block 。 基本上，所需的唯一步骤是：

1. 将katex_block.rb放在_plugins文件夹中

2. 将katex.min.js存储在您网站上的任何位置。 默认值为/public/js/katex.min.js ，否则您必须修改_config.yml添加

    katex: path_to_js: "./your/path/to/katex/js" 

3. （几乎是可选的）链接katek.min.css和字体。

katex.min.js ， katex.min.css和字体可以从KaTeX GitHub页面下载。 与MathJax一样，您也可以配置KaTeX。 访问KaTeX GitHub页面，了解如何从头开始重新编译katex.min.css文件以包括所需的更改。