evermillion/README.md

# spatial theory and level design: assignment 1

proof of concept and test repository for pushing beeg repositories to 𝓁𝒶 𝓅𝑜𝒾𝓈𝓈𝑜𝓃 𝒹𝓊 𝒻𝑜𝓇𝑔𝑒

## how do i add _my_ repository?

1. add git files to the repository root/folder

   - [.gitignore](https://forge.joshwel.co/mark/unity/raw/branch/main/.gitignore)
   - [.gitattributes](https://forge.joshwel.co/mark/unity/raw/branch/main/.gitattributes)

2. manage your git repo with github desktop or via the command line

3. open your repository in the terminal

   ![gh desktop](https://forge.joshwel.co/mark/stld-asg1/raw/branch/main/Documentation/Screenshot%202024-06-05%20095930.png)

   run the following:

   ```text
   git checkout -b main
   git lfs install
   git config lfs.https://forge.joshwel.co/<username>/<repository>.git/info/lfs.locksverify true
   ```

4. make a repo and follow the forge's instructions

   ![instructions](https://forge.joshwel.co/mark/stld-asg1/media/branch/main/Documentation/Screenshot%202024-06-05%20100151.png)

   > [!IMPORTANT]  
   > if the project has a github deliverable, you must have different remote names \
   > i would recommend `origin` pointing to github, and `forge` pointing to the forge

   ```text
   git remote add forge https://forge.joshwel.co/mark/<username>/<repository>/
   git push -u forge main
   ```

   ```text
   $ git push -u origin main
   Uploading LFS objects: 100% (886/886), 2.9 GB | 45 MB/s, done.
   Enumerating objects: 4641, done.
   Counting objects: 100% (4641/4641), done.
   Delta compression using up to 16 threads
   Compressing objects: 100% (4637/4637), done.
   Writing objects: 100% (4641/4641), 51.45 MiB | 7.90 MiB/s, done.
   Total 4641 (delta 2185), reused 0 (delta 0), pack-reused 0 (from 0)
   remote: Resolving deltas: 100% (2185/2185), done.
   To https://forge.joshwel.co/mark/stld-asg1.git
   * [new branch]      main -> main
   branch 'main' set up to track 'origin/main'.
   ```

   if all goes well it should look something like this,
   where there is a line for Git LFS (`Uploading LFS objects`)

5. profit

   for best results, use remote name `origin` for github, and `forge` for 𝓁𝒶 𝓅𝑜𝒾𝓈𝓈𝑜𝓃 𝒹𝓊 𝒻𝑜𝓇𝑔𝑒

   ```text
   # push changes to github
   git push origin main

   # push changes to forge
   git push forge main
   ```

   same things apply to pulling, have fun!

## i previously didn't have .gitattributes, what now

it's a very involved process, and git is scary. \
oh well, give up. restart your git repo if you can, else oops