Discourse ドキュメントカテゴリー向け視覚的インデックスエディタの導入

ドキュメントカテゴリーでは、サイドバーのインデックスを管理画面のUIで直接作成できるようになりました。インデックスエディタはDoc Categoriesプラグインの近日導入予定の変更であり、個別のインデックストピックを維持管理する必要がなくなります。

インデックスの作成方法3つ

カテゴリーの編集に、モードセレクター付きのドキュメントインデックスタブが追加されました。

  • エディタ: リンクを含むセクションとして、その場でインデックスを作成します。
  • インデックストピック: 従来の動作で、トピックの見出しとリストがインデックスになります。
  • 無効: そのカテゴリーのサイドバーインデックスをオフにします。

すでにインデックストピックを参照しているカテゴリーは、現在と全く同じように動作し続けます。

インデックスの構築

セクションはリンクを含み、リンクはトピックまたは入力したURLのいずれかを指します。各リンクには固有のアイコンを付けることができ、2つのリンクが同じ場所を指す場合や2つのセクションが同じタイトルを持つ場合、エディタが警告を表示します。

カテゴリー内のトピックでインデックスに表示されていないものがある場合、画面に通知が表示され、それらのトピックを一括で追加できます。

自動インデックスセクションは、カテゴリーのトピックから自動的にコンテンツを埋めるため、重要なページを手動でリストアップし、残りはすべて1か所にまとめて表示できます。保存ごとに再同期させることも可能です。

セクションとリンクはドラッグ&ドロップで並べ替えることができます。すべてのドラッグハンドルは通常のタブストップとしても機能し、移動メニューを開けるため、キーボードのみでもインデックス全体を並べ替えることができます。バッチモードでは複数選択が可能で、複数の行を一括削除したり、選択範囲全体をまとめてドラッグしたりできます。

サイトで有効にする

インデックスエディタは試験的な近日導入予定の変更です。/admin/config/upcoming-changesでDoc categories index editorを有効にしてください。これはドキュメントカテゴリーのみに影響し、管理者がカテゴリーを編集している間のみ表示されます。

フィードバックをお待ちしています

実際のインデックス運用に対する感想をお聞かせください。ここでインデックスを作成するのがトピックを維持管理するより優れているかどうか、カテゴリーを移行する前に不足している機能、または粗雑に感じる部分など、何でも構いません。

「いいね!」 7

当初のPR FEATURE: Add visual doc category index editor - Pull Request #87 - discourse/discourse-doc-categories - GitHub は、実験的な今後の変更として統合されたばかりです。この機能は、Alpha段階へ移行する前に、今後1〜2週間の間にさらなる改良が加えられる可能性があります。

「いいね!」 1