テスト中… エディターは、トピック スレッドにレンダリングされるものとは常に異なるものを表示します markdown: [^note] + [^note]: これは脚注であるはずです。。
テスト投稿で discourse.python.org では、角括弧の内側または外側にキャレットを配置すると、どちらの場合もインライン注釈 markdown: ^[これはインライン注釈としてコード化されています] が生成されます。
…そして、ここでも同じことが起こります。エディターのプレビュー ペインでは見栄えが良いのですが、スレッドでは期待どおりにレンダリングされません。(ただし、現在 discourse.python.org でアクティブなダーク テーマでは、ハイパーリンクも非常に暗く、小さくなっています。)
折りたたみドロップダウンを使用するつもりです \u003c1\u003e。
<1
なぜなら、追加情報に関連する段落の直後に配置でき、折りたたまれた状態では、長い脚注よりも行数が少なくなる可能性があるからです。(「1」の周りに角括弧を使用しようとしましたが、角括弧がマークダウン インタープリターを混乱させないようにエスケープする方法を見つけられませんでした。)
「いいね!」 1
discuss.python.org では、この問題に苦労しています。
Discourse の深い豊かさを高めることができる補足表記のオプションがあります。ただし、成功裡な実装にはいくつかの鍵があります。
理想からの主な逸脱は、「脚注」という用語を、明らかにそうではないものに対して使用していることです。インラインノートはインラインですが、フットノートはページのフッター/下部にあります(この場合、メッセージのフッター)。
そして、それは第二の逸脱を強調します。脚注とインラインノートは、明らかに異なるユースケースと効果的な使用のための異なるベストプラクティスを持つ、2つの明確に異なる種類のノートです。したがって、それらは別個の機能であり、おそらく別個の構成変数セットによって制御されるべきです。
ケアレットの位置を変更するオプションにより、ユーザーはインサイチュ展開(インラインノート)またはリモート参照(脚注)のいずれかを選択できます。現在、両方の構成がインラインノートを生成します。これは少し当惑させられましたが、メッセージ本文に割り込むのではなく、メッセージの下部に大きなノートテキストを配置するのに役立ちます。
いずれにせよ、discuss.python.org の私たちは、インラインノートと脚注の両方を使用できることを強く望んでいます。それは、よく構成されたトピック投稿の魅力的な性質を拡張するでしょう。
1つのオプションは、ケアレットの位置を2つの異なるスイッチにすることです。
^[txt] インラインノートを作成します。
[^lbl] 脚注を作成します。
^[^lbl] 表示場所からリモートでノートテキストを配置したインラインノートを作成します。
これらの2つの補足テキスト項目に対する一般的な名前は「注釈」です。
「いいね!」 2
mattdm
(Matthew Miller)
3
「いいね!」 3
マシュー、同意します。参照箇所を強調していただきありがとうございます。残念ながら、それらの参照は少し不十分で、ここにはより良いトピックが見つかりませんでした。CommonMark.org には、より最近の議論があるかもしれません。
解決しましたね。しかし、CommonMark に状況をどのように提示するかをまず把握する必要があります。他のユーザーからの入力が、トピックが CommonMark に転送される際の議論に情報を提供するので、ここに投稿しました。Discourse はユーザーとしての私たちの直接の「親」でもあり、サムたちはおそらく、脚注の拡張機能の実装がユーザーにとってどれほどうまく機能しているかを知りたいでしょう。
ですから、あなたの考えを共有してください。そして、このトピックには30日後に投稿が消える「ゴミ箱」があるので、速やかにお願いします!
「いいね!」 1
@mlgtechuser、もし私が正しく理解していれば、これは次のような例かもしれません。
代わりに discussion.fedoraproject.org/new-topic を試して、次のように入力すると:
[^1]
[^1]: Content
…より期待どおりの結果が見られるかもしれません。フッターは、インラインの数値参照を選択したときにのみ表示されるインラインボックスではなく、参考文献としてレンダリングされます。
それ以外の場合、両方のモードが共存することを要求しており、一部の「注釈」がドキュメントの末尾に追加された参考文献フッターとしてレンダリングされ、他の注釈はインラインのままになる場合、それが素晴らしいものであることに私も全面的に同意します。