Discourseは非常にカスタマイズ性が高く、テーマを通じて外観のほぼあらゆる面を変更することができます。
Discourseの継続的な更新や新機能との互換性を維持するためには、すべてのテーマにおいて定期的なメンテナンスが必要です。メンテナンスの頻度は、カスタマイズの複雑さや種類によって異なります。以下のガイドラインに従うことで、テーマのメンテナンス負荷を最小限に抑えることができます。
- 公式のテーマまたはテーマコンポーネントで、目的の機能に一致するものがないか確認してください。これらはDiscourse本体と連動して更新されます。また、独自のカスタマイズを行う際の参考例としても活用できます。
- 管理画面の「カスタマイズ → テキスト」機能を使用して、特定のテキストを検索し、そこで置き換えることで、インターフェースのテキストを変更してください。
- テーマのCSSは付加的な性質を持つため、デフォルトのスタイルを直接編集せずに上書きすることができます。このアプローチにより、CSSのメンテナンス性が向上し、更新との競合を最小限に抑えることができます。
- Git（GitHub、GitLab、Bitbucketなど）のようなバージョン管理システムを使用して、変更を追跡してください。管理画面の「カスタマイズ → テーマ」にあるHTMLおよびCSSエディタは、細かな調整には便利ですが、より複雑な変更を追跡・トラブルシューティングするには、バージョン管理システムの方が適しています。
- 高度なカスタマイズを行う場合は、新しい機能のために独立したモジュールを作成し、プラグインアウトレットを通じて統合してください。DiscourseはEmber.jsを使用しているため、Emberコンポーネントの構築が理想的です。この方法により、カスタム機能は分離され、メンテナンスが軽減され、Discourseの更新との競合を回避しやすくなります。
テーマ内でDiscourseのデフォルトJavaScriptやHTMLテンプレートを上書きすることは、最終手段としてのみ行うべきです。これらの変更はDiscourseの更新と互換性がなくなりやすく、トラブルシューティングが困難で、ダウンタイムにつながるエラーを引き起こす可能性が高いためです。
Discourseテーマの使用や構築に関する詳細については、Metaコミュニティで質問してください。また、以下のテーマに関するガイドもご覧ください。
- Discourseテーマ使用の初心者向けガイド
- Discourseテーマのデザイナー向けガイド
- Discourseテーマの開発者向けガイド
- テーマやプラグインの問題をトラブルシューティングするためのセーフモードの使い方
- テーマとテーマコンポーネントの構造
- フォントテーマコンポーネントの作成と共有
- カラースキームの作成と共有
- テーマでDiscourseコア変数を使用する方法
- Discourseテーマに設定を追加する方法
- Theme Creator：Discourseをインストールせずにテーマを作成・表示！
このドキュメントはバージョン管理されています。変更提案はGitHubから行ってください。