From 79173399be37d69ab35afa79c4345d81591a8916 Mon Sep 17 00:00:00 2001 From: Lars Wirzenius Date: Sat, 13 Jun 2020 08:13:20 +0300 Subject: doc: write introduction to a jt subplot --- jt.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/jt.md b/jt.md index 58e591c..c765d03 100644 --- a/jt.md +++ b/jt.md @@ -1,3 +1,36 @@ +# Introduction + +The **jt** software (short for "journalling tool") is a helper for +maintaining a journal or personal knowledge base. It has been written +for the personal use of its authors, but might be useful for others. + +The guiding principle for jt is that having longevity for one's data +and complete control over it are crucial. Because of these, the +approach taken by jt is to build a static web site from source files +stored in a version control system. The files will be edited with a +text editor chosen by the journal writer, rather than via a custom +web, desktop, or mobile application. The built journal is then served +with some suitable web server. + +The role of jt is to make it easier to create new journal entries (new +Markdown files), and to make all the common tasks of maintaining a +knowledge base have minimal friction. + +## Example + +The following example creates a new journal, which will be the default +journal for the user, and a new journal entry. The entry is a draft +until it's finished. + +~~~sh +$ jt create ~/Journal default "My private journal" +$ jt new --tag meta --tag journalling "My first journal entry" +... # text editor is opened so the new entry can be written +$ jt finish +~~~ + + + --- title: "jt—a journalling tool" author: -- cgit v1.2.1