branch: externals/org-gnosis
commit 89c769c3eead8cc74ca338eddfbfb9e50cc4c01c
Author: Thanos Apollo <[email protected]>
Commit: Thanos Apollo <[email protected]>
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 154f54b181..5cc3580198 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: <https://thanosapollo.org/projects/org-gnosis/>
- 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 7a36265dbf..9746d77f32 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{[email protected]}
@@ -32,16 +32,19 @@ The documentation furnished herein corresponds to stable
version
+ Name: Org Gnosis | Organization Of Gnosis (knowledge/information)
+ Homepage: <https://thanosapollo.org/projects/org-gnosis/>
-
-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 6085a1014b..8e12dbea66 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 86b2590da5..fb09c45c62 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 <[email protected]>
-;; 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:
