Entry
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.
Navigate π
- Via other document > navigate methods.
- Hop to entries via the graph.
- Select a related entry via entry head and entry links.
Markdown π
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 \
)
Config π
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 open
or closed
.