rustdoc needs a way to specify HTML metadata for standalone docs

[brson]

The HTML meta tags for descriptions and keywords are both important for SEO. For library docs we can generate this information automatically, but not for standalone docs.

I've never seen any such markdown extension, though maybe Jekyll headers can do this. We may need to invent something.

cc #12466.

[thehydroimpulse]

I implemented a frontmatter module for rustdoc not too long ago. So you can specify arbitrary key->value pairs:

---
title: "Foobar"
description: "Foobar 123"
keywords: ["foo", "bar"]
---

# Header 1

blah blah

Not sure if that's what you're thinking of.

[brson]

@thehydroimpulse Yes, that sounds exactly like what I need!

[thehydroimpulse]

Cool, I'll extract it out into it's own PR.

[steveklabnik]

That's sweet, though other frontmatter i've seen usually has ---s at both the top and bottom of it.

[thehydroimpulse]

Oh yeah, there's also one at the top.

[steveklabnik]

triage: no change

[edunham]

@thehydroimpulse Could you link the PR from this issue to make it easier to track?

[thehydroimpulse]

@edunham It's a really old PR. #16374

[edunham]

aww, looks like it got stalled on insufficient time for cleanup. Thanks for the link!

[steveklabnik]

Triage: no change.

[steveklabnik]

@rust-lang/rustdoc, are we interested in this feature?

[GuillaumeGomez]

I can add it.

[GuillaumeGomez]

Actually we can already add data in headers through --html-in-header option. Closing it then.