tree 6630398f48bc544cdf53e2d994180970eec1ba08
parent bcbf5b005af0c682b2e5f393324569dd2b3843ab
author Alexander Daryin <shurick@google.com> 1784673433 +0000
committer Alexander Daryin <shurick@google.com> 1784673433 +0000

Add markdown.frontmatter option to strip YAML front matter

Markdown files authored for static site generators (Jekyll, Hugo, etc.)
often begin with a YAML front matter block delimited by "---" lines.
Gitiles has no front matter support, so CommonMark parses the block as
ordinary content: the closing "---" turns the metadata into a setext
<h2>, rendering an ugly heading of raw "key: value" pairs at the top of
the page.

Add an opt-in "markdown.frontmatter" option (default false, consistent
with the other non-GitHub-flavor extensions). When enabled,
GitilesMarkdown installs commonmark-ext-yaml-front-matter so the leading
block is parsed into a YamlFrontMatterBlock, and MarkdownToHtml omits
that block from the rendered output instead of throwing on the unknown
CustomBlock.

Documented in Documentation/{config,markdown}.md and covered by
GitilesMarkdownTest.

Change-Id: I2ace7227728e964d2e73d5149a06f2d9a884f0c8