Skip to content

Conversation

@youngjungithub
Copy link
Contributor

@youngjungithub youngjungithub commented Apr 11, 2025

This PR updates our documentation site to use the official codehike package (v1.0.5)
instead of the deprecated @codehike/mdx. The CodeHike project has consolidated all
functionality into the main codehike package, discontinuing support for the separate
@codehike/mdx package.

Changes include:

  • Updated package.json dependencies to use codehike@^1.0.5
  • Removed the deprecated @codehike/mdx dependency
  • Updated import statements in docusaurus.config.js to use the new module path:
    const { remarkCodeHike, recmaCodeHike } = require('codehike/mdx')
  • Replaced the incompatible shiki/nord.json theme with 'github-dark'
  • Updated MDX configuration to align with the new CodeHike API
  • Adjusted code block syntax in documentation files to work with the new version

This migration ensures our documentation site continues to have proper syntax highlighting
and code examples while staying current with the CodeHike ecosystem. The github-dark theme
provides excellent readability and maintains visual consistency.

@youngjungithub youngjungithub requested a review from a team as a code owner April 11, 2025 13:36
@youngjungithub youngjungithub marked this pull request as draft April 11, 2025 13:36
@youngjungithub youngjungithub force-pushed the update-codespike branch 3 times, most recently from da25aa3 to f8042f5 Compare April 11, 2025 14:54
@youngjungithub youngjungithub changed the title feat: update codehike version to 1.0.5 from 0.9.0 fix(website): migrate from @codehike/mdx to codehike 1.0.5 Apr 15, 2025
This commit updates our documentation site to use the official `codehike` package (v1.0.5)
instead of the deprecated `@codehike/mdx`. The CodeHike project has consolidated all
functionality into the main `codehike` package, discontinuing support for the separate
`@codehike/mdx` package.

Changes include:
- Updated package.json dependencies to use `codehike@^1.0.5`
- Removed the deprecated `@codehike/mdx` dependency
- Updated import statements in docusaurus.config.js to use the new module path:
  `const { remarkCodeHike, recmaCodeHike } = require('codehike/mdx')`
- Replaced the incompatible shiki/nord.json theme with 'github-dark'
- Updated MDX configuration to align with the new CodeHike API
- Adjusted code block syntax in documentation files to work with the new version

This migration ensures our documentation site continues to have proper syntax highlighting
and code examples while staying current with the CodeHike ecosystem. The github-dark theme
provides excellent readability and maintains visual consistency.

chore: nix fix
@youngjungithub
Copy link
Contributor Author

youngjungithub commented Apr 15, 2025

Note for the reviewer: There is a small visual discrepancy in the UI on one specific article which will be fixed in a separate, follow-up PR. This allows the current PR to focus solely on the migration task and simplifies the review.
Before:

Before.mov

After:

After.mov

@youngjungithub youngjungithub marked this pull request as ready for review April 15, 2025 14:22
@youngjungithub youngjungithub requested a review from a team as a code owner April 15, 2025 14:22
@andrew-scott-fischer andrew-scott-fischer merged commit 0e0f858 into master Apr 15, 2025
6 checks passed
@andrew-scott-fischer andrew-scott-fischer deleted the update-codespike branch April 15, 2025 14:41
@github-actions
Copy link

🎉 This PR is included in version @api-ts/typed-express-router@2.0.0-beta.1 🎉

The release is available on npm package (@beta dist-tag)

Your semantic-release bot 📦🚀

@github-actions
Copy link

🎉 This PR is included in version @api-ts/express-wrapper@2.0.0-beta.1 🎉

The release is available on npm package (@beta dist-tag)

Your semantic-release bot 📦🚀

@github-actions
Copy link

🎉 This PR is included in version @api-ts/typed-express-router@1.1.14 🎉

The release is available on npm package (@latest dist-tag)

Your semantic-release bot 📦🚀

@github-actions
Copy link

🎉 This PR is included in version @api-ts/express-wrapper@1.0.34 🎉

The release is available on npm package (@latest dist-tag)

Your semantic-release bot 📦🚀

@github-actions
Copy link

🎉 This PR is included in version @api-ts/superagent-wrapper@1.3.4 🎉

The release is available on npm package (@latest dist-tag)

Your semantic-release bot 📦🚀

@github-actions
Copy link

🎉 This PR is included in version @api-ts/openapi-generator@5.8.0 🎉

The release is available on npm package (@latest dist-tag)

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants