🛠️ GitHub Master Guide

Efficiently manage, update, and deploy your web files directly via GitHub. We are simplifying repository maintenance through step-by-step automation and manual control.

📌 Workflow Prerequisites

Section 1
📥 How to Copy Any HTML Code from GitHub

To ensure you get the functional code without extra HTML formatting from GitHub's UI, follow these steps:

  1. Navigate to the repository and click on the specific .html file you wish to copy.
  2. Locate the "Raw" button at the top right of the file preview pane.
  3. Clicking Raw will open a plain text version of the code in your browser.
  4. Press Ctrl + A (Windows) or Cmd + A (Mac) to select everything.
  5. Press Ctrl + C to copy the clean, unformatted code to your clipboard.

💡 Pro Tip:

Using the "Raw" view prevents accidental inclusion of line numbers or GitHub UI elements that could break your site's design.

Section 2
🔗 Updating the Master Index.html with a New Link

Adding a new page to your master directory requires precise insertion to maintain the visual layout.

Execution Steps:

  1. Open your index.html file in the GitHub editor.
  2. Locate the section where your navigation links or "cards" are stored.
  3. Use the following AI Command to ensure perfect formatting:
“I want to update my master index.html page by adding a new page link. In the HTML code below: [ ENTER MASTER INDEX.HTML CODE HERE ] Please modify my existing master index.html file by adding a new entry using the same structure, formatting, layout style, spacing, and design as the existing links already present in the file. Here are the details for the new page: URL: [PASTE_LINK] Title: "[PASTE_TITLE]" Do not change anything else. Return the full updated HTML.”

⚠️ Warning:

Ensure the URL precisely matches the filename in your repository (e.g., my-new-page.html) to avoid 404 errors.

Section 3
✏️ Editing Master Index.html Directly in GitHub

You don't need external software to update your site. GitHub's built-in editor is sufficient for quick changes.

  1. Go to your repository and click on index.html.
  2. Click the Pencil Icon (Edit this file) in the top right corner.
  3. Paste your updated code (generated in Step 2) into the editor, replacing the old code.
  4. Scroll down to the "Commit changes..." box.
  5. Enter a short description (e.g., "Added link to New Guide") and click Commit changes.
Action Shortcut/Button
Edit Mode Pencil Icon / Press 'E'
Save Changes Commit Changes Button
Preview Changes "Preview" tab next to "Edit"
Section 4
🔄 Renaming a File to Index.html

If you have a file named home.html or temp.html and want it to be your homepage, it must be named index.html.

The Renaming Procedure:

  1. Navigate to the file you want to rename in your GitHub repository.
  2. Click the Pencil Icon to enter edit mode.
  3. In the filename box at the top (where the current name is displayed), click inside and delete the old name.
  4. Type index.html exactly.
  5. Scroll to the bottom and click Commit changes.

⚠️ Critical Note:

GitHub Pages looks specifically for index.html to serve as the root. If you already have an index.html, you must rename or delete the old one first, as two files cannot share the same name.

💡 Troubleshooting & Best Practices

Crafted & Designed by Umer Malik