Theme variables

The chapter-vars.html helper sets a number of variables for this theme, which can be accessed in markdown files and Liquid templates. It can also render the variables for inspection.

Parameters:

• id: The page.id of the chapter page for which to set variables.
• slug: The page.slug of the chapter page for which to set variables (ignored if id is passed).
• withnum: For performance reasons, chapter and part numbers are not computed unless withnum is true. (To compute only chapter or only part numbers, set withnum=part or withnum=chapter instead.)
• inspect: If true, render the variables to the page, for debugging.

To set variables for the current chapter:

{% include chapter-vars.html id=page.id withnum="true" %}

Then access them like this:

**Chapter number:** {{ chapter_num }}

…which renders: Chapter number: 4

To inspect all the variables, for debugging:

{% include chapter-vars.html id=page.id inspect="true" withnum="true" %}

…which renders this:

To set variables for a different chapter, you can pass the chapter’s slug, like this:

{% include chapter-vars.html slug="contents" withnum="true" inspect="true" %}

…which renders this:

This file is located at: _chapters/010-chapterbook-theme/060-variables.md