From a0bf41cc7f612d049f8a5c33330f09f756484d41 Mon Sep 17 00:00:00 2001 From: George <31376482+george-gca@users.noreply.github.com> Date: Sun, 19 Mar 2023 09:43:02 -0300 Subject: [PATCH] Added related_posts false to the announcements front matter (#1266) Added `related_posts: false` to the announcements front matter to avoid errors like #1203. Also included explanation in README FAQ section. --- README.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README.md b/README.md index 8a5d19e72558..1949a6090f3a 100644 --- a/README.md +++ b/README.md @@ -394,6 +394,15 @@ If you have a different question, please ask using [Discussions](https://github. RSS Feed plugin works with these correctly set up fields: `title`, `url`, `description` and `author`. Make sure to fill them in an appropriate way and try again. +5. **Q:** My site doesn't work when I enable `related_blog_posts`. Why?
+ **A:** This is probably due to the [classifier reborn](https://github.com/jekyll/classifier-reborn) plugin, which is used to calculate + related posts. If the error states `Liquid Exception: Zero vectors can not be normalized...`, it means that it could not calculate related + posts for a specific post. This is usually caused by [empty or really small blog posts](https://github.com/jekyll/classifier-reborn/issues/64) + without meaningful words (i.e. only [stop words](https://en.wikipedia.org/wiki/Stop_words)) or even + [specific characters](https://github.com/jekyll/classifier-reborn/issues/194) you used in your posts. Also, the calculus for similar posts are + made for every `post`, which means every page that uses `layout: post`, including the announcements. To change this behavior, simply add + `related_posts: false` to the front matter of the page you don't want to display related posts on. + ## Features