A jungle gym for thought with an API for the mind.
A knowledge bonsai wends through concepts in semantic space, like a melody winds through harmonies in music.
β οΈ π± This project is newly sprouted! So please consider it a beta: Remember to backup all data and please use version control.
The WikiBonsai project[^ai] transforms a collection of markdown files into a text-based, easy-to-navigate jungle gym for thought[^mind] with an API for the mind[^mixed-metaphors]. This is accomplished by enabling personal knowledge management (PKM) workflows that rely on [[wiki]]
syntaxes, "semantic trees" or "knowledge bonsais", and data visualizations that are viewable on screens or in augmented/virtual reality.
This project is about strategically implementing functionality that will benefit the most users and developers across the digital ecosystem. Thus, it abides by the Unix Philosophy: Everything is modularized and implemented in such a way as to maximize re-use whether it be for the browser, desktop, mobile, or headset. It's about furthering the state of PKM as a whole by building atop "standardization bedrock" instead of just creating a single application.
Further, these workflows may also facilitate the mapping of semantic space which could prove an invaluable resource in building a better understanding of how neural nets work and furthering the development of interpretable, explainable AI.
Only time will tell how far this path may go.
These are the workflows the WikiBonsai project enables for markdown-based collections of notes:
[[wikirefs]]
syntax for quick associative linking (a.k.a. "wikilink", "bidirectional link", "internal link", etc.).[[wikiref]]
support).These workflows are what distinguish the "WikiBonsai" from other styles of digital garden -- particularly the semantic tree.
The documentation in this repository describe the philosophies, mechanics, and terminologies that are adopted throughout all of the WikiBonsai projects:
The following links point to repositories of the WikiBonsai project and are organized by stack depth. Projects toward the top are ready-to-use and meant for the end user, while projects toward the bottom are meant for developers to build with and integrate into other solutions:
:colon::attributes
.[[wikirefs]]
.:colon::attributes
.[[wikirefs]]
.[[wikirefs]]
.:colon::attributes
).[[wikirefs]]
.:colon::attributes
) specification.[[wikirefs]]
specification.The systems you interact with have an effect on the way you think. This system is meant to provide a "jungle gym for the thought," but it can't do everything and might even have negative consequences if used improperly. Here are some supplemental suggestions for adopting a framework such as this, especially for educational purposes:
The workflows this project enables are meant to help develop an explicit relationship with the words you use. It's possible over-reliance on a tool like this (like many other digital productivity tools) can allow, or even facilitate, overly modular and fractured trains of thought. Writing full essays can combat fractured thinking and exercise those parts of the mind.
By adopting a tool specifically meant for mapping vocabulary, it can be tempting to use niche words or make up one's own to demarcate an idea. But too much of this risks building a Tower of Babel and losing the ability to communicate effectively with others. Use shared vocabulary where you can and if you've found a word of better fit, use it with others. That is the purpose of language after all.
Like this project it is best to view a set of notes and explicit knowledge as a current state of affairs -- it's the state of the trail; of how much clutter has been cleared away. The goal is to build a navigable path for yourself, but to remain aware of what other things lie beyond the already-explored path. Always be open to what hard reality is telling you, especially while getting your hands dirty.
The digital world cannot replace practical, hands-in-the-mud experience. No matter what you learn or study be sure to learn something, anything, that requires your hands in the real world.
As with pretty much all human endeavors, this project does not represent any kind of "final word" or "best solution" but a "clearing of brush" or "cutting away the chaffe"...Of making the road ahead a touch less bumpy and a bit more wonder-full for those that follow.
[^ai]: π€ AI Collaboration: To date, code and prose of the WikiBonsai project was not written by AI, but was occasionally consulted to improve overall quality. This may or may not change going forward. [^mind]: Not too dissimilar from a "bicycle for the mind". [^mixed-metaphors]: Please excuse the mixed metaphor soup.
πΊπΈ Made in the USA π¦ π