diff --git a/CHANGELOG.md b/CHANGELOG.md index 9b3dd033..265906b8 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -18,6 +18,7 @@ - Add `after-content.html` and `before-related.html` includes to ease docs site overrides. - GitHub Workflows security hardening [#3884](https://github.com/mmistakes/minimal-mistakes/issues/3884) - Replace Font Awesome v5 search page with v6. +- Try adding an FAQ page. ## [4.25.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.25.0) diff --git a/docs/_data/navigation.yml b/docs/_data/navigation.yml index 5398e474..6893b59c 100644 --- a/docs/_data/navigation.yml +++ b/docs/_data/navigation.yml @@ -78,6 +78,8 @@ docs: url: /docs/javascript/ - title: Meta children: + - title: "FAQ" + url: /docs/faq/ - title: "History" url: /docs/history/ - title: "Contributing" diff --git a/docs/_docs/05-configuration.md b/docs/_docs/05-configuration.md index 9e534c18..c8b6ffb7 100644 --- a/docs/_docs/05-configuration.md +++ b/docs/_docs/05-configuration.md @@ -1040,9 +1040,16 @@ The paginator only works on files with name `index.html`. To use pagination in a paginate_path: /recent/page:num/ ``` -**Please note:** When using Jekyll's default [pagination plugin](https://jekyllrb.com/docs/pagination/) `paginator.posts` can only be called once. If you're looking for something more powerful that can paginate category, tag, and collection pages I suggest [**jekyll-paginate-v2**](https://github.com/sverrirs/jekyll-paginate-v2). +**Please note:** When using Jekyll's default [pagination plugin](https://jekyllrb.com/docs/pagination/) `paginator.posts` can only be called once. If you're looking for something more powerful that can paginate category, tag, and collection pages, [**jekyll-paginate-v2**](https://github.com/sverrirs/jekyll-paginate-v2) is the way to go. {: .notice--info} +#### Using Jekyll Paginate V2 + +Jekyll Paginate V2 is not available on GitHub Pages. You must build your site locally or with a CI service like [GitHub Actions][gh-pages-actions]. +{: .notice--info} + + [gh-pages-actions]: https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#publishing-with-a-custom-github-actions-workflow + ### Timezone This sets the timezone environment variable, which Ruby uses to handle time and date creation and manipulation. Any entry from the [IANA Time Zone Database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) is valid. The default is the local time zone, as set by your operating system. diff --git a/docs/_docs/18-history.md b/docs/_docs/18-history.md index fff8d8c7..c87563a3 100644 --- a/docs/_docs/18-history.md +++ b/docs/_docs/18-history.md @@ -5,7 +5,7 @@ permalink: "/docs/history/" excerpt: Change log of enhancements and bug fixes made to the theme. sidebar: nav: docs -last_modified_at: '2024-04-24T00:51:32+08:00' +last_modified_at: '2024-04-26T00:43:39+08:00' toc: false --- @@ -33,6 +33,7 @@ toc: false - Add `after-content.html` and `before-related.html` includes to ease docs site overrides. - GitHub Workflows security hardening [#3884](https://github.com/mmistakes/minimal-mistakes/issues/3884) - Replace Font Awesome v5 search page with v6. +- Try adding an FAQ page. ## [4.25.0](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.25.0) diff --git a/docs/_docs/22-faq.md b/docs/_docs/22-faq.md new file mode 100644 index 00000000..f41f7fc1 --- /dev/null +++ b/docs/_docs/22-faq.md @@ -0,0 +1,18 @@ +--- +title: Frequently Asked Questions +classes: wide +permalink: "/docs/faq/" +sidebar: + nav: docs +last_modified_at: '2024-04-24T00:51:32+08:00' +toc: false +--- + +This page is still under construction. Meanwhile, check out existing [issues](https://github.com/mmistakes/minimal-mistakes/issues) and [discussions](https://github.com/mmistakes/minimal-mistakes/discussions) to see if your question has already been asked before. +{: .notice--primary } + +- `'require': cannot load such file -- webrick (LoadError)` + + This error occurs when you run `jekyll serve` on Ruby 3.0+. + + Ruby 3.0 no longer comes with Webrick by default. To fix this, add `gem "webrick"` to your `Gemfile` and run `bundle install`. See [jekyll/jekyll#8523](https://github.com/jekyll/jekyll/issues/8523)