単一カテゴリスタイルのサイト設定への移行

:information_source: Discourseのアップデートが[date=2023-11-13 timezone=“America/New_York”]以降に行われた場合、この変更が含まれます。

UIでのカテゴリの表示方法(サイドバーやチャット、投稿でカテゴリに言及する際など)を統一するため、category_styleサイト設定からデフォルト以外のカテゴリスタイルを削除し、最終的にこの設定自体を削除します。

:information_source: すでにデフォルト(箇条書き)のカテゴリスタイルを使用している場合は、何もする必要はありません。

デフォルト(箇条書き)以外のカテゴリスタイルを使用している場合は、すぐに安全にインストールできる新しいテーマコンポーネントがあります。これをインストールすると、最終的にコアからこの設定が削除された後も、サイトは既存のカテゴリスタイル設定を引き続き使用します。

非デフォルトのカテゴリスタイルに強くこだわりがない場合は、サイトに追加のテーマコンポーネントが必要になるのを避けるために、デフォルト(箇条書き)スタイルに戻すことをお勧めします。手順は以下のとおりです。

デフォルトの箇条書きスタイルに戻すためにインストールするものは何もありません。

category_style管理設定を探し、「bullet」に変更します。次のように表示されます。

手順は以下のとおりです。

  1. サイトで /admin に移動します。
  2. メニューから「SETTINGS」を選択します。
  3. 「category style」を検索します。
  4. 「category style」のプルダウンを選択し、「bullet」を選択します(または「RESET」を選択してデフォルトの箇条書きに戻します)。

上記を実行すると、カテゴリが表示されるすべての場所で箇条書きスタイルが表示されるようになります。

まもなく、デフォルトのカテゴリスタイルを使用していないすべてのサイトの管理ダッシュボードに、コアからカテゴリスタイル設定が削除される前に、Category Badge Styles テーマコンポーネントをインストールする必要があることを通知するメッセージが表示されます。

テーマコンポーネントをインストールしたら、引き続き使用したい既存のカテゴリスタイルを選択してください。ここで選択した設定は、カテゴリスタイル設定がコアから削除されるまで有効にならないことに注意してください。これは、シームレスな移行を保証するための措置です。

「いいね!」 22

これは、このようなテーマコンポーネントにどのような影響がありますか?

「いいね!」 16

同じ質問です。カテゴリアイコンを使用する場合、通常、カテゴリスタイルは none に設定されます。そうしないと、アイコンと箇条書きの両方が表示されてしまいます。現在:

これはカテゴリアイコンコンポーネントにマージされるのでしょうか、それともアイコン付きのプレーンなスタイルには2つのコンポーネント(またはカスタムスタイル)が必要になるのでしょうか?

その他のフィードバック:

現在、サイドバーのスタイルは箇条書きバッジのように見えますが、同じクラスの要素ではなく、同じスタイル宣言で宣言されていません。したがって、クラスとスタイル宣言も統一されるのでしょうか?

例:丸い箇条書きにしたい場合:

これは、箇条書きバッジに簡単な宣言で実現できます:

.badge-wrapper.bullet .badge-category-bg {
  border-radius: 10px;
  width: 9px;
}

サイドバーで同じプレーンな色の丸い箇条書きを表示するのは、より複雑になります。(デフォルトでは、親カテゴリと子カテゴリのカラーがグラデーション宣言で混ざり合います)例として、最近これを行いました:

.sidebar-section-link-prefix > span {
// 親カテゴリの背景色を非表示にする
  background-size: 15px 15px !important;
  background-position: right center !important;
}
.sidebar-section-link-wrapper .sidebar-section-link-prefix .prefix-span {
  width: 0.5em;
  height: 0.5em;
  border-radius: 50%;
}
「いいね!」 15

では、公式のDiscourseサイト(このmeta.discourse.org)も箇条書きスタイルに戻るのでしょうか?(いくつかのカテゴリでも「ボックススタイル」が使用されていることに気づきました)。問題なく機能していた機能が削除される理由がわかりません。コードの保守が大変すぎるのでしょうか?それとも、将来的に同じテーマコンポーネントを宣伝・販売するためでしょうか?

「いいね!」 1

category style 設定は、カテゴリページのレイアウトではなく、カテゴリバッジのスタイル用です。

こちらは「box」バージョンです。

デフォルトの「bullet」と比較すると、

sidebarhashtag-autocomplete の導入により、これらのスタイルが UI のすべての要素でうまく機能しなくなりました。ほとんどのサイトではデフォルトを使用しているため、それでも必要なサイトのためにテーマコンポーネントを作成し、全体を簡素化するためにコアから設定を削除するのが理にかなっています。

当社のテーマコンポーネントはすべて無料ですので、何かを販売する機会を探しているわけではありません。 :slight_smile:

「いいね!」 13

もしブレイクの最初の投稿を正しく理解していれば、ここでは何も削除されず、新しいhttps://github.com/discourse/discourse-category-badge-stylesテーマコンポーネントを使用して、現在と同じようにサイトを構成できるようになります。それをインストールして、カテゴリスタイルを`none`に設定するだけです。`category style`サイト設定が存在する間はまだ効果がありませんが、すぐに実行できます。

テーマコンポーネントの設定は次のようになります。

「いいね!」 4

それは、私にとって別の疑問を提起します。カテゴリは現在、表示スタイルの色選択を none で無効にしているので、TC もその動作に一致するのでしょうか、それとも色選択を許可するのでしょうか?色選択を許可する場合、カテゴリの色の設定がずっと簡単になります。

「いいね!」 3

サイトで試したところ、「box」オプションに顕著なスタイルの違いが見られました。

テーマコンポーネントなしの状態は以下のようになります。

CleanShot 2023-10-18 at 18.58.06@2x

テーマコンポーネントありの状態(.badge-wrapper.box からのパディングが大きく、var(--category-badge-text-color) からの青いフォント)は以下のようになります。

「いいね!」 8

これをテストしたところ、再現することができました。

「いいね!」 10

「デスクトップカテゴリページスタイル」設定を削除または変更する予定はありますか?

「いいね!」 2

このテーマコンポーネントは、代替スタイルを削除する変更がDiscourseにマージされるまで正常に機能しません。現在、私たちの作業はブランチ(https://github.com/discourse/discourse/tree/category-bullet-only…)にあり、テーマコンポーネントはそれで動作しています。まだ作業中です。

カテゴリアイコンコンポーネントはリファクタリングが必要になります。このアップデートが行われる前に、それに取り組むことができます。

デフォルトの箇条書きカテゴリスタイルとアイコンについては、コンポーネントで処理されるはずです…しかし、追加のボックス/バーのスタイルについては、両方のコンポーネントが必要になります。

これは、#announcementsのようなメンションにも当てはまります。私たちはこれを調査しましたが、共有コンポーネントを使用するのは複雑すぎるという結果になりました…しかし、バリエーション間でHTMLとCSSをどの程度密接にミラーリングできるか再確認できます。

理由はいくつかありますが、デフォルトの箇条書きスタイルは、私たちがホストしているサイトの大多数で使用されており、サイドバーやカテゴリメンション(例:Announcements)のような新機能を導入するにつれて、複数のスタイルは物事を複雑にします。

複数のバリエーションをサポートするということは、すべてを3〜4回対応し、テストする必要があるということです。これは、機能が純粋に視覚的であり、サイトの小さな割合しか使用しない場合、正当化するのが難しくなります。このようなものをテーマコンポーネントに移動すると、代替スタイルを使用するサイトを引き続きサポートしながら、Discourseを少し簡素化できます。

通常、テーマコンポーネントを販売することはありませんが、エンタープライズ顧客向けにカスタムコンポーネントを構築しています。この変更の計画はありません。

現時点では計画はありませんが、これは同様の状況であり、ほとんどのサイトはデフォルトスタイルを使用しています(圧倒的多数)。もしそうするのであれば、同様の計画に従い、テーマコンポーネントを介して削除されたスタイルをサポートするでしょう。

「いいね!」 13

デフォルトに戻すには、警告を削除するにはどうすればよいですか? カテゴリバッジのスタイルを「箇条書き」に設定しますか?

「いいね!」 3

はい、その通りです。すぐに変更する必要はありませんが、変更するまで管理者のホームページに警告が表示されます。

「いいね!」 4

そして、そのヘルパーコンポーネントは、ある時点で機能を開始し、箇条書きを非表示にするのでしょうか? 現在、箇条書きはそのまま表示され、アイコン(私にとってはnoneとcategoryアイコン)も表示されます。

「いいね!」 2

この問題を修正するために、テーマコンポーネントにアップデートをプッシュしました。最新バージョンにアップデートして有効にすることができます。

これにより、テーマコンポーネント内で既存のカテゴリバッジスタイルを選択できるようになりますが、まだ効果はありません。

「いいね!」 3

フォーラムを箇条書きに戻し、テーマコンポーネントを「なし」にリセットしましたが、箇条書きが表示され続けています。これは意図した動作でしょうか?

「いいね!」 3

「なし」にしたい場合は、現時点では両方を「なし」に設定する必要があります。これにより、コアが更新されたとき(コアの更新はまだ作業中です)に、それらの設定がコアから削除されるため、テーマコンポーネントは「なし」のままになります。現在は、コア設定の優先度がまだ高くなっていますが、まもなくテーマコンポーネントで選択したものになります。

「いいね!」 4

これで完璧に動作します。迅速なアップデートをありがとうございます!

「いいね!」 4

ありがとう、箇条書きでうまくいきました。実際、以前は箇条書きがもっと小さかったので線を使っていたことを思い出しました。(しかし、それは私のテーマで変更されたのかもしれません、わかりません)。

「いいね!」 4

インストールプロセスのビデオはありますか?プロセスを表示しながら同時に指示を読むことができるので、役立ちます。元に戻せないような大きな変更を誤って加えてしまうのではないかという恐れから、サイトへの変更はめったに行いません。

「いいね!」 2