If NBfancy is initialised with the flag --extra_config
it will give the user access to two additional configuration files: keywords.cfg
and box.ipynb
. The first of these, keywords.cfg
, can be used to modify the behaviour of existing keywords and allows the user to define their own keywords. The notebook file called "box" is discussed in the next section.
!nbfancy init example2 --extra_conf
!ls example2/config
The configuration file itself is a CSV file, which defines the behaviour of the underlying keywords. If this file is present and different to the internal configuration, it will be used instead.
!cat example2/config/keywords.cfg
Comments in this file are denoted using #
and any line starting with #
is ignored. Blank lines are also ignored allowing for the config to contain vertical spaces. The first line defines the headings: the keyword and all the properties that are expected. After that each line defines an environement by defining a keyword, which will trigger the cell in a notebook to be processed followed by the formatting. The formatting consists of the colour of the boxm the symbol as defined by the font-awsome font, whether or not the keyword is printed in the rendered notebook and finally whether the cell get hidden (used for solutions).