Grav - Biến chủ đề

{{ base_dir }}

Chúng ta có thể lấy thư mục tệp cơ sở cài đặt Grav bằng cách sử dụng biến này.

{{ base_url }}

Có thể truy cập url cơ sở của trang Grav bằng cách sử dụng biến này.

{{ base_url_relative }}

Nó trả về đường dẫn tương đối của url cơ sở đến trang Grav.

{{ base_url_absolute }}

Nó trả về đường dẫn tuyệt đối của url cơ sở đến trang Grav.

{{ theme_dir }}

Nó được sử dụng để trả về thư mục thư mục tệp của chủ đề hiện tại.

{{ theme_url }}

Nó được sử dụng để trả về URL tương đối của chủ đề hiện tại.

summary([size])

Nó cung cấp một ý chính của nội dung trang với kích thước được chỉ định được cung cấp dưới dạng một tham số.

Nếu kích thước không được chỉ định thì giá trị nhận được từ summary.size biến trong system/config/site.yaml tập tin.

Bạn cũng có thể phân tách ===trong nội dung của bạn. Nội dung trước dấu phân cách sẽ được sử dụng để tóm tắt.

{{ page.summary }}

Hoặc là

{{ page.summary(80) }}

content()

Nó được sử dụng để lấy toàn bộ nội dung HTML của trang.

{{ page.content }}

headers()

Nó trả về các tiêu đề trang được xác định trong YAML của trang.

title: About Us
author: Johnson

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

media()

Nó được sử dụng để truy cập tất cả các tệp phương tiện như hình ảnh, video và các tệp khác. Nó sẽ trả về một mảng chứa tất cả các phương tiện được liên kết với một trang.

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

title()

Nó được đặt để trả về tiêu đề của trang được xác định trong tiêu đề YAML cho trang.

title: My Page

menu()

Giá trị của menuđược trả về biến được chỉ định trong tiêu đề YAML của trang. Nếutitle biến không được đặt, sau đó nó sẽ mặc định thành title.

title: My Blog
menu: my blog page

visible()

Nó được sử dụng để thiết lập khả năng hiển thị của trang. Thông thường các trang có giá trị số theo sau là dấu chấm (tức là 01. tên thư mục) được hiển thị trong menu và tên thư mục không chứa giá trị số (tức là tên thư mục) sẽ không hiển thị. Chúng tôi có thể ghi đè nó trong tiêu đề trang.

title: About Us
visible: true

routable()

Bằng cách sử dụng điều này, chúng tôi có thể xác định xem một trang có routable hoặc là not routablenghĩa là liệu bạn có thể nhận lại nội dung khi trỏ trình duyệt của mình đến trang hay không. Các trang không thể định tuyến có thể được sử dụng trong các plugin, mẫu, v.v. và không thể truy cập trực tiếp các trang này. Điều này được đặt trong tiêu đề trang.

title: My Page
routable: true

slug()

Bằng cách sử dụng biến này, chúng ta có thể nhận được tên trực tiếp như được hiển thị trong URL của trang.

my-page

url([include_host = false])

Nó được sử dụng để trả về URL của trang

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

Hoặc là

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

route()

Nó được sử dụng để trả về định tuyến nội bộ của trang.

home()

Sử dụng biến này, bạn có thể xác định xem trang có được định cấu hình như hometrang hay không. Điều này trả về true khi một trang được định cấu hình làm trang chủ và false khi không được định cấu hình. Bạn có thể tìm thấy cài đặt này trongsystem.yaml tập tin.

root()

Nó xác định xem trang hiện tại có phải là trang gốc của hệ thống phân cấp hay không. Nó trở lạitrue nếu đó là trang gốc hoặc false nếu nó không phải là trang gốc.

active()

Bạn có thể xác định xem trình duyệt có đang truy cập trang hiện tại hay không bằng cách sử dụng biến này. Nó trở lạitrue nếu trình duyệt đang truy cập trang này hoặc false nếu nó không phải.

modular()

Bằng cách sử dụng biến này, chúng tôi có thể xác định xem trang này có phải là mô-đun hay không. Nếu đây là trang mô-đun thì nó trả vềtrue và false nếu nó không phải.

activeChild()

Biến này có thể xác định xem URL của URI này có URL của trang đang hoạt động hay không; hay nói cách đơn giản là URL của trang này trong URL hiện tại. Điều này rất hữu ích khi bạn đang làm việc trên điều hướng và bạn muốn biết rằng liệu các trang có lặp lại trên cùng một trang mẹ hay không.

find(url)

Như được chỉ định bởi URL định tuyến, đối tượng trang được trả về bởi biến này.

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

collection()

Biến này được sử dụng để trả về nhóm trang cho ngữ cảnh được xác định bởi tiêu đề trang bộ sưu tập.

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

isFirst()

Nếu trang hiện tại là trang đầu tiên của nó, thì nó sẽ trả về true người khác trả lại false.

isLast()

Nếu trang hiện tại là trang cuối cùng của trang anh chị em của nó, thì nó sẽ trả về true người khác trả lại false.

nextSibling()

Với tham chiếu đến vị trí hiện tại, nó trả về trang anh em tiếp theo từ mảng.

prevSibling()

Với tham chiếu đến vị trí hiện tại, nó trả về trang anh chị em trước đó từ mảng.

children()

Như đã định nghĩa trong cấu trúc nội dung trang, mảng các trang con được trả về bởi biến này.

orderBy()

Loại thứ tự của trẻ em đã được sắp xếp được trả về bằng phương thức này. Các giá trị có thể được bao gồmdefault, title, date và folder và các giá trị này được định cấu hình trong tiêu đề trang.

orderDir()

Phương thức này sẽ trả về hướng thứ tự của các trang con được sắp xếp. Và các giá trị có thể làasc(tăng dần) hoặc desc(descending). Thông thường những giá trị này được cấu hình trong tiêu đề trang.

orderManual()

Phương thức này trả về một mảng bao gồm thứ tự trang thủ công và thứ tự này sẽ dành cho bất kỳ phần con nào của trang. Giá trị này thường sẽ được đặt trong tiêu đề trang.

maxCount()

Biến này cho biết rằng có tối đa bao nhiêu trang con được phép trả về. Thông thường giá trị được chỉ định trong tiêu đề trang.

children.count()

Biến này trả về số lượng trang con cho một trang.

children.current()

Biến này sẽ trả về mục con hiện tại.

children.next()

Thao tác này sẽ trả về mục con tiếp theo từ một mảng các trang con.

children.prev()

Thao tác này sẽ trả về mục con trước đó từ một mảng các trang con.

children.nth(position)

Điều này sẽ trả lại vị trí của con trong mảng con.

parent()

Trong cấu trúc cây lồng nhau khi bạn muốn điều hướng trở lại trang mẹ, bạn có thể sử dụng biến này. Nó sẽ trả về đối tượng trang mẹ cho trang hiện tại.

isPage()

Bằng cách sử dụng biến này, bạn có thể xác định xem trang này có .md hoặc nó chỉ là một thư mục để định tuyến.

isDir()

Bằng cách sử dụng biến này, bạn có thể xác định xem trang hiện tại chỉ là một thư mục để định tuyến hay không. Nó trở lạitrue hoặc là false dựa trên nó.

id()

Điều này sẽ trả về id duy nhất cho trang.

modified()

Nó trả về dấu thời gian về thời điểm trang được sửa đổi lần cuối.

date()

Dấu thời gian ngày cho trang được trả về bằng phương thức này. Thông thường điều này được định cấu hình trong tiêu đề đại diện cho ngày của trang hoặc bài đăng. Nếu không có giá trị nào được cung cấp theo mặc định, dấu thời gian đã sửa đổi sẽ được sử dụng.

filePath()

Bằng cách sử dụng này, bạn có thể nhận được đường dẫn tệp đầy đủ của trang.

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

filePathClean()

Điều này sẽ trả về đường dẫn tương đối.

user/pages/ 01.home/default.md

path()

Thao tác này sẽ trả về một đường dẫn đầy đủ đến thư mục chứa trang hiện tại.

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

folder()

Thao tác này sẽ trả về tên thư mục cho trang.

taxonomy()

Điều này sẽ trả về một mảng phân loại được kết nối với trang.

path()

Phần của url hiện tại có thể được truy cập bằng cách sử dụng phương pháp này.

uri.path = /section/category/page

paths()

Mảng các phần tử đường dẫn được trả về bằng cách sử dụng phương thức này.

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

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

Phương thức này trả về tuyến đường có URL tuyệt đối hoặc URL tương đối.

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

Hoặc là,

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

params()

Điều này sẽ trả về phần tham số trong URL.

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

param(id)

Điều này sẽ trả về giá trị của tham số.

uri.param('param1') = foo

query()

Phần truy vấn của URL có thể được truy cập bằng cách sử dụng phương pháp này.

uri.query = query1=bar&query2=qux

query(id)

Sử dụng điều này, bạn có thể truy cập vào mục truy vấn cụ thể.

uri.query('query1') = bar

url([include_host = true])

Điều này trả về URL đầy đủ có thể chứa hoặc không chứa máy chủ.

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

extension()

Điều này sẽ trả về phần mở rộng hoặc nếu không được cung cấp, thì nó sẽ trả về html.

uri.extension = json)

host()

Điều này trả về máy chủ của URL.

uri.host = mysite.com

base()

Điều này sẽ trả về phần cơ sở của URL.

uri.base = http://mysite.com

rootUrl([include_host = true])

Thao tác này sẽ trả về URL gốc của phiên bản Grav.

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

referrer()

Thông tin liên kết giới thiệu của trang được trả về theo phương thức này.