Introduction to Git
From ALFA
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.
Contents
[hide]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
- Open up Git Extensions.
- Select Clone GitGub repository from the common actions pane.
- Select the second tab to search.
- Search for alfa010_bg.
- Select the one from A Land Far Away.
- Near the bottom, use the Browse button to navigate to your <My Documents>\Neverwinter Nights 2\modules folder.
- Rename the local directory from alfa010_bg to alfa010_bg_build.
Automatic Authentication
- In Git Extensions, navigate to Repository > Remote Repositories.
- Hit Browse and go to your .ppk file you saved earlier.
- Save changes.