== Welcome!
Chameleon is a blogging platform optimized for customizability and
extensibility. It is built using Ruby on Rails, and is freely available under
the terms of the MIT License. This file will guide you through setting it up,
you can always find the latest version online at
http://chameleon.wikidot.com/doc:installation.



== Installation
To get started using Chameleon, you need to do two things: first you need to set
up your server, and then you need to install and run Chameleon.

So, first of all, you need a web server, which can be hosted at a web host or
installed by yourself. When choosing a web host, you need to make sure they
support Ruby and MySQL. If you're just testing Chameleon, you can install it
locally, and you'll have to download and install Ruby from
http://www.ruby-lang.org/en/downloads/, and MySQL from
http://dev.mysql.com/downloads/.

Next, copy the file config/database.example.yml to config/database.yml, and
update the "development" and "production" parts of it to match your database
settings (you can enter the same credentials in the two sections). So, this
becomes:

development:
  adapter: mysql            # Change this to the sort of database you'll be using, for example "mysql" or "postgresql".
  database: <database_name> # Change this to the name of the database Chameleon should use.
  username: <username>      # Your database username comes here.
  password: <password>      # Your database password comes here.
  host: localhost           # Change this to the host name where the database will run. Most of the time, this will be 
  "localhost".
[...]
production:                 # Copy the development section to here, to keep the same settings.
  adapter: mysql
  database: <database_name>
  username: <username>
  password: <password>
  host: localhost

Now, upload the complete directory to your server.


Next, we'll set up the database. To do this, you need access to the command
line. If your host supports SSH, you should normally have access to it, ask them
how to do this if you don't know. Once on the comman line, run these commands:
To load the database schema into the database, run:
  rake db:schema:load
Then, to set some default settings, a default user and a welcome post, run:
  rake db:fixtures:load


Finally, all you need to do is run the application. Again, you may need to
contact your host on how to do this. If you're running Chameleon locally, you
can run "ruby script/server" in the command line to start the server, and if you
then surf to http://0.0.0.0:3000 you'll see you Chameleon installation. By
surfing to http://0.0.0.0:3000/admin, you can log in with the default username
"admin" and password "admin", and you'll get to the admin center. From there on,
you'll find your way easily.



== Uninstalling
If you decide to uninstall Chameleon, because you don't need it anymore, it's
quite simple (simpler than installing it). Just remove all files you installed
(all in this directory), and remove the database of this project. Normally,
everything is gone now!



== More about Chameleon
You can find out more about Chameleon on its site, at
http://chameleon.wikidot.com. There is some documentation available online, in a
wiki, so you can contribute to the documentation yourself. Information about the
development is also available online, on that same site.
If you would have any more questions, you can always leave a question on the
forums, or mail me at JW00000@gmail.com.