Ensure that description is not displayed on each page when specified globally

Fixes #2286

Author: dragonstyle

news/changelog-1.2.md

@@ -37,6 +37,7 @@
 ## Books
 
 - Fix issue that caused incomplete search indexes for books
+- Don't display the book description in each chapter's title block
 
 ## Publishing
 

src/config/constants.ts

@@ -414,6 +414,7 @@ export const kDoi = "doi";
 export const kAbstract = "abstract";
 export const kAbstractTitle = "abstract-title";
 export const kDescription = "description";
+export const kHideDescription = "hide-description";
 export const kTocTitle = "toc-title";
 export const kTocLocation = "toc-location";
 export const kLang = "lang";

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

@@ -22,6 +22,7 @@ import {
   kDate,
   kDescription,
   kDoi,
+  kHideDescription,
   kNumberSections,
   kOutputExt,
   kOutputFile,
@@ -87,6 +88,7 @@ import { removePandocTo } from "../../../command/render/flags.ts";
 import { resourcePath } from "../../../core/resources.ts";
 import { PandocAttr, PartitionedMarkdown } from "../../../core/pandoc/types.ts";
 import { stringify } from "encoding/yaml.ts";
+import { fromFileUrl } from "https://deno.land/[email protected]/path/win32.ts";
 
 export function bookPandocRenderer(
   options: RenderOptions,
@@ -169,6 +171,9 @@ export function bookPandocRenderer(
             ? chapterInfoForInput(project, fileRelative)
             : undefined;
 
+          // Since this is a book page, we need to suppress rendering of the description
+          file.recipe.format.metadata[kHideDescription] = true;
+
           // see if there is a 'title' in the yaml, if there isn't one, then we
           // try to extract via partitioned.headingText
           const titleInMetadata = frontMatterTitle(partitioned.yaml);

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

@@ -15,7 +15,8 @@ <h1 class="title">$title$</h1>
 $endif$
 </div>
 
-$if(description)$
+$if(hide-description)$
+$elseif(description)$
 <div>
   <div class="description">
     $description$