Initial commit

.gitignore

@@ -0,0 +1,4 @@
+.DS_Store
+.obsidian/publish.json
+.obsidian/workspace*.json
+00 Planner

.obsidian/app.json

@@ -0,0 +1,7 @@
+{
+  "newFileLocation": "folder",
+  "newFileFolderPath": "10 Notes",
+  "attachmentFolderPath": "90 Extras/92 Assets",
+  "alwaysUpdateLinks": true,
+  "readableLineLength": true
+}

.obsidian/appearance.json

@@ -0,0 +1,3 @@
+{
+  "baseFontSize": 16
+}

.obsidian/backlink.json

@@ -0,0 +1,3 @@
+{
+  "backlinkInDocument": true
+}

.obsidian/command-palette.json

@@ -0,0 +1,6 @@
+{
+  "pinned": [
+    "insert-template",
+    "workspace:toggle-pin"
+  ]
+}

.obsidian/community-plugins.json

@@ -0,0 +1,6 @@
+[
+  "obsidian42-brat",
+  "query-control",
+  "calendar",
+  "nldates-obsidian"
+]

.obsidian/core-plugins-migration.json

@@ -0,0 +1,30 @@
+{
+  "file-explorer": true,
+  "global-search": true,
+  "switcher": true,
+  "graph": true,
+  "backlink": true,
+  "canvas": false,
+  "outgoing-link": true,
+  "tag-pane": true,
+  "properties": true,
+  "page-preview": true,
+  "daily-notes": true,
+  "templates": true,
+  "note-composer": true,
+  "command-palette": true,
+  "slash-command": true,
+  "editor-status": true,
+  "bookmarks": true,
+  "markdown-importer": false,
+  "zk-prefixer": false,
+  "random-note": false,
+  "outline": true,
+  "word-count": true,
+  "slides": false,
+  "audio-recorder": false,
+  "workspaces": false,
+  "file-recovery": true,
+  "publish": false,
+  "sync": false
+}

.obsidian/core-plugins.json

@@ -0,0 +1,31 @@
+{
+  "file-explorer": true,
+  "global-search": true,
+  "switcher": true,
+  "graph": true,
+  "backlink": true,
+  "canvas": true,
+  "outgoing-link": true,
+  "tag-pane": true,
+  "properties": true,
+  "page-preview": true,
+  "daily-notes": true,
+  "templates": true,
+  "note-composer": true,
+  "command-palette": true,
+  "slash-command": false,
+  "editor-status": true,
+  "bookmarks": true,
+  "markdown-importer": false,
+  "zk-prefixer": false,
+  "random-note": false,
+  "outline": true,
+  "word-count": true,
+  "slides": false,
+  "audio-recorder": false,
+  "workspaces": false,
+  "file-recovery": true,
+  "publish": false,
+  "sync": true,
+  "webviewer": false
+}

.obsidian/daily-notes.json

@@ -0,0 +1,5 @@
+{
+  "format": "YYYY-MM-DD, ddd",
+  "folder": "00 Planner/01 Days",
+  "autorun": false
+}

.obsidian/graph.json

@@ -0,0 +1,22 @@
+{
+  "collapse-filter": true,
+  "search": "",
+  "showTags": false,
+  "showAttachments": false,
+  "hideUnresolved": false,
+  "showOrphans": true,
+  "collapse-color-groups": true,
+  "colorGroups": [],
+  "collapse-display": true,
+  "showArrow": false,
+  "textFadeMultiplier": 0,
+  "nodeSizeMultiplier": 1,
+  "lineSizeMultiplier": 1,
+  "collapse-forces": true,
+  "centerStrength": 0.518713248970312,
+  "repelStrength": 10,
+  "linkStrength": 1,
+  "linkDistance": 250,
+  "scale": 1,
+  "close": false
+}

.obsidian/hotkeys.json

@@ -0,0 +1,129 @@
+{
+  "app:go-back": [
+    {
+      "modifiers": [
+        "Mod",
+        "Alt"
+      ],
+      "key": "ArrowLeft"
+    },
+    {
+      "modifiers": [
+        "Mod"
+      ],
+      "key": "["
+    }
+  ],
+  "app:go-forward": [
+    {
+      "modifiers": [
+        "Mod",
+        "Alt"
+      ],
+      "key": "ArrowRight"
+    },
+    {
+      "modifiers": [
+        "Mod"
+      ],
+      "key": "]"
+    }
+  ],
+  "daily-notes": [
+    {
+      "modifiers": [
+        "Mod"
+      ],
+      "key": "D"
+    }
+  ],
+  "editor:delete-paragraph": [],
+  "daily-notes:goto-prev": [
+    {
+      "modifiers": [
+        "Alt",
+        "Mod"
+      ],
+      "key": "["
+    }
+  ],
+  "daily-notes:goto-next": [
+    {
+      "modifiers": [
+        "Alt",
+        "Mod"
+      ],
+      "key": "]"
+    }
+  ],
+  "editor:toggle-highlight": [
+    {
+      "modifiers": [
+        "Mod",
+        "Shift"
+      ],
+      "key": "H"
+    }
+  ],
+  "bookmarks:open": [
+    {
+      "modifiers": [
+        "Mod",
+        "Shift"
+      ],
+      "key": "B"
+    }
+  ],
+  "theme:use-dark": [
+    {
+      "modifiers": [
+        "Mod",
+        "Shift"
+      ],
+      "key": "-"
+    }
+  ],
+  "theme:use-light": [
+    {
+      "modifiers": [
+        "Mod",
+        "Shift"
+      ],
+      "key": "="
+    }
+  ],
+  "app:toggle-left-sidebar": [
+    {
+      "modifiers": [
+        "Ctrl"
+      ],
+      "key": "1"
+    }
+  ],
+  "app:toggle-right-sidebar": [
+    {
+      "modifiers": [
+        "Ctrl"
+      ],
+      "key": "2"
+    }
+  ],
+  "publish:view-changes": [
+    {
+      "modifiers": [
+        "Alt",
+        "Mod"
+      ],
+      "key": "P"
+    }
+  ],
+  "insert-template": [
+    {
+      "modifiers": [
+        "Alt",
+        "Ctrl"
+      ],
+      "key": "T"
+    }
+  ]
+}

.obsidian/plugins/calendar/data.json

@@ -0,0 +1,10 @@
+{
+  "shouldConfirmBeforeCreate": true,
+  "weekStart": "locale",
+  "wordsPerDot": 250,
+  "showWeeklyNote": true,
+  "weeklyNoteFormat": "gggg, [week] ww",
+  "weeklyNoteTemplate": "",
+  "weeklyNoteFolder": "00 Planner/02 Weeks",
+  "localeOverride": "system-default"
+}

.obsidian/plugins/calendar/manifest.json

@@ -0,0 +1,10 @@
+{
+  "id": "calendar",
+  "name": "Calendar",
+  "description": "Calendar view of your daily notes",
+  "version": "1.5.10",
+  "author": "Liam Cain",
+  "authorUrl": "https://github.com/liamcain/",
+  "isDesktopOnly": false,
+  "minAppVersion": "0.9.11"
+}

.obsidian/plugins/nldates-obsidian/data.json

@@ -0,0 +1,12 @@
+{
+  "autosuggestToggleLink": true,
+  "autocompleteTriggerPhrase": "@",
+  "isAutosuggestEnabled": true,
+  "format": "YYYY-MM-DD, ddd",
+  "timeFormat": "HH:mm",
+  "separator": " ",
+  "weekStart": "monday",
+  "modalToggleTime": false,
+  "modalToggleLink": false,
+  "modalMomentFormat": "YYYY-MM-DD HH:mm"
+}

.obsidian/plugins/nldates-obsidian/manifest.json

@@ -0,0 +1,10 @@
+{
+  "id": "nldates-obsidian",
+  "name": "Natural Language Dates",
+  "description": "Create date-links based on natural language",
+  "version": "0.6.2",
+  "author": "Argentina Ortega Sainz",
+  "authorUrl": "https://argentinaos.com/",
+  "isDesktopOnly": false,
+  "minAppVersion": "1.0.0"
+}

.obsidian/plugins/obsidian42-brat/data.json

@@ -0,0 +1,16 @@
+{
+  "pluginList": [
+    "reply2za/obsidian-query-control"
+  ],
+  "pluginSubListFrozenVersion": [],
+  "themesList": [],
+  "updateAtStartup": true,
+  "updateThemesAtStartup": true,
+  "enableAfterInstall": true,
+  "loggingEnabled": false,
+  "loggingPath": "BRAT-log",
+  "loggingVerboseEnabled": false,
+  "debuggingMode": false,
+  "notificationsEnabled": true,
+  "personalAccessToken": ""
+}

.obsidian/plugins/obsidian42-brat/manifest.json

@@ -0,0 +1,15 @@
+{
+	"id": "obsidian42-brat",
+	"name": "BRAT",
+	"version": "1.0.3",
+	"minAppVersion": "1.4.16",
+	"description": "Easily install a beta version of a plugin for testing.",
+	"author": "TfTHacker",
+	"authorUrl": "https://github.com/TfTHacker/obsidian42-brat",
+	"helpUrl": "https://tfthacker.com/BRAT",
+	"isDesktopOnly": false,
+	"fundingUrl": {
+		"Buy Me a Coffee": "https://bit.ly/o42-kofi",
+		"Visit my site": "https://tfthacker.com"
+	}
+}

.obsidian/plugins/obsidian42-brat/styles.css

@@ -0,0 +1,3 @@
+.brat-modal .modal-button-container {
+  margin-top: 5px !important;
+}

.obsidian/plugins/query-control/data.json

@@ -0,0 +1,8 @@
+{
+  "defaultCollapse": true,
+  "defaultShowContext": false,
+  "defaultHideTitle": true,
+  "defaultHideResults": false,
+  "defaultRenderMarkdown": true,
+  "defaultSortOrder": "0"
+}

.obsidian/plugins/query-control/manifest.json

@@ -0,0 +1 @@
+{"id":"query-control","name":"Query Control","version":"0.7.13","minAppVersion":"1.7.2","description":"An experimental Obsidian plugin that adds additional control to queries","author":"NothingIsLost & reply2za","authorUrl":"https://github.com/reply2za","isDesktopOnly":false}

.obsidian/plugins/query-control/styles.css

@@ -0,0 +1,68 @@
+.workspace-leaf-content[data-type="markdown"] .internal-query .nav-header {
+  margin-top: 0; /* works around issues with minimal theme */
+}
+
+.workspace-leaf-content[data-type="markdown"] .internal-query .nav-header .nav-buttons-container {
+  position: unset; /* works around issues with minimal theme */
+  justify-content: center; /* works around issues with minimal theme */
+}
+
+.workspace-leaf-content[data-type="markdown"] .internal-query .is-hidden {
+  display: none;
+}
+
+.search-results-children.is-rendered .search-result-file-match {
+  white-space: normal;
+}
+
+.search-results-children.is-rendered {
+  padding: 0;
+}
+
+.search-results-children.is-rendered .search-result-file-matches .markdown-preview-view {
+  padding: 0;
+}
+
+.search-results-children.is-rendered .search-result-file-matches .markdown-preview-section {
+  max-width: 100%;
+}
+
+.search-results-children.is-rendered .task-list-item-checkbox {
+  vertical-align: unset;
+}
+
+.search-results-children.is-rendered ul {
+  padding-inline-start: 40px;
+  margin-block-end: 0;
+  margin-block-start: 0;
+}
+
+.cm-preview-code-block.is-rendered .markdown-preview-view {
+  height: inherit;
+}
+
+.query-control-sort-tooltip {
+  position: absolute;
+  top: var(--tooltip-top);
+  left: var(--tooltip-left);
+  background: #333;
+  color: #fff;
+  border-radius: 4px;
+  padding: 5px;
+  z-index: 1000;
+}
+
+.query-control-sort-option {
+  padding: 5px;
+  cursor: pointer;
+}
+
+.query-control-sort-option:hover {
+  background: #555;
+}
+
+.query-control-sort-option-checkmark {
+  color: #fff;
+  margin-left: 10px;
+  font-size: 1em;
+}

.obsidian/templates.json

@@ -0,0 +1,4 @@
+{
+  "folder": "90 Extras/91 Templates",
+  "dateFormat": "YYYY-MM-DD, ddd"
+}

.obsidian/types.json

@@ -0,0 +1,14 @@
+{
+  "types": {
+    "aliases": "aliases",
+    "cssclasses": "multitext",
+    "tags": "tags",
+    "url": "multitext",
+    "author": "text",
+    "finished": "checkbox",
+    "finished-date": "text",
+    "related-to": "multitext",
+    "authors": "multitext",
+    "related": "multitext"
+  }
+}

10 Notes/Short Introduction to Obsidian.md

@@ -0,0 +1,32 @@
+Here a short intro to [Obsidian](https://obsidian.md) and *Personal Knowledge Management Systems*. 
+
+I currently, document some of the Codex/BitTorrent stuff in the vault you already can use to see how does it feel for you. The vault is available on GitHub: [https://github.com/codex-storage/bittorrent-codex-docs](https://github.com/codex-storage/bittorrent-codex-docs). You can just clone the rero, and open the cloned folder in Obsidian. That's it. This is you local copy - anything you do is only visible to you. GitHub is used for a more controlled syncing. Normally, when you work on your own content, you will put your vault on some shared network drive (end-to-end encrypted of course! :yum:  ), and then you can conveniently open it on any other device. Syncing is done by the network drive, Obsidian has nothing to do with it in this case. You content keeps the same structure (including folders) as you see it in your local (shared) folder - thus, everything is transparent and extremely portable. Myself, I have a paid subscription to Obsidian Sync service (not that I really need it, but I wanted to try it and to support the Obsidian team a bit). It costs me $96,00 per year:
+
+![[Pasted image 20250513024925.png]]
+
+Obsidian also provides publishing service, which I use for our Codex/BitTorrent documentation and which costs me around $10,- monthly: here you can see how it looks like: [https://publish.obsidian.md/bittorrent](https://publish.obsidian.md/bittorrent). You can also just as easily create an empty vault to play with the settings and plugin. The BitTorrent vault has some basic set of plugins included. For a more active collaborative vault, perhaps using Obsidian Sync and then try to [Collaborate on a shared vault](https://help.obsidian.md/sync/collaborate). It requires a paid subscription, but perhaps $96,- per user per year will not break the bank (limit is 20 users currently). Paid Sync service also includes versioning of the content.
+
+### Personal Knowledge Management Systems
+
+Now, maybe the most important part is that Obsidian (as well as Logseq, and mentioned above Roam Research) are called Personal Knowledge Management systems. Those system can be used for project documentation and any other inventory, but their true power is in knowledge management. Sounds like nothing, but it was and still is new for me.
+
+I spent years "reinventing" my documentation systems and only after I discovered Obsidian I started to learn more about how to effectively record information in a way, that it is findable when needed, and fulfills quite a different purpose than many people expect when they think about documenting: a knowledge management system should allow you to be more productive in ***creating new ideas*** based on what you have learned before. A good intro is to look into the concept of [zettelkasten](https://en.wikipedia.org/wiki/Zettelkasten). You will find a lot of good free and paid materials on how to use tools like Obsidian or Logseq effectively. Of course, Obsidian is also very good on creating a traditional documentation without taking full advantage of linking and indexing, and it is still very convenient to use it as such - not everything is suitable for zettelkasten, sometimes you just need to write longer manuals or tutorial or just keep your home inventory. Such more traditional documentation vaults often relay on folder structure, but soon after you start learning about knowledge management like zettelkasten, you will discover that folder are actually really bad idea. A proper knowledge management system relays on linking relevant content so that information is always preserved with some context and relation to other things. And this is where systems like Obsidian really excel, with the convenience of linking content and powerful graphs and search capabilities - if you embrace that, you will see why using folders is more an impediment than anything else in recording what you learn and what you need to find to built new great things. A knowledge management system is something quite personal I believe, but learning it will certainly help in how we record the knowledge about things we are working on. We can also have multiple vaults for some dedicated purposes.
+
+And again, we decided to give it a try, and if it does not work for us, we will review and adjust.
+
+To start, we have two options:
+
+1. Built on top of the Codex/BitTorrent vault (this vault),
+2. Start with a fresh new vault.
+
+We can have multiple vaults, but there should be one central vault which will always be ultimate place to go to find out the stuff. I feel this should be a knowledge management vault, but I would not be too dogmatic about using the folders - I do not use them for this purpose, but if you need one for something, the system will not break because of it - everything in the end is connected, and indexed, and in which folder things are (as you will see) is really secondary. If we need more vaults later, we can add them, but we should always refer to them from the main vault so that we have single source of true.
+
+The last remark from me would be that we should be careful not to bloat the system with too many invasive plugins, so that the content remains as clean and as portable as possible. The setup I created in the Codex/BitTorrent try to follow that principle.
+
+I think this is already long intro. Please play with Obsidian shortly. I do not feel like an expert here, but if you need to discuss something I will be happy to help.
+
+### Some other links
+
+Some of you were wondering if commenting/reviewing can be done in obsidian. I did not try anything yet myself. What I found is [https://github.com/Fevol/obsidian-criticmarkup](https://github.com/Fevol/obsidian-criticmarkup). I may give it a spin in the coming days.
+
+There is also a blog post from HackMD, which is related: [HackMD & Obsidian: The ultimate markdown workflow](https://hackmd.io/@hackmd-blog/hackmd-obsidian-workflow).

90 Extras/91 Templates/Book.md

@@ -0,0 +1,7 @@
+---
+tags:
+  - book
+authors: 
+link: 
+related-to:
+---

90 Extras/91 Templates/Tweet.md

@@ -0,0 +1,7 @@
+---
+tags:
+  - tweet
+author: 
+link: 
+related-to:
+---

LICENSE.md

@@ -0,0 +1,23 @@
+```
+MIT License
+
+Copyright (c) [2025] [Codex Team]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

README.md

@@ -0,0 +1,12 @@
+## Codex Documentation Vault
+
+This is our documentation. An [Obsidian](https://obsidian.md) vault containing
+all Codex-related docs.
+
+### Obsidian
+
+This repository is a complete [Obsidian](https://obsidian.md) vault. You can open it on your computer in the [Obsidian App](https://obsidian.md/download) and have a searchable Codex documentation vault under your full control. Comparing to bloated [Notion](https://www.notion.so), which is a great tool for procrastination rather than a tool for capturing knowledge, Obsidian let's you capture the knowledge quickly and with excellent overview of how different topic connect to each other. And in the end - all are just Markdown files.
+
+The vault includes the `.obsidian` folder, but does not include publishing settings, and workspace configuration as those are personal and change every time you open the vault. If you want to have the full control over your Obsidian look and full, your own [[Hot-Keys|hot-keys]], [[Installed plugins|plugins]], etc, your can delete `.obsidian` or replace it with your own.
+
+To learn more about Obsidian and *Knowledge Management Systems*, please also check [[Short Introduction to Obsidian]].