jekyll-bonsai 0.0.3

data/README.md

@@ -0,0 +1,11 @@
+# Jekyll-Bonsai
+
+<img src="https://github.com/manunamz/jekyll-bonsai/blob/main/assets/img/bonsai-light.svg" width="300" height="300"/>
+
+⚠️ This Is An Experimental Template ⚠️
+
+Consider this an alpha. Expect things to change, for there to be bugs, and for the code to be pretty messy.
+
+⚠️ A Note on Scalability ⚠️
+
+In a word, it doesn't. Enough notes will cause the d3 graph to become very, very slow.

data/_config.yml

@@ -0,0 +1,155 @@
+# jekyll configs
+
+title: jekyll-bonsai
+description: A modern jekyll theme for semantically inclined digital gardeners.
+author: manunamz
+baseurl: '/jekyll-bonsai'
+# baseurl: ''
+# url: https://manunam.me
+# url: 'https://manunamz.github.io'
+
+# logo-light: "/assets/images/logo-light.png"
+# logo-dark: "/assets/images/logo-dark.png"
+
+permalink: pretty
+include: 
+  - "_pages"
+exclude: 
+  - "node_modules/"
+  - "package.json"
+  - "package-lock.json"
+  - "*.gemspec"
+  - "*.gem"
+  - "Gemfile"
+  - "Gemfile.lock"
+  - "script/"
+  - "lib/"
+  - "bin/"
+  - "Rakefile"
+  - "README.md"
+  - "CHANGELOG.txt"
+  - "LICENSE.txt"
+
+collections:
+  entries:
+    output: true
+    # permalink: /entry/:id
+    # permalinks are manually generated -- see local 'prep_note' plugin.
+  states:
+    output: true
+    permalink: /stat/:title
+    order:
+      - tags.md
+      - sprout.md
+      - bud.md
+      - bamboo.md
+      - bloom.md
+      - berry.md
+      - fruit.md
+      - melon.md
+      - seed.md
+      - tea.md
+      - pot-bamboo.md
+
+defaults:
+  - scope:
+      path: "_entries/**/*.md"
+      type: "entries"
+    values:
+      layout: "entry"
+  - scope:
+      path: "_states/**/*.md"
+      type: "states"
+    values:
+      layout: "state"
+
+sass:
+  sass_dir:          _sass
+  style:            :compressed
+
+enable_mathjax: true
+kramdown:
+  math_engine: mathjax
+
+# plugins:
+#   - jekyll-namespaces
+#   - jekyll-wikilinks
+#   - jekyll-feed
+#   - jekyll-seo-tag
+#   - jekyll-sitemap
+
+# 
+# jekyll-bonsai configs
+# 
+# dendron forces the root note-title to be 'root.md' -- this is the replacement title for 'root'
+# (make sure you change the title in root.md file as well)
+index_title: "Jekyll-Bonsai"
+# graph: default graph type in side bar.
+## may be 'tree' or 'net-web'
+graph_type: "tree"
+# nav: default nav type in side bar.
+## may be 'tabs' (visited/path) or graph (bonsai)
+nav_type: "graph"
+# recent (weather): set number of notes to display on recent (weather) page.
+## may be an integer (defaults to 10)
+recent_num: 10 
+# local note-nav component defaults
+## may be 'open' or 'closed'
+entry_head_status: "open"
+entry_foot_links_status: "open"
+entry_foot_posts_status: "open"
+social:
+  enabled: true
+  connect:
+    # facebook_url:
+    github_url: https://github.com/manunamz/
+    # linkedin_url:
+    # pinterest_url:
+    rss_url: https://manunam.me/feed.xml
+    twitter_url: https://twitter.com/manunamz/
+  share:
+    - 'email'
+    # - 'facebook'
+    # - 'linkedin'
+    # - 'pinterest'
+    - 'twitter'
+
+compress_html:
+  clippings: all
+  comments: all
+  endings: all
+  startings: []
+  blank_lines: false
+  profile: false 
+
+# Google Analytics (ip is anonymized by default)
+ga_tracking: UA-190413040-3
+
+# 
+# plugins
+# 
+namespaces:
+  # enabled: true
+  include:
+    - "entries"
+wikilinks:
+  # enabled: true
+  exclude:
+    - "pages"
+    - "states"
+d3_graph_data:
+  # enabled: true
+  # path: "/assets"
+  exclude:
+    - "pages"
+    - "posts"
+    - "states"
+
+# seo
+# tagline: ""
+# description: ""
+# twitter:
+#   card: summary
+#   username: manunamz
+# author:
+#   twitter: manunamz

data/_entries/digital-garden.bonsai.md

@@ -0,0 +1,36 @@
+---
+id: 77dfbf83f6
+title: Bonsai
+desc: ''
+updated: 1624991154120
+created: 1620493859775
+tags: "\U0001F38B"
+notable: true
+---
+
+Bonsai literally means "tray planting". It is the art of recreating a realistic picture of nature[>i] in miniaturized form. From the perspective of a site-[[people.creator]], they are seeding and pruning a `jekyll-bonsai` in a small [[features.site-nav.graph|tray-like]] space. The finer details are described well by the wikipedia article on bonsai:
+
+> Purposes of bonsai are primarily contemplation for the [[people.visitors|viewer]], and the pleasant exercise of effort and ingenuity for the [[people.creator|grower]]. By contrast with other plant cultivation practices, bonsai is not intended for production of food or for medicine[>data]. Instead, bonsai practice focuses on long-term cultivation and shaping of one or more small trees growing in a [[features.site-nav.graph|container]]."
+>
+> ...
+>
+> A bonsai is created beginning with a specimen of source material. This may be a cutting, seedling[>seed], or small tree[>pot-bamboo] of a species suitable for bonsai development.
+>
+> ...
+>
+> Bonsai uses cultivation techniques like pruning, root reduction, potting, defoliation, and grafting to produce small trees that mimic the shape and style of mature, full-size trees.
+>
+> ~[wikipedia > bonsai; 2021-05-08](https://en.wikipedia.org/wiki/Bonsai)
+
+The various steps of the process are still under experimentation and being discovered, but you can learn more by reading about about the [[digital-garden.plants|plant types]] that grow in this garden.
+
+And because of the wonders of technology, this bonsai can be displayed for [[people.visitors]]. From their perspective, the creation is experienced as a digital garden which they may traverse at their leisure.
+
+[>i]: read as: the internet.
+
+[>data]: read as: "data" or "engagement".
+
+[>seed]: 🌰
+
+[>pot-bamboo]: 🎍
+

data/_entries/digital-garden.field-logs.md

@@ -0,0 +1,10 @@
+---
+id: c99e15751d
+title: Field Logs
+desc: ''
+updated: 1622903231656
+created: 1622901113335
+tags: 🌿
+---
+
+📓 Field logs are personal observations and ruminations. They are blog [[features.notes.note-foot.posts]], which can be viewed on the [[features.pages.field-blogs]] page.

data/_entries/digital-garden.fork.md

@@ -0,0 +1,10 @@
+---
+id: 7be41b1b1f
+title: Fork
+desc: ''
+updated: 1622903869435
+created: 1620492740142
+tags: "\U0001F331"
+---
+🚏 The fork in the [[digital-garden.path]] is where [[people.visitors]] may decide where to go next: To either drill down deeper through the [[features.site-nav.graph.type.tree]]'s children or hop around the [[features.site-nav.graph.type.net-web]].
+

data/_entries/digital-garden.md

@@ -0,0 +1,17 @@
+---
+id: e002fd0f60
+title: Digital Garden
+desc: ''
+updated: 1626463960679
+created: 1620492305910
+tags: 🎋
+notable: true
+---
+
+The [digital gardens](https://github.com/MaggieAppleton/digital-gardeners) mentioned in [[root]] are about developing new ways of structuring knowledge and navigating digital spaces. Techniques found in the wild[>i] are typically a mix derived from [personal knowledge management](https://en.wikipedia.org/wiki/Personal_knowledge_management), [personal wikis](https://en.wikipedia.org/wiki/Personal_wiki), [zettelkasten](https://en.wikipedia.org/wiki/Zettelkasten), and [evergreen notes](https://notes.andymatuschak.org/z4SDCZQeRo4xFEQ8H4qrSqd68ucpgE6LU155C) among others.[>me]
+
+_[[digital-garden.bonsai|Bonsai]]_ is the culmination and curation of what I have learned and built.
+
+[>i]: read as: the internet.
+
+[>me]: Well, at least from what I've found...so far...😈

data/_entries/digital-garden.path.md

@@ -0,0 +1,11 @@
+---
+id: 8179d196d7
+title: Path
+desc: ''
+updated: 1622911875817
+created: 1620492802357
+tags: "\U0001F331"
+---
+
+🛤 The [[features.notes.note-head]] is the path from the site's root to the current note. It's a bit of landscape built from the [[features.site-nav.graph.type.tree]] that provides context for the current concept.
+

data/_entries/digital-garden.plants.md

@@ -0,0 +1,12 @@
+---
+id: 19f701acb2
+title: Plants
+desc: ''
+updated: 1626296774584
+created: 1620493511415
+tags: "\U0001F33F"
+---
+
+Plant types are defined with [[features.tags]]. You can click the 🔖 for more detailed information at the [[features.pages.status-tags]] page. 
+
+One thing to keep in mind is that the tagging for this site is more of a blend of the descriptions herein and the philosophical drivers of this site's design.

data/_entries/digital-garden.pollinate.md

@@ -0,0 +1,10 @@
+---
+id: 8269f156b2
+title: Pollinate
+desc: ''
+updated: 1623851074627
+created: 1622905274852
+tags: 🌱
+---
+
+🐝 Help [[digital-garden.plants]] grow in the garden by [[features.notes.note-body.share|sharing]] to stimulate cross-pollination...But no stinging, please. 

data/_entries/digital-garden.steps.md

@@ -0,0 +1,10 @@
+---
+id: 7fb84949c2
+title: Steps
+desc: ''
+updated: 1624990132504
+created: 1622906343832
+tags: 🌿
+---
+
+🥾 The steps [[people.visitors]] take in the garden form a trail which may be traversed to re-[[features.visited|visit]] what's been previously seen.

data/_entries/digital-garden.stream.md

@@ -0,0 +1,12 @@
+---
+id: 506bb3c66e
+title: Stream
+desc: ''
+updated: 1624739035593
+created: 1622901056839
+tags: 🌿
+---
+
+🌊 [[features.notes.note-foot.webmentions]] are represented as the stream: It's a flow of social interaction that, if one is not careful, can easily get swept up in. 
+
+> "To go down to the water, the chaotic water and source of all life, is to risk an encounter with the terrible thing that lurks in the depths."

data/_entries/digital-garden.sweep.md

@@ -0,0 +1,12 @@
+---
+id: aa265ceb2f
+title: Sweep
+desc: ''
+updated: 1623851670041
+created: 1622911160563
+tags: 🌱
+---
+
+🧹 Sweeping one's [[digital-garden.steps]] is the act of [[features.visited.delete-data|deleting]] data.
+
+While not equivalent in meaning, the notion is a hat-tip to the hiker/camper's notion of [Leave No Trace](https://en.wikipedia.org/wiki/Leave_No_Trace).

data/_entries/digital-garden.weather.md

@@ -0,0 +1,12 @@
+---
+id: 0315db1dcc
+title: Weather
+desc: ''
+updated: 1623851207617
+created: 1620492879316
+tags: 🌿
+---
+
+🌦 The [[features.pages.recent]] page gives [[people.visitors]] a sense of what [[features.notes]] have changed[>ha] recently. 
+
+[>ha]: Time to get used to change 👛, ya'll. 

data/_entries/features.md

@@ -0,0 +1,10 @@
+---
+id: 4605176572
+title: Features
+desc: ''
+updated: 1622910680489
+created: 1620408409799
+tags: 🎋
+---
+
+See child notes for available features.

data/_entries/features.notes.hover-preview.md

@@ -0,0 +1,10 @@
+---
+id: b31614e93b
+title: Hover Preview
+desc: ''
+updated: 1623851006039
+created: 1620408675890
+tags: "\U0001F331"
+---
+
+[[features.notes|Note]] previews popup when the cursor hovers over [[features.site-nav.graph.links.wikilinks]].

data/_entries/features.notes.md

@@ -0,0 +1,12 @@
+---
+id: 4fd03d1501
+title: Notes
+desc: ''
+updated: 1623851234604
+created: 1620411880535
+tags: "\U0001F38B"
+notable: true
+---
+The focus of this template are notes: Atomic concepts and ideas that are, ideally, meaningfully [[features.site-nav.graph.links|linked]]. 
+
+You can navigate notes via their various parts (see children notes) or the [[features.site-nav.graph]].

data/_entries/features.notes.note-body.md

@@ -0,0 +1,12 @@
+---
+id: 1646d01db5
+title: Note Body
+desc: ''
+updated: 1623851249517
+created: 1620505728158
+tags: "\U0001F33F"
+---
+The note body displays the note's title, [[digital-garden.plants|plant]] [[features.tags|tag]], and the time the note was last updated.
+
+Note content is rendered in markdown. Some extensions are listed in the children notes.
+

data/_entries/features.notes.note-body.share.md

@@ -0,0 +1,10 @@
+---
+id: d3c959da7e
+title: Share
+desc: ''
+updated: 1623851592682
+created: 1622846943488
+tags: 🌱
+---
+
+[[people.visitors]] may share [[features.notes]] and [[features.pages.field-blogs]] via the share buttons in the note body.

data/_entries/features.notes.note-body.sidenotes.md

@@ -0,0 +1,52 @@
+---
+id: 95a80b4157
+title: Sidenotes
+desc: ''
+updated: 1623870486255
+created: 1620408418339
+tags: "\U0001F331"
+---
+Special syntax for sidenotes is supported. Their syntax is reminiscent of traditional markdown footnotes. In markdown files, they look like this (without spaces around the left/right carrots):
+
+```
+This is what a left-sidenote[ < left] and a right-sidenote[ > right] look like.
+
+[ < left]: the syntax looks similar to...
+[ > right]: ...regular markdown footnotes.
+```
+
+Which, once rendered, looks like:
+
+* * *
+
+This is what a right-sidenote[<left] and a left-sidenote[>right] look like.
+
+* * *
+
+On medium to small sized screens, you can click on sidenote superscripts to show or hide their content.
+
+## Notable Quirks
+
+- Sidenotes increment together, but separately from footnotes[^foot]. So, for example, it's possible for there to be a '1' for both a standard markdown footnote and a sidenote.
+- Sidenotes require an "\\n" after each definition to parse properly. A warning will display if there are missing newlines (regardless of sidenotes).
+
+## Influences
+
+- [tufte css](https://github.com/edwardtufte/tufte-css), for clean'n'simple sidenote css implementation.
+- [simply jekyll](https://github.com/raghuveerdotnet/simply-jekyll), how to implement tufte css in jekyll.
+- [gwern.net](https://github.com/gwern/gwern.net), for sidenote implementation comparisons.
+
+## Proposal
+
+Would Kramdown be interested in integrating this functionality?
+
+[<left]: the syntax looks similar to...[^left-quirk]
+
+[>right]: ...regular markdown footnotes.
+
+[^foot]: A regular markdown footnote.
+
+[^left-quirk]: Left sidenotes are functional for completeness sake, but this theme is not optimized for them as their placement above the [[features.site-nav.graph]] is rather awkward.
+
+[^num]: Footnotes, however, increment separately and the superscripts are clickable on all sized screens, unlike sidenote superscripts, which are only clickable on medium and small sized screens.
+