docs: customize Material for mkdocs

[davidlj95]

So we're ready to start writing

There are maaaaaaaaaany things here (went checking each of mkdocs docs pages) buuuuut some of them:

• Custom colors according to logo
• Custom font (same as Angular v17 brand guidelines). Loaded via FontSource to avoid Google Fonts injecting 🍪 s
  • Implies setting up a pkg.json & copying installed fonts to a public directory
  • Removes markdowns after copying to avoid mkdocs displaying those as part of our docs. exclude_docs works partially. As plugins like privacy keep reading those. So removing instead.
  • Customizes CSS to match angular.dev h1, h2 sizes (tho they don't respect guidelines I think)
• Custom icon & favicon
• Support for abbreviations / glossary
• Support for social plugin (generates social cards)
• Description to be ~200 chars. Ensure fits social card properly.
• Dark/light themes customization
• SPA (XHR reqs when navigating) via navigation.instant
• ToC integrated in navigation + following anchors
• Go to top navigation
• Search (with suggestions, highlighting and search link)
• Edit (and view) doc page on GitHub
• Tooltips for abbreviations (& tooltips if adding)
• Tabbed content (with anchor links that change all together / slugs instead of generated anchor names)
• Code highlighting
• Nested blocks with superfences
• Admonitions
• Footnotes
• Social links

Minors:

• Configure WebStorm to use Prettier for CSS
• Fix docs: serve run config (was installing)
• Ignore site / .venv / fonts docs directories for Prettier
• Ignore content/fonts from Git, it's generated
• Specify English language
• Custom GitHub repo logo (vs git default)
• Configuration to serve publicly (ie: to check in another device)

[davidlj95]

Current dependencies on/for this PR:

• main
  • PR docs: customize Material for mkdocs #264 👈

This stack of pull requests is managed by Graphite.

[github-actions]

📦 Bundle size (Angular v17)

Git ref: 79a5be4

Module file	Size	Base size	Difference
ngx-meta-core.mjs	2846 bytes (2.8KiB)	Not available	Not available
ngx-meta-json-ld.mjs	226 bytes (226B)	Not available	Not available
ngx-meta-open-graph.mjs	888 bytes (888B)	Not available	Not available
ngx-meta-routing.mjs	839 bytes (839B)	Not available	Not available
ngx-meta-standard.mjs	784 bytes (784B)	Not available	Not available
ngx-meta-twitter-card.mjs	501 bytes (501B)	Not available	Not available
Total	6084 bytes (6.0KiB)	Not available	Not available

Base size data is not available yet. Try again when the CI/CD has finished running on main branch

[github-actions]

📦 Bundle size (Angular v16)

Git ref: 79a5be4

Module file	Size	Base size	Difference
ngx-meta-core.mjs	3250 bytes (3.2KiB)	Not available	Not available
ngx-meta-json-ld.mjs	392 bytes (392B)	Not available	Not available
ngx-meta-open-graph.mjs	1232 bytes (1.3KiB)	Not available	Not available
ngx-meta-routing.mjs	1015 bytes (1015B)	Not available	Not available
ngx-meta-standard.mjs	901 bytes (901B)	Not available	Not available
ngx-meta-twitter-card.mjs	661 bytes (661B)	Not available	Not available
Total	7451 bytes (7.3KiB)	Not available	Not available

Base size data is not available yet. Try again when the CI/CD has finished running on main branch

[github-actions]

📦 Bundle size (Angular v15)

Git ref: 79a5be4

Module file	Size	Base size	Difference
ngx-meta-core.mjs	3250 bytes (3.2KiB)	Not available	Not available
ngx-meta-json-ld.mjs	392 bytes (392B)	Not available	Not available
ngx-meta-open-graph.mjs	1232 bytes (1.3KiB)	Not available	Not available
ngx-meta-routing.mjs	1015 bytes (1015B)	Not available	Not available
ngx-meta-standard.mjs	901 bytes (901B)	Not available	Not available
ngx-meta-twitter-card.mjs	661 bytes (661B)	Not available	Not available
Total	7451 bytes (7.3KiB)	Not available	Not available

Base size data is not available yet. Try again when the CI/CD has finished running on main branch

[github-actions]

🎉 This PR is included in version 1.0.0-alpha.39 🎉

The release is available on:

• npm package (@main dist-tag)
• GitHub release

Your semantic-release bot 📦🚀