From 2b47b301cbf234eabfcebd28f069e5d154441354 Mon Sep 17 00:00:00 2001
From: Marc Coquand <marc@mccd.space>
Date: Mon, 13 May 2024 13:22:47 -0500
Subject: test a org based readme

---
 README.org | 80 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 80 insertions(+)
 create mode 100644 README.org

(limited to 'README.org')

diff --git a/README.org b/README.org
new file mode 100644
index 0000000..14ae9cd
--- /dev/null
+++ b/README.org
@@ -0,0 +1,80 @@
+* Stitch - Note Composer
+
+Stitch is a minimal grep-based CLI tool for composing notes.  It is
+built around the idea of writing notes separately and then using tags
+to compose these notes together.
+
+Stitch does not have any opinion about which file format you use for
+file capturing, use org, markdown, whatever you want. You can
+customize the grep command.
+
+Stitch limits itself only to note composing. For capturing notes, you
+will have to set up your own system.
+
+** AIMS
+
+- Single binary
+- Minimal
+- Work with any file format
+
+** CREDIT
+
+Stitch is based and largely a stripped down copy of the note composing
+system of Howm for Emacs.
+
+** INSTALLATION
+
+Chmod +x the binary and put in PATH.
+
+Set the environment variables:
+
+STICH_DIRECTORY
+STICH_GREP_CMD (default "grep")
+STITCH_HEADLINE_PATTERN (default "^\* ")
+STITCH_TAG_PATTERN (default ":[a-z]:")
+
+** SPEED UP
+
+Stitch uses grep by default. As your notes grow, this will 
+become rather slow. To speed it up, you can replace it grep with ugrep.
+
+** DEVELOPMENT
+
+To set up the project, easiest way is to just install Nix, direnv and
+enable nix flakes. Then to compile:
+
+dune build
+
+And to run:
+
+dune exec -- stitch
+
+
+** RECIPES
+
+- Building a journaling system
+You can build a basic capture command using $EDITOR and date command:
+
+alias capture="JRNL=\"$STITCH_DIRECTORY/$(date +'%Y-%m-%d
+%H:%M').org\" echo '* :journal:' > $JRNL_FILE && $EDITOR $JRNL_FILE
+
+and then you can find your journal entries, automatically sorted by
+creation date with stitch and the journal tag:
+
+alias jrnl="stitch -t journal"
+* KNOWN ISSUES
+
+- Resizing the screen when editor is open causes panic
+
+
+* Author
+
+Marc Coquand, 2024
+
+* LICENSE
+
+BSD-3-Clause
+
+
+
+
-- 
cgit v1.2.3