Discourse は、.tar.gz アーカイブまたはリモート Git リポジトリ(プライベートリポジトリを含む)から取得できる ネイティブテーマ をサポートしています。
テーマの例:GitHub - discourse/discourse-simple-theme: Sam's simple discourse theme · GitHub
Git リポジトリは更新がチェックされます(1 日 1 回)、または 更新を確認 ボタンを使用してチェックできます。変更が検出されると、更新を確認 ボタンが 最新バージョンに更新 に変わります。
![]()
テーマを作成するには、特定のファイル構造に従う必要があります。含めることができるファイルは以下の通りです。
about.json(必須)
common/common.scss
common/header.html
common/after_header.html
common/footer.html
common/head_tag.html
common/body_tag.html
common/embedded.scss
desktop/desktop.scss
desktop/header.html
desktop/after_header.html
desktop/footer.html
desktop/head_tag.html
desktop/body_tag.html
mobile/mobile.scss
mobile/header.html
mobile/after_header.html
mobile/footer.html
mobile/head_tag.html
mobile/body_tag.html
locales/en.yml
locales/{locale}.yml
stylesheets/{anything}/{anything}/{anything}.scss
javascripts/{anything}.js
javascripts/{anything}.gjs
javascripts/{anything}.hbs
assets/{asset_filename}
settings.yml
上記のファイル
はすべてオプションです。必要なファイルのみを作成すれば十分です。
テーマの SCSS を複数のファイルに分割したい場合は、現在それが可能です。
テーマを複数の JS ファイルに分割したい場合は、必要な JS ファイルを javascripts ディレクトリに追加するだけです。
about.json ファイルの構造は以下の通りです。詳細については Adding metadata and screenshots to a Theme をご覧ください。
{
"name": "My Theme",
"component": false,
"license_url": null,
"about_url": null,
"authors": null,
"theme_version": null,
"minimum_discourse_version": null,
"maximum_discourse_version": null,
"assets": {
"variable-name": "assets/my-asset.jpg"
},
"color_schemes": {
"My Color Scheme": {
"primary": "222222"
}
},
"screenshots": ["screenshots/light.jpeg", "screenshots/dark.jpeg"]
}
テーマに設定を追加する方法については、こちらをご覧ください:Add settings to your Discourse theme
フルテーマではなく テーマコンポーネント を追加する場合は、about.json ファイルに "component": true という行を追加してください。
ファイル構造は、テーマのカスタム CSS / HTML と一致します。
さらなる読み物
#themes::tag タグ付きの他の記事もご覧ください。
関連記事:
- Developing Discourse Themes & Theme Components
- Install the Discourse Theme CLI console app to help you build themes
- Include assets (e.g. images, fonts) in themes and components
最終確認者:@SaraDev、2022-08-15T21:00:00Z
このドキュメントはバージョン管理されています。変更の提案は GitHub で行えます。

