Grav - Zmienne motywu

{{ base_dir }}

Korzystając z tej zmiennej możemy uzyskać katalog bazowy plików instalacji Grav-a.

{{ base_url }}

Dostęp do podstawowego adresu URL witryny Grav jest możliwy za pomocą tej zmiennej.

{{ base_url_relative }}

Zwraca względną ścieżkę podstawowego adresu URL do witryny Grav.

{{ base_url_absolute }}

Zwraca bezwzględną ścieżkę podstawowego adresu URL do witryny Grav.

{{ theme_dir }}

Służy do zwracania folderu katalogu plików bieżącego motywu.

{{ theme_url }}

Służy do zwracania względnego adresu URL aktualnego motywu.

summary([size])

Daje streszczenie zawartości strony o określonym rozmiarze podanym jako parametr.

Jeśli rozmiar nie jest określony, wartość jest pobierana z summary.size zmienna w system/config/site.yaml plik.

Możesz także użyć separatora ===w treści. Treść przed separatorem zostanie użyta do podsumowania.

{{ page.summary }}

Lub

{{ page.summary(80) }}

content()

Służy do pobrania całej zawartości HTML strony.

{{ page.content }}

headers()

Zwraca nagłówki stron zdefiniowane na pierwszej stronie YAML.

title: About Us
author: Johnson

The author of this page is:  {{ page.header.author }}

media()

Służy do uzyskiwania dostępu do wszystkich plików multimedialnych, takich jak obrazy, filmy i inne pliki. Zwróci tablicę zawierającą wszystkie media powiązane ze stroną.

{% set first_image = page.media|first %}
{% set my_pdf = page.media['myfile.pdf'] %}
{% for image in page.media.images  %}
   {{ image.html }}
{% endfor %}

title()

Zwraca tytuł strony zdefiniowany w nagłówkach YAML dla strony.

title: My Page

menu()

Wartość menuzwracana jest zmienna, która jest określona w nagłówkach YAML strony. Jeślititle zmienna nie jest ustawiona, to domyślnie title.

title: My Blog
menu: my blog page

visible()

Służy do ustawienia widoczności strony. Zwykle strony z wartością numeryczną, po której następuje kropka (np. 01. nazwa folderu) są wyświetlane w menu, a nazwa folderu, która nie zawiera wartości liczbowej (tj. Nazwa folderu) nie jest widoczna. Możemy to zmienić w nagłówku strony.

title: About Us
visible: true

routable()

Korzystając z tego, możemy określić, czy strona jest routable lub not routableco oznacza, że ​​możesz otrzymywać treści z powrotem, kierując przeglądarkę na stronę. Strony, które nie są routowalne, mogą być używane we wtyczkach, szablonach itp., A do tych stron nie można uzyskać bezpośredniego dostępu. Jest to ustawione w nagłówkach stron.

title: My Page
routable: true

slug()

Używając tej zmiennej, możemy uzyskać bezpośrednią nazwę wyświetlaną w adresie URL strony.

my-page

url([include_host = false])

Służy do zwracania adresu URL strony

{{ page.url }}  { # could return /myfolder/mypage #}

Lub

{{ page.url(true) }}  {# could return http: //mysite.com/ myfolder/mypage #}

route()

Służy do zwracania wewnętrznego routingu strony.

home()

Za pomocą tej zmiennej możesz określić, czy strona jest skonfigurowana jako homestrona czy nie. Zwraca wartość true, gdy strona jest skonfigurowana jako strona główna i false, gdy nie jest skonfigurowana. Możesz znaleźć to ustawienie wsystem.yaml plik.

root()

Określa, czy bieżąca strona jest stroną główną hierarchii, czy nie. Wracatrue jeśli jest to strona główna lub false jeśli nie jest to strona główna.

active()

Możesz określić, czy przeglądarka ma dostęp do bieżącej strony, używając tej zmiennej. Wracatrue jeśli przeglądarka ma dostęp do tej strony lub false jeśli nie.

modular()

Korzystając z tej zmiennej, możemy określić, czy ta strona jest modułowa, czy nie. Jeśli jest to strona modułowa, wracatrue i false jeśli nie.

activeChild()

Ta zmienna może określić, czy adres URL tego identyfikatora URI zawiera adres URL aktywnej strony; lub, w prostych słowach, adres URL tej strony w aktualnym adresie URL. Jest to bardzo przydatne, gdy pracujesz nad nawigacjami i chcesz wiedzieć, czy strony iterują po tej samej stronie nadrzędnej.

find(url)

Jak określono w adresie URL trasy, obiekt strony jest zwracany przez tę zmienną.

{% include 'modular/author-detail.html.twig' with {'page': page.find('/authors/ john-bloggs')} %}

collection()

Ta zmienna służy do zwracania grupy stron dla kontekstu określonego przez nagłówki stron kolekcji.

{% for child in page.collection %}
   {% include 'partials /blog_item.html.twig' with {'page':child, 'truncate':true} %}
{% endfor %}

isFirst()

Jeśli bieżąca strona jest pierwszą ze stron siostrzanych, to wraca true else wraca false.

isLast()

Jeśli bieżąca strona jest ostatnią ze stron siostrzanych, to wraca true else wraca false.

nextSibling()

W odniesieniu do bieżącej pozycji zwraca następną stronę siostrzaną z tablicy.

prevSibling()

W odniesieniu do bieżącej pozycji zwraca poprzednią stronę siostrzaną z tablicy.

children()

Jak zdefiniowano w strukturze zawartości stron, tablica stron potomnych jest zwracana przez tę zmienną.

orderBy()

Ta metoda zwraca sortowany typ zamówienia dzieci. Wartości, które mogą być uwzględnione, todefault, title, date i folder i te wartości skonfigurowane w nagłówkach stron.

orderDir()

Ta metoda zwraca kierunek kolejności posortowanych stron podrzędnych. Wartości mogą być alboasc(rosnąco) lub desc(descending). Zwykle te wartości są konfigurowane w nagłówkach stron.

orderManual()

Ta metoda zwraca tablicę składającą się z kolejności stron podręcznika i ta kolejność będzie dotyczyła wszystkich elementów podrzędnych strony. Ta wartość jest zwykle ustawiana w nagłówkach stron.

maxCount()

Ta zmienna mówi, że maksymalnie ile stron potomnych może zostać zwróconych. Zwykle wartość jest określana w nagłówkach stron.

children.count()

Ta zmienna zwraca liczbę stron podrzędnych dla strony.

children.current()

Ta zmienna zwróci bieżący element podrzędny.

children.next()

To zwróci następny element podrzędny z tablicy stron podrzędnych.

children.prev()

To zwróci poprzedni element podrzędny z tablicy stron podrzędnych.

children.nth(position)

To zwróci pozycję dziecka w tablicy dzieci.

parent()

W zagnieżdżonej strukturze drzewa, gdy chcesz wrócić do strony nadrzędnej, możesz użyć tej zmiennej. Zwróci obiekt strony nadrzędnej dla bieżącej strony.

isPage()

Używając tej zmiennej, możesz określić, czy ta strona ma rzeczywisty plik .md plik lub po prostu folder do routingu.

isDir()

Używając tej zmiennej możesz określić, czy bieżąca strona jest tylko folderem do routingu. Wracatrue lub false w oparciu o to.

id()

Spowoduje to zwrócenie unikalnego identyfikatora strony.

modified()

Zwraca sygnaturę czasową ostatniej modyfikacji strony.

date()

Ta metoda zwraca datownik strony. Zwykle jest to konfigurowane w nagłówkach, które reprezentują datę strony lub posta. Jeśli domyślnie nie zostanie podana żadna wartość, używany jest zmodyfikowany znacznik czasu.

filePath()

Korzystając z tego, możesz uzyskać pełną ścieżkę do pliku strony.

/Users/yourname/sites/ Grav/user/pages/ 01.home/default.md

filePathClean()

To zwróci ścieżkę względną.

user/pages/ 01.home/default.md

path()

Spowoduje to zwrócenie pełnej ścieżki do katalogu, w którym znajduje się bieżąca strona.

/Users/yourname /sites/ Grav/user/pages /01.home

folder()

Spowoduje to zwrócenie nazwy folderu dla strony.

taxonomy()

To zwróci tablicę taksonomii, która jest połączona ze stroną.

path()

Dostęp do części bieżącego adresu URL można uzyskać za pomocą tej metody.

uri.path = /section/category/page

paths()

Tablica elementów ścieżki jest zwracana przy użyciu tej metody.

uri.paths = [section, category, page])

route([absolute = false][, domain = false])

Ta metoda zwraca trasę z bezwzględnym lub względnym adresem URL.

uri.route(true) = http://mysite.com/Grav/ section/category/page

Lub,

uri.route() = /section/category/page)

params()

To zwróci część parametru w adresie URL.

uri.params = /param1:foo/param2:bar

param(id)

To zwróci wartość parametru.

uri.param('param1') = foo

query()

Dostęp do części adresu URL zawierającej zapytanie można uzyskać za pomocą tej metody.

uri.query = query1=bar&query2=qux

query(id)

Dzięki temu możesz uzyskać dostęp do określonego elementu zapytania.

uri.query('query1') = bar

url([include_host = true])

Zwraca pełny adres URL, który może zawierać hosta lub nie.

uri.url(false) = Grav/section/ category/page/param:foo?query = bar

extension()

To zwróci rozszerzenie, a jeśli nie zostanie podane, zwróci kod HTML.

uri.extension = json)

host()

Zwraca hosta adresu URL.

uri.host = mysite.com

base()

Spowoduje to zwrócenie podstawowej części adresu URL.

uri.base = http://mysite.com

rootUrl([include_host = true])

Spowoduje to zwrócenie głównego adresu URL instancji Grav.

uri.rootUrl() = http://mysite.com/Grav

referrer()

Ta metoda zwraca informacje o stronie odsyłającej.