Contributing to the Tricia Development

There are two contribution scenarios:

1. contributing to the Tricia core, and
2. contributing a new plugin or layout style for a specific project (see Customizing the Tricia Web Design).

Contributions to the Tricia Core

Since we use Mercurial as a decentralized version control system, the best way to contribute code is to create a fork of the Tricia repository and then push the contributions to this fork. Follow these steps:

1. Create an account at https://bitbucket.org/account/signup/
2. Go to the Tricia repository at http://bitbucket.org/infoasset/tricia
3. Click on the "fork" link
4. Now you can push your changes to this repository and then tell us about your repository so that we can pull your changes to our main Tricia repository.

Creating a new Plugin or Style

If you want to modify the look and feel of your Tricia installation (see Customizing the Tricia Web Design) or want to create a new plugin (see here), your modifications will not be part of the Tricia core repository. In order to deploy your changes to a productive Tricia installation, you have to publish your modifications to a separate repository at bitbucket.org.

This repository then has to be registered in your productive Tricia installation by calling the following Installer command:

java -jar installer.jar install $release()$ -repos=http://bitbucket.org/USER_NAME/REPOSITORY_NAME

As you can see, the branches in your repository have to be synchronized with the branches on the Tricia core repository.