Like in a dictionary, encylopedia, or wikipedia, entries are one of the central document types to this template (besides
posts). They are atomic concepts and ideas. Ideally they are meaningfully linked so as to understand how ideas relate to one another.
- Via other document > navigate methods.
- Hop to entries via the graph.
- Select a related entry via entry head and entry links.
Entries use hierarchical namespaces and live in the
_entries/ directory. Its structure will typically contain frontmatter, wiki attributes, and markdown text respectively:
# The filename contains the path from the hierarchy's # root (base markdown file) to # leaf (the current markdown file) # # ex: # The following filename... # # base-concept.mid-concept.current-concept.md # # ...would map to a tree node with path: # # root -> base-concept -> mid-concept -> current-concept
--- frontmatter: attributes --- wiki-attribute::[\[base-concept.related-concept]] Then follows the rest of the text for the document, some of which might contain some more [\[wikilinks]].
(without the backslash escape chars
There are some
entry configs that the creator may set:
bonsai: entries: backlinks: false root_path: "_entries/root.md" toggles: # may be 'open' or 'closed' breadcrumb: "open" attr_box: "open" foot_links: "open" foot_tagged: "open"
backlinks: Once enough links and attributes have been accumulated, it might be desirable to try turning off backlinks to cleanup the entry’s footer. (This is more likely happen if you’re using the jekyll-wikilinks
attributes and block-level wikilinks)
root_path refers to which document should act as the root of the namespaces hierarchy (and the tree graph).
toggles: refer to the entry head and entry links which may be toggled