diff options
| author | Christopher R. Nelson <christopher.nelson@languidnights.com> | 2024-01-22 21:19:37 -0500 |
|---|---|---|
| committer | Christopher R. Nelson <christopher.nelson@languidnights.com> | 2024-01-22 21:19:37 -0500 |
| commit | 39bd5394bf91411721bb5e06fdfc04aa20c63542 (patch) | |
| tree | 27fe64f8f61032ad348b23d495999404ddbe4fa2 /README.org | |
| parent | 490bd1f52fdc5ea7a1bc2a4a0e6d2f985a21feba (diff) | |
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.
Diffstat (limited to 'README.org')
| -rw-r--r-- | README.org | 57 |
1 files changed, 0 insertions, 57 deletions
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 |