Docusaurus 2021 年のまとめ
Docusaurus は 2021 年に大きな進歩を遂げました！多くの支持を集め、GitHub で 3 万スターを超えました！
国際化のリリース後、v1 との完全な機能パリティを達成し、最初のベータ版を発表し、今年は大幅に多くのユーザーを迎えることができました。
公式 v2 リリースは間近に迫っています！最新情報については、ロードマップ issue をフォローしてください。
ハイライト
今年を振り返るために、いくつかのハイライトを見ていきましょう。半年前のToDo リストを覚えていますか？もう一度取り出して、どこまで進んだかを確認しましょう！
- 国際化：2020 年後半に最初に実装されてから 4 か月後に正式にリリースされました。多くのプロジェクトで大きな成功を収めています
- 自動生成サイドバー：もう大きな
sidebars.jsを管理する必要はありません - Webpack 5：ビルドパフォーマンスが大幅に向上しました
- 末尾スラッシュ構成：コンテンツホスティングプロバイダーとのシームレスな統合
- モバイルナビゲーションの再設計：モバイルユーザーもデスクトップと同じナビゲーション機能を利用できるようになりました
- UI の改善：よりアクセスしやすい引用符、より良い警告、トップに戻るボタンなど
- 複数ブログ著者：1 つのブログ記事を共同執筆したすべての素晴らしい貢献者にクレジットを与えることができます！
- その他のブログ機能：アーカイブページ、SEO 用の構造化データ、フィード内の完全な投稿コンテンツ – 完全な機能を備えたブログをすぐに公開できます
- アセットのコロケーション：もう静的フォルダを肥大化させる必要はありません。画像を Markdown ファイルと一緒に配置できます
- サイドバーカテゴリのインデックスページ：カテゴリラベルをページに関連付けられるようになり、ドキュメントの整理が向上しました
私たちのコードベースも時間の経過とともに磨かれてきました。テストカバレッジを改善し、すべてのパッケージを TypeScript に移行し、公開されるバンドルサイズを最大 60% 削減しました！
トレンド
npm
Docusaurus v2 は着実に成長を続けています。v2 のインストール数は v1 の 8 倍になりました。毎週のダウンロード数では、1 月初旬の 28,066 件から 12 月中旬のピーク時の 86,846 件へと 3 倍の増加 (+209.4%) を記録しました。
(ああ、お決まりのクリスマスの低下...)
2.0.0-alpha.71 から 2.0.0-beta.14 まで、18 個のバージョンをリリースしました。これは 20 日ごとに 1 回のリリースです！
GitHub
- スター：20,460 → 29,679 (+45.1% y/y)。そして、このブログ記事が公開される直前に、3 万スターに到達しました！
- 総貢献者数：512 → 773 (+51.0% y/y)
- 依存関係：v2 で 5,039 → 14,579 (+189.3% y/y)、v1 で 6,311 → 7,581 (+20.1% y/y)
- コミット：過去 1 年間で 1,187 件のコミットがあり、週平均 23 件のコミットです
- Issue：619 件の Issue がオープンされ、そのうち 505 件が最終的に解決されました
- 新しいコアチームメンバー (そう、私です 😝)
スターのトレンドも非常に良好です。類似のプロジェクトと比較して、より速いペースで成長しています
スターが 8.4k 増加し、今年のJavaScript 静的サイトジェネレーターのライジングスターで、Next.js と Astro に次いで 3 位にランクインしました。
注目の採用例
ショーケースには、Docusaurus 2 のプラグイン可能なアーキテクチャの真の可能性を示すいくつかの新しい「お気に入り」サイトが追加されました。
Docusaurus ユーザーの創造性は、私たちの想像をはるかに超えています 🤩 Docusaurus のコンテンツ機能を活用しながら、オリジナルのテーマデザインを模索する採用者がますます増えることを楽しみにしています！お使いのサイトで Docusaurus を使用している場合は、ショーケースに掲載させていただきたいと考えています。
コミュニティ
Discordのアクティブなモデレーターとして、コミュニティが活発になっていることがはっきりとわかります。よくある質問の多くはドキュメントに統合され、いくつかの機能リクエストも実装されています。プロジェクトとコミュニティは相互に利益を得ています。たとえば、私は以前コミュニティの貢献者であり、その後メンテナーになりました。
Twitter では、インスピレーションを与えるフィードバックが常に寄せられています
@docusaurus は素晴らしい！こんなに簡単に使えるなんて信じられません。
追加のプラグイン、ツール、コンパイル手順は不要です。そのまま使えます。
@docusaurus が大好きです。Docusaurus なしでは、サイトに含まれる API、チュートリアル、ブログを効率的かつ美しくワークフローに組み込むことはできませんでした。
そして、それらすべてを私たちの小さな箱に保管しています 😄 Docusaurus をお楽しみいただけましたら、コメントを付けて私たちをタグ付けしてください！
公式リリースが近づくにつれて、プラグインの作成者、カスタマイズされたサイトの作成者、すべての新しいユーザーなど、人々が何をしているのかについて、より深く知りたいと考えています。成果についてお知らせいただければ、皆様のニーズにより適切に応えられるように開発を進めることができます。
今後の展望
ここ数か月間、Docusaurus のリリース候補フェーズについて常に話し合ってきましたが、はい、もうすぐそこまできています。次の段階に自信を持って進むことができるようになる前に解決する必要があるすべての Issue を追跡するために、専用のマイルストーンを作成しました。簡単に言えば、私たちはより堅牢なテーマワークフローを構築し、クリエイティブなサイト作成者がアップグレード時に変更を壊すことを恐れることなく、デフォルトテーマをカスタマイズできるようにしたいと考えています。これには以下が含まれます
- コンポーネント構成に関するガイドライン。サイトの一部をカスタマイズする場合に、必要なことだけを行うコンポーネントが常に存在するように、テーマコンポーネントが適切な粒度を持つようにしたいと考えています。
- swizzle CLI の改善。ユーザーが喜んで使用し、考えられるすべてのスウィズルシナリオで役立つようにしたいと考えています。
- テーマ API のリファクタリング。すべてのスウィズル可能なコンポーネントが実際にスウィズルに適したものになるように、非 UI コンポーネントは再配置されます。
- ドキュメント。初めてのコーダーから経験豊富な Web 開発者まで、誰もが最大限にアクセスできるようにしたいと考えています。あらゆるスキルレベルに役立つ、より段階的なチュートリアルとして整理します。
Docusaurus 2.0 の計画の詳細については、このロードマップ issue を参照してください。2.0 はコミュニティの協力によって実現する大規模なリリースとなるため、マイルストーン issue のいずれかにご意見やご提案をお寄せください！
コアチームが一般公開リリースに向けて熱心に取り組んでいるため、2.0 以降はマイナーバージョンとして他の便利な機能をリリースする予定です。さらに、3.0 でのアーキテクチャの変更についても計画を進めています！
Docusaurus 2.0の正式リリースにより、v1からの新規導入や移行がさらに進むと確信しています。
2021年のすべての貢献者に感謝の意を表します。特に以下の方々には格別な感謝を申し上げます。
- コアチーム：Alexey Pyltsyn、Sébastien Lorber、Joshua Chen、Yangshun Tayには、コミュニティの管理、Docusaurusの広報、課題のトリアージ、新機能の実装にご尽力いただきました。
- Joel Marceyには、Docusaurusの作成と開発を長きにわたりサポートしていただきました。
- Algoliaチームには、Docusaurusユーザーの新しいDocSearchへの移行を支援し、検索に関する質問に答えていただきました。
- 活発なコミュニティメンバーの皆様には、貴重なコードの貢献、ドキュメントの改善、Discordでの質問への回答にご協力いただきました。
さようなら、2021年。素晴らしい2022年を迎えましょう！