/pages-example

JNL 221 example repository published to Pages.

Primary LanguageHTML

JNL 221 - Example repository

You're on the main page for a repository called pages-example.

Think of this repository like a folder on your computer. In JNL 221, you're frequently organizing our HTML, CSS and content files for different projects in one folder. Once everything is working the way you want it to locally (meaning on your own machine), you can upload those files to a Github repository and maintain the organizational structure you used there.

How this example repository is organized:

├── images/
│   ├── Armorysquaresyr.jpg
│   ├── Destiny_USA.png
│   └── Syrcityhall2.jpg
├── main.css
├── index.html
├── other.html
└── README.md (the file you're reading)

Things to keep in mind:

  • File names matter. Even a slight difference will throw things off. index.html is different than index(3).html and INDex.HTML

  • Paths to files matter. If I want to show the image Armorysquaresyr.jpg in my HTML file, I have to point toward images/Armorysquaresyr.jpg because it's located inside a folder. (More on file paths.)

  • Your core HTML file should be named "index.html". The URL for this repository is https://richardsalex.github.io/pages-example/ and will go directly to index.html.

  • Changes may not be instantaneously reflected online. If I'm getting a 404 page when I go to the above URL, I can try visiting the pages individually: https://richardsalex.github.io/pages-example/index.html or https://richardsalex.github.io/pages-example/other.html. If it's not working, see "File names matter" or "Paths to files matter" above.

I want to:

(Note: these instructions are for Github's web interface.)

Create a new repository from scratch.

Go check out the instructions you've been given and video I recorded for you, both posted on Blackboard. Alternatively, read Github's own documentation on the subject.

Upload all my files to a repository.

  1. From the main repository page, click the Add file button, selecting Upload files from the drop-down menu.

  2. Drag and drop the contents of the project folder on your computer where indicated. Don't drag the folder itself, but the files and folders inside of it.

  3. Click the green Commit changes button.

Upload an individual file OR replace an existing file with a new version.

  1. From the main repository page, click the Add file button, selecting Upload files from the drop-down menu.

  2. Drag and drop the file from your computer where indicated. Or: follow the choose your files link and navigate to the file you want to select.

  3. Click the green Commit changes button.

See a list of all my repositories.

  1. From any page, click on your account icon in the very top right and choose Your repositories.

Edit a file here.

  1. From the main repository page, click on the name of the file you want to edit.

  2. Click the pencil icon with the Edit this file tooltip.

  3. Make changes to the file name or file content.

  4. Click the green Commit changes button.

Remove a file.

  1. From the main repository page, click on the name of the file you want to remove.

  2. Click the trashcan icon with the Delete this file tooltip.

  3. Click the green Commit changes button.

Publish my repository to Github Pages.

  1. From the main repository page, click Settings, which has a gear icon next to it.

  2. On the left rail, click Pages.

  3. Click on the button that says None and select main.

  4. Click the Save button.

  5. You repository should now be published at the link shown. The URL format is generally https://[your username].github.io/[your repository name]/. If it's not showing up or you're getting a 404 webpage, go look at "Changes may not be instantaneously reflected online" above.

Make a copy of this repository and/or its files to practice on my own.

Option 1: Download the files from this repository.

  1. From the main repository page, click the green Code button.

  2. Choose Download ZIP.

  3. You can then make changes and upload the same files to your own repository under your Github account.

Option 2: Fork your own copy of this repository.

  1. From the main repository page, in the top right, click the Fork button.

  2. When it asks where the repository should be forked, click on your account name.

  3. You now have an identical copy of that repository under your account.

Delete an existing repository.

  1. From the main repository page, click Settings, which has a gear icon next to it.

  2. Scroll to the bottom of the page, looking for the section labeled "Danger Zone."

  3. Click the Delete this repository button and follow the instructions. Once it's gone, there's no undo function or way to recover it.