Grav - 主題變數

{{ base_dir }}

可以使用此變數獲取 Grav 安裝的基本檔案目錄。

{{ base_url }}

可以使用此變數訪問 Grav 站點的基本 URL。

{{ base_url_relative }}

它返回 Grav 站點基本 URL 的相對路徑。

{{ base_url_absolute }}

它返回 Grav 站點基本 URL 的絕對路徑。

{{ theme_dir }}

它用於返回當前主題的檔案目錄資料夾。

{{ theme_url }}

它用於返回當前主題的相對 URL。

summary([size])

它提供頁面內容的概要，指定大小作為引數。

如果未指定大小，則值將從system/config/site.yaml檔案中的summary.size變數獲取。

您也可以在內容中使用分隔符===。分隔符之前的內容將用於摘要。

{{ page.summary }}

或者

{{ page.summary(80) }}

content()

它用於獲取頁面的完整 HTML 內容。

{{ page.content }}

headers()

它返回在頁面 YAML 前端內容中定義的頁面標題。

title: About Us
author: Johnson

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

media()

它用於訪問所有媒體檔案，例如影像、影片和其他檔案。它將返回一個包含與頁面關聯的所有媒體的陣列。

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

title()

它設定為返回頁面的標題，該標題在頁面的 YAML 標題中定義。

title: My Page

menu()

返回menu變數的值，該值在頁面的 YAML 標題中指定。如果未設定title變數，則預設為title。

title: My Blog
menu: my blog page

visible()

它用於設定頁面的可見性。通常，以數字後跟句點（即 01.foldername）結尾的頁面會顯示在選單中，而不包含數字值的資料夾名稱（即 foldername）則不可見。我們可以在頁面標題中覆蓋它。

title: About Us
visible: true

routable()

透過這個我們可以確定一個頁面是否可路由或不可路由，這意味著當您將瀏覽器指向頁面時是否可以接收回內容。不可路由的頁面可用於外掛、模板等，這些頁面無法直接訪問。這在頁面標題中設定。

title: My Page
routable: true

slug()

使用此變數，我們可以獲取頁面 URL 中顯示的直接名稱。

my-page

url([include_host = false])

它用於返回頁面的 URL

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

或者

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

route()

它用於返回頁面的內部路由。

home()

使用此變數，您可以確定頁面是否配置為首頁。當頁面配置為首頁時返回 true，否則返回 false。您可以在system.yaml檔案中找到此設定。

root()

它確定當前頁面是否是層次結構的根頁面。如果它是根頁面則返回true，如果不是根頁面則返回false。

active()

您可以使用此變數確定瀏覽器是否正在訪問當前頁面。如果瀏覽器正在訪問此頁面，則返回true；否則返回false。

modular()

使用此變數，我們可以確定此頁面是否為模組化頁面。如果是模組化頁面則返回true，否則返回false。

activeChild()

此變數可以確定此 URI 的 URL 是否包含活動頁面的 URL；或者，簡單來說，此頁面的 URL 是否在當前 URL 中。當您處理導航並想要知道頁面是否正在迭代相同的父頁面時，這非常有用。

find(url)

根據路由 URL 指定，此變數將返回 page 物件。

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

collection()

此變數用於根據集合頁面標題返回上下文的頁面組。

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

isFirst()

如果當前頁面是其同級頁面的第一個，則返回true，否則返回false。

isLast()

如果當前頁面是其同級頁面的最後一個，則返回true，否則返回false。

nextSibling()

參考當前位置，它從陣列中返回下一個同級頁面。

prevSibling()

參考當前位置，它從陣列中返回上一個同級頁面。

children()

根據頁面內容結構定義，此變數將返回子頁面的陣列。

orderBy()

此方法返回排序後的子項的排序型別。可能包含的值為default、title、date和folder，這些值在頁面標題中配置。

orderDir()

此方法返回排序後的子頁面的排序方向。值可以是asc（升序）或desc（降序）。通常這些值在頁面標題中配置。

orderManual()

此方法返回一個包含手動頁面排序的陣列，此排序將用於頁面的任何子項。此值通常在頁面標題中設定。

maxCount()

此變量表示最多允許返回多少個子頁面。通常在頁面標題中指定值。

children.count()

此變數返回頁面有多少個子頁面。

children.current()

此變數將返回當前子項。

children.next()

這將從子頁面陣列中返回下一個子項。

children.prev()

這將從子頁面陣列中返回上一個子項。

children.nth(position)

這將返回子項在子項陣列中的位置。

parent()

在巢狀樹狀結構中，當您想要向上導航到父頁面時，可以使用此變數。它將返回當前頁面的父頁面物件。

isPage()

使用此變數，您可以確定此頁面是否具有實際的.md檔案，或者它只是一個用於路由的資料夾。

isDir()

使用此變數，您可以確定當前頁面是否只是一個用於路由的資料夾。它根據情況返回true或false。

id()

這將返回頁面的唯一 ID。

modified()

它返回頁面上次修改的時間戳。

date()

此方法返回頁面的日期時間戳。通常在表示頁面或帖子的日期的標題中配置。如果未提供值，則預設使用修改的時間戳。

filePath()

透過這個，您可以獲取頁面的完整檔案路徑。

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

filePathClean()

這將返回相對路徑。

user/pages/ 01.home/default.md

path()

這將返回當前頁面所在的目錄的完整路徑。

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

folder()

這將返回頁面的資料夾名稱。

taxonomy()

這將返回與頁面連線的分類法陣列。

path()

可以使用此方法訪問當前 url 的部分。

uri.path = /section/category/page

paths()

此方法返回路徑元素陣列。

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

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

此方法返回絕對或相對URL的路由。

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

或者，

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

params()

這將返回URL中的引數部分。

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

param(id)

這將返回引數的值。

uri.param('param1') = foo

query()

可以使用此方法訪問URL的查詢部分。

uri.query = query1=bar&query2=qux

query(id)

使用此方法可以訪問特定的查詢項。

uri.query('query1') = bar

url([include_host = true])

這將返回完整的URL，可能包含也可能不包含主機。

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

extension()

這將返回副檔名，如果沒有提供，則返回html。

uri.extension = json)

host()

這將返回URL的主機。

uri.host = mysite.com

base()

這將返回URL的基本部分。

uri.base = http://mysite.com

rootUrl([include_host = true])

這將返回Grav例項的根URL。

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

referrer()

此方法返回頁面的推薦者資訊。