OpenUrban is a non-profit user generated web map and wiki focused on proposed and current urban development around the world. Its purpose is to help people understand how their cities and communities are changing and support their active participation in that change.
Development Setup
-
Download the latest version of Vagrant.
-
Clone this repository into a nice, cozy place on your computer.
-
Copy the configuration file and fill it out with your favorite editor.
$ cp sample.env .env -
Run the command
vagrant upinside the repository you just cloned. -
Log in to your local OpenUrban server.
$ vagrant ssh -
Load the development database to get a starter set of information.
$ mysql --user=openurban --password=testing < /var/www/openurban/development_db.sql -
Browse to
http://localhost:8080in your favorite browser and see your very own version of OpenUrban!
Requirements
OpenUrban is built on MediaWiki (1.19.2), Semantic Mediawiki and related Semantic Mediawiki extensions. The site uses a LAMP stack, currently:
- PHP 5.3.10-1ubuntu3.6 (apache2handler)
- MySQL 5.5.29-0ubuntu0.12.04.2
Contributing
Any code developed for OpenUrban will be integrated back into the Semantic Mediawiki code base.
You can contribute code in two ways:
- Making pull requests for the code that resides on Github. This includes the skin and various Semantic Mediawiki extensions.
- At the wiki markup level, which is where much of the front end design and development occurs.
If you would like to contribute to this part of the project you can either:- request administrative priviledges on the wiki by sending an email to reed [at] openurban [dot] com (recommended)
- create a local version of OpenUrban and submit code revisions via Github's issue tracker
Contact
If you want to give us a heads up about some part of the code use Github Issues.
You can also tweet at us:
- CJ Bryan (Dev/Back-end) https://twitter.com/waltz
- Reed Duecy-Gibbs (Design/Front-end) https://twitter.com/rduecyg
License
Open source under the GPL license version 2.