Getting started with the OpenHatch code (moved): Difference between revisions
Content added Content deleted
No edit summary |
imported>Brittag (updating link) |
||
(61 intermediate revisions by 22 users not shown) | |||
Line 1: | Line 1: | ||
{{Hacking OpenHatch}} |
|||
To get your own instance of OpenHatch running, follow these '''five steps''' and then get in touch with us. |
|||
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] |
|||
== 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 |
|||
It might take a while; it's kind of a big repository. (Like, a hundred megs.) |
|||
== Read the README == |
|||
The repository is called '''milestone-a''' so you have to "cd" into it: |
|||
$ cd milestone-a |
|||
There you'll find a README.mkd file. Give it a careful read. |
|||
$ less README.mkd |
|||
'''That''' is what we really keep up to date with the necessary things. |
|||
== 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. |
|||
== 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. |
|||
== Get in touch == |
|||
The fifth ''mandatory'' step (okay, not quite mandatory) is that you say hello to us. There's always someone on the #openhatch IRC channel in freenode. And you can join our Devel mailing list. |
|||
== 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