2.2. GeoGig setup¶
Before we can use GeoGig, we will need to configure the tool. Specifically we will want to enter information about the user that will be doing the commit. The information we enter here will be contained in all commits performed by this user, associating changes with its author.
User information can be set globally, for all repositories managed by GeoGig, or on a per-repository basis. We will set this information globally.
In a terminal, enter the following two commands, substituting your own information for what is in quotes:
geogig config --global user.name "Author"
geogig config --global user.email "email@example.com"
If you encounter any errors with the geogig command line interface, please see the Troubleshooting section.
2.3. Create a GeoGig repository¶
On the command line, navigate to the geogig directory.
Create a new directory and call it repo. This directory will house the GeoGig repo.
As mentioned before, no spatial data needs to be contained in this directory. In fact, no files at all need to be in this directory, except for the .geogig subdirectory.
Switch to this directory.
Create a new GeoGig repository in this directory:
View a directory listing that shows all files and verify that the .geogig directory has been created.
2.4. More about the geogig command¶
All working commands with GeoGig are in the following form:
geogig [command] [options]
These commands must be run from in the directory where the repository was created.
To see a full list of commands, type:
To see a list of the parameters associated with a given command, type help followed by the command. For example, to see the parameters associated with the show command, type:
geogig help show
Displays information about a commit, feature or feature type Usage: show [options] <reference> Options: --raw Produce machine-readable output Default: false
Your copy of GeoGig may include a command geogig-console which opens a dedicated GeoGig shell, allowing you to run GeoGig commands without typing geogig first.
(geogig):/home/boundless/repo $ init Initialized empty Geogig repository in /home/boundless/repo/.geogig (geogig):/home/boundless/repo (master) $ log No commits to show
geogig-console is still in development and some terminals can produce artifacts on the line which make it difficult to use.
Table Of Contents
Boundless provides commercial open source software for internet mapping and geospatial application development. We are dedicated to the growth and support of open source software.
This work is licensed under a Creative Non Commercial-Commons Attribution-Share Alike 3.0 United States License. Feel free to use this material, but we ask that you please retain the Boundless branding, logos and style.