feat(docs, blog): add support for tags.yml, predefined list of tags

[OzakIOne]

Motivation

User request to have a predefined list of tags in a file which you can only choose from

Using a tags file, you can ensure that your tags usage is consistent across your plugin content set. Use the onInlineTags: 'throw' plugin option to enforce this consistency and prevent usage of inline tags declared on the fly.

Behavior :
undefined: search tags.yml by convention. Feature disabled if file does not exist
null/false (default): feature disabled even if tags.yml exists
tagFile.yml: search for tagFile.yml and throw if file does not exist

We check for duplicated tags permalink route and throw in case of duplication

Test Plan

yarn jest -t
ensureUniquePermalinks
normalizeTags
normalize tags
normalizeFrontMatterTags
processFileTagsPath
Dogfood

Test links

Guides:

• https://deploy-preview-10137--docusaurus-2.netlify.app/docs/create-doc/#doc-tags
• https://deploy-preview-10137--docusaurus-2.netlify.app/docs/blog/#blog-post-tags

API refs:

• https://deploy-preview-10137--docusaurus-2.netlify.app/docs/api/plugins/@docusaurus/plugin-content-blog/#tags
• https://deploy-preview-10137--docusaurus-2.netlify.app/docs/api/plugins/@docusaurus/plugin-content-docs/#tags

Tags pages blog:

• https://deploy-preview-10137--docusaurus-2.netlify.app/blog/tags/release/
• https://deploy-preview-10137--docusaurus-2.netlify.app/blog/tags/

Tags pages docs:

• https://deploy-preview-10137--docusaurus-2.netlify.app/tests/docs/tags/a/
• https://deploy-preview-10137--docusaurus-2.netlify.app/tests/docs/tags/

Related issues/PRs

fix #5913
#5975

[github-actions]

⚡️ Lighthouse report for the deploy preview of this PR

URL	Performance	Accessibility	Best Practices	SEO	PWA	Report
/	🟠 75	🟢 98	🟢 96	🟢 100	🟠 88	Report
/docs/installation	🟠 61	🟢 96	🟢 100	🟢 100	🟠 88	Report
/docs/category/getting-started	🟠 75	🟢 100	🟢 100	🟢 90	🟠 88	Report
/blog	🟠 67	🟢 100	🟢 100	🟢 90	🟠 88	Report
/blog/preparing-your-site-for-docusaurus-v3	🟠 62	🟢 96	🟢 100	🟢 100	🟠 88	Report
/blog/tags/release	🟠 70	🟢 100	🟢 100	🟠 80	🟠 88	Report
/blog/tags	🟠 75	🟢 100	🟢 100	🟢 90	🟠 88	Report

[netlify]

✅ [V2]

Name	Link
🔨 Latest commit	389e046
🔍 Latest deploy log	https://app.netlify.com/sites/docusaurus-2/deploys/6659ea1795ae61000849512e
😎 Deploy Preview	https://deploy-preview-10137--docusaurus-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[slorber]

We need :

  export type VersionMetadata = ContentPaths & {
    tagsFile: TagsFile | null;

    tagsPath: string;
  }

---

We probably need to modify/rename this method

type TagsFile = Record<string, Tag>

export function normalizeFrontMatterTags(
  /** Base path to append the tag permalinks to. */
  tagsPath: string,
  /** Can be `undefined`, so that we can directly pipe in `frontMatter.tags`. */
  frontMatterTags: FrontMatterTag[] | undefined = [],
  tagsFile: TagsFile
): Tag[]

[github-actions]

Size Change: +614 B (+0.04%)

Total Size: 1.72 MB

Filename	Size	Change
website/.docusaurus/docusaurus.config.mjs	27.1 kB	+155 B (+0.58%)
website/.docusaurus/registry.js	276 kB	+108 B (+0.04%)
website/.docusaurus/routes.js	180 kB	+72 B (+0.04%)
website/.docusaurus/routesChunkNames.json	120 kB	+36 B (+0.03%)
website/build/assets/js/main.********.js	855 kB	+243 B (+0.03%)

ℹ️ View Unchanged

Filename	Size
website/.docusaurus/codeTranslations.json	2 B
website/.docusaurus/globalData.json	107 kB
website/.docusaurus/i18n.json	930 B
website/.docusaurus/site-metadata.json	2.17 kB
website/build/assets/css/styles.********.css	112 kB
website/build/index.html	38.1 kB

_{compressed-size-action}