ナレッジベース

:warning: このテーマコンポーネントの機能は、Discourse Docs プラグインに置き換えられました

このテーマコンポーネントは、選択されたカテゴリに対してナレッジベース風のビューを可能にします。

:link: リポジトリリンク

:link: テーマクリエーターでプレビュー


設定で有効化されたカテゴリのナビゲーションピルに、KBボタンが追加されます。

このビューに切り替えると、ナレッジベースには最新のトピックリストの簡略化されたバージョンが表示されます。

サイドバーのタグをクリックすると、トピックリストが自動的にそのタグでフィルタリングされます。任意の数のタグを選択でき、フィルタリングされたトピックに付けられたタグのみがタグリストに表示されるため、大量のドキュメントを閲覧しやすくなります。

検索したい場合は、ボックスに用語を入力するだけです。検索結果も選択したタグに制限されます。

考慮事項

このコンポーネントが機能するには、以下のサイト設定が必須です:タグ付けの有効化 および タグによるフィルタ表示

このテーマコンポーネントには現在、モバイルビューは用意されていません。

とはいえ、より高度なバージョンの構築に取り組んでいます。準備が整い次第、Meta でお知らせします!

「いいね!」 27

このコミットで基本的なモバイル表示が追加されました。

完璧ではありません。タグが多数ある場合、それらをスクロールして表示する必要があります。その問題を解決するためのいくつかの案を検討中です。

「いいね!」 9

私たちは4年以上にわたり、Discourseをナレッジベースとして利用しており、ナレッジベース固有の投稿は約350件あります。これは非常にエキサイティングです!

テーマコンポーネントを通じてこれが可能かどうかはわかりませんが、カテゴリを開いたときにこの「ビュー」をデフォルトにすることは可能でしょうか?つまり、/c/knowledge-baseに移動するのではなく、自動的に/c/knowledge-base?kb=activeとして読み込まれるようにすることはできるでしょうか?

KBテーマコンポーネントを有効にしており、非常に気に入っていますが、以前ブックマークしていた/c/knowledge-baseリンクを使用しているため、ユーザーがKBビューを見ていないのではないかと懸念しています。

この機能の開発に尽力していただき、ありがとうございます。

「いいね!」 6

これに関する設定を追加するよう検討します!ご提案いただきありがとうございます。また、これが役立つと聞いて嬉しいです。

「いいね!」 6

これは現在、テーマ設定として実装されています。サブカテゴリもサポートされるようになりました!

「いいね!」 9

更新しました。素晴らしいです、ありがとうございます!

「いいね!」 3

サブカテゴリにこれを適用するにはどうすればよいですか?特別な構文はありますか?

ありがとうございます!コミュニティ内にこのコンポーネントを適用するのに最適なカテゴリがあるのですが、問題に直面しています。「kb categories」のドロップダウンにカテゴリが表示されないため、コンポーネントを適用するカテゴリを選択できません。アドバイスをお願いします。

カテゴリのスラッグを入力するだけで作成できます。直感的ではありません。サブカテゴリの作成方法についてはまだ見つけられていませんが、カテゴリが最上位レベルにある場合は非常に簡単です。

「いいね!」 1

はい、非常に直感的ではありません。「作成」ボタンを押してカテゴリを作成すると、機能するようですが、期待通りに表示されません。

テスト用にDiscourseを新規インストールし、両方のコンポーネントを設定しました:

br%20a170a9ec422c

(D.I.Y. / diy はKBを有効にしたいカテゴリで、カスタムトップナビゲーションリンク コンポーネントを使用して作成された特定のトップリンクを持っています)

br%2086f9546a1534

しかし、D.I.Y. カテゴリは通常の表示で現れます:

URL の末尾には /c/diy?kb=active と表示されています。

「いいね!」 1

特別な構文はありません。kb categories というテーマ設定に、カテゴリ(サブカテゴリかどうかは問いません)のスラッグを入力し、ブラウザをリフレッシュするだけで動作するはずです。

これは現在、テーマ設定の制限によるものです。@Sean_R が提案したように、スラッグを手入力する必要があります。

@TowerBR さん、問題は解決しましたか?設定にカテゴリを追加した後、ブラウザをリフレッシュしましたか?KB ボタンをクリックしましたか?馬鹿げた質問で申し訳ありませんが、根本的な原因を突き止めようとしています。

「いいね!」 1

動作しました、ありがとうございます :slight_smile:

この方法が気に入っています。すべての KB サブカテゴリに同じ名前を付けられ、一度だけ追加するだけで済むからです。

ただし、ドロップダウンからカテゴリに移動すると、KB ビューに自動的に切り替わらないことに気づきました。

他のすべてのナビゲーション方法は問題なく動作しますが、サブカテゴリのドロップダウンだけが機能しません。

「いいね!」 2

「デフォルトでKBビューを使用」がオンになっていますか?私のサイトのサブカテゴリでテストしたところ、問題なく動作しているように見えました。

「いいね!」 2

はい、動作しますが、サブカテゴリのドロップダウンを使用してカテゴリを別のカテゴリに変更する場合は、動作しないことがあります。

奇妙ですね。もし再現できる場合はお知らせください。確認いたします。サブカテゴリのドロップダウンからは、その動作を再現できていません。

「いいね!」 2

はい、すでにその手順は済ませていますが、上の投稿の画像をご覧ください:post above

br%2086f9546a1534

「カスタムトップナビゲーションリンク」コンポーネントを削除しました。現在は完全に「クリーン」なインストール状態です:

br%20346e44618d61

はい、キャッシュもクリアしました。

はい。メインのドロップダウンからカテゴリを選択すると、URL の末尾に /c/diy?kb=active が付いた状態でカテゴリページが既に読み込まれます。KB ボタンにカーソルを合わせると、この「アドオン」なしの「通常」の URL が表示されますが、クリックしても何も起こりません。

テーマコンポーネントの最新バージョンで動作していますか?Discourse のバージョンは tests-passed または stable で動作していますか?

「いいね!」 2

毎回同じことが起こります。「KB」をクリックするか、リフレッシュすれば直りますが、ドロップダウンからカテゴリに移動した場合は直りません。

はい:

params:
   version: tests-passed
「いいね!」 3

素晴らしいですね!早速インストールして見てみましたが、すでに非常に有用であることがわかります。

このテーマコンポーネントは、@angus による https://meta.discourse.org/t/knowledge-base-plugin/115288 のプラグインと競合しているようです。このテーマコンポーネントを有効にする前に、そのプラグインをアンインストールする必要があります。そうでないと、知識ベースのカテゴリを表示した際に以下のような現象が発生します。メニューの横に奇妙な水平線と回転する円が表示されていることに注意してください。

アドバンスド版について、そして今後の予定についてもっとお聞きできればと思います。いくつかのフィードバックを共有します:

  • バグ?左側のメニューからタグを選択してそのタグでフィルタリングした後、他のカテゴリや最新記事などに移動すると、次に「KB」をクリックして知識ベースに戻っても、まだそのタグでフィルタリングされた状態のままになります。
  • タイトル下のタグをクリックすると、そのタグのタグページに移動しますが、左側のメニューのタグをクリックしたときのように、フィルタリングされた KB ビューには移動しません。
  • 左側のメニューでタグカテゴリのタイトルをクリックすると、そのカテゴリの最新記事ビューに移動します。これはリンク先を設定しないことをお勧めします。また、カテゴリタイトルに # を含める必要はないでしょう。これは気が散る要因です。
  • 左側のメニューで、各タグに関連するトピック数を表示できると便利です。
  • KB トピックをアルファベット順、あるいはカスタム順序でソートできると便利です。
「いいね!」 4