内部リンク


ExercismのMarkdownパーサーでレンダリングされるリンクは、内部リンクかどうかがチェックされ、内部リンクであればツールチップで装飾されることがあります。

概念のツールチップは、たとえば次のようになります。

使い方

このように装飾されるリンクに特別な構文はありません。代わりに、リンクのhrefが次の2つの形式のどちらかに従っているかどうかをチェックします。

  • URL。例:https://exercism.org/tracks/ruby/concepts/basics
  • 絶対パス。例:/tracks/ruby/concepts/basics

相対URL(./や../で始まるものなど)には現在対応していません。Markdownパーサーは、レンダリングするドキュメントの文脈や、レンダリングするときの文脈、gitリポジトリの構造を認識していないためです。

代替手段

通常のリンクを使う代わりに、ウィジェットをレンダリングすることもできます。ウィジェットは一般に、追加の読み物や、何かを学ぶのに適した演習を提案するために、ドキュメントの最後で使われます。

詳しくは、ウィジェットのドキュメントを参照してください。