チーム内のコミュニケーションには Discourse を使用しています。内部ハンドブック専用のカテゴリがあり、そこではすべての投稿がウィキとして扱われています。
Docs プラグインは内部ドキュメントの検索や閲覧に最適ですが、あるドキュメントページから別のページへリンクすると、通常のフォーラム表示に戻ってしまうという問題があります。
投稿間でのリンクを自動的に書き換え、Knowledge Explorer 内に留まるようにすることは可能でしょうか?
これは可能ですが、ややハック的な実装になってしまいます。各リンククリックにクエリパラメータを追加し、TopicController にパッチを適用して Docs ビューへリダイレクトする必要があります。ただし、すべての内部リンクが Docs 内のトピックを指しているわけではないため、その点も考慮する必要があります。
実装を試みる前に、この機能へのリクエストがもっと増えるのを見たいと考えています。
これには賛成です。さらに、リンクの元に関係なく、「Docs」トピックが常に最初に「Docs」ビューで表示されるようにする機能があればと思います。そうしないと、体験がやや一貫性に欠け、場合によっては自ら「ハック的」な印象を与えてしまうこともあります。
これは非常に役立ちます。別のプラットフォームから多くのドキュメントをインポートしましたが、それらは他のドキュメントにリンクしています。ドキュメントページ(/docs?category=123&topic=456)またはトピックページ(/t/topic-title/456)へのリンクを置き換えることを余儀なくされているようです。
トピックタイトルを含む情報量の多いトピックリンクを使用できると便利ですが、ドキュメントビューで表示されたときにドキュメントにリダイレクトされるようになります。
さらに、トピックを別のカテゴリに移動した場合、/docs?categoryリンクは正しく機能しなくなります。驚くべきことに、実際にはドキュメントビューでトピックが表示されますが、古いカテゴリのフィルターが設定されます。
これ、まさに探していたものです!
現在、ドキュメントのトピックへのリンクを /docs?ascending=false&category=22&topic=1564 のように追加していますが、これは非常に手間がかかります。
ちょっとした質問ですが、皆さんはこの機能のプルリクエスト(PR)もサポートしていますか?もしそうなら、喜んでスポンサーになります。
こんにちは、ご提案とプルリクエストの申し出ありがとうございます。ドキュメントの改善について話し合っており、各ドキュメントに2つのURLではなく単一のURLを持たせるというアイデアも含まれています。それがこの問題を解決すると思いますが、現在のドキュメント機能の大幅なリファクタリングが必要になるでしょう。
簡単な回避策があります。組み込みのパーマリンク機能が機能するのではないでしょうか?管理インターフェイスで定義できます。少し手間はかかりますが、共有するのに非常にきれいなURLが得られます。
ありがとうございます、フィードバックに感謝します!
とりあえず、提案された回避策を使用してみます。しかし、/docsにトピックを増やすほど、長いURLリストを手動で管理しなければならない場合、事態はより複雑になる可能性があります。