Differences

This shows you the differences between two versions of the page.

--- git:get_started [2018/08/27 11:30] – typos
+++ git:get_started [2024/08/20 21:38] (current) – external edit 127.0.0.1
@@ Line 121: / Line 121: @@
 A snapshot of expected terminal output is illustrated,
 {{git:gt_git_snakey_rubbletracker_term_scrn.png?600x0|Clone rubbleTracker Terminal}}
+===== Add a File to Repository  =====
+Let's a add a new file to our repository!
+<code>
+cd ~/gt_git/Snakey/rubbleTracker
+touch my_new_file.txt
+ls
+</code>
+A new file named 'my_new_file.txt' has been added in the directory, '~/gt_git/Snakey/rubbleTracker'.
+The following command will inform you of whether changes have been made to your local (version of the) repository, causing it to be out of sync with the remote repository.
+<code>
+git status
+</code>
+We first need to inform Git of any new files that it must track on our local machine.
+<code>
+git add my_new_file.txt
+</code>
+Now that the file is tracked, we can 'commit' it to be staged for the next push to the remote repository.
+<code>
+git commit -m "added new example text file"
+</code>
+The '-m' flag allows you to specify text describing the changes being committed. You should **ALWAYS** do this!
+Finally, we can push the staged changes to the remote repository,
+<code>
+git push origin master
+</code>
+Expected terminal output,
+{{git:gt_git_add_new_file.png?600x0|Add File to rubbleTracker - Terminal}}
+===== Update a File in Repository  =====
+We previously added an empty file, 'my_new_file.txt', to the repository.
+Now let's modify it and update the changes to the remote repository!
+<code>
+cd ~/gt_git/Snakey/rubbleTracker
+echo "Hello World!" >> my_new_file.txt
+cat my_new_file.txt
+</code>
+The commands above were a quick way to add simple text to our previously empty file. It now contains the text 'Hello World!'.
+If we run ''git status'', we see that Git is tracking the 'my_new_file.txt' and acknowledges there has been a modification to the file.
+Commit the changed file so that it can be uploaded to the remote server,
+<code>
+git commit -am "added some example text"
+</code>
+The '-a' flag specifies to automatically add any files currently tracked by git (that have been modified) to be staged for upload to the remote repo. The '-m' flag allows the user to enter descriptive text briefly describing the changes.
+Now push the staged changes to the remote repository,
+<code>
+git push origin master
+</code>
+Example terminal output is illustrated,
+{{git:gt_git_modify_file_term.png?600x0|Modify File in rubbleTracker - Terminal}}
+We additionally, see that the new file has been added via the repository's browser page,
+{{git:gt_git_modify_file_browser.png?600x0|Modify File in rubbleTracker - Browser}}
+===== Remove a File from Repository  =====
+In our final example walk through, we'll remove the text file we created from the repository and propagate this update/deletion to the remote repository.
+<code>
+cd ~/gt_git/Snakey/rubbleTracker
+git rm my_new_file.txt
+</code>
+''git rm'' will remove a file both from the local file system as well as from the list of files that git tracks for changes. Running ''git status'' will show that git has marked this file for deletion.
+Commit the change (ie. file deletion) to be staged for upload to the remote rpo.
+<code>
+git commit -m "removed example file"
+</code>
+Push the change,
+<code>
+git push origin master
+</code>
+Example terminal output is illustrated,
+{{git:gt_git_rm_file_term.png?600x0|Remove File from rubbleTracker - Terminal}}