tautan internal penurunan harga jekyll

Jekyll menggunakan tautan berformat Markdown, tetapi bagaimana saya bisa menautkan ke konten internal?

[[link]] 

Anda sekarang dapat memposting tautan internal dengan menggunakan yang berikut:

[Some Link]({% post_url 2010-07-21-name-of-post %})

Ini juga dirujuk dalam Dokumentasi Jekyll .

https://github.com/mojombo/jekyll/pull/369

Sekarang mungkin untuk menautkan ke halaman selain posting menggunakan linktag. linkberfungsi untuk posting, halaman, dokumen dalam koleksi, dan file.

{{ site.baseurl }}{% link _collection/name-of-document.md %}
{{ site.baseurl }}{% link _posts/2016-07-26-name-of-post.md %}
{{ site.baseurl }}{% link news/index.html %}
{{ site.baseurl }}{% link /assets/files/doc.pdf %}

Ingatlah untuk menyertakan ekstensi file saat menggunakan linktag. Untuk menggunakannya untuk membuat tautan:

[Link to a document]({{ site.baseurl }}{% link _collection/name-of-document.md %})
[Link to a post]({{ site.baseurl }}{% link _posts/2016-07-26-name-of-post.md %})
[Link to a page]({{ site.baseurl }}{% link news/index.html %})
[Link to a file]({{ site.baseurl }}{% link /assets/files/doc.pdf %})

Lihat Dokumentasi Jekyll .

Untuk halaman, mereka memutuskan untuk tidak menambahkan page_urltag karena Anda harus mengetahui jalur halaman itu. Jadi, Anda hanya perlu menautkannya secara manual:

[My page](/path/to/page.html)

Atau Anda dapat melakukan sesuatu yang besar dan jelek seperti ini jika Anda ingin mendapatkan judul halaman secara terprogram:

{% for page in site.pages %}
  {% if page.url == '/path/to/page.html' %}
[{{ page.title }}]({{ page.url }})
  {% endif %}
{% endfor %}

Jika konten internal berada di halaman yang sama maka dimungkinkan untuk menautkannya menggunakan auto_idsfitur. Anda mengaktifkan ini di _config.yml:

kramdown:
    auto_ids: true

Dengan ini diaktifkan setiap heading mendapat idreferensi berdasarkan teks heading. Sebagai contoh

### My Funky Heading

akan menjadi

<h3 id="my-funky-heading">My Funky Heading</h3>

Anda dapat menautkan ini dari dalam dokumen yang sama dengan melakukan sesuatu seperti ini:

The funky text is [described below](#my-funky-heading)

Anda dapat menetapkan id eksplisit jika Anda lebih suka:

### My Funky Heading
{: #funky }

dan tautan ke sana

The funky text is [described below](#funky)

Ada beberapa cara menghubungkan di Jekyll, beberapa di antaranya sekarang sudah ketinggalan zaman.

Dengan tag tautan

Cara yang disarankan untuk menautkan ke file internal adalah

[Link]({{ site.baseurl }}{% link path/to/file.md %})

Perhatikan bahwa ini akan menyebabkan kesalahan jika file bergerak atau terhapus.

Dengan permalinks

Untuk menautkan ke halaman tanpa menyebabkan kesalahan (tautan yang terputus):

[Link]({{ '/path/to/page/' | relative_url }})

Perhatikan bahwa di sini Anda perlu mengetahui permalink halaman dan meneruskannya melalui relative_urlfilter untuk memastikan bahwa diawali dengan url dasar situs.

Permalink suatu halaman tergantung pada permalinkpengaturan dalam file konfigurasi Anda dan permalinkkunci di bagian depan file tersebut.

Dengan jekyll-relative-links

Jika Anda ingin menggunakan jalur relatif (dan ingin tautan berfungsi dalam tampilan penurunan harga GitHub), Anda harus menggunakan jekyll-relative-links. Ini memungkinkan Anda menulis tautan seperti:

[Link](./path/to/file.md)

[Link to file in parent folder](../file.md)

Bayangkan ini adalah direktori proyek Anda:

Untuk menautkan "index.md" ke file di dalam folder "blog" bernama "20190920-post1.md", lakukan hal berikut:

1. Buka file "index.md".

2. Tambahkan yang berikut ini:

   [teks apa saja] (./ jalur relatif)

Sebagai contoh:

- [Sept 20th 2019 - Kikucare's Journey](./blog/20190920-post1.md)

Keluaran: