テーマとテーマコンポーネントの構造

Discourse は、.tar.gz アーカイブまたはリモートの git リポジトリ(プライベートリポジトリを含む)から取得できるネイティブテーマをサポートしています。

テーマの例はこちらです: GitHub - discourse/discourse-simple-theme: Sam's simple discourse theme

git リポジトリは更新がチェックされます(1日1回)、または \u003ckbd\u003e更新を確認\u003c/kbd\u003e ボタンを使用することでチェックされます。変更が検出されると、\u003ckbd\u003e更新を確認\u003c/kbd\u003e ボタンが \u003ckbd\u003e最新版に更新\u003c/kbd\u003e に変わります。

image

テーマを作成するには、特定のファイル構造に従う必要があります。含めることができるファイルは次のとおりです。

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}.hbs
javascripts/{anything}.hbr

assets/{asset_filename}

settings.yml

上記のファイル :arrow_up: はすべてオプションなので、必要なものだけを作成すればよいです。

テーマの 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.

Discourse に、完全なテーマではなく テーマコンポーネント を追加することを示すには、about.json ファイルに \"component\": true という行を追加するだけです。

ファイル構造は、テーマのカスタム CSS / HTML と一致します。

さらに詳しく

#themes::tag の付いた他の記事を確認してください。

:information_source: 参照:


最終レビュー: @SaraDev 2022-08-15T21:00:00Z


\u003csmall\u003eこのドキュメントはバージョン管理されています - 変更提案は github で行えます。\u003c/small\u003e

\u003c!-- START DOCS ASSET MAP
[
{
"local_path": "/assets/theme-structure-1.png",
"local_sha1": "5d81758f2f3090bee941c034a5d5a8165df50ce4",
"remote_short_url": "upload://465qlv5OiFWlR8qrBc6wGExEt07.png"
},
{
"local_path": "/assets/theme-structure-2.png",
"local_sha1": "66944b3e613c84ac19333461a11ffb39988b5f32",
"remote_short_url": "upload://d4Smpts3JzE3LozxhVOInZNjv3S.png"
},
{
"local_path": "/assets/theme-structure-3.png",
"local_sha1": "971f8599d19fa8f30ba787bf7c74bdc54a5f9228",
"remote_short_url": "upload://vQ0g1yk6xAJqM2fLe2nCmTdsK9h.png"
}
]
END DOCS ASSET MAP –\u003e

「いいね!」 62
Alien Night Theme - A free Dark Theme for Discourse
Override values for auto-generated color variables
How to modify the header HTML, but still remaining the default founctions
Custom user fields show on Activity, but not Summary page
Add Unsolved button to top menu using custom HTML
How do I get started with Discourse development as a regular end user with no programming experience?
Custom assets upload folder?
Some basic questions about discourse and rails
Color Scheme Contest (with Prizes!)
Add support for theme settings
Create and share a font theme component
Create and share a color scheme
Split up theme SCSS into multiple files
Theme Developer Quick Reference Guide
Theme Developer Tutorial: 2. Creating a remote theme
Mobile View Loading different HTML as compared to Desktop
Developing Discourse Themes & Theme Components
Minimizing Maintenance on Theme Customizations
Need help with theme component Github
Allow users to select new color palettes
Challenges creating a custom color palette
Adding metadata and screenshots to a Theme
Push to digital ocean from command line and rebuild
Battle Axe - A free theme by the Tappara.co hockey community
Beginner's guide to using Discourse Themes
Discourse deployment using github or bitbucket?
How to remove sticky top bar?
Do you have original customisations?
Add custom content that only appears on your homepage
Highlight color
Timefuser Theme
Compact member list
Understanding the development/deployment process
CSS Theme Contest (with Prizes!)
How to bring in Latest topics when using category boxes
Need to include PGN (chess game notation) in a post
Custom header colour and category icons and login button
Automatic dark mode for embedded comments as well?
Add settings to your Discourse theme
Designer's Guide to getting started with themes in Discourse