quacksouls / honkit-plugin-exercise

Formatting exercises/problems in HonKit

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

HonKit plugin: exercise

Formats and numbers each exercise. Numbering is automatic and starts at 1. An exercise can be labelled to allow for cross-referencing.

Installation

Install via npm:

npm install honkit-plugin-exercise --save-dev

Add the plugin to your book.json:

{
    plugins: [ "exercise" ]
}

Usage

An exercise is added by the block:

{% exercise %}{% endexercise %}
Insert your exercise text here.

To help cross-reference an exercise, you can add a label. The label text should not have any white spaces.

{% exercise label="my_label" %}{% endexercise %}
Insert your exercise text here.

For example, the following exercise blocks

{% exercise %}{% endexercise %}
What Is the airspeed velocity of an unladen swallow?

{% exercise label="a_label" %}{% endexercise %}
What do you mean? An African or a European swallow?

would be rendered as

Unladen swallow

Cross-reference an exercise like how you cross-reference a section in a Markdown file. In the above example, the exercise having the label "a_label" can be cross-referenced as:

[this exercise](/path/to/file.md#a_label)

About

Formatting exercises/problems in HonKit

License:Apache License 2.0


Languages

Language:JavaScript 100.0%