メインコンテンツにスキップ

Docusaurus 3.0 を発表

·11 分で読めます
Sébastien Lorber
Docusaurus メンテナー、This Week In React 編集者

本日、Docusaurus 3.0 を発表できることを嬉しく思います!🥳

Meta Open Sourceでは、Docusaurus が最小限の労力で最高のドキュメント Web サイトを構築するのに役立ち、本当に重要なこと、つまりコンテンツの作成に集中できると考えています。

これは Docusaurus の新しいメジャーバージョンであり、エキサイティングな新機能とアップグレードされた依存関係が付属しています。

セマンティックバージョニングの原則に従い、このリリースには、v3 アップグレードガイドで徹底的に文書化した**破壊的変更**が含まれています。破壊的変更は面倒ですが、実装予定の**Docusaurus 機能の新しい波**の基盤を築くために必要です。

v3.0 social-card image

Docusaurus v3 へのサイトの準備

·14 分で読めます
Sébastien Lorber
Docusaurus メンテナー、This Week In React 編集者
警告

このブログ記事は、Docusaurus v3 がベータ版だったときに書かれました。Docusaurus v3 の現在の安定版リリースにアップグレードする場合、依存関係のバージョンとアップグレード手順にいくつかの変更点がありますのでご注意ください。最新の移行手順については、アップグレードガイドをご覧ください。

Docusaurus v3 は現在**ベータ版**であり、公式リリースは間近です。この新しいメジャーバージョンに向けて**サイトの準備**を開始するには絶好のタイミングです。

Docusaurus v3 には、いくつかの**破壊的変更**が含まれていますが、その多くは**Docusaurus v2 で今日処理できます**。サイトの準備は段階的に行うことができ、v3 へのアップグレードが容易になります。

主な破壊的変更点は、MDX v1 から MDX v3 へのアップグレードです。詳細については、**MDX v2** および **MDX v3** のリリースノートをご覧ください。MDX は désormais、Markdown コンテンツを**より厳密に**、そして**微妙な違い**をもってコンパイルします。

この記事では、主にこの新しい MDX バージョンに向けてコンテンツを準備する方法に焦点を当て、今日処理できるその他の破壊的変更点についてもいくつかリストします。

Preparing your site for Docusaurus v3 - social card

フロントエンドの依存関係を自信を持ってアップグレードする

·9 分で読めます
Sébastien Lorber
Docusaurus メンテナー、This Week In React 編集者

フロントエンド開発者はしばしば**npm 依存関係をアップグレード**する必要がありますが、これらのアップグレードは恐ろしく感じられ、通常のテストスイートでは検出されない**微妙な UI の副作用**につながる可能性があります。

Docusaurus のアップグレードはその好例です。すべてのページを 1 つずつ確認しないと、視覚的な回帰がないことを確認するのは困難です。 **Docusaurus v3 は間近に迫っており**(現在ベータ版)、自信を持ってこのアップグレードを行うお手伝いができればと考えています。

この記事では、**GitHub Actions****Playwright**、および **Argos**に基づく**視覚的回帰テスト**ワークフローを紹介します。これは Docusaurus や React に直接結び付けられているわけではなく、他のフロントエンドアプリケーションやフレームワークで動作するように適応させることができます。

Upgrading frontend dependencies with confidence - social card