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.
This commit is contained in:
George 2023-03-19 09:43:02 -03:00 committed by GitHub
parent 1701a23c8d
commit 45c3d91b69
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 12 additions and 0 deletions

View File

@ -389,6 +389,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`. 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. 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? <br>
**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 ## Features

View File

@ -2,6 +2,7 @@
layout: post layout: post
date: 2015-10-22 15:59:00-0400 date: 2015-10-22 15:59:00-0400
inline: true inline: true
related_posts: false
--- ---
A simple inline announcement. A simple inline announcement.

View File

@ -3,6 +3,7 @@ layout: post
title: A long announcement with details title: A long announcement with details
date: 2015-11-07 16:11:00-0400 date: 2015-11-07 16:11:00-0400
inline: false inline: false
related_posts: false
--- ---
Announcements and news can be much longer than just quick inline posts. In fact, they can have all the features available for the standard blog posts. See below. Announcements and news can be much longer than just quick inline posts. In fact, they can have all the features available for the standard blog posts. See below.

View File

@ -2,6 +2,7 @@
layout: post layout: post
date: 2016-01-15 07:59:00-0400 date: 2016-01-15 07:59:00-0400
inline: true inline: true
related_posts: false
--- ---
A simple inline announcement with Markdown emoji! :sparkles: :smile: A simple inline announcement with Markdown emoji! :sparkles: :smile: