Skip to content

fix(blog): normalize inline authors socials - #10424

Merged
slorber merged 10 commits into
mainfrom
ozaki/inlineAuthor
Aug 29, 2024
Merged

fix(blog): normalize inline authors socials#10424
slorber merged 10 commits into
mainfrom
ozaki/inlineAuthor

Conversation

@OzakIOne

@OzakIOne OzakIOne commented Aug 19, 2024

Copy link
Copy Markdown
Contributor

Motivation

Fix #10417

Test Plan

Local & CI

Test links

Deploy preview: https://deploy-preview-10424--docusaurus-2.netlify.app/

@facebook-github-bot facebook-github-bot added the CLA Signed Signed Facebook CLA label Aug 19, 2024
@netlify

netlify Bot commented Aug 19, 2024

Copy link
Copy Markdown

[V2]

Name Link
🔨 Latest commit e8ac33e
🔍 Latest deploy log https://app.netlify.com/sites/docusaurus-2/deploys/66d09b6ea0b95d000808f1eb
😎 Deploy Preview https://deploy-preview-10424--docusaurus-2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@github-actions

github-actions Bot commented Aug 19, 2024

Copy link
Copy Markdown

⚡️ Lighthouse report for the deploy preview of this PR

URL Performance Accessibility Best Practices SEO Report
/ 🟠 68 🟢 98 🟢 96 🟢 100 Report
/docs/installation 🟠 52 🟢 97 🟢 100 🟢 100 Report
/docs/category/getting-started 🟠 74 🟢 100 🟢 100 🟠 86 Report
/blog 🟠 64 🟢 96 🟢 100 🟠 86 Report
/blog/preparing-your-site-for-docusaurus-v3 🔴 48 🟢 92 🟢 100 🟢 100 Report
/blog/tags/release 🟠 65 🟢 96 🟢 100 🟠 86 Report
/blog/tags 🟠 75 🟢 100 🟢 100 🟠 86 Report

@github-actions

github-actions Bot commented Aug 19, 2024

Copy link
Copy Markdown

Size Change: -58.3 kB (-0.5%)

Total Size: 11.5 MB

Filename Size Change
website/build/blog/2018/12/14/Happy-First-Birthday-Slash.html 30.4 kB -2.83 kB (-8.52%)
website/build/blog/2021/05/12/announcing-docusaurus-two-beta.html 47.5 kB -4.39 kB (-8.47%)
website/build/blog/2022/08/01/announcing-docusaurus-2.0.html 139 kB -2.83 kB (-2%)
website/build/blog/authors/j-marcey.html 65 kB -10 kB (-13.36%) 👏
website/build/blog/authors/josh-cena.html 43 kB -2.82 kB (-6.15%)
website/build/blog/authors/lex-111.html 50.2 kB -7.2 kB (-12.53%) 👏
website/build/blog/authors/slorber/authors/3.html 77.7 kB -7.2 kB (-8.49%)
website/build/blog/authors/yangshun.html 57.8 kB -7.2 kB (-11.08%) 👏
website/build/blog/authors/zpao.html 43.5 kB -2.82 kB (-6.09%)
website/build/blog/page/3.html 71.7 kB -2.82 kB (-3.78%)
website/build/blog/page/4.html 64.2 kB -4.38 kB (-6.39%)
website/build/blog/page/5.html 41.9 kB -2.82 kB (-6.31%)
ℹ️ View Unchanged
Filename Size Change
website/.docusaurus/codeTranslations.json 2 B 0 B
website/.docusaurus/docusaurus.config.mjs 27.9 kB 0 B
website/.docusaurus/globalData.json 30.2 kB 0 B
website/.docusaurus/i18n.json 930 B 0 B
website/.docusaurus/registry.js 155 kB 0 B
website/.docusaurus/routes.js 74.3 kB 0 B
website/.docusaurus/routesChunkNames.json 81.7 kB 0 B
website/.docusaurus/site-metadata.json 2.17 kB 0 B
website/build/assets/css/styles.********.css 113 kB 0 B
website/build/assets/js/main.********.js 666 kB 0 B
website/build/blog.html 61.4 kB 0 B
website/build/blog/2017/12/14/introducing-docusaurus.html 74.8 kB -13 B (-0.02%)
website/build/blog/2018/04/30/How-I-Converted-Profilo-To-Docusaurus.html 47.3 kB 0 B
website/build/blog/2018/09/11/Towards-Docusaurus-2.html 51.7 kB 0 B
website/build/blog/2019/12/30/docusaurus-2019-recap.html 39.6 kB -13 B (-0.03%)
website/build/blog/2020/01/07/tribute-to-endi.html 34 kB -13 B (-0.04%)
website/build/blog/2021/01/19/docusaurus-2020-recap.html 48.9 kB -13 B (-0.03%)
website/build/blog/2021/03/09/releasing-docusaurus-i18n.html 45.1 kB -13 B (-0.03%)
website/build/blog/2021/11/21/algolia-docsearch-migration.html 52.9 kB 0 B
website/build/blog/2022/01/24/docusaurus-2021-recap.html 44.5 kB -13 B (-0.03%)
website/build/blog/2022/09/01/docusaurus-2.1.html 50.9 kB -13 B (-0.03%)
website/build/blog/archive.html 24.7 kB 0 B
website/build/blog/authors.html 46.5 kB 0 B
website/build/blog/authors/slorber.html 61.5 kB 0 B
website/build/blog/authors/slorber/authors/2.html 65.4 kB 0 B
website/build/blog/authors/slorber/authors/4.html 44.7 kB 0 B
website/build/blog/page/2.html 66 kB 0 B
website/build/blog/preparing-your-site-for-docusaurus-v3.html 138 kB -13 B (-0.01%)
website/build/blog/releases/2.2.html 49.6 kB -12 B (-0.02%)
website/build/blog/releases/2.3.html 60.8 kB -12 B (-0.02%)
website/build/blog/releases/2.4.html 65.3 kB -12 B (-0.02%)
website/build/blog/releases/3.0.html 111 kB 0 B
website/build/blog/releases/3.1.html 52 kB -11 B (-0.02%)
website/build/blog/releases/3.2.html 48.8 kB -12 B (-0.02%)
website/build/blog/releases/3.3.html 55.5 kB -12 B (-0.02%)
website/build/blog/releases/3.4.html 55.8 kB -5 B (-0.01%)
website/build/blog/releases/3.5.html 58 kB -2 B (0%)
website/build/blog/tags.html 28.6 kB 0 B
website/build/blog/upgrading-frontend-dependencies-with-confidence-using-visual-regression-testing.html 128 kB -12 B (-0.01%)
website/build/docs.html 49.4 kB -3 B (-0.01%)
website/build/docs/advanced.html 31.1 kB -12 B (-0.04%)
website/build/docs/advanced/architecture.html 30.7 kB -8 B (-0.03%)
website/build/docs/advanced/client.html 76 kB -12 B (-0.02%)
website/build/docs/advanced/plugins.html 58.6 kB -12 B (-0.02%)
website/build/docs/advanced/routing.html 73.9 kB -4 B (-0.01%)
website/build/docs/advanced/ssg.html 81.5 kB -12 B (-0.01%)
website/build/docs/api/docusaurus-config.html 202 kB -12 B (-0.01%)
website/build/docs/api/misc/@docusaurus/eslint-plugin.html 48.3 kB -8 B (-0.02%)
website/build/docs/api/misc/@docusaurus/eslint-plugin/no-html-links.html 38.1 kB -12 B (-0.03%)
website/build/docs/api/misc/@docusaurus/eslint-plugin/no-untranslated-text.html 37 kB -12 B (-0.03%)
website/build/docs/api/misc/@docusaurus/eslint-plugin/prefer-docusaurus-heading.html 38.3 kB -8 B (-0.02%)
website/build/docs/api/misc/@docusaurus/eslint-plugin/string-literal-i18n-messages.html 41.9 kB -12 B (-0.03%)
website/build/docs/api/misc/@docusaurus/logger.html 39.8 kB -12 B (-0.03%)
website/build/docs/api/misc/create-docusaurus.html 34.9 kB -12 B (-0.03%)
website/build/docs/api/plugin-methods.html 67.4 kB -8 B (-0.01%)
website/build/docs/api/plugin-methods/extend-infrastructure.html 63 kB -8 B (-0.01%)
website/build/docs/api/plugin-methods/i18n-lifecycles.html 60.6 kB -8 B (-0.01%)
website/build/docs/api/plugin-methods/lifecycle-apis.html 170 kB -12 B (-0.01%)
website/build/docs/api/plugin-methods/static-methods.html 46.5 kB -8 B (-0.02%)
website/build/docs/api/plugins.html 31.6 kB -12 B (-0.04%)
website/build/docs/api/plugins/@docusaurus/plugin-client-redirects.html 62.6 kB +1 B (0%)
website/build/docs/api/plugins/@docusaurus/plugin-content-blog.html 198 kB +1 B (0%)
website/build/docs/api/plugins/@docusaurus/plugin-content-docs.html 202 kB -3 B (0%)
website/build/docs/api/plugins/@docusaurus/plugin-content-pages.html 78 kB -12 B (-0.02%)
website/build/docs/api/plugins/@docusaurus/plugin-debug.html 50.5 kB -12 B (-0.02%)
website/build/docs/api/plugins/@docusaurus/plugin-google-analytics.html 51.5 kB -12 B (-0.02%)
website/build/docs/api/plugins/@docusaurus/plugin-google-gtag.html 51 kB -16 B (-0.03%)
website/build/docs/api/plugins/@docusaurus/plugin-google-tag-manager.html 49.8 kB -12 B (-0.02%)
website/build/docs/api/plugins/@docusaurus/plugin-ideal-image.html 51.1 kB -8 B (-0.02%)
website/build/docs/api/plugins/@docusaurus/plugin-pwa.html 122 kB -8 B (-0.01%)
website/build/docs/api/plugins/@docusaurus/plugin-sitemap.html 68.5 kB -6 B (-0.01%)
website/build/docs/api/plugins/@docusaurus/plugin-vercel-analytics.html 42.2 kB 0 B
website/build/docs/api/themes.html 30.4 kB -12 B (-0.04%)
website/build/docs/api/themes/@docusaurus/theme-classic.html 46.4 kB -8 B (-0.02%)
website/build/docs/api/themes/@docusaurus/theme-live-codeblock.html 38.6 kB -8 B (-0.02%)
website/build/docs/api/themes/@docusaurus/theme-mermaid.html 37.5 kB -8 B (-0.02%)
website/build/docs/api/themes/@docusaurus/theme-search-algolia.html 34.7 kB -12 B (-0.03%)
website/build/docs/api/themes/configuration.html 256 kB -5 B (0%)
website/build/docs/blog.html 219 kB -6 B (0%)
website/build/docs/browser-support.html 51 kB -12 B (-0.02%)
website/build/docs/category/getting-started.html 28.3 kB 0 B
website/build/docs/category/guides.html 36.4 kB 0 B
website/build/docs/cli.html 63.8 kB -11 B (-0.02%)
website/build/docs/configuration.html 98.5 kB -8 B (-0.01%)
website/build/docs/create-doc.html 65.3 kB 0 B
website/build/docs/creating-pages.html 59.1 kB -11 B (-0.02%)
website/build/docs/deployment.html 211 kB -3 B (0%)
website/build/docs/docs-introduction.html 53.6 kB -12 B (-0.02%)
website/build/docs/docs-multi-instance.html 78.7 kB -8 B (-0.01%)
website/build/docs/docusaurus-core.html 245 kB -12 B (0%)
website/build/docs/guides/whats-next.html 32.8 kB -12 B (-0.04%)
website/build/docs/i18n/crowdin.html 151 kB 0 B
website/build/docs/i18n/git.html 82.6 kB -8 B (-0.01%)
website/build/docs/i18n/introduction.html 50.7 kB -12 B (-0.02%)
website/build/docs/i18n/tutorial.html 171 kB +1 B (0%)
website/build/docs/installation.html 73 kB 0 B
website/build/docs/introduction/index.html 280 B 0 B
website/build/docs/markdown-features.html 83.2 kB -11 B (-0.01%)
website/build/docs/markdown-features/admonitions.html 118 kB -8 B (-0.01%)
website/build/docs/markdown-features/assets.html 93.5 kB -10 B (-0.01%)
website/build/docs/markdown-features/code-blocks.html 245 kB -8 B (0%)
website/build/docs/markdown-features/diagrams.html 56 kB +2 B (0%)
website/build/docs/markdown-features/head-metadata.html 52.8 kB -12 B (-0.02%)
website/build/docs/markdown-features/links.html 43.1 kB -12 B (-0.03%)
website/build/docs/markdown-features/math-equations.html 95.4 kB -1 B (0%)
website/build/docs/markdown-features/plugins.html 101 kB -4 B (0%)
website/build/docs/markdown-features/react.html 144 kB -12 B (-0.01%)
website/build/docs/markdown-features/tabs.html 148 kB -12 B (-0.01%)
website/build/docs/markdown-features/toc.html 88.8 kB -8 B (-0.01%)
website/build/docs/migration.html 43 kB -13 B (-0.03%)
website/build/docs/migration/v2.html 41.2 kB -12 B (-0.03%)
website/build/docs/migration/v2/automated.html 42.6 kB -12 B (-0.03%)
website/build/docs/migration/v2/manual.html 207 kB -12 B (-0.01%)
website/build/docs/migration/v2/translated-sites.html 52.8 kB -12 B (-0.02%)
website/build/docs/migration/v2/versioned-sites.html 67.2 kB -12 B (-0.02%)
website/build/docs/migration/v3.html 218 kB -11 B (-0.01%)
website/build/docs/playground.html 32.5 kB -12 B (-0.04%)
website/build/docs/resources/index.html 325 B 0 B
website/build/docs/search.html 121 kB -11 B (-0.01%)
website/build/docs/seo.html 93 kB +1 B (0%)
website/build/docs/sidebar.html 136 kB -8 B (-0.01%)
website/build/docs/sidebar/autogenerated.html 156 kB +1 B (0%)
website/build/docs/sidebar/items.html 188 kB -12 B (-0.01%)
website/build/docs/sidebar/multiple-sidebars.html 67.1 kB -8 B (-0.01%)
website/build/docs/static-assets.html 56.2 kB -8 B (-0.01%)
website/build/docs/styling-layout.html 141 kB -12 B (-0.01%)
website/build/docs/support/index.html 319 B 0 B
website/build/docs/swizzling.html 120 kB +2 B (0%)
website/build/docs/team/index.html 310 B 0 B
website/build/docs/typescript-support.html 65.4 kB -12 B (-0.02%)
website/build/docs/using-plugins.html 115 kB +1 B (0%)
website/build/docs/versioning.html 87.1 kB +1 B (0%)
website/build/index.html 37.8 kB 0 B

compressed-size-action

@slorber slorber left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Need to move implementation to normalizeAuthor + add a few new tests for getBlogPostAuthors

Comment thread packages/docusaurus-plugin-content-blog/src/authors.ts Outdated
Comment thread packages/docusaurus-plugin-content-blog/src/authors.ts Outdated
return authorInput;
return {
...authorInput,
socials: normalizeSocials(authorInput.socials ?? {}),

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here if author front matter has no social key, the result will be social: {}.

If the key was absent before normalization, we'd rather keep it absent after normalization (unless it's an explicit goal of the normalization to always have an object for empty (in which case the normalized type shouldn't allow null/undefined anymore)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm +1 to make socials required—unless we plan to make socials: null and socials: {} render different things, for which I cannot conceive a reason.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think we plan render those differently.

I also like to normalize to {} for convenience of frontend code, although technically this slightly increases bundle size / memory by creating useless empty objects when we could use optional chaining. Maybe always normalizing to undefined would be better? That's really a detail so I'm fine with any of those.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think neither of those would be a concern when there aren't thousands of authors (by which time the blog posts' metadata is a far bigger concern).

Comment thread project-words.txt Outdated
@slorber slorber added the pr: bug fix This PR fixes a bug in a past release. label Aug 21, 2024
@slorber slorber changed the title fix: normalize inline authors socials fix(blog): normalize inline authors socials Aug 29, 2024
@slorber
slorber marked this pull request as ready for review August 29, 2024 14:52

@slorber slorber left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM thanks 👍

@slorber

slorber commented Aug 29, 2024

Copy link
Copy Markdown
Collaborator

oups, updated the branch and now we have test failures 😄

@slorber
slorber merged commit 2aef92c into main Aug 29, 2024
@slorber
slorber deleted the ozaki/inlineAuthor branch August 29, 2024 16:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed Signed Facebook CLA pr: bug fix This PR fixes a bug in a past release.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Blog author social platforms shorthands are not normalized for inline authors

4 participants