Q: asciidoc にコンパクトなリンク構文はありますか? のよう[[page name]]に、リンク ターゲットはリンク テキストから派生しますか?
---+詳細
ほとんどの wiki には、同じ wiki 内の異なるページへのリンクのための非常に簡単でコンパクトな構文があります。
たとえば、元の WikiWikiWeb で使用されCamelCaseていた - キャメルケースの単語は自動的にリンクされました。
たとえば、多くのウィキでは、[[link to a page]]. 通常、実際のターゲット ページ名は、スペースを _underscore または -dash または +plus 記号に変更する、または完全な URI エンコードなどの変換によって、リンク テキストから派生します。
Github プロジェクト リポジトリに関連付けられているウィキは、二重角かっこの構文をサポートしています。これには、一連のファイル サフィックス、.md/markdown、.asciidoc/:-) などに沿って検索する追加機能があり、同じウィキに書かれたページを含めることができます。さまざまなマークアップで。asciidoc を除く、サポートされているすべてのマークアップ変数について - リンク ターゲットまたはアンカーに二重角括弧を既に使用しています。
残念ながら、 https://github.github.com/gfm/#linksのようなセミフォーマルな GitHub Flavored Markdown ドキュメントは、このコンパクトな二重ブラケット構文を説明しておらず、おそらく結果として、GFM から asciidoc への変換ツール kramdoc も説明していません。
Q: asciidoc にコンパクトなリンク構文はありますか?
私の知る限り、AsciiDoc リンクはリンク テキストとターゲットの両方を指定する必要があり、最もコンパクトな形式は相対リンクlink:Page-Name.html[Page-Name]です。リンク テキストとページ ベース名が同じ場合、これは冗長です。
(ただし、asciidoc は、リンクのように見える場合、リンク テキストとターゲットを同じにします: https://asciidoctor.org。)
さらに言えば、kramdown/kramdocが理解できる公式のコンパクトリンク構文がMarkdownにありますか? それとも、GitHub wiki が二重角括弧をサポートする理由が不足しているの[[page name]]でしょうか?
---+ 尊大な
ウィキの最も重要な機能は次のとおりです。
オンラインですばやく簡単に編集可能
すばやく簡単にコンパクトなリンク表現を使用できるため、Wiki マークアップは、リンクが存在しないかのように読みやすくなります。
まだ存在しないページへのリンクは許可され、区別されているため、それらをクリックして移動を開始することができます。
つまり、書きやすく、見つけやすく、作成しやすいリンクです。
公式の Markdown と AsciiDoc がこのようなコンパクト リンクをサポートしていない場合、私は非常に失望します。特に、仕事で AsciiDoc を使わざるを得なくなっているからです。
AFAICT AsciiDoc は<<intra-document>>、多くの場合、セクション タイトル テキストから暗黙的に作成されたターゲット アンカーを使用して、コンパクト リンクまたはクロス リファレンスをサポートします。しかし、異なる Wiki ページまたはドキュメント間の AFAICT リンクは、はるかに冗長にする必要があります。
さらに言えば、GitHub wiki の .asciidoc wiki ページで、まだ存在しないページへのリンクが既存のページと区別されていないことにも不満を持っています。