Merge pull request #7336 from jekyll/docs/data-variables
docs: Page variables as YAML data
This commit is contained in:
		
						commit
						29ba846f9b
					
				|  | @ -0,0 +1,153 @@ | ||||||
|  | global: | ||||||
|  |   - name: site | ||||||
|  |     description: >- | ||||||
|  |       Site wide information + configuration settings from <code>_config.yml</code>. | ||||||
|  |       See below for details. | ||||||
|  |   - name: page | ||||||
|  |     description: >- | ||||||
|  |       Page specific information + the <a href="/docs/front-matter/">front matter</a>. | ||||||
|  |       Custom variables set via the front matter will be available here. See below for details. | ||||||
|  |   - name: layout | ||||||
|  |     description: >- | ||||||
|  |       Layout specific information + the <a href="/docs/front-matter/">front matter</a>. | ||||||
|  |       Custom variables set via front matter in layouts will be available here. | ||||||
|  |   - name: content | ||||||
|  |     description: >- | ||||||
|  |       In layout files, the rendered content of the Post or Page being wrapped. | ||||||
|  |       Not defined in Post or Page files. | ||||||
|  |   - name: paginator | ||||||
|  |     description: >- | ||||||
|  |       When the <code>paginate</code> configuration option is set, this variable becomes available | ||||||
|  |       for use. See <a href="../pagination/">Pagination</a> for details. | ||||||
|  | 
 | ||||||
|  | site: | ||||||
|  |   - name: site.time | ||||||
|  |     description: >- | ||||||
|  |       The current time (when you run the <code>jekyll</code> command). | ||||||
|  |   - name: site.pages | ||||||
|  |     description: >- | ||||||
|  |       A list of all Pages. | ||||||
|  |   - name: site.posts | ||||||
|  |     description: >- | ||||||
|  |       A reverse chronological list of all Posts. | ||||||
|  |   - name: site.related_posts | ||||||
|  |     description: >- | ||||||
|  |       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 <code>jekyll</code> command with the <code>--lsi</code> | ||||||
|  |       (<a href="https://en.wikipedia.org/wiki/Latent_semantic_analysis#Latent_semantic_indexing">latent semantic indexing</a>) | ||||||
|  |       option. Also note GitHub Pages does not support the | ||||||
|  |       <code>lsi</code> option when generating sites. | ||||||
|  |   - name: site.static_files | ||||||
|  |     description: >- | ||||||
|  |       A list of all <a href="/docs/static-files/">static files</a> (i.e. | ||||||
|  |       files not processed by Jekyll's converters or the Liquid renderer). | ||||||
|  |       Each file has five properties: <code>path</code>, <code>modified_time</code>, | ||||||
|  |       <code>name</code>, <code>basename</code> and <code>extname</code>. | ||||||
|  |   - name: site.html_pages | ||||||
|  |     description: >- | ||||||
|  |       A subset of `site.pages` listing those which end in `.html`. | ||||||
|  |   - name: site.html_files | ||||||
|  |     description: >- | ||||||
|  |       A subset of `site.static_files` listing those which end in `.html`. | ||||||
|  |   - name: site.collections | ||||||
|  |     description: >- | ||||||
|  |       A list of all the collections (including posts). | ||||||
|  |   - name: site.data | ||||||
|  |     description: >- | ||||||
|  |       A list containing the data loaded from the YAML files located in the <code>_data</code> | ||||||
|  |       directory. | ||||||
|  |   - name: site.documents | ||||||
|  |     description: >- | ||||||
|  |       A list of all the documents in every collection. | ||||||
|  |   - name: site.categories.CATEGORY | ||||||
|  |     description: >- | ||||||
|  |       The list of all Posts in category <code>CATEGORY</code>. | ||||||
|  |   - name: site.tags.TAG | ||||||
|  |     description: >- | ||||||
|  |       The list of all Posts with tag <code>TAG</code>. | ||||||
|  |   - name: site.url | ||||||
|  |     description: >- | ||||||
|  |       Contains the url of your site as it is configured in the <code>_config.yml</code>. | ||||||
|  |       For example, if you have <code>url: http://mysite.com</code> in your configuration file, | ||||||
|  |       then it will be accessible in Liquid as <code>site.url</code>. For the development | ||||||
|  |       environment there is <a href="/news/#3-siteurl-is-set-by-the-development-server">an | ||||||
|  |       exception</a>, if you are running <code>jekyll serve</code> in a development environment | ||||||
|  |       <code>site.url</code> will be set to the value of <code>host</code>, <code>port</code>, | ||||||
|  |       and SSL-related options. This defaults to <code>url: http://localhost:4000</code>. | ||||||
|  |   - name: "site.[CONFIGURATION_DATA]" | ||||||
|  |     description: >- | ||||||
|  |       All the variables set via the command line and your <code>_config.yml</code> are available | ||||||
|  |       through the <code>site</code> variable. For example, if you have <code>foo: bar</code> in | ||||||
|  |       your configuration file, then it will be accessible in Liquid as <code>site.foo</code>. | ||||||
|  |       Jekyll does not parse changes to <code>_config.yml</code> in | ||||||
|  |       <code>watch</code> mode, you must restart Jekyll to see changes to variables. | ||||||
|  | 
 | ||||||
|  | page: | ||||||
|  |   - name: page.content | ||||||
|  |     description: >- | ||||||
|  |       The content of the Page, rendered or un-rendered depending upon | ||||||
|  |       what Liquid is being processed and what <code>page</code> is. | ||||||
|  |   - name: page.title | ||||||
|  |     description: >- | ||||||
|  |       The title of the Page. | ||||||
|  |   - name: page.excerpt | ||||||
|  |     description: >- | ||||||
|  |       The un-rendered excerpt of a document. | ||||||
|  |   - name: page.url | ||||||
|  |     description: >- | ||||||
|  |       The URL of the Post without the domain, but with a leading slash, e.g. | ||||||
|  |       <code>/2008/12/14/my-post.html</code> | ||||||
|  |   - name: page.date | ||||||
|  |     description: >- | ||||||
|  |       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 <code>YYYY-MM-DD HH:MM:SS</code> (assuming UTC), or | ||||||
|  |       <code>YYYY-MM-DD HH:MM:SS +/-TTTT</code> (to specify a time zone using an offset from UTC. | ||||||
|  |       e.g. <code>2008-12-14 10:30:00 +0900</code>). | ||||||
|  |   - name: page.id | ||||||
|  |     description: >- | ||||||
|  |       An identifier unique to a document in a Collection or a Post (useful in RSS feeds). e.g. | ||||||
|  |       <code>/2008/12/14/my-post</code><code>/my-collection/my-document</code> | ||||||
|  |   - name: page.categories | ||||||
|  |     description: >- | ||||||
|  |       The list of categories to which this post belongs. Categories are derived from the directory | ||||||
|  |       structure above the <code>_posts</code> directory. For example, a post at | ||||||
|  |       <code>/work/code/_posts/2008-12-24-closures.md</code> would have this field set to | ||||||
|  |       <code>['work', 'code']</code>. These can also be specified in the | ||||||
|  |       <a href="/docs/front-matter/">front matter</a>. | ||||||
|  |   - name: page.tags | ||||||
|  |     description: >- | ||||||
|  |       The list of tags to which this post belongs. These can be specified in the | ||||||
|  |       <a href="/docs/front-matter/">front matter</a>. | ||||||
|  |   - name: page.path | ||||||
|  |     description: >- | ||||||
|  |       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 <a href="/docs/front-matter/">front matter</a>. | ||||||
|  |   - name: page.next | ||||||
|  |     description: >- | ||||||
|  |       The next post relative to the position of the current post in <code>site.posts</code>. | ||||||
|  |       Returns <code>nil</code> for the last entry. | ||||||
|  |   - name: page.previous | ||||||
|  |     description: >- | ||||||
|  |       The previous post relative to the position of the current post in <code>site.posts</code>. | ||||||
|  |       Returns <code>nil</code> for the first entry. | ||||||
|  | 
 | ||||||
|  | paginator: | ||||||
|  |   - name: paginator.per_page | ||||||
|  |     description: Number of Posts per page. | ||||||
|  |   - name: paginator.posts | ||||||
|  |     description: Posts available for that page. | ||||||
|  |   - name: paginator.total_posts | ||||||
|  |     description: Total number of Posts. | ||||||
|  |   - name: paginator.total_pages | ||||||
|  |     description: Total number of pages. | ||||||
|  |   - name: paginator.page | ||||||
|  |     description: The number of the current page. | ||||||
|  |   - name: paginator.previous_page | ||||||
|  |     description: The number of the previous page. | ||||||
|  |   - name: paginator.previous_page_path | ||||||
|  |     description: The path to the previous page. | ||||||
|  |   - name: paginator.next_page | ||||||
|  |     description: The number of the next page. | ||||||
|  |   - name: paginator.next_page_path | ||||||
|  |     description: The path to the next page. | ||||||
|  | @ -19,54 +19,12 @@ The following is a reference of the available data. | ||||||
|     </tr> |     </tr> | ||||||
|   </thead> |   </thead> | ||||||
|   <tbody> |   <tbody> | ||||||
|  |   {% for var in site.data.jekyll_variables.global %} | ||||||
|     <tr> |     <tr> | ||||||
|       <td><p><code>site</code></p></td> |       <td><p><code>{{ var.name }}</code></p></td> | ||||||
|       <td><p> |       <td><p>{{- var.description -}}</p></td> | ||||||
| 
 |  | ||||||
|           Sitewide information + configuration settings from |  | ||||||
|           <code>_config.yml</code>. See below for details. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>page</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         Page specific information + the <a href="/docs/front-matter/">front |  | ||||||
|         matter</a>. Custom variables set via the front matter will be |  | ||||||
|         available here. See below for details. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>layout</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         Layout specific information + the <a href="/docs/front-matter/">front |  | ||||||
|         matter</a>. Custom variables set via front matter in |  | ||||||
|         layouts will be available here. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>content</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         In layout files, the rendered content of the Post or Page being wrapped. |  | ||||||
|         Not defined in Post or Page files. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>paginator</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         When the <code>paginate</code> configuration option is set, this |  | ||||||
|         variable becomes available for use. See <a |  | ||||||
|         href="../pagination/">Pagination</a> for details. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |     </tr> | ||||||
|  |   {% endfor %} | ||||||
|   </tbody> |   </tbody> | ||||||
| </table> | </table> | ||||||
| </div> | </div> | ||||||
|  | @ -82,136 +40,12 @@ The following is a reference of the available data. | ||||||
|     </tr> |     </tr> | ||||||
|   </thead> |   </thead> | ||||||
|   <tbody> |   <tbody> | ||||||
|  |   {% for var in site.data.jekyll_variables.site %} | ||||||
|     <tr> |     <tr> | ||||||
|       <td><p><code>site.time</code></p></td> |       <td><p><code>{{ var.name }}</code></p></td> | ||||||
|       <td><p> |       <td><p>{{- var.description -}}</p></td> | ||||||
| 
 |  | ||||||
|         The current time (when you run the <code>jekyll</code> command). |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>site.pages</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         A list of all Pages. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>site.posts</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         A reverse chronological list of all Posts. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>site.related_posts</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         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 |  | ||||||
|         <code>jekyll</code> command with the <code>--lsi</code> (<a href="https://en.wikipedia.org/wiki/Latent_semantic_analysis#Latent_semantic_indexing">latent semantic indexing</a>) option. Also note GitHub Pages does not support the <code>lsi</code> option when generating sites. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>site.static_files</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         A list of all <a href="/docs/static-files/">static files</a> (i.e. |  | ||||||
|         files not processed by Jekyll's converters or the Liquid renderer). |  | ||||||
|         Each file has five properties: <code>path</code>, <code>modified_time</code>, <code>name</code>, <code>basename</code> and <code>extname</code>. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>site.html_pages</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         A subset of `site.pages` listing those which end in `.html`. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>site.html_files</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         A subset of `site.static_files` listing those which end in `.html`. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>site.collections</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         A list of all the collections. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>site.data</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         A list containing the data loaded from the YAML files located in the <code>_data</code> directory. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>site.documents</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         A list of all the documents in every collection. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>site.categories.CATEGORY</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         The list of all Posts in category <code>CATEGORY</code>. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>site.tags.TAG</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         The list of all Posts with tag <code>TAG</code>. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>site.url</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         Contains the url of your site as it is configured in the <code>_config.yml</code>. |  | ||||||
|         For example, if you have <code>url: http://mysite.com</code> |  | ||||||
|         in your configuration file, then it will be accessible in Liquid as |  | ||||||
|         <code>site.url</code>. For the development environment there is |  | ||||||
|         <a href="/news/#3-siteurl-is-set-by-the-development-server">an exception</a>, |  | ||||||
|         if you are running <code>jekyll serve</code> in a development environment |  | ||||||
|         <code>site.url</code> will be set to the value of <code>host</code>, |  | ||||||
|         <code>port</code>, and SSL-related options. This defaults to |  | ||||||
|         <code>url: http://localhost:4000</code>. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>site.[CONFIGURATION_DATA]</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         All the variables set via the command line and your |  | ||||||
|         <code>_config.yml</code> are available through the <code>site</code> |  | ||||||
|         variable. For example, if you have <code>foo: bar</code> |  | ||||||
|         in your configuration file, then it will be accessible in Liquid as <code>site.foo</code>. |  | ||||||
|         Jekyll does not parse changes to <code>_config.yml</code> in |  | ||||||
|         <code>watch</code> mode, you must restart Jekyll to see changes to variables. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |     </tr> | ||||||
|  |   {% endfor %} | ||||||
|   </tbody> |   </tbody> | ||||||
| </table> | </table> | ||||||
| </div> | </div> | ||||||
|  | @ -227,113 +61,12 @@ The following is a reference of the available data. | ||||||
|     </tr> |     </tr> | ||||||
|   </thead> |   </thead> | ||||||
|   <tbody> |   <tbody> | ||||||
|  |   {% for var in site.data.jekyll_variables.page %} | ||||||
|     <tr> |     <tr> | ||||||
|       <td><p><code>page.content</code></p></td> |       <td><p><code>{{ var.name }}</code></p></td> | ||||||
|       <td><p> |       <td><p>{{- var.description -}}</p></td> | ||||||
| 
 |  | ||||||
|         The content of the Page, rendered or un-rendered depending upon |  | ||||||
|         what Liquid is being processed and what <code>page</code> is. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>page.title</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         The title of the Page. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>page.excerpt</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         The un-rendered excerpt of a document. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>page.url</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         The URL of the Post without the domain, but |  | ||||||
|         with a leading slash, e.g. |  | ||||||
|         <code>/2008/12/14/my-post.html</code> |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>page.date</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         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 |  | ||||||
|         <code>YYYY-MM-DD HH:MM:SS</code> (assuming UTC), or |  | ||||||
|         <code>YYYY-MM-DD HH:MM:SS +/-TTTT</code> (to specify a time zone using |  | ||||||
|         an offset from UTC. e.g. <code>2008-12-14 10:30:00 +0900</code>). |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>page.id</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         An identifier unique to a document in a Collection or a Post (useful in RSS feeds). e.g. |  | ||||||
|         <code>/2008/12/14/my-post</code> |  | ||||||
|         <code>/my-collection/my-document</code> |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>page.categories</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         The list of categories to which this post belongs. Categories are |  | ||||||
|         derived from the directory structure above the <code>_posts</code> |  | ||||||
|         directory. For example, a post at |  | ||||||
|         <code>/work/code/_posts/2008-12-24-closures.md</code> would have this |  | ||||||
|         field set to <code>['work', 'code']</code>. These can also be specified |  | ||||||
|         in the <a href="/docs/front-matter/">front matter</a>. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>page.tags</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         The list of tags to which this post belongs. These can be specified in |  | ||||||
|         the <a href="/docs/front-matter/">front matter</a>. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>page.path</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         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 |  | ||||||
|         <a href="/docs/front-matter/">front matter</a>. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>page.next</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         The next post relative to the position of the current post in |  | ||||||
|         <code>site.posts</code>. Returns <code>nil</code> for the last entry. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>page.previous</code></p></td> |  | ||||||
|       <td><p> |  | ||||||
| 
 |  | ||||||
|         The previous post relative to the position of the current post in |  | ||||||
|         <code>site.posts</code>. Returns <code>nil</code> for the first entry. |  | ||||||
| 
 |  | ||||||
|       </p></td> |  | ||||||
|     </tr> |     </tr> | ||||||
|  |   {% endfor %} | ||||||
|   </tbody> |   </tbody> | ||||||
| </table> | </table> | ||||||
| </div> | </div> | ||||||
|  | @ -341,20 +74,14 @@ The following is a reference of the available data. | ||||||
| <div class="note"> | <div class="note"> | ||||||
|   <h5>ProTip™: Use Custom Front Matter</h5> |   <h5>ProTip™: Use Custom Front Matter</h5> | ||||||
|   <p> |   <p> | ||||||
| 
 |  | ||||||
|     Any custom front matter that you specify will be available under |     Any custom front matter that you specify will be available under | ||||||
|     <code>page</code>. For example, if you specify <code>custom_css: true</code> |     <code>page</code>. For example, if you specify <code>custom_css: true</code> | ||||||
|     in a page’s front matter, that value will be available as |     in a page’s front matter, that value will be available as <code>page.custom_css</code>. | ||||||
|     <code>page.custom_css</code>. |  | ||||||
| 
 |  | ||||||
|   </p> |   </p> | ||||||
|   <p> |   <p> | ||||||
| 
 |  | ||||||
|     If you specify front matter in a layout, access that via <code>layout</code>. |     If you specify front matter in a layout, access that via <code>layout</code>. | ||||||
|     For example, if you specify <code>class: full_page</code> |     For example, if you specify <code>class: full_page</code> in a layout’s front matter, | ||||||
|     in a layout’s front matter, that value will be available as |     that value will be available as <code>layout.class</code> in the layout and its parents. | ||||||
|     <code>layout.class</code> in the layout and its parents. |  | ||||||
| 
 |  | ||||||
|   </p> |   </p> | ||||||
| </div> | </div> | ||||||
| 
 | 
 | ||||||
|  | @ -369,42 +96,12 @@ The following is a reference of the available data. | ||||||
|     </tr> |     </tr> | ||||||
|   </thead> |   </thead> | ||||||
|   <tbody> |   <tbody> | ||||||
|  |   {% for var in site.data.jekyll_variables.paginator %} | ||||||
|     <tr> |     <tr> | ||||||
|       <td><p><code>paginator.per_page</code></p></td> |       <td><p><code>{{ var.name }}</code></p></td> | ||||||
|       <td><p>Number of Posts per page.</p></td> |       <td><p>{{- var.description -}}</p></td> | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>paginator.posts</code></p></td> |  | ||||||
|       <td><p>Posts available for that page.</p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>paginator.total_posts</code></p></td> |  | ||||||
|       <td><p>Total number of Posts.</p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>paginator.total_pages</code></p></td> |  | ||||||
|       <td><p>Total number of pages.</p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>paginator.page</code></p></td> |  | ||||||
|       <td><p>The number of the current page.</p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>paginator.previous_page</code></p></td> |  | ||||||
|       <td><p>The number of the previous page.</p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>paginator.previous_page_path</code></p></td> |  | ||||||
|       <td><p>The path to the previous page.</p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>paginator.next_page</code></p></td> |  | ||||||
|       <td><p>The number of the next page.</p></td> |  | ||||||
|     </tr> |  | ||||||
|     <tr> |  | ||||||
|       <td><p><code>paginator.next_page_path</code></p></td> |  | ||||||
|       <td><p>The path to the next page.</p></td> |  | ||||||
|     </tr> |     </tr> | ||||||
|  |   {% endfor %} | ||||||
|   </tbody> |   </tbody> | ||||||
| </table> | </table> | ||||||
| </div> | </div> | ||||||
|  | @ -412,9 +109,7 @@ The following is a reference of the available data. | ||||||
| <div class="note info"> | <div class="note info"> | ||||||
|   <h5>Paginator variable availability</h5> |   <h5>Paginator variable availability</h5> | ||||||
|   <p> |   <p> | ||||||
| 
 |     These are only available in index files, however they can be located in a subdirectory, | ||||||
|     These are only available in index files, however they can be located in a |     such as <code>/blog/index.html</code>. | ||||||
|     subdirectory, such as <code>/blog/index.html</code>. |  | ||||||
| 
 |  | ||||||
|   </p> |   </p> | ||||||
| </div> | </div> | ||||||
|  |  | ||||||
		Loading…
	
		Reference in New Issue