include
This function has two behaviors:
Reads a Quarkdown file and includes its parsed content in the current document. Loadable libraries are fetched from the library folder (
--libs
option).Loads a present but unloaded library into the current context. The context of the main file is shared to the sub-file and vice versa, allowing for sharing of variables, functions and other declarations.
Return
the content of the file as a node if a file is included, or nothing if a library is loaded
Parameters
path
either a path (relative or absolute with extension) to the file to include, or the name of a loadable library
Throws
if the loaded Quarkdown source cannot be evaluated or if it cannot be evaluated into a suitable output value