Code repository
Main Page > Resources > Resources/Code repository
On this page you'll find information on AtoM's code repository - where to find the code, and useful suggestions for how to take advantage of it for development.
Seealso
If you're doing development work with AtoM, please consider contributing code back to the public project! More information:
Contents
AtoM and Git
The AtoM project source code is managed with version control software called Git and is publicly hosted by the popular GitHub git repository hosting service. It enables users and developers to keep updated when changes are made to the code while managing any conflicts with local changes made to the code. Git also allows users to retrieve the code as it existed at any time in the past. Git is an open source project.
A lot of community documentation exists for Git. The Pro Git book is written by Scott Chacon, the CIO of GitHub, a popular site which provides free Git hosting for open source projects and provides web-based code browsing and issue tracking. Git Pro is published by Apress. You can buy a copy or read it for free on the web.
See Git's official documentation and their list of external resources for more information on how to use Git.
Git clients
If you are using a Linux or Unix system, a Git command line tool might already be available on your system. The Git command line tool offers built-in documentation. It is great for quickly reminding yourself of the command line syntax. Use this command to see a list of help topics:
$ git help
To read the help topic explaining Git's "clone" command, for example, enter the following;
$ git help clone
A list of other Git clients is available here.
Browse our code on GitHub
The public code repository for AtoM is hosted at Github.
- Code repository web interface: https://github.com/artefactual/atom
- List of changes committed to the repository: https://github.com/artefactual/atom/commits/
Checkout
Our installation instructions always include, in the "Download AtoM" section, the option to check the code out from our repository, or download a tarball. Please be sure to check the relevant section in our docs, depending on which version of AtoM you are installing. We version all our documentation per major release - you can find an index of the versions available here:
We put the detailed installation instructions, including the instructions on downloading or checking out AtoM, in the "Linux" page of the Installation section of our Administrator's manual.
For example, here is a link to the 2.1 "Download AtoM" section:
Update via git
Use this command to update a previously checked out working copy:
$ git pull
If you have already begun working with the AtoM code, you may want to rebase.
Create patches
See the Contribute code page for details on how to fix bugs and contribute patches.