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 テーマに設定を追加する方法
- テーマ クリエーター、Discourse をインストールせずにテーマを作成して表示する！
このドキュメントはバージョン管理されています。変更はgithub で提案してください。