Jekyll używa linków sformatowanych w Markdown, ale jak mogę utworzyć linki do treści wewnętrznych?
[[link]]
Możesz teraz publikować linki wewnętrzne, korzystając z:
[Some Link]({% post_url 2010-07-21-name-of-post %})
Jest to również wymienione w dokumentacji Jekyll .
[Title of post](/correct/permalink)
za pomocą jednego polecenia? Mogłem to zrobić tylko z filtrowaniem, które jest zbyt szczegółowe.post-url
nie jestpost_url
Za pomocą
link
tagu można teraz tworzyć linki do stron innych niż posty .link
działa dla postów, stron, dokumentów w kolekcji i plików.Pamiętaj, aby w przypadku używania
link
tagu podać rozszerzenie pliku . Aby użyć go do utworzenia łącza:Zobacz dokumentację Jekyll .
źródło
{{ site.baseurl }}
ponieważ podwaja wartość baseurl w wygenerowanym href.[Link to a post]({% link _posts/2016-07-26-name-of-post.md %})
W przypadku stron zdecydowali się nie dodawać
page_url
tagu, ponieważ i tak musiałbyś znać ścieżkę do strony. Musisz więc tylko ręcznie połączyć się z nim:Lub możesz zrobić coś dużego i brzydkiego w ten sposób, jeśli chcesz programowo uzyskać tytuł strony:
źródło
Jeśli zawartość wewnętrzna znajduje się na tej samej stronie, można utworzyć do niej link za pomocą tej
auto_ids
funkcji. Włączasz to w_config.yml
:Gdy ta opcja jest włączona, każdy nagłówek otrzymuje odniesienie na
id
podstawie tekstu nagłówka. Na przykładstanie się
Możesz utworzyć link do tego z tego samego dokumentu, wykonując coś takiego:
Jeśli wolisz, możesz przypisać wyraźny identyfikator:
i link do niego
źródło
W Jekyll istnieje wiele sposobów łączenia, z których niektóre są obecnie nieaktualne.
Ze znacznikami linków
Zalecany sposób tworzenia linków do plików wewnętrznych to
Pamiętaj, że spowoduje to błąd, jeśli plik zostanie przeniesiony lub zostanie usunięty.
Z permalinkami
Aby utworzyć łącze do strony bez powodowania błędów (zamiast tego niedziałające linki):
Zauważ, że tutaj musisz znać permalink strony i przepuścić go przez
relative_url
filtr, aby upewnić się, że jest poprzedzony podstawowym adresem URL witryny.Link bezpośredni do strony zależy od
permalink
ustawień w pliku konfiguracyjnym ipermalink
klucza w pierwszej części pliku.Z linkami względnymi jekyll
Jeśli chcesz używać ścieżek względnych (i chcesz, aby linki działały w widoku przecen GitHub), powinieneś użyć
jekyll-relative-links
. Dzięki temu możesz pisać linki takie jak:źródło
Wyobraź sobie, że to jest katalog Twojego projektu:
Aby połączyć „index.md” z plikiem w folderze „blog” o nazwie „20190920-post1.md”, wykonaj następujące czynności:
Dodaj następujące informacje:
[dowolny tekst] (./ ścieżka względna)
Na przykład:
Wynik:
źródło