コミュニティ用語集？

貢献 特徴
1

こんにちは、Discourse 内でコミュニティ用語集を作成したいと考えています。例えば、このようなものです：

image
image795×331 34.9 KB

この機能はコア機能には含まれていないことは理解していますが、既存のプラグインはありますか？それとも、フォーラムでこれを実現するための創意工夫をされた方はいますか？

補足すると、フォーラムを用語集に変えるのではなく、フォーラムに用語集を追加したいと考えています。

よろしくお願いいたします！

「いいね！」 2
2

それをウィキ投稿にするのは、あなたが望むことですか？

「いいね！」 1
3

ウィキ投稿（コンテンツ用）と DiscoTOC（アルファベット間のナビゲーション用）の組み合わせは非常に優れています。

このプラグインが何らかの形で役立つかもしれないと興味深いです。

「いいね！」 5
4

ある程度は機能するかもしれませんが、私が考えているものとは少し異なります。用語集ページがあれば、各単語をその定義へのリンクにしたり、単語の直下に定義を表示したり（定義を表示するアコーディオン形式など）できます。前者の場合、サイト全体でリンク化することで、ユーザーが単語の定義ページに移動できますし、後者の場合、アコーディオンが開くようにできます。

上記はウィキと計画的なフレームワークで実現可能ですが、トピックではなく単語をより直感的に追加できる方法があれば、コミュニティでの使いやすさが向上します。また、ページ上部にあるアルファベット順のソーターも便利な機能です。

「いいね！」 2
5

DiscoTOC はまだ使ったことがありません。それを使えば実現できるかもしれません。Knowledge Explorer プラグインは素晴らしいですが、用語集やサイトの他の部分とどう連携させるかを考える必要があります。

「いいね！」 1
6

linkify というテーマコンポーネントがあります。数語程度であれば、これで目的が達成できるかもしれません。数十、数百の単語を扱う場合は、プラグインをおすすめします。

「いいね！」 5
7

少し試行錯誤して、テーマに CSS を追加し、用語集のリンクが標準のテキスト色で点線のアンダーラインが表示されるようにしました。

a.linkify-word { 
  text-decoration-line: underline; 
  text-decoration-style: dotted; 
  color: $primary; 
  text-underline-offset: 0.1em; 
}

（text-underline-offset のブラウザ互換性はまだ完全ではありませんが、少なくとも Firefox（デスクトップ）や Safari では、見た目が少し良くなります。）

例：

  • ライトテーマ、デスクトップ Safari
    Screen Shot 2020-04-13 at 12.53.38
  • Minima テーマ ダーク、モバイル Safari
    IMG_D6FF5C8CE093-1
「いいね！」 4
8

https://discourse.igkt.net/ フォーラムの用語集セクションに取り組んでおり、次のように作成しました。

  • 用語集エントリのカテゴリを作成します（私の場合は #glossary）

  • 用語集トピックを作成します。私の場合は、用語集の各コンセプトに対して1つのトピックを作成しましたが、別の方法として、トピックを少なくしてMarkdownの見出しを使用し、アンカースタイルのリンクを使用することもできます。一意のリンクを持つものは何でも機能します。

  • 組み込みのWatched Words機能を使用して、用語集の単語（および同義語）を関連するトピックにリンクします。（残念ながら、これは手動で行う必要があります。これに関する自動化を思いつかない限り）

これはそのフォーラムの新しい機能なので、それが有用であるかどうか、用語集のカバー範囲が十分であるかどうか、そしてユーザーがこれらの単語に独自のリンクを追加する能力を妨げるかどうかについて、フィードバックが寄せられると確信しています。

用語集を実装した他の人がいれば、その方法についてぜひお聞きしたいです。

「いいね！」 3
9

私もこれを試みましたが、技術的および社会的な理由から、実際に機能させるのは驚くほど難しいです。

私のヒント：

  1. ウォッチワードを使用する場合は、制限的な正規表現を使用してください。そうしないと、役に立たないタイミングで適用されてしまいます。

  2. トピックテンプレートは、貢献の良い構造を奨励するのに非常に役立ちます。

  3. チャンピオンが必要です。または、自分でチャンピオンになる覚悟をしてください。大変な作業です！

「いいね！」 1
10

これらの2つの#theme-componentが役立つかもしれません。

サイトのドキュメントの一部としての用語集は良い考えです。その目的のために、プラグイン Doc Categories は非常に役立ちます。私は通常、ユーザーインターフェースなどに関するさまざまなドキュメントのトピックをハウツーとしてコピーします。

https://meta.discourse.org/t/auto-linkify-words/82193

https://meta.discourse.org/t/add-abbr-tags-to-words-in-posts/88394

「いいね！」 1