Ruby Tarot Files

Ruby Tarot
http://rubytarot.org

Copyright 2011, KJ Coop <kj@kjcoop.com>
http://rubytarot.org

This file is part of Ruby Tarot.

Ruby Tarot is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

Ruby Tarot is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with Ruby Tarot.  If not, see <http://www.gnu.org/licenses/>.
--------------------------------------------

This package consists of Ruby scripts to select 3 tarot cards representing past,
present and future from the major arcana and generate a PDF with pictures and
their interpretations. It also includes an image for each card. The artwork is
public domain, the specific files included come from Wikipedia.

REQUIRES
Ruby
Ruby Gems
Ruby Gem Prawn

FIRST USE
Unpack the file you downloaded. In a terminal. navigate to the directory created
when you extracted the file. Make sure the file ruby_tarot is executable. If
you're not sure or don't know what that means, type the following:
    chmod +x ruby_tarot

To run the file, go to the directory where Ruby Tarot lives and type:
    ruby ruby_tarot

This will output 3 lines indicating what 3 cards it selected. For example:
    Card #0 is #10: The Wheel Of Fortune: chance or luck.
    Card #1 is #7: The Chariot: transition; moving from one place or another.
    Card #2 is #11: Death: a new beginning.

It will also create a PDF in the same directory. It will be titled something
like tarot_0123456789.pdf where the string of numbers represents the current
Unix timestamp.

SUBSEQUENT USES
Navigate to the folder where ruby_tarot was unpacked. Execute it by typing
the following command:
To run the file, go to the directory where Ruby Tarot lives and type:
    ruby ruby_tarot

DISCLAIMER
This is intented for entertainment purposes only.

SOURCES FOR CARD MEANINGS
None. I completely fabricated them because I was too lazy to do research then
paraphrase it. Perhaps future versions will actually include research.

KNOWN ISSUES
As it comes, Ruby Tarot can't be run from any other directory because
I don't have any kind of installer to put the libraries in the appropriate
directories.