mmistakes / minimal-mistakes

:triangular_ruler: Jekyll theme for building a personal site, blog, project documentation, or portfolio.
https://mmistakes.github.io/minimal-mistakes/
MIT License
12.39k stars 25.56k forks source link

Pagination is enabled, but I couldn't find an index.html page to use as the pagination template. #380

Closed healiseu closed 8 years ago

healiseu commented 8 years ago

Hi Michael, first I would like to express my gratitude for the effort you put to make your theme attractive and easy to follow with minimal mistakes ;-)


Environment informations


Expected behavior

I was not expecting to get this message

Pagination: Pagination is enabled, but I couldn't find an index.html page to use as the pagination template. Skipping pagination.

Steps to reproduce the behavior

My public repository is healiseu

I forked your master repository and changed permalink of my home.md to the root folder (/) in order to force generation of index.html inside the _site folder.

I had to erase the index.html from the master branch of your release to make it work.

In my _config.yml file the following lines are without comments

paginate: 5
paginate_path: /page:num/
mmistakes commented 8 years ago

Thanks!

The theme defaults to a homepage index with paginated posts. The file that builds that is <root>/index.html. If you're adding _pages/home.md with a permalink of / then you're essentially telling Jekyll to build two homepage indexes, one overriding the other.

The fact that one of them is a Markdown file is also causing problems with the jekyll-paginate plugin.

As per Jekyll's docs in regards to pagination.

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.

If you want the paginated homepage then remove _pages/home.md and move that content into <root>/index.html.

If you don't want a paginated homepage then just remove <root>/index.html and the error will go away since you shouldn't be using paginator.posts anymore.

healiseu commented 8 years ago

Good morning Michael, thank you for your prompt reply, I don't want a paginated homepage and I have already removed <roor>/index.html the error disappears when you comment out these lines at _config.yml

paginate: 5
paginate_path: /page:num/

Nevertheless I might need pagination in listing posts, collections, etc. I will have to add more posts and collection files to test that.

mmistakes commented 8 years ago

I don't think that's possible. The Jekyll pagination plugin is kind of limited. It only really works with a page at the root of your site. Trying to use it in multiple locations, collections, categories, etc. will likely produce that error.

There are other Jekyll plugins that take a stab at pagination but sadly none of them are supported with GitHub Pages (if you're hosting there).

Closing as this is an issue with the core of Jekyll/plugins and not the theme.