List page having blank cards in the article card array

[f-hollow]

Checklist

• Checked the issue tracker for similar issues to ensure this is not a duplicate.
• Provided a clear description of your suggestion.
• Included any relevant context or examples.

Issue or Suggestion Description

The article card array has gaps as shown in the screenshot:

Issue analysis

Obviously, the blank cards appear in front of the article cards that have links in content summaries:

• Heading titles, such as # Introduction
• Links to another page, such as Espressif’s Secure Manufacturing Service

Hugo version

This issue appeared after upgrading Hugo v0.120.4 to v0.135.0.

Proposed fixes

• Avoid adding heading titles right after front matter
• Avoid adding links in the first paragraph
• If links or heading title are needed at the beginning of an article, add a manual summary or front matter summary (for details, see the content summaries link above)

Follow-up actions

Suggest applying the proposed fixes to all problematic articles.

[pedrominatel]

Is this issue still present after the last update?

[f-hollow]

Is this issue still present after the last update?

The issue is still present.

Hugo expects the summaries to be in plain text. It is done intentionally to avoid code blocks, pictures, tables, etc., in article summaries. I agree that this is a good approach. Those who came across an article and started reading a summary are interested in what they can learn from an article, they are most likely not ready to click any links leading elsewhere before they open the article.

[f-hollow]

We eradicated these issues by applying the following measures:

• In Feat/style and publish front matter summary in article #402, we changed the default value of showSummary to true.
  • As the PR description explains, the blank cards appeared because Hugo generated automatic summaries for articles.
  • This PR updates the single template and forces Hugo to use the summary from the YAML frontmatter. For older articles, that do not have a summary field in the front matter, the summary will be empty.
• In feat: add check for summary and update contribution guide #475, we implemented:
  • Validation of presence of the summary field in the YAML frontmatter, indirectly urging authors to add such a summary.
  • Added informative guidelines on how to write a summary in archetypes/blog.md making it easy for authors to write summaries.

As these measures effectively resolve the issue, we can close it now.