Make sure you have installed git bash
This guide will use the Linux command line, so if you use Windows, make sure to install Windows Subsystem for Linux (WSL) and Ubuntu
NOTE: If you are having problems, report and take pictures of the issue to our discord server.
- Create a personal token here
![](https://private-user-images.githubusercontent.com/108279046/309442721-c1268863-9a2a-4047-99b7-4fa7785142f5.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjQ5ODQzOTgsIm5iZiI6MTcyNDk4NDA5OCwicGF0aCI6Ii8xMDgyNzkwNDYvMzA5NDQyNzIxLWMxMjY4ODYzLTlhMmEtNDA0Ny05OWI3LTRmYTc3ODUxNDJmNS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwODMwJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDgzMFQwMjE0NThaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT01NGE2YWE5MDM4MmRhZWFmOGUyMTkzZDE5ZTE0MTkyZmVjMGQ5MzFkMDM5M2JiZTkyMTEwZjFkZGIzYWVjN2UyJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.xOBoE6tGbwSpJPynINlyNVshk31eRT8e9f4yy5vm8YA)
- Set expiration to
No expiration
and tick every scope.
- Setup
gh
authentication on your local device by running the following
sudo apt install gh
gh auth setup-git
gh auth login
When asked:
- What account do you want to log into? ANSWER: GitHub.com
- What is your preferred protocol for Git operations? ANSWER: HTTPS
You'll then be asked to paste the personal token you have previously created.
- Click on
Code
and then copy the HTTPS URL of the repository.
![](https://private-user-images.githubusercontent.com/108279046/309184775-608dccda-721b-495d-a838-e2a3c4f4ba8a.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjQ5ODQzOTgsIm5iZiI6MTcyNDk4NDA5OCwicGF0aCI6Ii8xMDgyNzkwNDYvMzA5MTg0Nzc1LTYwOGRjY2RhLTcyMWItNDk1ZC1hODM4LWUyYTNjNGY0YmE4YS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwODMwJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDgzMFQwMjE0NThaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT02MjYzZTdjMGJmY2YwMDY1OWZjMWI1MTkxMTI0OGRjODA5MzdiOTI0ZjdhNjM0N2Y5NDFlZGZlNmFkZDJkZGExJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.vaL_780DClocYIwvRtVzgg7Q7IzOWA6E5-oC5-xbtFc)
- Open a Linux terminal/command line
![](https://private-user-images.githubusercontent.com/108279046/309190825-b79f655f-fa56-49cc-9b91-2594cca418ad.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjQ5ODQzOTgsIm5iZiI6MTcyNDk4NDA5OCwicGF0aCI6Ii8xMDgyNzkwNDYvMzA5MTkwODI1LWI3OWY2NTVmLWZhNTYtNDljYy05YjkxLTI1OTRjY2E0MThhZC5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwODMwJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDgzMFQwMjE0NThaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1mNjgyZGZmNTgxM2Q1OWZkZDk3ZmNiM2U4MzM4NmI0ZTkyMGUwYjkwNGNkMGJmN2ZiZWMxYTI2YjFjZmVhYzUwJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.1yHuW70vogcX4-RqvV13SJA_xcJpv0QTIeHyF2eIYls)
- Navigate to your choice of directory (run
cd
andls
where necessary). See below for example.
![](https://private-user-images.githubusercontent.com/108279046/309194067-7d332d14-cef1-480c-b195-b9c23c246bd5.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjQ5ODQzOTgsIm5iZiI6MTcyNDk4NDA5OCwicGF0aCI6Ii8xMDgyNzkwNDYvMzA5MTk0MDY3LTdkMzMyZDE0LWNlZjEtNDgwYy1iMTk1LWI5YzIzYzI0NmJkNS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwODMwJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDgzMFQwMjE0NThaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT0yMTEzMzdkOGFjODAzOTYwZGU4YWQwYmJjZjJlZmRhMjc3ZjI5NTNmY2E3NTYwNjFmYzViODg4OTEyMGJiY2E4JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.00mPd1EFsWlbO1DMZIIQ5wX5zhM4gQL91DbnsGoxvxs)
- Clone this github repository to your chosen directory
git clone https://github.com/abyanmajid/info1111-task1-cc18-2.git
cd info1111-task1-cc18-2
Now you can make modifications to the changes
directory. But before you edit anything, it is good practice to run
git pull
This will make sure that you update the clone you have made in your local device with the latest version of this github repository. Meaning, you'd have retrieved the latest changes made by others, before you start working.
NOTE: changes/main.tex
will be the main LaTeX file where we will be making our respective code changes to.
If you use Overleaf, you can simply copy paste the LaTeX you have written in Overleaf to changes/main.tex
Make sure you are in the right directory, i.e. if you run ls
, you should see changes
, stable
and README.md
- Run the following to tell git to keep track of all of the changes you have made so far in the current directory.
git add .
- Run the following to save the changes you have made so far.
git commit -m "brief desc of your changes"
- Run the following to push your changes to this repository (thereby replacing the current version with a new version containing your modifications).
git push -u origin main
NOTE: You may occassionally be denied from running the above commands due to problems such as version clashes, etc. Usually, git will tell you the problem and the commands you need to do to resolve it.
You should run the commands as instructed by git. If you're stuck, report your issue to our Discord server.