Menu

GIT

git (2)
Nightinggale Ted McBride
Attachments
Setup1.jpg (35531 bytes)
Setup2.jpg (23141 bytes)
clone type.jpg (15493 bytes)
getLink.jpg (25940 bytes)
setup3.jpg (27382 bytes)
setup4.jpg (26895 bytes)

This guide tells how to use git to get the newest version of a mod combined with the included submodules.

This guide assumes that you use smartGIT, but in theory you can use any git client. The screenshots are from smartGIT 5 as they were made just before smartGIT 6 was released.

Install smartGIT, run it once and answer the questions. Presumably the default options will be ok. When asked for a name and email, use the one you have on Sourceforge. Note that the email will appear in public if you commit yourself.

Getting the mod itself:
First you go to https://sourceforge.net/p/colonizationmodcollection/Medieval_Conquest/ci/master/tree/

As you see in the screenshot above there are 3 modes.
SSH - Read/write
HTTP - use HTTPS instead of git's own protocol
RO - Read Only

All URLs given here will be read only unless you are logged into Sourceforge when you view the list. The reason is that your username have to be included in the URL if you plan to write back to sourceforge.

HTTP is slower than RW, but it is a lot easier to get through firewalls.

To make a local copy using git, you select Project->Clone in smartGIT.

You enter the URL you just found, but only the URL, not the entire line, like
git clone git://git.code.sf.net/p/colonizationmodcollection/Medieval_Conquest colonizationmodcollection-Medieval_Conquest
You will get an error if you do this step wrong and then you can try again,

Next it will ask for the kind of repository and you select Git.

Next it asks for tags and submodules and you want all of them

Next it will ask for authentication. It will either have a Private Key or Password. Unless you already know how to use public/private keys, switch to password. Write your password and store it. Failure to store will make smartGIT ask for your password 3 times whenever you pull (download updates). Naturally you shouldn't save a pasword on a shared computer.

Next it will ask where to put the files on your harddisk.

All modules are designed to be playable if put directly into MODS. Because of this, the recommended place is My Documents\My games\Sid Meier's Civilization IV Colonization\MODS\Medieval_Conquest
The last part is important because savegames can only be loaded if whoever loads them uses the same name. Because of this it will be beneficial to use a standard name as it makes bugreports with savegames a lot easier to handle.

Last call the repository something inside smartGIT. Presumably the default name will be ok.

Now smartGIT will download a whole lot of data. Once complete, you can use the git usage guide to figure out how to update.

To control git, goto [GIT switch branch]


Related

Wiki: GIT switch branch

MongoDB Logo MongoDB