About Tropaion

Tropaion is a web-based sport results service developed with current technologies and best practices in mind. It focuses on usability, web standards and social features. On top of that it advocates data reuse by making all data available in the semantic web. The sports data is annotated within the HTML code of the websites with RDFa, using the Sports-Ontology to describe the tournament structure, participating teams & athletes, the sports results, and their relationships.

Name meaning

What do all sports and tournaments have in common? They reward athletes with a trophy (e.g. medal or cup) for a specific achievement. The word tropaion is the Acient Greek origin of trophy. So I thought this word and a trophy symbol represent a sports results service best.

License

Tropaion is Open Source Software, and licensed under the GNU GPLv3 (see LICENSE.md). The software provides it's data under the terms of the Creative Commons Attribution 3.0 Unported License. So the service and the content conforms to the Open Definition provided by the Open Knowledge Foundation.

System Requirements

Web Server (like Apache)
PHP 5.3.2 or higher
MySQL 5 or higher

Feedback

Bug reports and feature request can be made under https://github.com/Tobion/Tropaion/issues.

Contributing

Want to contribute to the development of Tropaion? Great! This is what makes open source unique.

Basics

Tropaion is written in PHP and based on the Symfony2 framework. You can read the documentation to understand its fundamentals. Tropaion uses Git as distributed revision control system and it's development page is hosted at GitHub under https://github.com/Tobion/Tropaion.

Configure your development environment

Set up Git
Fork this project (see example how to do it)
Install a local web server with PHP and MySQL; I recommend XAMPP

Configure Apache host by adding the following lines to the file /xampp/apache/conf/httpd.conf (replace PATH-TO with your path to the project folder); (re)start Apache and MySQL

 Alias /tropaion "PATH-TO/Tropaion/web/"
 <Directory "PATH-TO/Tropaion/web/">
 		Options Indexes FollowSymLinks Includes ExecCGI
 		AllowOverride All
 		Order allow,deny
 		Allow from all
 </Directory>

Using the Git-Bash, execute the following command inside the Tropaion folder to install third-party dependencies and to publish the bundle's assets
```
 ./bin/vendors install
 ./app/console assets:install --symlink
```
Open your browser at http://localhost/tropaion/config.php to check the system requirements and configure your database connection
Access the starting page of Tropaion at http://localhost/tropaion/app_dev.php
Edit the code with whatever text editor or IDE you prefer; I recommend NetBeans with Twig Plugin
Send pull requests to let me know about the changes you've made

TODO

describe database initialisation including stored procedures (add command for it)

Tobion / Tropaion