Don't show the "description" in the blog post

[benlindsay]

I like to have short summaries/descriptions of my blog posts show up in the home page listing all the blog posts, but I don't want them to show up in the blog posts themselves. I can't figure out how to configure that. For example, I have this at the top of a blog post's index.qmd file:

---
title: "Analyzing Larger-than-Memory Data on your Laptop"
author: "Ben Lindsay"
date: "2017-03-10"
categories:
  - "python"
  - "recommender systems"
  - "dask"
  - "pandas"
  - "big data"
description: "Dask is an amazing Python library that lets you do all your Pandas-style dataframe manipulations with just a few simple tweaks so you don't have to worry about Jupyter freezing up."
---

Here's how that shows up in the post listings, as desired:

But then in that post, I don't want that description (the highlighted part) cluttering up the head of the post

Is there a way to configure that so the summary shows up in the post listing but not in the post itself?

[mcanouil]

Quickly, my first thought would be to modify the title-block.html partial (https://quarto.org/docs/journals/templates.html#html-partials).

[benlindsay]

Thanks for this! So looking here:

quarto-cli/src/resources/formats/html/templates/title-block.html

Lines 18 to 25 in bf943ee

	$if(hide-description)$
	$elseif(description)$
	<div>
	<div class="description">
	$description$
	</div>
	</div>
	$endif$

it looks like there's a "hide-description" variable that can hide the description, and looking here:

quarto-cli/src/project/types/book/book-render.ts

Lines 178 to 179 in 1152cf9

	// Since this is a book page, we need to suppress rendering of the description
	file.recipe.format.metadata[kHideDescription] = true;

it kinda looks like rendering to books makes use of that. So maybe a hook like that can be used for rendering websites too?

For now, I'm going with a simpler CSS hack that avoids dealing with the templates

[benlindsay]

@mcanouil Do you think it would make sense to create a new issue/feature request from this discussion? Happy to do that if it would be welcome.

[dragonstyle]

You are exactly correct, BTW- specifying hide-description: true in your document (or in a _metadata.yml for your posts folder) will prevent the display of the description. It looks like this slipped through the cracks as far as documentation / YAML validation. An issue would very much be appreciated - I will get it fixed for 1.3.

[benlindsay]

For my use case, adding this to the styles.css file did the trick:

#quarto-document-content .description {
  display: none
}