GitHub

GitHub is a web-based platform that provides hosting of coding repositories. It offers a centralized location for people to store, manage, and allow collaboration on their code. It is especially useful for version control and project tracking. The following information is geared towards linking gluey annex repositories with GitHub, but can easily be used to link your home computer to a GitHub repository. This wiki page is being updated as the author learns how to use GitHub, so if you know a better, more efficient way to accomplish a task then by all means please do it that way (... and add an addendum to this page if you have a login).

The Setup

1. Sign up for a GitHub account by going to the GitHub website and create a new account
   - If you do not make your email address public you will have problems pushing your code later


2. Once you're logged in, click on the "+" sign at the top-right corner of the GitHub homepage and select "New repository" to create a new repository. Give your repository a name and provide a description.
• The repository name will be your folder name on gluey (see below)
• Repository description is optional
• Repository Setting:
• Private vs. Public
• License (optional) - MIT License is well known and least restrictive
• You can add a README file
• You can also rename the main branch (this must be done before the repository is created, changing the name will change all subsequent repositories that are made in the future)
• And more ...


3. Once the repository is setup online, add a Personal Access Token
• At the top-right of the GitHub website click on the pull-down and select "Settings"
• On the left select "Developer settings" located at the bottom
• Then on the left select "Personal access tokens"
• Select "Fine-grained tokens" or "Tokens (classic)", I did the prior one
• For the Fine-grained token you will need to select which permissions you'd like to allow (not sure about the classic token)
• Select a period for the token to be valid, upto 90 days maximum (I believe)
• Once complete it will provide you with the token you can copy, this will be used in place of your password later


4. Clone your repository
• Log in to gluey using a VNC and navigate to the location in your annex where you'll be working
• You can do the same for your home computer, you'll just need to open a terminal or command prompt and navigate to the directory where you want to store your code
• Use the command:
  git clone https://github.com/your-username/your-repository.git
    - Make sure to replace "your-username" with your GitHub username and "your-repository" with the name of your repository
• You will now need to login. Use your GitHub Username, but make sure to use the Personal Access Token you created earlier and NOT your GitHub password


5. At this point you should have a new folder in your annex with the name of your GitHub repository
• Confirm that the remote repository is correctly added, use the command:
  git remote -v
  
• If needed, you can link the local repository to the remote repository using:
  git remote add origin repository-url
  


6. To switch to or determine a branch in Git, you can use the git checkout command:
   • Determine the name of the branch you want to switch to via:
     git branch
       - It will show all branches available and indicate your current branch with a *
     
   • Create a new branch using:
     git branch new-branch-name
   • Switch to that branch and work in it via:
     git checkout new-branch-name
     
   
   
   • The two steps above can be combined:
     git checkout -b new-branch-name
       - This will create and switch to the new branch in one step
   
   
7. Add files/folders to your directory


8. When you're ready to save, make sure you are in the root directory of your repository or the directory where the new folder you want to save is located. Then use the git add command to add the new folder and its contents to the staging area. Run the following command:
   git add folder-name
    - Adds the specified file or folder
     OR
   git add .
    - Adds all new files and folders in the current directory recursively, does not add higher directory information
     OR
   git add -A
    - Adds all files: new, modified, and deleted files. It will include files in the current directory and in higher directories that belong to the same git repository
     OR
   git add -u
    - Adds modified and deleted files only. Excludes new files. It will include files in the current directory and in higher directories that belong to the same git repository
   
   For a more detailed description of git add go to: https://github.com/git-guides/git-add


9. Once the new folder/file is added to the staging area, you can commit the changes using the git commit command:
   git commit -m "Commit message"
     - Replace Commit message with a descriptive message summarizing the changes you made. Keep " " around your message


10. After committing the changes (on your local machine), you can push them to the remote repository on GitHub using the git push command:
    git push origin branch-name
      - Replace branch-name with the name of the branch you want to push to (e.g., main)
      - You will need to login with your Username and Personal Access Token

The Extras

• For information on common git commands, see the top of the Git Guides webpage (https://github.com/git-guides/git-add)



• git status
    - This command shows the branch you're on, what files are in the working or staging directory, and other important information
    Example:
  

          mcintyre@gluey/nfs/direct/annex/mcintyre/GitRepo/Radphi_pi02gp/RUN0
          $ git status
          # On branch PI0
          # Untracked files:
          #   (use "git add <file>..." to include in what will be committed)
          #
          #	STEP6/
          #	STEP7/
          nothing added to commit but untracked files present (use "git add" to track)
        



• git reset
    - This command unstages all changes (e.g. all git add performed before a git commit)
  
git reset file-name
  - This command undoes git add for uncommited changes to file file-name


• Adding a repository from your local computer to GitHub
    1) On your local computer, initialize the folder you want to adds as a repository:
      - Use cd to navigate to the folder that contains the work you'd like to track/backup
      - Type git init to initialize the folder for Git tracking
      - Type touch .gitignore to create a blank file in that folder, which can later be modify to specify files or types of files you don't want to track (optional step)
  
    2) Go to https://github.com/ , login, and create a repository as described above. Name the repository the same as your working folder you did the git init command in
  
    3) On your local computer link your working folder to the GitHub repsoitory:
      - Type git remote add origin github-repository-url
          github-repository-url can be found online. In your repository folder click on the green [<> Code] button then under the Local tab you'll see Clone HTTPS. Click the copy button to paste the address into the line of code above
  
    4) On your local computer, merge the two repositories (local and online):
      - Type git pull origin main
          This assumes the GitHub branch is named main in the repository you created online
  
    5) On your local computer, add files to track:
      - Type git add .
  
    6) On your local computer, commit that add:
      - Type git commit -m "Message here"
          Change Message here to a brief description of the reason for the commit (ex: Initial commit). Make sure to keep ""
  
    7) On your local computer, change (if required) the branch name to the name listed in the online repository:
      - Typing git branch tells you the name(s) of the branch(es) with the current one having a * next to it
      - If you need to modify your local computer's branch name use git branch -M main where main is the name to change the branch to
      - Use git branch to verify the change
  
    8) On your local computer, push your commit:
      - Type git push -u origin main
          You'll need to enter your GitHub profile name and your Personal Access Token to complete the push
  
    9) At this point your online GitHub repository should be the same as the working folder on your local computer.
      You can now continue to code and push/pull to GitHub as needed to track/update changes. Good luck, if it doesn't work don't blame me ... I only work here :)