From 89c769c3eead8cc74ca338eddfbfb9e50cc4c01c Mon Sep 17 00:00:00 2001 From: Thanos Apollo Date: Sun, 22 Feb 2026 12:09:39 +0200 Subject: Update commentary and docs for new version. --- doc/org-gnosis.info | 47 +++++++++++++++++++++++++---------------------- doc/org-gnosis.org | 34 ++++++++++++++++++---------------- doc/org-gnosis.texi | 23 +++++++++++++---------- org-gnosis.el | 42 +++++++++++++++++++++++++----------------- 4 files changed, 81 insertions(+), 65 deletions(-) diff --git a/doc/org-gnosis.info b/doc/org-gnosis.info index 154f54b..5cc3580 100644 --- a/doc/org-gnosis.info +++ b/doc/org-gnosis.info @@ -16,7 +16,7 @@ Copyright (C) 2025 Free Software Foundation, Inc. INFO-DIR-SECTION Emacs misc features START-INFO-DIR-ENTRY -* Org Gnosis : (org-gnosis). Roam-like Knowledge Management System. +* Org Gnosis : (org-gnosis). Minimal note-taking system with linked notes. END-INFO-DIR-ENTRY  @@ -43,20 +43,23 @@ instructions, customization options, and recommendations for effectively using ‘org-gnosis’. The documentation furnished herein corresponds to stable version -0.0.4, released on 2025-02-13. +0.2.0, released on 2026-02-22. • Name: Org Gnosis | Organization Of Gnosis (knowledge/information) • Homepage: - Org Gnosis (GNU-sis) is an org-mode parsing tool that organizes notes -as atomic nodes in an SQLite database. Each heading with an ID is -treated as an atomic note (node), storing its metadata, such as title -and links, in a relational database to facilitate efficient linking and -navigation. + Org-gnosis provides a minimal note-taking system with linked notes. +It functions as an independent module, designed to integrate with Gnosis +(a self-testing system) but usable standalone. - This tool also offers special functionality for journal entries, -stored in a separate directory with support for customizable templates. -This can serve as an additional space for temporary notes. + The package implements Zettelkasten-style note-taking: notes have +unique IDs, link to other notes, and the system tracks backlinks. Notes +are stored as org files and indexed in an SQLite database. + + When used with Gnosis, notes can link to themata (question subjects), +connecting note-taking with self-testing. The system also provides +journaling functionality with customizable templates, either as separate +files or as headings in a single file. * Menu: @@ -422,18 +425,18 @@ completed only once, allowing you to contribute to GNU Emacs.  Tag Table: -Node: Top858 -Node: Installation & Configuration2909 -Node: Taking Notes With Org Gnosis5474 -Node: Organizing your notes6464 -Node: Importing Notes8348 -Node: Configuration8759 -Node: Completions8948 -Node: Diacritic Insensitive completions9224 -Node: Encryption11121 -Node: Contributing11787 -Node: Sources11970 -Node: Patches Require Copyright Assignment To The FSF12260 +Node: Top865 +Node: Installation & Configuration3069 +Node: Taking Notes With Org Gnosis5634 +Node: Organizing your notes6624 +Node: Importing Notes8508 +Node: Configuration8919 +Node: Completions9108 +Node: Diacritic Insensitive completions9384 +Node: Encryption11281 +Node: Contributing11947 +Node: Sources12130 +Node: Patches Require Copyright Assignment To The FSF12420  End Tag Table diff --git a/doc/org-gnosis.org b/doc/org-gnosis.org index 7a36265..9746d77 100644 --- a/doc/org-gnosis.org +++ b/doc/org-gnosis.org @@ -4,8 +4,8 @@ #+language: en #+options: ':t toc:nil author:t email:t num:t #+startup: content -#+macro: stable-version 0.0.4 -#+macro: release-date 2025-02-13 +#+macro: stable-version 0.2.0 +#+macro: release-date 2026-02-22 #+macro: file @@texinfo:@file{@@$1@@texinfo:}@@ #+macro: space @@texinfo:@: @@ #+macro: kbd @@texinfo:@kbd{@@$1@@texinfo:}@@ @@ -14,8 +14,8 @@ #+macro: kbd @@texinfo:@kbd{@@$1@@texinfo:}@@ #+texinfo_filename: org-gnosis.info #+texinfo_dir_category: Emacs misc features -#+texinfo_dir_title: Org Gnosis : (org-gnosis) -#+texinfo_dir_desc: Roam-like Knowledge Management System +#+texinfo_dir_title: Org Gnosis : (org-gnosis) +#+texinfo_dir_desc: Minimal note-taking system with linked notes #+texinfo_header: @set MAINTAINERSITE @uref{https://thanosapollo.org,maintainer webpage} #+texinfo_header: @set MAINTAINER Thanos Apollo #+texinfo_header: @set MAINTAINEREMAIL @email{public@thanosapollo.org} @@ -32,16 +32,19 @@ The documentation furnished herein corresponds to stable version + Name: Org Gnosis | Organization Of Gnosis (knowledge/information) + Homepage: - -Org Gnosis (GNU-sis) is an org-mode parsing tool that organizes notes -as atomic nodes in an SQLite database. Each heading with an ID is -treated as an atomic note (node), storing its metadata, such as title -and links, in a relational database to facilitate efficient linking -and navigation. -This tool also offers special functionality for journal entries, -stored in a separate directory with support for customizable -templates. This can serve as an additional space for temporary notes. +Org-gnosis provides a minimal note-taking system with linked notes. +It functions as an independent module, designed to integrate with +Gnosis (a self-testing system) but usable standalone. + +The package implements Zettelkasten-style note-taking: notes have +unique IDs, link to other notes, and the system tracks backlinks. +Notes are stored as org files and indexed in an SQLite database. + +When used with Gnosis, notes can link to themata (question subjects), +connecting note-taking with self-testing. The system also provides +journaling functionality with customizable templates, either as +separate files or as headings in a single file. * COPYING :PROPERTIES: @@ -62,11 +65,10 @@ included in the section entitled “GNU Free Documentation License.” modify this GNU manual.” #+end_quote - * Installation & Configuration + The ~org-gnosis~ package is available from the GNU ELPA archive, which is enabled by default. - + + Prior to querying an archive, make sure to update the index, with {{{kbd(M-x package-refresh-contents)}}}. @@ -283,7 +285,7 @@ Here’s the process: 2. Email the specified address with your request. 3. Await a legal agreement from the FSF. 4. Sign and return the document, which can be done via email. - + The entire process usually takes about a week and needs to be completed only once, allowing you to contribute to GNU Emacs. diff --git a/doc/org-gnosis.texi b/doc/org-gnosis.texi index 6085a10..8e12dbe 100644 --- a/doc/org-gnosis.texi +++ b/doc/org-gnosis.texi @@ -29,7 +29,7 @@ modify this GNU manual.” @dircategory Emacs misc features @direntry -* Org Gnosis : (org-gnosis). Roam-like Knowledge Management System. +* Org Gnosis : (org-gnosis). Minimal note-taking system with linked notes. @end direntry @finalout @@ -52,7 +52,7 @@ instructions, customization options, and recommendations for effectively using @code{org-gnosis}. The documentation furnished herein corresponds to stable version -0.0.4, released on 2025-02-13. +0.2.0, released on 2026-02-22. @itemize @item @@ -61,15 +61,18 @@ Name: Org Gnosis | Organization Of Gnosis (knowledge/information) Homepage: @uref{https://thanosapollo.org/projects/org-gnosis/} @end itemize -Org Gnosis (GNU-sis) is an org-mode parsing tool that organizes notes -as atomic nodes in an SQLite database. Each heading with an ID is -treated as an atomic note (node), storing its metadata, such as title -and links, in a relational database to facilitate efficient linking -and navigation. +Org-gnosis provides a minimal note-taking system with linked notes. +It functions as an independent module, designed to integrate with +Gnosis (a self-testing system) but usable standalone. -This tool also offers special functionality for journal entries, -stored in a separate directory with support for customizable -templates. This can serve as an additional space for temporary notes. +The package implements Zettelkasten-style note-taking: notes have +unique IDs, link to other notes, and the system tracks backlinks. +Notes are stored as org files and indexed in an SQLite database. + +When used with Gnosis, notes can link to themata (question subjects), +connecting note-taking with self-testing. The system also provides +journaling functionality with customizable templates, either as +separate files or as headings in a single file. @end ifnottex diff --git a/org-gnosis.el b/org-gnosis.el index 86b2590..fb09c45 100644 --- a/org-gnosis.el +++ b/org-gnosis.el @@ -1,9 +1,9 @@ -;;; org-gnosis.el --- Roam-like Knowledge Management System -*- lexical-binding: t; -*- +;;; org-gnosis.el --- Learning-focused note-taking for Gnosis -*- lexical-binding: t; -*- ;; Copyright (C) 2024-2026 Free Software Foundation, Inc. ;; Author: Thanos Apollo -;; Keywords: extensions +;; Keywords: outlines, extensions, org-mode ;; URL: https://thanosapollo.org/projects/org-gnosis/ ;; Version: 0.1.2 @@ -24,27 +24,35 @@ ;;; Commentary: -;; Org-gnosis is a Zettelkasten-style knowledge management system for -;; Emacs, part of the Gnosis ecosystem. It provides efficient -;; note-taking and journaling with SQLite-backed storage. Org Gnosis -;; notes can be linked to Gnosis themata for additional features. +;; Org-gnosis provides a minimal note-taking system with linked notes. +;; It functions as an independent module, designed to integrate with +;; Gnosis (a spaced repetition system) but usable standalone. +;; +;; The package implements Zettelkasten-style note-taking: notes have +;; unique IDs, link to other notes, and the system tracks backlinks. +;; Notes are stored as org files and indexed in an SQLite database. +;; +;; When used with Gnosis, notes can link to themata (question subjects), +;; connecting note-taking with spaced repetition. Without Gnosis, it +;; provides a lightweight system for linked notes and journaling. ;; ;; Features: -;; - Zettelkasten-style linked notes with unique IDs -;; - Daily journaling with customizable templates -;; - Tag-based organization and retrieval -;; - Backlinks tracking and navigation -;; - TODO integration for journal entries -;; - SQLite database for fast searching -;; - Support for hierarchical note structures -;; - Encrypted file support (.gpg) +;; - Unique IDs for each note +;; - Backlinks and forward link tracking +;; - Tag-based organization +;; - Daily journaling (single file or separate files per day) +;; - SQLite database for indexing +;; - Hierarchical note structures +;; - Optional .gpg encryption +;; - Optional integration with Gnosis themata ;; -;; Main Commands: +;; Main interactive commands: ;; - `org-gnosis-find': Find or create a note ;; - `org-gnosis-insert': Insert a link to a note -;; - `org-gnosis-journal': Create/visit today's journal entry +;; - `org-gnosis-journal': Open today's journal entry ;; - `org-gnosis-find-by-tag': Find notes by tag -;; - `org-gnosis-visit-backlinks': See all notes linking to current note +;; - `org-gnosis-visit-backlinks': Visit notes linking to current note +;; - `org-gnosis-db-sync': Sync database with files ;; ;;; Code: -- cgit v1.0