如何在新的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's answer中所述，您需要修改_layout文件夹中的某些文件。假设您当前使用的是最小模板，只需将_layout文件夹复制到项目文件夹中，然后进行所需的修改即可。要找到最小模板的位置，只需在项目文件夹中运行以下命令

bundle show minima

要使用MathJax，可以遵循getting started guide。也就是说，只需将以下内容放在脑海中即可。

<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 page下载。与MathJax一样，您也可以配置KaTeX。请访问KaTeX GitHub页面，以查看如何从头开始重新编译katex.min.css文件以包括所需的更改。