WDD 231 | Setup

Setup: Hosting on GitHub

Overview

This setup activity establishes your remote wdd231 repository that is cloned to your local computer system. This class uses GitHub to host your course work and the GitHub Pages service to render your work as a live website.

GitHub is a web-based platform used for version control and collaboration. GitHub offers the distributed version control and source code management functionality of git, and has its own features.

Activity Instructions

A GitHub account is required. If you already have a GitHub account, use it.

You do NOT need a separate GitHub account for this class.
In your GitHub account, create a repository named "wdd231" (without the quotes). This will be your course repository. Be sure to use lowercase notation as shown.

Video Demonstration: ▶️ Create a GitHub Repository 5:00min
(Name your repository wdd231 and not wdd131 as is demonstrated in the video)
Verify that you have Git installed on your computer. You can check the status of git by using a command line interface and typing
```
git --version
```
If you do not have git installed, go to Git-Installing Git and follow the directions for your operating system.
Verify that your git global username and email are configured on your local system.
```
git config --list
```
If you need to set your user.name and user.email, enter the following commands:
(use your GitHub username and your byui email address within the empty quotes)
```
git config --global user.name ""
```
```
git config --global user.email ""
```
When these commands are entered correctly, there will be no output to the screen, otherwise you will get an error message.
Set the git configuration file to NOT ignore case changes/renaming in file and folder names.
```
git config --global core.ignorecase false
```
Clone the repository to your local system. Your local repository folder is your working repository from which you will build, test, edit, commit and then finally, deploy/upload your weekly work.

Video Demonstration: ▶️ Cloning a Repository from GitHub to a Local Folder - 9:25 min
(Name your repository wdd231 and not wdd131 as is demonstrated in the video)
Publishing Process: Open the repository folder in VS Code and test that you can make additions/changes. Then commit those changes and then sync/push to your wdd231 remote GitHub Pages enabled repository.

Video Demonstration: ▶️ GitHub Publishing Workflow

This workflow demonstration video is from WDD 130 and references that course. The principles, however, are the same and that is the purpose of the video. The video instruction is NOT for you to follow blindly, step by step. This idea of learning and then applying principles is very important in software development.

Getting Help

If you were not able to complete any of these steps, then you are not prepared yet.
Please reach out for help in Microsoft Teams.