Jak renderować stronę ze znacznikami Jekyll na indeksie witryn

Question

Prawdopodobnie brakuje mi czegoś prostego, ale nie mam możliwości testowania Jekylla lokalnie.

Używam stron GitHub do renderowania Jekyll, na początek chcę tylko renderować zawartość znacznika na głównym index.html z jednej strony ze wskazówkami.

struktura jest:

Index.html

--- 
layout: default 
--- 

_layouts
- default.html

//html stuff.. 
<section> 

{{page.content}} 

</section> 

W folderze głównym mam stronę o nazwie content.md że Chcę renderować na {{page.content}} układ jest renderowany, ale sekcja etykiet płynnych jest pusta.

Jak renderować content.md?

Przykład: https://github.com/wycks/wordpress-gears-jekyll

Answer 1

Istnieje kilka rzeczy się tu dzieje.

1. W pliku _layouts/default.html (i wszelkich innych _layouts plików katalogów dla tej sprawy), zamiast:

   {{ page.content }} 
   

   trzeba użyć:

   {{ content }} 
   

2. tylko Jekyll umożliwia dołączanie plików z katalogu głównego katalogu lokacji poziomu _includes. Tak więc musisz przenieść swój content.md z katalogu głównego do tego katalogu (tworząc go, jeśli jeszcze nie istnieje).

3. Wreszcie, musisz rzeczywiście wykonać wywołanie pliku dołączającego z pliku index.html. Można to zrobić poprzez zmianę zawartości pliku index.html do:

   --- 
   layout: default 
   --- 
   
   {% include content.md %} 
   

który będzie konfiguracja zachowanie szukasz.

---

Chciałbym zwrócić uwagę na dwie innymi:

1. Może się okazać, że zmiana rozszerzenia pliku indeksu od .html do .md działa lepiej. Ważna uwaga: musisz użyć .html, jeśli chcesz stronicować. Zgodnie z Jekyll Pagination documentation funkcja działa tylko wtedy, gdy plik ma nazwę index.html.

2. Jeśli wszystko, co robisz w swoim pliku indeksu, wywołuje zawartość znajdującą się tylko na tej stronie, możesz być równie dobrze po prostu umieszczając zawartość bezpośrednio w pliku indeksu.

Answer 2

include tylko pozwala na to pliki bezpośrednio pod _includes/. Istnieje również include_relative, który pozwala na używanie ścieżek i dołączanie z innych miejsc. Include musi być w stosunku do danego pliku Jednakże:

{% include_relative somedir/footer.html %} 

---

Jest jeden problem z albo obejmować metody nie mogę rozwiązać: Jeśli plik to ma przedni sprawę Jekyll nie pozbawi go na zewnątrz. Więc nie możesz używać przedniej materii do przechowywania, obejmują one określone dane meta - np. Powiedz "tytuł". Oczywiście możesz używać zmiennych - {% assign title = "My Title" %}, ale nie jest to odpowiednik, ponieważ jeśli chcesz, aby to, co zawierasz, było częścią kolekcji lub renderowane niezależnie, musisz mieć przednie sprawy.