Skip to content

Commit

Permalink
Added README file.
Browse files Browse the repository at this point in the history
quotes is ready for release to Github at version 0.1!
  • Loading branch information
veddox committed Jun 27, 2015
1 parent 64f6cea commit 019aca0
Show file tree
Hide file tree
Showing 2 changed files with 73 additions and 4 deletions.
67 changes: 67 additions & 0 deletions README
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
QUOTES README
=============

quotes is a small utility for creating, organizing and accessing your own
personal collection of quotes.

Written in line with the Unix philosophy, it is small, scriptable and concentrates
on doing its one thing well. Implemented in Common Lisp, it comes with a simple,
text-based commandline interface.

Licensed under the terms of the MIT license.


INSTALLING

Currently the only supported Common Lisp implementation is clisp. If have not
installed this yet, you will most likely find it in your distribution's repository.
On Ubuntu and derivatives, you can get it by passing the following command:

sudo apt-get install clisp

Once clisp is installed, navigate to the directory containing quotes and start it
with:

./quotes.lisp

If you plan on using it regularly, you can do the following for easy access
(requires root, assumes you are in the quotes folder):

mkdir /usr/lib/quotes
cp quotes.lisp util.lisp parser.lisp backend.lisp /usr/lib/quotes
chmod 755 /usr/lib/quotes/*.lisp
ln -s /usr/lib/quotes/quotes.lisp /usr/bin/quotes

From now on, you can access quotes like any other command in terminal.


USING

For a summary of commandline options, type

quotes --help

Starting quotes without any parameters launches the interactive mode, which is
self-explanatory.

The default quote collection set up by quotes lives at ~/.quotes. This is a plain
text file with a very simple syntax that is easy to expand and edit by hand -
feel free!


TODO

Make the installation process file more user-friendly. Add support for other
Common Lisp implementations (especially SBCL). Fix bugs.

Long-term: write a GUI. This probably ought to be a standalone application in
its own right, which could communicate with quotes using sockets - that means
that quotes would need a server mode to be able to keep running in the background.


Suggestions, bug fixes or any other contributions are welcome via the Github
site https://github.com/veddox/quotes


Daniel Vedder
Last edited 28/06/2015
10 changes: 6 additions & 4 deletions quotes.lisp
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
#!/usr/bin/clisp
;;;
;;; quotes is a small Unix utility for creating, organizing
;;; and accessing your own collection of quotes and citations.
Expand All @@ -10,7 +11,7 @@
;;; date: 25/06/2015
;;;

(defconstant VERSION '(0 0 3))
(defconstant VERSION '(0 1 0))

(load "util.lisp")
(load "backend.lisp")
Expand Down Expand Up @@ -58,9 +59,10 @@ Commandline options:
(main-menu)))
(let ((collection (cmd-parameter "--collection"))
(command (cmd-parameter "--command")))
(if collection (parse-quotefile collection)
(parse-quotefile *default-collection*))
(when command (interpret-command command))))
(when collection (setf *default-collection* collection))
(when command
(parse-quotefile *default-collection*)
(interpret-command command))))


(defun user-browse-quote ()
Expand Down

0 comments on commit 019aca0

Please sign in to comment.