Discourse のテーマとテーマコンポーネントを使用して、Discourse のフロントエンドの外観、感触、および機能をカスタマイズできます。開発者ガイドのこのセクションは、簡単なテーマを単一のサイト用に開発する場合から、複雑なオープンソースのテーマコンポーネントまで、必要となるすべてのリファレンス資料を提供することを目的としています。
このはじめにでは、テーマ開発のためのすべてのツールと API の概要を提供することを目的としています。テーマ開発のステップバイステップのチュートリアルをご希望の場合は、こちらに直接移動してください。
テーマとテーマコンポーネント
Discourse テーマ は、CSS と JavaScript を使用してフロントエンドのユーザーエクスペリエンスをカスタマイズするために使用できます。各テーマには独自の git リポジトリがあり、コミュニティ管理者は、共有ホスティングプラットフォーム上であっても、通常、Discourse 管理パネル経由でインストールおよび管理できます。
テーマコンポーネント は、全体的なテーマの一部として、他のテーマコンポーネントと連携して使用することを意図したテーマです。開発の観点から見ると、テーマコンポーネントとテーマはほぼ同一です。これらのガイドでは、「テーマ」と「テーマコンポーネント」という用語は同義語として使用されます。
前提条件
まず、Discourse で既存のテーマとテーマコンポーネントを使用する方法を理解していることを確認してください。既製のテーマを使用することが、コミュニティをカスタマイズするための最も速く安全な方法です。それ以上のカスタマイズが必要な場合は、独自のテーマの作成を検討する時が来ました。
Discourse の全体的なアーキテクチャの一部として、Discourse テーマは標準の HTML、CSS、JavaScript テクノロジーを使用して構築されており、より高度な UI のために Ember の概念を利用しています。これらのリファレンスガイドは、これらのテクノロジーの基本的な理解を前提としており、可能な限り外部リファレンスへのリンクを示しています。
Discourse は急速に進化するプロジェクトであるため、カスタムテーマは時間の経過とともにメンテナンスが必要になります。計画と開発プロセスの一部としてこれを考慮するようにしてください。
はじめに
フロントエンドのカスタマイズ
その他！
残りの開発者ガイドも確認してください！
このドキュメントはバージョン管理されています - 変更の提案はgithubで行ってください。