The Graft Developers
https://graft.sirref.org/index/
index
/index/
Graft Documentation
Welcome to the Graft Graft
Graft is a preprocessor for Forester allowing users to write their forests using markdown and bibtex. Different markups and formats have slightly different semantics in terms of the trees they generate. For more information, please refer to their individual trees.
2025
7
14
https://graft.sirref.org/graft-0001/
graft-0001
/graft-0001/
Markdown Syntax
The markdown syntax is the core feature of Graft. It supports most of what Forester has to offer. It uses a Jekyll format frontmatter to provide Forester metadata and supports special code blocks too.
2025
7
14
https://graft.sirref.org/graft-0003/
graft-0003
/graft-0003/
YAML Frontmatter
The markdown format for Graft follows the Jekyll-style YAML frontmatter format. For example:
will generate a tree with title and date metadata with a single paragraph of text.
To insert meta field into your tree, you can use a nested object in your YAML frontmatter.
There is no centralised documentation on these meta but this biographical tree example may be useful
2025
7
15
https://graft.sirref.org/graft-0008/
graft-0008
/graft-0008/
Subheadings are subtrees
Markdown headings are automatically transformed into "anonymous subtrees"
2025
7
15
Anonymous!
Just like that. It means they allow authors to provide structure without adhering to the atomicity principles.
2025
7
15
Interaction with Forester Subtrees
Markdown sections delimited by headings have no "closing tag". This means you that you don't quite get the nice feature of Forester where subtrees can be a standalone thing inside another text. Furthermore, including a subtree
2025
7
15
https://graft.sirref.org/named-subtrees/
named-subtrees
/named-subtrees/
Named subtrees
Sometimes you don't want to create a new file just to have a referenceable tree. In this case, you want a named subtree. In the markdown syntax you can use markdown heading IDs to name your subtrees. For example this section has the following heading:
2025
7
14
https://graft.sirref.org/graft-0004/
graft-0004
/graft-0004/
Forester Code Blocks
The markdown syntax cannot do everything that Forester can. For example, how might you transclude another tree into your tree?
At any given moment, you can escape into Forester syntax by using a code block where the infostring is forester. Graft will translate this into Forester syntax and output it in the same location as the code block in the generated code.
2025
7
14
https://graft.sirref.org/graft-0005/
graft-0005
/graft-0005/
Other Special Code Blocks
by Graft.
ocaml code blocks will be run through hilite and converted to HTML.
2025
7
16
https://graft.sirref.org/graft-0007/
graft-0007
/graft-0007/
Verbatim HTML
Using markdown's HTML blocks, you can add HTML directly into your tree.
For example you could embed a marquee element by writing.
]]>
This is a marquee element!
2025
7
14
https://graft.sirref.org/graft-0002/
graft-0002
/graft-0002/
Bibtex Syntax
The bibtex syntax allows you to generate individual reference trees per entry.
For example, consider the following bibtex entry.
We have placed this in a file called refs.bib and can directly reference the entry with mokhov-build-systems!
Warning: the bibtex is quite fragile due to the parser we use. At some point
I hope to help make this better. Using the above entry as an example would be wise. For example,
middle name initials are not supported in author names.
2025
7
14
https://graft.sirref.org/graft-0006/
graft-0006
/graft-0006/
Usage
To use Graft you will need to install it via opam.
and after setting up a minimal Forester project, you can generate your forest using:
This assumes your forest.toml is set up to build from trees and all of your markdown and bibtex files are stored in src.
2025
7
14
https://graft.sirref.org/usage-dev/
usage-dev
/usage-dev/
Development
Graft has most likely had plenty of improvements and bug fixes since the last release. To grab a hold of those changes you can pin the package:
References
Andrey Mokhov
Neil Mitchell
Simon Jones
2018
https://graft.sirref.org/mokhov-build-systems/
mokhov-build-systems
/mokhov-build-systems/
Build systems a la carte
Reference
https://doi.org/10.1145/3236774
Proceedings of the ACM on Programming Languages
10.1145/3236774
Andrey Mokhov
Neil Mitchell
Simon Jones
2018
Abstract
Build systems are awesome, terrifying -- and unloved. They are used by every developer around the world, but are rarely the object of study. In this paper we offer a systematic, and executable, framework for developing and comparing build systems, viewing them as related points in landscape rather than as isolated phenomena. By teasing apart existing build systems, we can recombine their components, allowing us to prototype new build systems with desired properties.
Context
Backlinks
2025
7
14
https://graft.sirref.org/graft-0006/
graft-0006
/graft-0006/
Usage
To use Graft you will need to install it via opam.
and after setting up a minimal Forester project, you can generate your forest using:
This assumes your forest.toml is set up to build from trees and all of your markdown and bibtex files are stored in src.
2025
7
14
https://graft.sirref.org/usage-dev/
usage-dev
/usage-dev/
Development
Graft has most likely had plenty of improvements and bug fixes since the last release. To grab a hold of those changes you can pin the package:
2025
7
14
https://graft.sirref.org/graft-0003/
graft-0003
/graft-0003/
YAML Frontmatter
The markdown format for Graft follows the Jekyll-style YAML frontmatter format. For example:
will generate a tree with title and date metadata with a single paragraph of text.
To insert meta field into your tree, you can use a nested object in your YAML frontmatter.
There is no centralised documentation on these meta but this biographical tree example may be useful
The Graft Developers
https://graft.sirref.org/index/
index
/index/
Graft Documentation
Welcome to the Graft Graft
Graft is a preprocessor for Forester allowing users to write their forests using markdown and bibtex. Different markups and formats have slightly different semantics in terms of the trees they generate. For more information, please refer to their individual trees.
2025
7
14
https://graft.sirref.org/graft-0001/
graft-0001
/graft-0001/
Markdown Syntax
The markdown syntax is the core feature of Graft. It supports most of what Forester has to offer. It uses a Jekyll format frontmatter to provide Forester metadata and supports special code blocks too.
2025
7
14
https://graft.sirref.org/graft-0003/
graft-0003
/graft-0003/
YAML Frontmatter
The markdown format for Graft follows the Jekyll-style YAML frontmatter format. For example:
will generate a tree with title and date metadata with a single paragraph of text.
To insert meta field into your tree, you can use a nested object in your YAML frontmatter.
There is no centralised documentation on these meta but this biographical tree example may be useful
2025
7
15
https://graft.sirref.org/graft-0008/
graft-0008
/graft-0008/
Subheadings are subtrees
Markdown headings are automatically transformed into "anonymous subtrees"
2025
7
15
Anonymous!
Just like that. It means they allow authors to provide structure without adhering to the atomicity principles.
2025
7
15
Interaction with Forester Subtrees
Markdown sections delimited by headings have no "closing tag". This means you that you don't quite get the nice feature of Forester where subtrees can be a standalone thing inside another text. Furthermore, including a subtree
2025
7
15
https://graft.sirref.org/named-subtrees/
named-subtrees
/named-subtrees/
Named subtrees
Sometimes you don't want to create a new file just to have a referenceable tree. In this case, you want a named subtree. In the markdown syntax you can use markdown heading IDs to name your subtrees. For example this section has the following heading:
2025
7
14
https://graft.sirref.org/graft-0004/
graft-0004
/graft-0004/
Forester Code Blocks
The markdown syntax cannot do everything that Forester can. For example, how might you transclude another tree into your tree?
At any given moment, you can escape into Forester syntax by using a code block where the infostring is forester. Graft will translate this into Forester syntax and output it in the same location as the code block in the generated code.
2025
7
14
https://graft.sirref.org/graft-0005/
graft-0005
/graft-0005/
Other Special Code Blocks
by Graft.
ocaml code blocks will be run through hilite and converted to HTML.
2025
7
16
https://graft.sirref.org/graft-0007/
graft-0007
/graft-0007/
Verbatim HTML
Using markdown's HTML blocks, you can add HTML directly into your tree.
For example you could embed a marquee element by writing.
]]>
This is a marquee element!
2025
7
14
https://graft.sirref.org/graft-0002/
graft-0002
/graft-0002/
Bibtex Syntax
The bibtex syntax allows you to generate individual reference trees per entry.
For example, consider the following bibtex entry.
We have placed this in a file called refs.bib and can directly reference the entry with mokhov-build-systems!
Warning: the bibtex is quite fragile due to the parser we use. At some point
I hope to help make this better. Using the above entry as an example would be wise. For example,
middle name initials are not supported in author names.
2025
7
14
https://graft.sirref.org/graft-0006/
graft-0006
/graft-0006/
Usage
To use Graft you will need to install it via opam.
and after setting up a minimal Forester project, you can generate your forest using:
This assumes your forest.toml is set up to build from trees and all of your markdown and bibtex files are stored in src.
2025
7
14
https://graft.sirref.org/usage-dev/
usage-dev
/usage-dev/
Development
Graft has most likely had plenty of improvements and bug fixes since the last release. To grab a hold of those changes you can pin the package:
Related
The Graft Developers
https://graft.sirref.org/index/
index
/index/
Graft Documentation
Welcome to the Graft Graft
Graft is a preprocessor for Forester allowing users to write their forests using markdown and bibtex. Different markups and formats have slightly different semantics in terms of the trees they generate. For more information, please refer to their individual trees.
2025
7
14
https://graft.sirref.org/graft-0001/
graft-0001
/graft-0001/
Markdown Syntax
The markdown syntax is the core feature of Graft. It supports most of what Forester has to offer. It uses a Jekyll format frontmatter to provide Forester metadata and supports special code blocks too.
2025
7
14
https://graft.sirref.org/graft-0003/
graft-0003
/graft-0003/
YAML Frontmatter
The markdown format for Graft follows the Jekyll-style YAML frontmatter format. For example:
will generate a tree with title and date metadata with a single paragraph of text.
To insert meta field into your tree, you can use a nested object in your YAML frontmatter.
There is no centralised documentation on these meta but this biographical tree example may be useful
2025
7
15
https://graft.sirref.org/graft-0008/
graft-0008
/graft-0008/
Subheadings are subtrees
Markdown headings are automatically transformed into "anonymous subtrees"
2025
7
15
Anonymous!
Just like that. It means they allow authors to provide structure without adhering to the atomicity principles.
2025
7
15
Interaction with Forester Subtrees
Markdown sections delimited by headings have no "closing tag". This means you that you don't quite get the nice feature of Forester where subtrees can be a standalone thing inside another text. Furthermore, including a subtree
2025
7
15
https://graft.sirref.org/named-subtrees/
named-subtrees
/named-subtrees/
Named subtrees
Sometimes you don't want to create a new file just to have a referenceable tree. In this case, you want a named subtree. In the markdown syntax you can use markdown heading IDs to name your subtrees. For example this section has the following heading:
2025
7
14
https://graft.sirref.org/graft-0004/
graft-0004
/graft-0004/
Forester Code Blocks
The markdown syntax cannot do everything that Forester can. For example, how might you transclude another tree into your tree?
At any given moment, you can escape into Forester syntax by using a code block where the infostring is forester. Graft will translate this into Forester syntax and output it in the same location as the code block in the generated code.
2025
7
14
https://graft.sirref.org/graft-0005/
graft-0005
/graft-0005/
Other Special Code Blocks
by Graft.
ocaml code blocks will be run through hilite and converted to HTML.
2025
7
16
https://graft.sirref.org/graft-0007/
graft-0007
/graft-0007/
Verbatim HTML
Using markdown's HTML blocks, you can add HTML directly into your tree.
For example you could embed a marquee element by writing.
]]>
This is a marquee element!
2025
7
14
https://graft.sirref.org/graft-0002/
graft-0002
/graft-0002/
Bibtex Syntax
The bibtex syntax allows you to generate individual reference trees per entry.
For example, consider the following bibtex entry.
We have placed this in a file called refs.bib and can directly reference the entry with mokhov-build-systems!
Warning: the bibtex is quite fragile due to the parser we use. At some point
I hope to help make this better. Using the above entry as an example would be wise. For example,
middle name initials are not supported in author names.
2025
7
14
https://graft.sirref.org/graft-0006/
graft-0006
/graft-0006/
Usage
To use Graft you will need to install it via opam.
and after setting up a minimal Forester project, you can generate your forest using:
This assumes your forest.toml is set up to build from trees and all of your markdown and bibtex files are stored in src.
2025
7
14
https://graft.sirref.org/usage-dev/
usage-dev
/usage-dev/
Development
Graft has most likely had plenty of improvements and bug fixes since the last release. To grab a hold of those changes you can pin the package:
Contributions