当前位置: 首页 > 工具软件 > jekyll-dash > 使用案例 >

Jekyll中文文档__Variables

危钱明
2023-12-01

Jekyll 浏览您的网站,寻找要处理的文件。任何有 front matter 的文件都要经过处理。对于这些文件中的每一个,Jekyll都会通过 Liquid 提供各种数据。以下是可用数据的参考。

Global Variables

VariableDescription

site

Site wide information + configuration settings from _config.yml. See below for details.

page

Page specific information + the front matter. Custom variables set via the front matter will be available here. See below for details.

layout

Layout specific information + the front matter. Custom variables set via front matter in layouts will be available here.

theme

Theme-gem specific information as defined in the theme's gemspec. Useful for rendering information in the theme demo's "About" page, for example. See below for details.

content

In layout files, the rendered content of the Post or Page being wrapped. Not defined in Post or Page files.

paginator

When the paginate configuration option is set, this variable becomes available for use. See Pagination for details.

===============================================

Site Variables

VariableDescription

site.time

The current time (when you run the jekyll command).

site.pages

A list of all Pages.

site.posts

A reverse chronological list of all Posts.

site.related_posts

If the page being processed is a Post, this contains a list of up to ten related Posts. By default, these are the ten most recent posts. For high quality but slow to compute results, run the jekyll command with the --lsi (latent semantic indexing) option. Also note GitHub Pages does not support the lsi option when generating sites.

site.static_files

A list of all static files (i.e. files not processed by Jekyll's converters or the Liquid renderer). Each file has five properties: path, modified_time, name, basename and extname.

site.html_pages

A subset of site.pages listing those which end in .html.

site.html_files

A subset of site.static_files listing those which end in .html.

site.collections

A list of all the collections (including posts).

site.data

A list containing the data loaded from the YAML files located in the _data directory.

site.documents

A list of all the documents in every collection.

site.categories.CATEGORY

The list of all Posts in category CATEGORY.

site.tags.TAG

The list of all Posts with tag TAG.

site.url

Contains the url of your site as it is configured in the _config.yml. For example, if you have url: http://mysite.com in your configuration file, then it will be accessible in Liquid as site.url. For the development environment there is an exception, if you are running jekyll serve in a development environment site.url will be set to the value of host, port, and SSL-related options. This defaults to url: http://localhost:4000.

site.[CONFIGURATION_DATA]

All the variables set via the command line and your _config.yml are available through the site variable. For example, if you have foo: bar in your configuration file, then it will be accessible in Liquid as site.foo. Jekyll does not parse changes to _config.yml in watch mode, you must restart Jekyll to see changes to variables.

=================================================================================

Page Variables

VariableDescription

page.content

The content of the Page, rendered or un-rendered depending upon what Liquid is being processed and what page is.

page.title

The title of the Page.

page.excerpt

The un-rendered excerpt of a document.

page.url

The URL of the Post without the domain, but with a leading slash, e.g. /2008/12/14/my-post.html

page.date

The Date assigned to the Post. This can be overridden in a Post’s front matter by specifying a new date/time in the format YYYY-MM-DD HH:MM:SS (assuming UTC), or YYYY-MM-DD HH:MM:SS +/-TTTT (to specify a time zone using an offset from UTC. e.g. 2008-12-14 10:30:00 +0900).

page.id

An identifier unique to a document in a Collection or a Post (useful in RSS feeds). e.g. /2008/12/14/my-post/my-collection/my-document

page.categories

The list of categories to which this post belongs. Categories are derived from the directory structure above the _posts directory. For example, a post at /work/code/_posts/2008-12-24-closures.md would have this field set to ['work', 'code']. These can also be specified in the front matter.

page.collection

The label of the collection to which this document belongs. e.g. posts for a post, or puppies for a document at path _puppies/rover.md. If not part of a collection, an empty string is returned.

page.tags

The list of tags to which this post belongs. These can be specified in the front matter.

page.dir

The path between the source directory and the file of the post or page, e.g. /pages/. This can be overridden by permalink in the front matter.

page.name

The filename of the post or page, e.g. about.md

page.path

The path to the raw post or page. Example usage: Linking back to the page or post’s source on GitHub. This can be overridden in the front matter.

page.next

The next post relative to the position of the current post in site.posts. Returns nil for the last entry.

page.previous

The previous post relative to the position of the current post in site.posts. Returns nil for the first entry.

=================================================

ProTip™: 使用自定义的 Front Matter

您指定的任何自定义的 front matter 都将可以在 page 的下级使用。例如,如果在页面的 front matter 指定 custom_css: true ,则该值将以 page.custom_css 来使用。

如果您在布局中指定了 front matter ,请通过 layout 访问该内容。例如,如果在布局的 front matter 中指定 class: full_page ,则该值将在布局及其父级中以 layout.class 来使用。

Theme Variables(4.3.0)

VariableDescription

theme.root

Absolute path to the theme-gem.

theme.authors

Comma separated string composed of the authors of the theme-gem.

theme.description

Description or summary of the theme-gem as specified in the theme gemspec.

theme.version

The version string of current theme.

theme.dependencies

List of runtime dependencies of the theme.

theme.metadata

A mapping of key-value pairs as defined in the theme gemspec.

=================================================

Paginator

VariableDescription

paginator.page

The number of the current page

paginator.per_page

Number of posts per page

paginator.posts

Posts available for the current page

paginator.total_posts

Total number of posts

paginator.total_pages

Total number of pages

paginator.previous_page

The number of the previous page, or nil if no previous page exists

paginator.previous_page_path

The path to the previous page, or nil if no previous page exists

paginator.next_page

The number of the next page, or nil if no subsequent page exists

paginator.next_page_path

The path to the next page, or nil if no subsequent page exists

=================================================

Paginator variable availability

这些仅在 index 文件中可用,但可以位于子目录中,如 /blog/index.html

 类似资料: