概要
Discourse Footnote を使用すると、投稿内で Markdown 形式の脚注を作成できます。
インストールガイド
このプラグインは Discourse コアにバンドルされています 。別途インストールする必要はありません。
脚注の有効化
Footnote プラグインはデフォルトで有効になっていますが、admin/plugins ページから無効化/有効化できます。
機能
有効化すると、以下のように入力することで投稿に脚注を追加できます。
脚注が必要な文章。 ^[脚注の内容]
脚注が必要な別の文章。 ^[2 番目の脚注の内容]
または以下のようにも可能です。
脚注が必要な文章。 [^1]
脚注が必要な別の文章。 [^2]
[^1]: 脚注の内容
[^2]: 2 番目の脚注の内容
投稿内で両方のスタイルを自由に組み合わせることもでき、番号付き以外のアンカーを使用することもできます。
display footnotes inline 管理設定によって制御される 2 種類の脚注表示方法があります。
インライン以外:
インライン:
脚注が必要な文章
脚注が必要な別の文章
インライン版は、引用やモバイル環境にも最適です。
設定
名前
説明
enable markdown footnotes
このサイトで Markdown 形式の脚注を有効にする
display footnotes inline
脚注のインライン展開を有効にする
当社のホスティングを利用していますか?このプラグインは、すべてのホスティングプランで利用可能です Footnote | Discourse - Civilized Discussion
開発履歴
Discourse footnote は、@Vitaly による footnote markdown.it 拡張機能 を Discourse プラグインとして再パッケージ化したものです。
「いいね!」 73
Kayla
2022 年 9 月 29 日午後 8:51
58
拡張機能は、[^1] を使用した通常の脚注のマークダウンを許可していないようです。注意しておきます。インライン形式を使用しない限り、脚注はフォーマットされません。
Sam Saffron:
「インライン」脚注(インライン展開ではなく、注釈自体)も使用できます。このように:
More wise sayings ^[Lincoln, or Einstein, or something]
インライン脚注形式を使用して脚注を有効にすると、自動番号付きの脚注が投稿の下にまとめて表示されます。また、インライン展開を有効にすると、投稿の下に脚注が表示されない、エリプシスツールチップのような体験が得られます。インライン展開オプションが有効になっている場合、投稿プレビューウィンドウは従来の番号付き脚注のように見えますが、公開後はインライン展開効果が表示されます。
インライン形式を使用した自動番号付き脚注はありがたいのですが、マークダウンをどのようにフォーマットすべきか、そして望ましい動作を得るためにどのオプションを使用すべきかを理解するのに数回試行錯誤しました。このコメントが他の人の混乱を避けるのに役立つことを願っています。
追記:インライン展開オプションは、そのオプションが有効になっているかどうかに関わらず(デスクトップでも)、モバイルで脚注がどのように表示されるかです。
「いいね!」 5
このDiscourseフットノートプラグインを使用して、ユーザーがインラインポップアップコンテンツを作成できるようにするレシピ:
このプラグインとComposer Footnote Button Theme Component を組み合わせます (これにより、コンポーザー/エディターにフットノートを作成するためのボタンが提供されます)
ポップアップ内にはHTMLを含むあらゆるものを配置できます。
例:
テキスト
テキストと画像のアップロード
HTMLコンテンツ
「いいね!」 14
jrgong
(jrgong)
2023 年 8 月 21 日午後 5:04
66
フッタープラグインは公開ページでも機能しますか?私の特定のケースでは、公開ページでは機能せず、通常のトピックビューでのみ表示されるようにしたいです(内部メモなどに使用するため)。
@jrgong – いいえ…
at the moment page publishing is not designed to support theme components or anything using plugin api and especially decorateCooked.
Not saying this is impossible, but we didn’t work on it and at this point I dont know if we will.
ただし、この代替アプローチ があり、現在テーマコンポーネントを開発中です… Githubで 。
「いいね!」 2
pfaffman
(Jay Pfaffman)
2023 年 10 月 24 日午後 12:54
68
これは17時間前にコアに移されたようです。
誰か適切な方に更新してもらいます。
翻訳が見つかりません: en.The discourse-footnote plugin has been integrated into discourse core. Please remove the plugin from your app.yml and rebuild your container.
main ← footnote-plugin
opened 10:11PM - 18 Oct 23 UTC
Formerly https://github.com/discourse/discourse-footnote
「いいね!」 3
コアに移行した後、
app.ymlからプラグインを削除し、./launcher rebuild appを実行しましたが、
設定はプラグインページに残ったままです。このままにしておいても大丈夫でしょうか?
それが新しいものです。 比較のために両方の写真を載せます。
「いいね!」 4
それはとても良い音ですね! シェアしてくれてありがとう。
blake
(Blake Erickson)
2023 年 10 月 24 日午後 3:50
72
これについて言及していただきありがとうございます。修正をプッシュしました。
「いいね!」 3
pfaffman
(Jay Pfaffman)
2023 年 10 月 24 日午後 3:56
73
もう一つの問題は、プラグインをインストールする必要がなくなったことです。もしインストールしてしまった場合は、git clone を yml ファイルに含める必要はありません。
「いいね!」 2
新しい情報でトピックを更新するのが遅すぎたので、あなたが先にやってしまいました。
それでも私の部分を追加します…
Discourse Footnote は Discourse コアにバンドルされたので、このプラグインを個別にインストールする必要はなくなりました。
セルフホストしている場合は、ダッシュボードに app.yml から削除する方法に関する情報が表示されるはずです。
当社でホストされていますか? この変更はあなたには一切影響しません。 このプラグインを引き続きお楽しみいただけ、何も心配する必要はありません。
「いいね!」 4
pfaffman
(Jay Pfaffman)
2023 年 10 月 24 日午後 4:17
75
ええ、すみません。
素晴らしいですね!計画があったのですね。待っていればよかったです。私が指摘したもう一つのことは、実際には誰か他の人が対処した問題でした。あなたが対応してくれるとわかっていたので、ただ待っていればよかったのです。(それに、とても綺麗ですし!)
まだ24時間も経っていないので、それもまた良いことですね。
ありがとうございます。
「いいね!」 4
Turtle
2025 年 2 月 13 日午前 1:52
77
脚注を通常の書式設定で表示する方法はありますか?このように3つのドットとインラインにならないようにするにはどうすればよいですか?\n\n代わりにこのように表示するにはどうすればよいですか?
Turtle
2025 年 3 月 8 日午後 3:20
79
いや、しかし、管理者が設定を変更するのではなく、一般ユーザーとしてという意味でした。
Jagster
(Jakke Flemming)
2025 年 3 月 8 日午後 4:54
80
いいえ、そのためのユーザー設定はありません。グローバル設定のみです。
「いいね!」 1
kiefferr
(Ryan Kieffer)
2025 年 3 月 30 日午後 6:15
81
フットノートでは、フットノートの括弧内に一般的なMarkdown構文をあまり使用できないことに気づきました\n\n大きな問題ではありませんが、フットノートに入れられる機能が制限されることは確かです!
{“translation”: "少なくとも4つのスペースでインデントを付けるようにしてください。
例:
ここに脚注の参照があります[^1]、もう一つ[^longnote]。
[^1]: こちらが脚注です。
[^longnote]: 複数のブロックを含む例。
以降の段落はインデントされていて、それらが
前の脚注に属していることを示します。
* アイテム1
* アイテム2
**もっと**テキスト
<em>italic</em>
``` (原文のHTMLタグと記号は保持してください)
脚注の例:
"}