Discourseの脚注

:discourse2: 概要 Discourse Footnote を使用すると、投稿内で Markdown 形式の脚注を作成できます。
:open_book: インストールガイド このプラグインは Discourse コアにバンドルされています。別途インストールする必要はありません。

脚注の有効化

Footnote プラグインはデフォルトで有効になっていますが、admin/plugins ページから無効化/有効化できます。

enable footnote

機能

有効化すると、以下のように入力することで投稿に脚注を追加できます。

脚注が必要な文章。 ^[脚注の内容] 
脚注が必要な別の文章。 ^[2 番目の脚注の内容]

または以下のようにも可能です。

脚注が必要な文章。 [^1] 
脚注が必要な別の文章。 [^2]

[^1]: 脚注の内容
[^2]: 2 番目の脚注の内容

投稿内で両方のスタイルを自由に組み合わせることもでき、番号付き以外のアンカーを使用することもできます。

display footnotes inline 管理設定によって制御される 2 種類の脚注表示方法があります。

インライン以外:

インライン:

脚注が必要な文章[1]
脚注が必要な別の文章[2]

インライン版は、引用やモバイル環境にも最適です。

設定

名前 説明
enable markdown footnotes このサイトで Markdown 形式の脚注を有効にする
display footnotes inline 脚注のインライン展開を有効にする

:discourse2: 当社のホスティングを利用していますか?このプラグインは、すべてのホスティングプランで利用可能です Footnote | Discourse - Civilized Discussion

開発履歴

Discourse footnote は、@Vitaly による footnote markdown.it 拡張機能 を Discourse プラグインとして再パッケージ化したものです。


  1. 脚注の内容 ↩︎

  2. 2 番目の脚注の内容 ↩︎

「いいね!」 73

拡張機能は、[^1] を使用した通常の脚注のマークダウンを許可していないようです。注意しておきます。インライン形式を使用しない限り、脚注はフォーマットされません。

インライン脚注形式を使用して脚注を有効にすると、自動番号付きの脚注が投稿の下にまとめて表示されます。また、インライン展開を有効にすると、投稿の下に脚注が表示されない、エリプシスツールチップのような体験が得られます。インライン展開オプションが有効になっている場合、投稿プレビューウィンドウは従来の番号付き脚注のように見えますが、公開後はインライン展開効果が表示されます。

インライン形式を使用した自動番号付き脚注はありがたいのですが、マークダウンをどのようにフォーマットすべきか、そして望ましい動作を得るためにどのオプションを使用すべきかを理解するのに数回試行錯誤しました。このコメントが他の人の混乱を避けるのに役立つことを願っています。

追記:インライン展開オプションは、そのオプションが有効になっているかどうかに関わらず(デスクトップでも)、モバイルで脚注がどのように表示されるかです。

「いいね!」 5

このDiscourseフットノートプラグインを使用して、ユーザーがインラインポップアップコンテンツを作成できるようにするレシピ:

このプラグインとComposer Footnote Button Theme Componentを組み合わせます [1](これにより、コンポーザー/エディターにフットノートを作成するためのボタンが提供されます)

ポップアップ内にはHTMLを含むあらゆるものを配置できます。

例:

テキスト [2]


テキストと画像のアップロード [3]


HTMLコンテンツ [4]


  1. (両方をインストールしてください) ↩︎

  2. ここにプレーンテキストが入ります。 ↩︎

  3. テキストと画像のアップロード

    ↩︎

  4. 初めてオープンソースグループに出会ったとき、それは当惑するような経験かもしれません。メーリングリストに初めて投稿するときも、取り組んでいるプロジェクトについてブログを書くときも、IRCチャンネルでチャットするときも、人々が交流する方法や、お互いに期待することは、教室や友人や家族との間とはかなり異なります。


    オープンネスと共有

    オープンソースのコミュニケーションは大きく異なる場合があります。共通して持っている中核的な価値観は、コードを共有することは良いということです。ライセンス、言語、インデントスタイルに関係なく、オープンソース開発者はソースコードを一緒に作成、共有、変更します。

    ↩︎

「いいね!」 14

フッタープラグインは公開ページでも機能しますか?私の特定のケースでは、公開ページでは機能せず、通常のトピックビューでのみ表示されるようにしたいです(内部メモなどに使用するため)。

@jrgong – いいえ…

ただし、この代替アプローチがあり、現在テーマコンポーネントを開発中です… Githubで

「いいね!」 2

これは17時間前にコアに移されたようです。
誰か適切な方に更新してもらいます。

翻訳が見つかりません: en.The discourse-footnote plugin has been integrated into discourse core. Please remove the plugin from your app.yml and rebuild your container.
「いいね!」 3

コアに移行した後、
app.ymlからプラグインを削除し、./launcher rebuild appを実行しましたが、
設定はプラグインページに残ったままです。このままにしておいても大丈夫でしょうか?

それが新しいものです。:+1: 比較のために両方の写真を載せます。

old one

new one

「いいね!」 4

それはとても良い音ですね!:+1: シェアしてくれてありがとう。:smiling_face_with_three_hearts:

これについて言及していただきありがとうございます。修正をプッシュしました。

「いいね!」 3

もう一つの問題は、プラグインをインストールする必要がなくなったことです。もしインストールしてしまった場合は、git clone を yml ファイルに含める必要はありません。

「いいね!」 2

新しい情報でトピックを更新するのが遅すぎたので、あなたが先にやってしまいました。:slight_smile:

それでも私の部分を追加します…


:information_source: Discourse Footnote は Discourse コアにバンドルされたので、このプラグインを個別にインストールする必要はなくなりました。:partying_face:

セルフホストしている場合は、ダッシュボードに app.yml から削除する方法に関する情報が表示されるはずです。

:discourse2: 当社でホストされていますか? この変更はあなたには一切影響しません。:+1: このプラグインを引き続きお楽しみいただけ、何も心配する必要はありません。

「いいね!」 4

ええ、すみません。

素晴らしいですね!計画があったのですね。待っていればよかったです。私が指摘したもう一つのことは、実際には誰か他の人が対処した問題でした。あなたが対応してくれるとわかっていたので、ただ待っていればよかったのです。(それに、とても綺麗ですし!)

まだ24時間も経っていないので、それもまた良いことですね。

ありがとうございます。

「いいね!」 4

3件の投稿が新しいトピックに分割されました:コンポーザーのギアメニューに脚注オプションを追加

脚注を通常の書式設定で表示する方法はありますか?このように3つのドットとインラインにならないようにするにはどうすればよいですか?[1]\n\n代わりにこのように表示するにはどうすればよいですか?


  1. これは奇妙に見えます ↩︎

この設定ですか?

「いいね!」 1

いや、しかし、管理者が設定を変更するのではなく、一般ユーザーとしてという意味でした。

いいえ、そのためのユーザー設定はありません。グローバル設定のみです。

「いいね!」 1

フットノートでは、フットノートの括弧内に一般的なMarkdown構文をあまり使用できないことに気づきました[1]\n\n大きな問題ではありませんが、フットノートに入れられる機能が制限されることは確かです!


  1. 例:これはフットノートの括弧内にありますが、段落、ヘッダー、リストなどを導入するとレイアウトが崩れます。\n\nここに段落の区切りがあります。 ↩︎

{“translation”: "少なくとも4つのスペースでインデントを付けるようにしてください。

例:


ここに脚注の参照があります[^1]、もう一つ[^longnote]。

[^1]: こちらが脚注です。

[^longnote]: 複数のブロックを含む例。

    以降の段落はインデントされていて、それらが
前の脚注に属していることを示します。

    * アイテム1
    * アイテム2

    **もっと**テキスト

    <em>italic</em>
``` (原文のHTMLタグと記号は保持してください)

脚注の例:

![image|387x219](upload://rKf3zv09pn1uwmMDpXGQrWxHK7m.png)"}