add/ref: update documentation.

This commit is contained in:
manunamz
2023-10-06 11:17:23 -04:00
parent 78c303a597
commit 64cbf45f73
18 changed files with 525 additions and 58 deletions
+12
View File
@@ -0,0 +1,12 @@
---
title: Astro-WikiBonsai
date: '2023-10-04'
---
Welcome to Astro-WikiBonsai.
It's a [[digital-garden]], whose defining feature are [[wikirefs]] (aka "bidirectional link"). These are links using the `[[double-square-bracket]]` syntax that link to files or pages within a collection of markdown files. They can be used in any and all markdown files across the site, though unique filenames are required.
[[wikibonsai]] style gardens in particular add a [[semantic-tree]], which is viewable as a sort of #tag tree called the [map-page](/map). It is built from [[index-type|index files]] whose content defines its structure using markdown lists and `[[wikirefs]]`. The files linked in the semantic tree are primarily [[entry-type|entries]] which act as concept summaries, much like a Wikipedia page. Each entry also displays back references, such as which posts link to those entries.
These syntaxes and workflows aim to make large amounts of content more easily navigable without the need for algorithms and opaque search mechanisms (though those are also generally readily accessible).