Jekyll ссылка на странице

Question

Я использую Jekyll на Github, и мне интересно, есть ли способ ссылки на раздел на странице. Скажем, у меня есть раздел, как

## Section 1 ##
section content 

и позже на той же странице я хочу ссылку на этот раздел. Я нашел, как сделать ссылку на другую страницу в блоге и сделать сноски, но не это.

Как примечание, я использую markdown: kramdown в моем _config.yml

Answer 1

kramdown поддерживает автоматическую генерацию идентификаторов заголовков, если для параметра auto_ids установлено значение true (по умолчанию). Это делается путем преобразования не преобразованного, то есть простого текста заголовка

Так в приведенном выше примере ## Section 1 ##, он будет генерировать следующий идентификатор: id="section-1"затем якорь связывается с помощью элемента A:

<A href="#section-1">Section One</A>

Или в простом kramdown/ уценке: [Section 1](#section-1)

Answer 2

Похоже, это было изменено на #heading-section-1 (сейчас проверяется на Jekyll 3.7.3).

Чтобы выяснить это самостоятельно, вы можете проверить элемент и увидеть идентификатор, используемый на отображаемой странице.

Answer 3

Я нашел хороший репозиторий, который помогает добавить привязки ко всем заголовкам за три простых шага.

Из документов :

1. Download the anchor_headings.htmlфайл из основной ветки

2. Закинь этот файл себе _includesпапка

3. Где вы обычно размещаете {{ content }}в вашем макете вместо этого вы должны использовать этот тег Liquid для вывода содержимого вашей страницы:

   {% включает anchor_headings.html html=content anchorBody="#" %}

В результате вы увидите:

Который легко настроить .

Answer 4

Если раздел страницы, к которому вы хотите перейти, не является заголовком раздела, то этот принятый ответ не сработал для меня. Для меня работало следующее:

      [jump](#final-solution)


<div id="final-solution"></div>

Answer 5

Я нашел альтернативу, которая работает на моем текущем статическом сайте Jekyll.

      ## My Subsection {#my-subsection}    

This is some content in the subsection.

[Link to the subsection](#my-subsection)

Надеюсь, поможет.