如何在没有 index.html 的情况下使用 Jekyll-paginate？

Question

我正在尝试在 Github 页面上构建我的博客，出于显而易见的原因，我必须使用 Jekyll-paginate。问题是，除了欢迎页面之外，我不使用 index.html 页面。我在名为 articles 的文件夹中有一个名为 index.html 的单独页面，因此博客的 url 应该是 xyz.github.io/articles/。

然而，这带来了一个主要问题 - 显然 jekyll-paginate 拒绝在博客的根目录中没有显式 index.html 的情况下工作。因此，我尝试使用没有此类限制的 jekyll-paginate-v2，并且效果很好！

然而，github 页面不支持 jekyll-paginate-v2，因此，我又回到了第 1 个方块。我该怎么办？

注意：这是我的代码：

index.md

---
layout: home
title: SomuSysAdmin
---

If you're new to this site and have no idea what's going on, first go and read the [About](about.md) section of the blog.

Here's a list of all the major articles this blog contains: 

## [Red Hat Certified Systems Administrator (RHCSA) Guide]({% post_url 2017-09-11-RHCSA %})

这是我的 _config.yml:

# -----------------------------------------------------------------------------
#  User configuration
# -----------------------------------------------------------------------------

title:               SomuSysAdmin

# The unique resource location of your page.
# Set to `https://<username>.github.io` when hosting on GitHub Pages
url:                 https://somuSysAdmin.github.io

# Set to '' when hosting a blog on GitHub Pages, ie on `//<username>.github.io`
# Set to '/<reponame>' when using the `gh-pages` branch of a repository
baseurl:             ''

# A very short description of your page
tagline:             Easiest way to earn some SysAdmin mojo!

# A short description of the page, used in the sidebar and as fallback for the meta description tag.
# Markdown enabled, but don't use more than one paragraph (enforced by `>`)
description:         >
  A short set of notes and pointers concerning everything I know about System Administration.
# This should be the same author as first entry in `_data/authors.yml`
author:
  name:              Somenath Sinha
  email:             somu.sysa_fakeID@gmail.com

# Fallback image and color
image:               /assets/img/nap.jpg
color:               '#4ea97e'

# The font used for headings. Expects a string that is a valid CSS font-family value.
font_heading:        "'Roboto Slab', Helvetica, Arial, sans-serif"

# The text font. Expects a string that is a valid CSS font-family value.
font:                "'Noto Sans', Helvetica, Arial, sans-serif"

# The string encoding what fonts to fetch from Google Fonts.
# See: https://qwtel.com/hydejack/docs/configuration/
google_fonts:        Roboto+Slab:700|Noto+Sans:400,400i,700,700i

# If you do not use a Google Fonts, uncomment the line below
# no_google_fonts:     true

# Set your Google Analytics id to receive `pageview` events.
# To remove Google Anaylics from your page, remove the line below.
google_analytics:    <UA-XXXXXXXX-X>

# Setting a disqus shortname will enable the comment section on pages with `comments: true` in the front matter
disqus_shortname:    somusa

# This text will appear in the footer of every page. Markdown enabled.
copyright:           '&copy; 2017 Somenath Sinha. All rights reserved.'

# Format of the permalinks
permalink:           pretty

# Pagination configuration (used by the `blog` layout)
paginate:            5
paginate_path:       '/page-:num/'

# If you are upgrading form a v5 verison of Hydejack, uncomment the two lines below,
# so that the location of the feed XML stays the same.
# feed:
#   path:              atom.xml

# Set to true when building with the `--lsi` option
# See: https://jekyllrb.com/docs/variables/#site-variables
# use_lsi:             true

# Set to `true` if you don't want to show an icon after each link that opens to an external site
# no_mark_external:    true

# Uncomment this line if third party plugins fail to work with dynimically loaded pages
# disable_push_state:  true

# Uncomment this line if want to disable the touch drawer on mobile
# disable_drawer: true

# -----------------------------------------------------------------------------
#  Collections
# -----------------------------------------------------------------------------

collections:
  featured_categories:
    permalink:       /category/:name/
    output:          true
  featured_tags:
    permalink:       /tag/:name/
    output:          true
  projects:
    permalink:       /projects/:path/
    output:          true

# -----------------------------------------------------------------------------
#  Advanced configuration
# -----------------------------------------------------------------------------

gems:
  - jekyll-default-layout
  - jekyll-feed
  - jekyll-optional-front-matter
  - jekyll-paginate
  - jekyll-redirect-from
  - jekyll-relative-links
  - jekyll-sitemap

exclude:
  - README.md
  - node_modules
  - package.json
  - package-lock.json
  - Gemfile
  - Gemfile.lock

kramdown:
  footnote_backlink: '&#x21a9;&#xfe0e;'
  math_engine:       mathjax
  math_engine_opts:
    preview:         true
    preview_as_code: true

compress_html:
  comments:          ["<!-- ", " -->"]
  clippings:         all
  endings:           all
  ignore:
    envs:            [development]

sass:
  style:             compressed

这是我的articles/index.md的内容：

---
layout  : blog
title   : Articles
menu    : true
order   : 1
---

那么，有什么方法可以在不使用显式 index.html 的情况下使用 jekyll-paginate 吗？

下面是当我尝试在我现在的博客上运行 jekyll 而没有 index.html 时发生的情况：

$ bundle exec jekyll serve --incremental
Configuration file: D:/Git/blog/_config.yml
      Deprecation: The 'gems' configuration option has been renamed to 'plugins'. Please update your config file accordingly.
      Source: D:/Git/blog
      Destination: D:/Git/blog/_site
Incremental build: enabled
    Generating...
      Pagination: Pagination is enabled, but I couldn't find an index.html page to use as the pagination template. Skipping pagination.
                    done in 1.736 seconds.
Please add the following to your Gemfile to avoid polling for changes:
    gem 'wdm', '>= 0.1.0' if Gem.win_platform?
Auto-regeneration: enabled for 'D:/Git/blog'
  Server address: http://127.0.0.1:4000/
  Server running... press ctrl-c to stop.

如您所见，分页根本不起作用！那么，我该如何解决它？我是markdown 和 jekyll 的新手，所以我什至可能遗漏了一些明显的东西！请帮我解决一下！

Answer 1

documentation for Jekyll pagination 说：

Pagination only works within HTML files

Pagination does not work from within Markdown or Textile files from your Jekyll site. Pagination works when called from within the HTML file, named index.html, which optionally may reside in and produce pagination from within a subdirectory, via the paginate_path configuration value.

因此，如果您希望您的博客出现在 URL /articles/ 和 /articles/N/ 上，请在您的配置中指定：

paginate_path: "/articles/:num/"

并在 articles 目录中放置一个 index.html 文件，其中列出了当前页面的帖子：

<!-- This loops through the paginated posts -->
{% for post in paginator.posts %}
  <h1><a href="{{ post.url }}">{{ post.title }}</a></h1>
  <p class="author">
    <span class="date">{{ post.date }}</span>
  </p>
  <div class="content">
    {{ post.content }}
  </div>
{% endfor %}

<!-- Pagination links -->
<div class="pagination">
  {% if paginator.previous_page %}
    <a href="{{ paginator.previous_page_path }}" class="previous">Previous</a>
  {% else %}
    <span class="previous">Previous</span>
  {% endif %}
  <span class="page_number ">Page: {{ paginator.page }} of {{ paginator.total_pages }}</span>
  {% if paginator.next_page %}
    <a href="{{ paginator.next_page_path }}" class="next">Next</a>
  {% else %}
    <span class="next ">Next</span>
  {% endif %}
</div>

（有关更多代码段和配置详细信息，请参阅 documentation。）

编辑： 我认为你的问题是你的 paginate_path 设置。您将其设置为 '/page-:num/'，因此 Jekyll Paginate 在您的站点根目录中查找 index.html。

Answer 2

对我来说 solution 是：

如果你想让你的博客页面完全在 index.html 之外，你需要做什么。

blog                   # New directory
└── index.html         # Your new blog page

在您的 blog/index.html 中，您需要添加将呈现博客页面的内容（home 布局是您拥有 paginator.posts 的位置）

---
layout: home
title: Blog
permalink: /blog/
---

然后确保您的 _config.yml 中有分页器配置：

# PAGINATION
paginate: 5
paginate_path: "/blog/page:num"

如何在没有 index.html 的情况下使用 Jekyll-paginate？

How to use Jekyll-paginate without index.html?

markdown

jekyll

github-pages

github-flavored-markdown

jekyll-paginator

index.md

这是我的 _config.yml:

这是我的articles/index.md的内容：