From 39bd5394bf91411721bb5e06fdfc04aa20c63542 Mon Sep 17 00:00:00 2001 From: "Christopher R. Nelson" Date: Mon, 22 Jan 2024 21:19:37 -0500 Subject: doc: README.org->README.rst cgit and friends (as well as my poor slow-to-reprogram brain) like ReStructuredText better than they like org-mode files. Let's give it to them because the org-mode file was only used as hall auto-generated it. --- README.org | 57 --------------------------------------------------------- 1 file changed, 57 deletions(-) delete mode 100644 README.org (limited to 'README.org') diff --git a/README.org b/README.org deleted file mode 100644 index df50fa6..0000000 --- a/README.org +++ /dev/null @@ -1,57 +0,0 @@ -# -*- mode: org; coding: utf-8; -*- - -#+TITLE: README for Reading-Heap - -* Reading-Heap - -Reading-Heap: a service and clients for managing your media consumption order. - -* Description - -** What is Reading-Heap? - -It's a *heap* of things you want to *read*. Shocking, I know. But what does that mean? Simply, it means you add a priority when you put an item on the heap, and when you ask the heap what to read it will take your priorities into account (another name for a heap is a priority queue, after all). - -** What sets Reading-Heap apart? - -Reading-Heap is implemented as a service, so any zmq-enabled language can write a client for it. You can add an article from your phone via a web service, grab the details into your wayland clipboard from the command line, and maybe one day file it into your org-mode agenda buffer via a (upcoming) emacs client. - -* Installation - -** Dependencies - -- [[https://www.gnu.org/software/guile/][Guile 3.0]] (or later) -- [[https://gitlab.com/a-sassmannshausen/guile-config][guile-config]] -- [[https://github.com/aconchillo/guile-json][guile-json]] -- [[https://github.com/jerry40/guile-simple-zmq][Guile-Simple-ZMQ]] -- [[https://zeromq.org/][ZeroMQ]] - -** Build Dependencies - -- [[https://www.gnu.org/software/automake/][GNU AutoMake]] -- [[https://www.gnu.org/software/autoconf/][GNU AutoConf]] -- (optionally) [[https://gitlab.com/a-sassmannshausen/guile-hall][Guile Hall]] 0.4.1+ - -** Procedure - -The usual autotools make process applies here. - -#+BEGIN_SRC bash - ./autogen.sh - ./configure - make - sudo make install -#+END_SRC - -* Usage - -** Command-line client - -#+BEGIN_SRC bash - reading-heap-client new --priority -1 --title "Foundation Trilogy" --author "Issac Asimov" --location "SF Bookshelf" --unique_id "0739444050" - reading-heap-client next -#+END_SRC - -** TODO Web client - -Details Forthcoming -- cgit v1.2.3