Introduction to Git

From ALFA
Jump to: navigation, search

Git is a piece of software that allows multiple developers to work together on a project. It provides you with methods of reverting changes through incremental backups, control who can/can't send changes, and more.

In this article, you will be learning how to set your computer up to access repositories on GitHub.


GitHub Registration

The first step is to create a GitHub account.

  • Open the registration link.
  • Provide a username, password, and email that you do not mind other builders knowing.
  • You do not need a paid plan.

Once registered, send a message to your HDM or a GitHub tech team owner.

Installing Git Extensions

Git Extensions is the software you will be using to interact with Git. It provides a clean user interface so that you will not have to learn any command line operation.

  • Download Git Extensions.
    • Check the box to install Git for Windows
    • Check the box to install Kdiff
    • Use PuTTY instead of OpenSSH.

Creating SSH Keys

Generation

  • Navigate to the folder where you installed Git Extensions.
  • Open the PuTTY subfolder.
  • Open puttygen.exe
  • Click the generate button.
  • Move the mouse around until the bar has finished filling.
  • Optional: Type in a comment.
  • Optional: Type in a password.
  • Save the public key somewhere you'll remember. Your home directory in a ssh folder works. Save it as <comment above>.pub.
  • Save the private key in the same place as <comment above>.ppk
  • Do not close the window yet!


Teach to GitHub

  • Navigate to Github's SSH Settings.
  • Click New SSH Key.
  • Give the title <comment above>.
  • Go back to Putty Generator. Go to the top box and copy the contents.
  • Paste the contents into the box on the GitHub website.
  • Click Add Key.
  • You may now close PuttyGen.

Clone ALFA Repository

Clone

(You will need to be added to the build team by the repository owner, probably the Infrastructure Admin or HDM, before cloning.)

  • Open up Git Extensions.
  • Select Clone GitGub repository from the common actions pane, or if that isn't there, GitHub->Clone/Fork from the dropdown menu.
  • Select the second tab to search.
  • Search for alfa010_bg or alfa003_tsm.
  • Select the one from A Land Far Away by clicking in the first column of the results list.
  • Near the bottom, use the Browse button to navigate to your <My Documents>\Neverwinter Nights 2\modules folder. Target it directly into the modules folder, not into a subfolder within the modules folder.
  • Rename the local directory from alfa010_bg to alfa010_bg_build or alfa003_tsm to alfa003_tsm_build.
  • Clone

Automatic Authentication

  • In Git Extensions, navigate to Repository > Remote Repositories.
  • Hit Browse and go to your .ppk file you saved earlier.
  • Save changes.

Settings and KDIFF3

  • Download and install KDiff3 into your Programs directory https://sourceforge.net/projects/kdiff3/files/kdiff3/
  • In Git Extensions, open Tools/Settings.
  • Click Repair next to any lines that are red.
  • Select KDiff as your merge and diff tools and set the paths to it.
  • Leave mergetool and difftool commands, line endings and file content encoding blank.

Missing Textures

Toolset Configuration/Use

Options/General

  • 1) Set Autosave to "False"
  • 2) Set Allow Plugins to "Load All Plugins"

Only use Save Directory, not Save.