Pages and Summary
HonKit uses a
SUMMARY.md file to define the structure of chapters and subchapters of the book. The
SUMMARY.md file is used to generate the book's table of contents.
The format of
SUMMARY.md is just a list of links. The link's title is used as the chapter's title, and the link's target is a path to that chapter's file.
Adding a nested list to a parent chapter will create subchapters.
# Summary * [Part I]( ) * [Writing is nice]( ) * [HonKit is nice]( ) * [Part II]( ) * [We love feedback]( ) * [Better tools for authors]( )
Each chapter has a dedicated page (
part#/README.md) and is split into subchapters.
Chapters in the Table of Contents can be pointing to specific part of a file using anchor.
# Summary ### Part I * [Part I]( ) * [Writing is nice]( ) * [HonKit is nice]( ) * [Part II]( ) * [We love feedback]( ) * [Better tools for authors]( )
The Table of Contents can be divided into parts separated by headings or horizontal lines:
# Summary ### Part I * [Writing is nice]( ) * [HonKit is nice]( ) ### Part II * [We love feedback]( ) * [Better tools for authors]( ) ---- * [Last part without title]( )
Parts are just groups of chapters and do not have dedicated pages, but according to the theme, it will show in the navigation.
Most of the files for HonKit use the Markdown syntax by default. HonKit infers your pages's structure from it. The syntax used is similar to the GitHub Flavored Markdown syntax. One can also opt for the AsciiDoc syntax.
Example of a chapter file
# Title of the chapter This is a great introduction. ## Section 1 Markdown will dictates _most_ of your **book's structure** ## Section 2 ...
Pages can contain an optional front matter. It can be used to define the page's description. The front matter must be the first thing in the file and must take the form of valid YAML set between triple-dashed lines. Here is a basic example:
description: This is a short description of my page # The content of my page ...
The front matter can define variables of your own, they will be added to the page variable so you can use them in your templating.