没有主题的杰基尔

Question

我正在尝试创建一个静态网站。我希望能够进行一些简单的预处理，例如在不使用 PHP 或 JavaScript.

的情况下将一页包含在另一页中

Jekyll 似乎非常适合这个，特别是考虑到它在 GitHub 页上的支持。

然而，在尝试了几个主题并尝试将它们调整为我喜欢的主题之后，我发现自己与这些主题作斗争，这些主题使它们成为障碍而不是帮助。因此，我决定尝试在没有它们的情况下工作，只使用 Jekyll 作为一个花哨的预处理器和插件平台（用于诸如 jekyll-redirect-from 之类的东西）。

令我惊讶的是，我找不到任何有关如何执行此操作、如何以及在何处放置哪些文件以生成可用站点的信息。感觉这应该非常简单，但到目前为止我发现的唯一途径是创建我自己的主题。这对我来说似乎太过分了。

TL;DR

如何在不使用主题的情况下创建 Jekyll 站点？我在哪里可以找到我需要的文件、位置、文件中需要什么等信息？

Answer 1

您可以使用 --blank 选项调用 jekyll new 命令，如 command line usage section of the docs 中所述。

这样 Jekyll 会生成一个包含空文件夹和文件的基本项目。

现在开始在 _layouts/my-fancy-layout.html 中创建您自己的布局：

<!DOCTYPE html>
<html>
  <head>
    <title>My Fancy Title</title>
  </head>
  <body>
    <p>Here comes my fancy content: </p>
    {{ content }}
  </body>
</html>

接下来向您的 index.html 添加一些内容并告诉它使用您的布局：

---
layout: my-fancy-layout
---
<h1>Hello, World!</h1>

这是具有自定义布局的基本 Jekyll 站点:)

进一步的步骤是：

阅读 Jekylls directory structure 了解每个文件的去向
将布局的复杂部分（如页眉或页脚）移动到 _include 目录和 include them in all your layouts
看看 variables section of the documentation 并在布局中使用 page.name 和 page.title

顺便说一句，我用这种方法创建了我的个人网站，而且效果很好。

没有主题的杰基尔

Jekyll without a theme

jekyll

jekyll-theme

TL;DR