This is the template off which all projects for the GeoTag-X platform are based. To build and use it, you'll need to download it first

git clone https://github.com/spMohanty/geotagx_project_template.git
cd geotagx_project_template/

It is highly recommended, but not necessary, that you install the template's requirements in an isolated environment to prevent any possible conflicts with your system. If you do not wish to create an isolated environment, head on over to the Installing requirements chapter.

First off, you will need to install virtualenv on your system

sudo pip install virtualenv

Then create a virtual environment in a directory of your choice; make sure you remember it! For this example, we create one in the env directory.

virtualenv env/

Finally, activate your new virtual environment

source env/bin/activate

Upon successful execution, the environment's directory (encased in parentheses) should be appended to your prompt, e.g. (env)name@domain:~$.

To install the template requirements, run

pip install -r requirements.txt

If you are not installing the requirements in an isolated environment, you will need to run the previous command as a super-user

sudo pip install -r requirements.txt

To make sure the requirements have been correctly installed, run

python build.py

which should display the script's instruction manual.

PS. If you are using a virtual environment, you must activate it each time you you wish to run the build.py script.

With the template requirements installed, it should be pretty straightforward building your own GeoTag-X project, provided you have the required files in place.

In case you do not have a working project, a sample project is provided. It is included as a submodule so you will need to fetch it before it can be used

git submodule update --init

The sample sample directory should now contain the entire sample project. To build it, run

python build.py sample/

The build.py script should produce a template.html file, i.e. the project's task presenter, in the project's folder. You can now setup the project via PyBossa's web interface or command line interface.