Discourse は高度にカスタマイズ可能であり、テーマを通じてその外観のほぼすべての側面を変更できます。
継続的な Discourse のアップデートや新機能との互換性を維持するために、すべてのテーマには時折メンテナンスが必要です。メンテナンスの頻度は、カスタマイズの複雑さと種類によって異なります。テーマのメンテナンス作業を最小限に抑えるには、次のガイドラインに従ってください。
- 必要な機能に一致する公式の テーマ または テーマコンポーネント があるか確認します。これらは Discourse と共に更新されます。これらは、独自のカスタマイズにアプローチする方法の例としても役立ちます。
- 管理 → カスタマイズ → テキスト機能を使用してインターフェーステキストを置き換えます。目的のテキストを検索し、そこで更新します。
- テーマの CSS は加算的なので、デフォルトのスタイルを直接編集せずに上書きできます。このアプローチにより、CSS のメンテナンス性が向上し、アップデートとの競合が最小限に抑えられます。
- 変更を追跡するために、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でお願いします。