Creating_dictionaries

Table of Contents CREATING A NEW CML DICTIONARY Create bitbucket repository Create hudson job Get the bitbucket repo to trigger hudson

CREATING A NEW CML DICTIONARY

Create bitbucket repository

The repository should contain a single .cml file in its root directory, containing the dictionary. The dictionary must either be the root element of the document, or be the child of a <cml></cml> that is the root of the document.

The root directory can contain non-cml files and subdirectories.

Create hudson job

In hudson click 'New Job' (in left-hand menu).

Enter job name (e.g. cml-dictionary-compchem-gaussian) - this should be prefixed **cml-dictionary-**. Select copy existing job, and enter 'cml-dictionary-compchem' Click 'Ok'

In the 'Source Code Management' section update the URLs to point at the new bitbucket repository (e.g. https://bitbucket.org/cml/dictionary-compchem-gaussian).

In the 'Build Triggers' section tick 'Trigger builds remotely' box, and enter an Authentication Token (e.g. W3y7N3Ha). (This may already be set, in which case you can just keep the existing value).

Click save.

Get the bitbucket repo to trigger hudson

Go back to the bitbucket repository and click 'Admin' on the top menu and then 'Services' in the LH menu.

Select 'POST' from the drop down menu and click 'Add Service'.

In the URL box enter the hudson trigger url in the format:

• • • • '

e.g.

And click 'Save Settings'

Now, when you push to bitbucket a hudson job should trigger immediately. This will validate the dictionary and upload it to the CML website. If validation fails then the job will fail and the dictionary won't get uploaded.

You can check the status of the jobs on the 'CML Dictionaries' page in hudson:

https://hudson.ch.cam.ac.uk/view/cml-dictionaries/