feat: generate content title from frontmatter

[billyyyyy3320]

Summary

Before:

---
date: 2019-2-26
tag: 
  - markdown
  - vuepress
author: ULIVZ
location: Hangzhou  
---

# Markdown Slot

VuePress implements a content distribution API for Markdown. With this feature, you can split your document into multiple fragments to facilitate flexible composition in the layout component.

## Why do I need Markdown Slot?

First, let's review the relationship between layout components and markdown files:

After:

---
title: Markdown Slot
date: 2019-2-26
tag: 
  - markdown
  - vuepress
author: ULIVZ
location: Hangzhou  
---

VuePress implements a content distribution API for Markdown. With this feature, you can split your document into multiple fragments to facilitate flexible composition in the layout component.

## Why do I need Markdown Slot?

First, let's review the relationship between layout components and markdown files:

There's no need to write your title in the beginning of your content any more, but that's not the main reason to make this breaking change.

In #32, we need a head which contains tags, date, author and location in post content.
In #45, we need a hero image for each post. It should be displayed in not only post list page but also post content page.

The ideal position for both of them is under the content title, but it'll be complicated to insert them into the middle of content.

I've checked out several blog tools and found that it's common to write title in front matter. I'll not merge this PR until I submit the PRs for #32 and #45. We can also remove modifyBlogPluginOptions in the next major release.

What kind of change does this PR introduce? (check at least one)

• Bugfix
• Feature
• Code style update
• Refactor
• Docs
• Build-related changes
• Other, please describe:

If changing the UI of default theme, please provide the before/after screenshot:

Does this PR introduce a breaking change? (check one)

• Yes
• No

[bencodezen]

Love the feature to add title from the frontmatter @newsbielt703! Just a couple of comments and then I think we should merge!

[bencodezen]

Will timezones be accepted as well? Best to document the standard if we're using ISO-8601 or something else

[billyyyyy3320]

VuePress' using gray-matter which depends js-yaml which follows standard yaml types, so all available formats are here. I've updated the docs.

[bencodezen]

Not critical to this PR, but what do you think about making Author an object instead so that people can define things like meta information (i.e., social media links, email, etc.)

[billyyyyy3320]

What do you recommend to leverage those meta information? Currently, people can display contact infos by the option footer.contact.

[flozero]

Thanks a lot to you ! Sent from ProtonMail Mobile

…

On Wed, Jan 29, 2020 at 10:13 AM, Billyyyyy3320 ***@***.***> wrote: @newsbielt703 commented on this pull request. --------------------------------------------------------------- In [styles/palette.styl](#51 (comment)): > @@ -18,7 +18,6 @@ $footerColor = #828282 $newsletterBgColor = #f8f8f8 // layout -$navbarHeight = 5rem okay then I'll check out source code to see is there any other styles written with px should be refactored to use rem instead. Thanks the review. — You are receiving this because you commented. Reply to this email directly, [view it on GitHub](#51), or [unsubscribe](https://github.com/notifications/unsubscribe-auth/ACYFLNGWPHFTPTRPR7CHG5DRAGMLJANCNFSM4KGVUVBQ).