Getting started with the OpenHatch code (moved): Difference between revisions

From OpenHatch wiki
Content added Content deleted
No edit summary
imported>Brittag
(updating link)
 
(65 intermediate revisions by 22 users not shown)
Line 1: Line 1:
{{Hacking OpenHatch}}
To get your own instance of OpenHatch running, follow these simple steps:


This page is now included in our project package, and is automatically generated by sphinx at openhatch.readthedocs.org: [http://openhatch.readthedocs.org/en/latest/getting_started/index.html Getting started with the OpenHatch code]
== 1. Clone our git repository ==

You will need to have the ''git'' version control system installed. Once you do, type this into a terminal:

$ git clone git://code.openhatch.org/milestone-a.git

== 2. Read the README ==

Once you change directory into the milestone-a directory:

$ cd milestone-a

and read the embedded README.mkd file.

$ less README.mkd

'''That''' is what we really keep up to date with the necessary things.

== 3. Run the tests ==

We have automated tests that help us know when we've broken functionality in the OpenHatch code. Running the tests is a good way to make sure your OpenHatch environment works properly! Try this:

$ ./bin/sqlite_mysite test missions

That runs the test suite for just the ''missions'' part of the code. It uses the sqlite-based test runner so it runs fast; the real website uses MySQL, not SQLite, but you'll discover that tests run about 10 times faster in the sqlite runner.

== 4. Play with your local install ==

Once you've gone through these steps, just visit your own OpenHatch instance on the web. You can start the server with:

$ ./bin/mysite runserver

and load up http://localhost:8000/ in your web browser.

== 5. Read more documentation ==

You can find more tips about hacking OpenHatch in other pages in the [[Category:Hacking_OpenHatch|Hacking OpenHatch category]] on this wiki.


[[Category:Hacking_OpenHatch]]

Latest revision as of 08:48, 18 February 2014

This is a page about improving or modifying OpenHatch.

We call that "Hacking OpenHatch," and there is a whole category of pages about that.


This page is now included in our project package, and is automatically generated by sphinx at openhatch.readthedocs.org: Getting started with the OpenHatch code