jekyll - 如何在单个 Jekyll 项目中组织多个输出？

Question

我使用 Jekyll 为软件产品创建文档。我有 30+
具有共同 LIQUID 模板但内容不同的不同产品。每个产品文档都有自己的目录 .

对于一个项目，一切正常。我有一个内容文件夹以及 css/js 文件夹。我运行“jekyll serve”并发布一个项目。

问题是，我不想让 30 个 Jekyll 项目一个接一个地存储，并使用类似的 css、configs、js 文件夹，并且只会在内容部分有所不同。

问题是:我怎样才能组织内部结构，以便我有一个
具有通用布局的单个项目和单个项目内的“x”个不同内容文件夹？

喜欢:

_产品1/

some_subdir

'topic.md'

_产品2/

some_subdir

'topic.md'

如果可能，我该如何管理输出？我需要分别发布产品 1 和产品 2 ... 产品“x”。

感谢您的帮助。

UPD:这是 GitHub 上的演示项目: https://github.com/plywoods/JekyllDocumentationDemo

Answer 1

在 Jekyll 中进行这种内容分离的方法是使用 Collections .

下面是一个使用 Collections 的 Jekyll 网站的例子:
https://github.com/netponto/netponto.github.io


_meetings , _members , 和 _sessions是不同的集合，类似于您的 _product1 , _product2 ， 等等。

You can customize the output / how the URL is going to be in the _config.yml 您的 Jekyll 网站。例如:

collections:
  meetings:
    output: true
    permalink: /reunioes/:path/
  sessions:
    output: true
    permalink: /sessoes/:path/

要显示集合的项目，例如“ session ”集合，您可以执行 something like this :

{% for session in site.sessions %}
  <p>{{ session.title }}</p>
{% endfor %}

如果您在实现集合时遇到问题，请在 GitHub 上汇总一个可重现的示例，以便其他人可以看到您尝试执行的操作并指出缺少的内容。