From 516263ea51350514571deafc70b14f9f19d760d8 Mon Sep 17 00:00:00 2001
From: "B. Stack" <bgstack15@gmail.com>
Date: Tue, 9 Jul 2024 15:11:26 -0400
Subject: initial commit

---
 README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..22a2b1e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+<!--
+.. File: README.md
+.. Author: bgstack15
+.. SPDX-License-Identifier: GPL-3.0-only
+.. Startdate: 2024-07-06-7 07:51
+.. Title: README for library_info project
+.. Project: library_info
+.. Purpose: Document the project
+.. History:
+.. Usage: Read it.
+.. Reference: See heading References
+.. Improve:
+.. Dependencies:
+-->
+
+# README for `library_info` project
+
+# Usage
+Because this does not need to be a complex flask web app, it is designed as a cli tool. Run it in cron no more often than once a day.
+
+    ./library_info_cli.py --output html > /var/www/html/library.html
+
+## Serving with DataTables
+To take advantage of [DataTables JS library](https://datatables.net/), you need to serve files in this directory layout:
+
+    .
+    * library.html
+    | -- DataTables
+         |-- datatables.min.css
+         `-- datatables.min.js
+
+# Design notes
+Columns for items checked out:
+* title
+* format
+* picture
+* barcode
+* due date
+* possible renewal date
+* how many times renewed already
+* when checked out
+
+plugin-based, so I can write a plugins/aspen.py with some standard format output.
+
+# Improvements
+I still need to implement these features.
+
+* add reservations for each library
-- 
cgit