Cal Raijin Taiko Website
Fork this repository on the GitHub website, then clone your repository onto your computer:
$ git clone email@example.com:[Your Github Account]/caltaiko.git
Go into the caltaiko repository
$ cd caltaiko
Run the setup script and follow the prompts to install all required dependencies.
This will also create the development database and seed it with random resources, including an admin account with username admin and password secret.
If any problems arise, please visit the wiki to see if your problem is addressed.
Integrate with AWS
Go to aws.amazon.com and create an Amazon AWS account.
Go to your management console and change the region to US West (N. California)
Go to the S3 Management Console and create a new bucket.
Go to the IAM ManagementConsole and create a new IAM user.
When the success notification pops up, be sure to either download the security credentials or otherwise store them in a secure location.
Create the file config/aws_config.yml and fill it with the following:
access_key_id: AWS_ACCESS_KEY_ID secret_access_key: AWS_SECRET_KEY_ID s3_host_name: "s3-us-west-1.amazonaws.com" bucket: YOUR_BUCKET_NAME
Where AWS_ACCESS_KEY_ID is the IAM user Access Key ID, AWS_SECRET_KEY_ID is the IAM user Secret Access Key, and YOUR_BUCKET_NAME is the name of the bucket you created.
Before your next Git commit, run git status to make sure the aws_config file is not being included (it's listed in the gitignore so it shouldn't be, but make ABSOLUTELY SURE!!!). This is extremely important, since if those access keys wind up on GitHub, bad people can very easily use them to rack up a bill of several thousand dollars on your AWS account.
Enable emails to be sent through Gmail
Create the file /config/local_env.yml and fill it with the following:
GMAIL_USERNAME: "firstname.lastname@example.org" GMAIL_PASSWORD: "PASSWORD" GMAIL_DOMAIN: "example.com"
where email@example.com is a Gmail address that you have access to, and example.com is the domain. Most likely this will be gmail.com, unless you are using a Google Apps account.
To keep track of any changes made to the original repository, add remote named upstream
git remote add upstream https://github.com/calraijintaiko/caltaiko.git
To sync any changes I make with your own repository, run the commands
git fetch upstream git merge upstream/master
To generate the formatted Rdoc document, run the command
from the main directory. This will generate a directory caltaiko/doc/app/.
Open the file caltaiko/doc/app/index.html to view the documentation on each of the pages, classes, modules, and methods of the application.