Discourseテーマの無効なバージョンリスト

正確にはそうではありませんが、もしかしたらそうかもしれません。

そのエラーが発生する理由は多数あります。最も一般的な理由は、おそらく .discourse-compatibility ファイルが空であることです [1][2][3]。(先頭の # はコメント行です)

この警告は実質的に、Discourse が現在のコンポーネント/プラグインの「最新」バージョンが現在の Discourse バージョンと互換性があるかどうか、あるいは古いバージョンのコンポーネント/プラグインをチェックアウトする必要があるかどうかを判断できないことを意味します。

コンポーネント/プラグインの .discourse-compatibility ファイルには、Discourse のバージョン範囲と特定のコンポーネント/プラグインのリビジョンとのマッピングを含めることができます。Discourse がマッピングを見つけると、最新バージョンではなくそのリビジョンを使用します。これには、開発者が以前の Discourse バージョンと互換性を損なう変更を加えた際に、ファイルを更新する必要があります。破壊的変更を行わなければ、ファイルは空のままになり、その結果、この警告メッセージが表示されます。

コンポーネント/プラグインが最新の Discourse バージョンで動作するかどうかは常に推測にすぎません。

私は 2026.1 向けにプラグインの開発を開始しました。したがって、Discourse の最低バージョンは 2026.1 となります。現在もそのバージョン(および現在の最新バージョン)に対して開発とテストを行っています。サポート対象となる以前の Discourse バージョンが存在しないため、.discourse-compatibility ファイルは空であり、その結果、この警告メッセージが表示されます。2026.1 のサポートが終了したら、新しい ESR(Extended Support Release)に移行する予定です。その時点で 2026.1 に対するテストは行わなくなり、.discourse-compatibility ファイルを更新して、ついに空ではなくなります。それによって初めて、私のプラグインに関するこの警告が消えます。

.discourse-compatibility ファイルに関する詳細情報: Introducing .discourse-compatibility: pinned plugin/theme versions for older Discourse versions