Внутрішні посилання

Посилання, які рендерить парсер Markdown від Exercism, перевіряються на те, чи вони внутрішні, і якщо так, то їх можна позначити спливними підказками.

Спливна підказка для концепції може мати такий вигляд:

Використання

Немає спеціального синтаксису, щоб посилання позначалися в такий спосіб. Натомість ми перевіряємо, чи href посилання відповідає одній із двох форм:

  • URL. Наприклад, https://exercism.org/tracks/ruby/concepts/basics
  • Абсолютний шлях. Наприклад, /tracks/ruby/concepts/basics

Ми поки що не підтримуємо відносні URL (наприклад, ті, що починаються з ./ або ../), бо парсер Markdown не знає ні контексту документа, який він рендерить, ні контексту, у якому він рендерить, ні структури git-репозиторію.

Альтернативи

Замість звичайних посилань можна рендерити віджети. Їх зазвичай використовують у кінці документа, щоб запропонувати додаткове читання або вправи, з яких можна чогось навчитися.

Докладніше можна прочитати в документації про віджети.