Skip to content

chore(website): allow markdown in titles #9839

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Conversation

JoshuaKGoldberg
Copy link
Member

PR Checklist

Overview

Swizzles the native Docusaurus components so that we can use react-markdown for titles.

💖

@typescript-eslint
Copy link
Contributor

Thanks for the PR, @JoshuaKGoldberg!

typescript-eslint is a 100% community driven project, and we are incredibly grateful that you are contributing to that community.

The core maintainers work on this in their personal time, so please understand that it may not be possible for them to review your work immediately.

Thanks again!


🙏 Please, if you or your company is finding typescript-eslint valuable, help us sustain the project by sponsoring it transparently on https://opencollective.com/typescript-eslint.

@JoshuaKGoldberg JoshuaKGoldberg requested review from Josh-Cena and a team August 20, 2024 17:31
Copy link

netlify bot commented Aug 20, 2024

Deploy Preview for typescript-eslint ready!

Name Link
🔨 Latest commit 4ded8df
🔍 Latest deploy log https://app.netlify.com/sites/typescript-eslint/deploys/66c62ab3abd586000825a0d6
😎 Deploy Preview https://deploy-preview-9839--typescript-eslint.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 94 (🔴 down 5 from production)
Accessibility: 100 (no change from production)
Best Practices: 92 (no change from production)
SEO: 90 (no change from production)
PWA: 80 (no change from production)
View the detailed breakdown and full score reports

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

Josh-Cena
Josh-Cena previously approved these changes Aug 20, 2024
Copy link
Member

@Josh-Cena Josh-Cena left a comment

Choose a reason for hiding this comment

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

Neat—makes sense to me :)

Copy link

codecov bot commented Aug 20, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 88.04%. Comparing base (57e4120) to head (4ded8df).
Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #9839   +/-   ##
=======================================
  Coverage   88.04%   88.04%           
=======================================
  Files         407      407           
  Lines       13948    13948           
  Branches     4078     4078           
=======================================
  Hits        12280    12280           
  Misses       1355     1355           
  Partials      313      313           
Flag Coverage Δ
unittest 88.04% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

@Josh-Cena
Copy link
Member

A few lint errors—then we can merge it.

bradzacher
bradzacher previously approved these changes Aug 21, 2024
Co-authored-by: Brad Zacher <brad.zacher@gmail.com>
@JoshuaKGoldberg JoshuaKGoldberg dismissed stale reviews from bradzacher and Josh-Cena via 3231a83 August 21, 2024 13:28
@JoshuaKGoldberg JoshuaKGoldberg added the 1 approval >=1 team member has approved this PR; we're now leaving it open for more reviews before we merge label Aug 21, 2024
Comment on lines 37 to 38
// @ts-expect-error -- BlogSidebarItem only allows title: string, but we render as Markdown
title: <Markdown>{item.title}</Markdown>,
Copy link
Member

Choose a reason for hiding this comment

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

This still gives a type checking error. I suspect you need to place the @ts-expect-error elsewhere.

But really, I would suggest you do the cast here—Docusaurus is not going to change the type of BlogSidebarItem so you don't actually gain any soundness.

Copy link
Member Author

Choose a reason for hiding this comment

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

Docusaurus is not going to change the type of BlogSidebarItem

Funny, I was thinking of filing an issue suggesting it allow any React node type for the title...

Copy link
Member

Choose a reason for hiding this comment

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

The type of Docusaurus describes what we will pass to these components by default, not what they can accept by principle; narrower types may allow swizzlers to do other things they otherwise can't do, say, title.toUpperCase(). Not easy to provide types in a customizable system :)

Copy link
Member

@Josh-Cena Josh-Cena left a comment

Choose a reason for hiding this comment

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

Just need the branch to be up to date

@JoshuaKGoldberg JoshuaKGoldberg merged commit 93f285d into typescript-eslint:main Aug 21, 2024
55 checks passed
@JoshuaKGoldberg JoshuaKGoldberg deleted the blog-markdown-titles branch August 21, 2024 18:13
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Aug 29, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
1 approval >=1 team member has approved this PR; we're now leaving it open for more reviews before we merge
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Docs: Render backtick-ed text as code in blog titles
3 participants