Kokua:Source Code

From Kokua Wiki
Jump to: navigation, search

There are several ways to get the Kokua Viewer source code.

Downloading from BitBucket with a web browser

Note: * The workflow for Kokua using mercurial and bitbucket in most cases does not use named branches.

If you just want to quickly get the latest Kokua source code, the simplest way is to download it from BitBucket with a web browser.

The official Kokua repository is available here:

To download the source code, click on the "Downloads" selection on the right side of the menu bar, then select the branches tab, then click "Download .zip" (or "Download .tar.gz", for advanced users).

That will download the source code from branch default which contains the stable source code. There are also other repositories available, which contain the Kokua source code at various stages of development:

  • experimental : in-progress source code repositories for the next experimental version. These are maintained by individual developers. There are personal repositories of Kokua team members and many contributors are also available on BitBucket. You can visit any of these repositories to download their source code in the same way as from the official repository:
  • release: finished source code for the most recently released version.
  • beta: finished source code for the most recent beta release, this will include approved code from individual developers and update merges of LL's viewer repositories.

Cloning the BitBucket repository

If you want to contribute to Kokua, or want easy access to the whole repository history, you should clone the Kokua repository (i.e. download a copy to your computer).


The hg clone URL for the official Kokua release repository is: https://bitbucket.org/kokua/kokua-release (or alternatively ssh://hg@bitbucket.org/kokua/kokua-release). If you are using a command line terminal, you can run the following command to clone the repository:

hg clone https://bitbucket.org/kokua/kokua-release

If you have signed up for BitBucket and "forked" a Kokua repository, you should clone your own fork instead (replace <username> with your bitbucket user name):

hg clone https://bitbucket.org/<username>/kokua-release

There are also several personal repositories of team members and contributors, which may contain commits that have not yet been merged into the official repository.