- );
-};
-
-export default Timeline;
\ No newline at end of file
diff --git a/src/theme/DocItem/Content/index.js b/src/theme/DocItem/Content/index.js
deleted file mode 100644
index 5fc93dd89..000000000
--- a/src/theme/DocItem/Content/index.js
+++ /dev/null
@@ -1,10 +0,0 @@
-import React from 'react';
-import Content from '@theme-original/DocItem/Content';
-
-export default function ContentWrapper(props) {
- return (
- <>
-
- >
- );
-}
diff --git a/src/theme/MDXComponents.js b/src/theme/MDXComponents.js
index f2f76c90a..7102ca371 100644
--- a/src/theme/MDXComponents.js
+++ b/src/theme/MDXComponents.js
@@ -19,7 +19,6 @@ import Admonition from '@theme/Admonition';
import TOCInline from '@theme/TOCInline';
import CodePenEmbed from '@site/src/components/CodePenEmbed';
import CodePreview from '@site/src/components/CodePreview';
-import { Timeline, TimelineEvent } from '@site/src/components/Timeline';
export default {
// Re-use the default mapping
@@ -43,6 +42,4 @@ export default {
TOCInline,
CodePenEmbed,
CodePreview,
- Timeline,
- TimelineEvent,
};
diff --git a/static/img/tutorials/html/html-history.png b/static/img/tutorials/html/html-history.png
new file mode 100644
index 000000000..71a916b44
Binary files /dev/null and b/static/img/tutorials/html/html-history.png differ
diff --git a/static/img/tutorials/html/what-is-html.svg b/static/img/tutorials/html/what-is-html.svg
new file mode 100644
index 000000000..87b030927
--- /dev/null
+++ b/static/img/tutorials/html/what-is-html.svg
@@ -0,0 +1,211 @@
+
diff --git a/tutorials/html/01-getting-started/browser-developer-tools.mdx b/tutorials/html/01-getting-started/browser-developer-tools.mdx
index 60b50647d..75820506a 100644
--- a/tutorials/html/01-getting-started/browser-developer-tools.mdx
+++ b/tutorials/html/01-getting-started/browser-developer-tools.mdx
@@ -1,16 +1,342 @@
---
id: browser-developer-tools
-title: "Inspecting Web Pages with Browser Developer Tools"
-sidebar_label: "Developer Tools"
+title: "Browser Developer Tools"
+sidebar_label: "Browser Developer Tools"
sidebar_position: 8
slug: /html/getting-started/browser-developer-tools
-description: "Master Chrome and Firefox DevTools to inspect HTML markup, debug layout elements, view real-time DOM changes, and audit web pages."
+description: "Learn how to open and use browser developer tools in Chrome, Firefox, and Edge. Master the Elements panel, live-edit HTML and CSS, use the Console, check responsive design, and debug your first web page like a professional."
keywords:
- browser developer tools
- - DevTools HTML inspection
- - DOM inspection
- - Chrome DevTools guide
- - web debugging tools
+ - Chrome DevTools tutorial
+ - inspect element
+ - HTML CSS debugging
+ - how to use DevTools
+ - Elements panel
+ - Console tab
+ - responsive design mode
+ - web developer tools for beginners
- CodeHarborHub HTML
-tags: [devtools, debugging, html, tools]
----
\ No newline at end of file
+tags: [html, web-development, beginner, devtools, debugging]
+image: /img/tutorials/html/browser-developer-tools.png
+last_update:
+ author: CodeHarborHub
+---
+
+Here is a secret every professional web developer relies on daily: **you can peek inside any website's HTML and CSS, right from your own browser, for free, without installing anything.**
+
+The tool that makes this possible is called **Developer Tools**, or **DevTools** for short. It is built into every modern browser, and learning to use it is one of the biggest confidence boosts you will get early in your HTML journey.
+
+In this lesson, you will learn to open DevTools, read a page's real structure, experiment safely, catch mistakes, and even preview how a page looks on a phone, all without touching a single line of code on the actual server.
+
+:::info Why this lesson matters
+Reading *about* HTML only gets you so far. DevTools lets you **see HTML working live**, on real websites, which makes everything you have learned so far click into place.
+:::
+
+
+
+
+## What Are Developer Tools?
+
+Developer Tools are a set of panels built directly into your browser that let you:
+
+- **Inspect** the exact HTML and CSS behind any element on a page.
+- **Edit** that HTML and CSS temporarily, just in your browser, to experiment.
+- **Read messages and errors** from JavaScript in the Console.
+- **Measure performance**, network requests, and much more.
+
+Think of it like an **X-ray machine for websites**. Point it at any part of a page, and you instantly see the code creating it.
+
+:::note Nothing you change is permanent
+Anything you edit in DevTools only affects **your own view**, in **your own browser**, for as long as the page stays open. Refresh the page, and everything returns to normal. This makes DevTools a completely safe place to experiment.
+:::
+
+## Step 1: Opening Developer Tools
+
+Every major browser includes DevTools, and they all work in a very similar way. Pick your browser below.
+
+
+
+
+Use any of these methods:
+
+- **Right-click** anywhere on a page and choose **"Inspect."**
+- Press **F12**
+- Press **Ctrl+Shift+I** (Windows/Linux) or **Cmd+Option+I** (macOS)
+- Click the **โฎ** menu โ **More tools โ Developer tools**
+
+
+
+
+Use any of these methods:
+
+- **Right-click** anywhere on a page and choose **"Inspect."**
+- Press **F12**
+- Press **Ctrl+Shift+I** (Windows/Linux) or **Cmd+Option+I** (macOS)
+- Click the **โฐ** menu โ **More tools โ Web Developer Tools**
+
+
+
+
+Use any of these methods:
+
+- **Right-click** anywhere on a page and choose **"Inspect."**
+- Press **F12**
+- Press **Ctrl+Shift+I** (Windows/Linux) or **Cmd+Option+I** (macOS)
+- Click the **โฏ** menu โ **More tools โ Developer tools**
+
+
+
+
+Safari hides this feature by default, so you need to enable it once:
+
+1. Open **Safari โ Settings โ Advanced**.
+2. Turn on **"Show features for web developers."**
+3. Now right-click any page and choose **"Inspect Element,"** or press **Cmd+Option+I**.
+
+
+
+
+A panel will appear, either docked to the side or the bottom of your browser window, packed with several tabs. Don't feel overwhelmed. As a beginner, you really only need **two** of them: **Elements** and **Console**.
+
+## Step 2: The Elements Panel (Your New Best Friend)
+
+The **Elements** panel (called **Inspector** in Firefox) shows you the **live HTML** of the current page, formatted as a neat, expandable tree, exactly like the DOM tree you learned about in [How the Web Works](./how-the-web-works.mdx).
+
+```mermaid
+flowchart LR
+ A["๐ฑ๏ธ Right-click an element on the page"] --> B["๐ต๏ธ Choose 'Inspect'"]
+ B --> C["๐ DevTools opens and highlights the matching HTML"]
+ C --> D["๐จ The Styles panel shows the CSS rules applied to it"]
+
+ style A fill:#e3f2fd,stroke:#1976d2,color:#000
+ style D fill:#e8f5e9,stroke:#388e3c,color:#000
+```
+
+### Try it right now
+
+Here is a small sample page. Right-click directly on the heading below, and choose **"Inspect"** (this works because it is real HTML rendered in your browser):
+
+
+<>
+
Inspect Me!
+
Right-click this paragraph and choose "Inspect" to see its HTML.
+
+>
+
+
+When you do this on a real webpage, DevTools will:
+
+1. Open automatically.
+2. **Highlight** the exact line of HTML for the element you clicked.
+3. Show its CSS rules in a side panel.
+
+This single trick, **right-click โ Inspect**, is the fastest way to understand how *any* website on the internet is built.
+
+
+
+
+## Step 3: Live-Editing HTML and CSS
+
+Once you have an element selected in the Elements panel, you can **double-click its text** to edit the HTML directly.
+
+```mermaid
+sequenceDiagram
+ participant You as ๐ You
+ participant Panel as ๐งฉ Elements Panel
+ participant Page as ๐ฅ๏ธ The Web Page
+
+ You->>Panel: Double-click an element's text
+ Panel->>Panel: Turns into an editable field
+ You->>Panel: Type new text and press Enter
+ Panel->>Page: Instantly updates the live page
+ Note over Page: Refreshing the page undoes the change
+```
+
+### Fun experiments to try
+
+- Find a heading on any news website and **change the text** to something silly.
+- Select an image and try **changing its `src` attribute** to a different picture URL.
+- Click the **Styles** tab, find a `color` value, and change it to `red` or `hotpink`.
+- **Uncheck a CSS property** in the Styles panel by clicking its checkbox, and watch the style disappear from the page.
+
+:::tip This is how professionals prototype
+Real developers use exactly this technique to test a design change before writing the "real" code in their project files. It is fast, safe, and encourages experimentation.
+:::
+
+## Step 4: Meet the Console
+
+The **Console** tab is where JavaScript messages, warnings, and errors appear. Even before you write JavaScript yourself, the Console is useful, because it often reveals **why a page is broken**.
+
+```mermaid
+flowchart TD
+ C["๐ฅ๏ธ Console Tab"] --> M["โน๏ธ Messages Logged information"]
+ C --> W["โ ๏ธ Warnings Something might be wrong"]
+ C --> E["โ Errors Something failed"]
+
+ style E fill:#ffebee,stroke:#c62828,color:#000
+ style W fill:#fff3e0,stroke:#f57c00,color:#000
+```
+
+You can also type directly into the Console and press Enter to run a quick command:
+
+```js
+console.log("Hello from DevTools!");
+document.querySelectorAll("p").length;
+```
+
+The first line prints a message. The second line counts how many `
` elements exist on the current page. Don't worry about fully understanding this yet. You will learn JavaScript basics later; for now, just know this powerful tool exists.
+
+## Step 5: Testing Responsive Design
+
+One of the most practical DevTools features for an HTML learner is the **Device Toolbar**, which simulates how a page looks on phones and tablets.
+
+
+
+
+1. Open DevTools.
+2. Click the small **phone and tablet icon** in the top-left of the DevTools panel (or press **Ctrl+Shift+M** / **Cmd+Shift+M**).
+3. Choose a device from the dropdown, such as "iPhone 14" or "iPad Air."
+4. The page redraws at that device's exact screen size.
+
+
+
+
+1. Open DevTools.
+2. Click the **Responsive Design Mode** icon (it looks like a phone and tablet).
+3. Or press **Ctrl+Shift+M** (Windows/Linux) or **Cmd+Option+M** (macOS).
+4. Choose or type a screen size to preview.
+
+
+
+
+This is exactly how professional developers check that a site looks good on every screen size, and it connects directly back to why we added the `` tag in the [HTML Document Structure](./html-document-structure.mdx) lesson.
+
+## A Quick Tour of the Other Panels
+
+You do not need these yet, but it helps to recognize their names as you keep learning:
+
+| Panel | What it is for |
+|-------|-----------------|
+| **Elements / Inspector** | View and edit live HTML and CSS. |
+| **Console** | See messages, warnings, and errors; run quick JavaScript. |
+| **Sources / Debugger** | Read and step through JavaScript files. |
+| **Network** | See every file a page downloads, and how long each takes. |
+| **Application / Storage** | Inspect data saved in `localStorage`, cookies, and caches. |
+| **Performance** | Measure how fast a page loads and renders. |
+| **Lighthouse / Audits** | Get an automated report on performance, accessibility, and SEO. |
+
+
+
+
+## A Simple DevTools Challenge
+
+Try this three-minute exercise on any website you like:
+
+1. Open the site and press **F12** to launch DevTools.
+2. Right-click the main heading and choose **Inspect**.
+3. In the Elements panel, double-click the heading's text and change it to your own name.
+4. Open the **Styles** panel and change its `color` to your favorite color.
+5. Open the **Device Toolbar** and preview the page as if it were on a phone.
+6. Refresh the page and watch your changes disappear, proving nothing was permanently changed.
+
+:::tip Why this exercise matters
+You just navigated the DOM, edited live HTML and CSS, and tested responsive design, the exact same first steps every professional developer takes when reviewing a website.
+:::
+
+## Common Beginner Confusions
+
+
+Will editing HTML in DevTools break the real website?
+
+No. Every change you make in DevTools only exists in your own browser tab, temporarily. The website's actual files on the server are never touched, and a simple page refresh undoes everything.
+
+
+
+
+ Why does the HTML in DevTools look different from "View Page Source"?
+
+"View Page Source" (Ctrl+U) shows the **original HTML file** sent by the server. The Elements panel shows the **live DOM**, which may have been changed by JavaScript after the page loaded. For learning HTML structure, both are useful, but DevTools shows the current, real state of the page.
+
+
+
+
+ I see red text in the Console. Did I break something?
+
+Not necessarily, and definitely not if you are just browsing someone else's website. Many production websites show warnings or minor errors in their Console that do not affect regular visitors. As you write your own JavaScript later, red Console messages will become one of your most useful debugging clues.
+
+
+
+
+ Do I need to keep DevTools open all the time?
+
+No. Open it only when you want to inspect, learn from, or debug a page. Keeping it open uses a small amount of extra memory, so most developers close it when they are done.
+
+
+
+## Quick Recap
+
+- **DevTools** is a free, built-in browser feature for inspecting and debugging web pages.
+- Open it with **right-click โ Inspect**, or the shortcut **F12** / **Ctrl+Shift+I**.
+- The **Elements panel** shows the live HTML and CSS of a page.
+- Changes made in DevTools are **temporary** and disappear on refresh.
+- The **Console** shows messages, warnings, and errors, and can run quick JavaScript.
+- The **Device Toolbar** lets you preview how a page looks on phones and tablets.
+
+## Frequently Asked Questions
+
+
+ How do I open Developer Tools?
+
+Right-click anywhere on a webpage and choose "Inspect," or press F12, or press Ctrl+Shift+I on Windows and Linux (Cmd+Option+I on macOS).
+
+
+
+
+ Is it safe to use browser DevTools?
+
+Yes. DevTools only affects what you see in your own browser tab. It cannot change the real website's files on its server, and your edits vanish when you refresh the page.
+
+
+
+
+ What is the difference between Inspect Element and View Page Source?
+
+"Inspect Element" opens the full DevTools panel and shows the live, current state of the page's HTML. "View Page Source" shows only the original HTML file exactly as it was sent by the server, before any JavaScript changes.
+
+
+
+
+ Can I use DevTools to learn how other websites are built?
+
+Yes, this is one of its best beginner uses. Inspecting real websites you admire is a great way to see practical HTML and CSS techniques in action.
+
+
+
+
+ Do all browsers have the same developer tools?
+
+Chrome, Firefox, and Edge all include very similar DevTools with the same core features. Safari has an equivalent but needs to be enabled first in its settings.
+
+
+
+## Test Your Understanding
+
+1. Name two ways to open Developer Tools.
+2. What is the difference between the Elements panel and "View Page Source"?
+3. If you edit an element's text in DevTools, will other visitors to the site see your change? Why or why not?
+4. What kind of information appears in the Console tab?
+5. Which DevTools feature helps you test how a page looks on a mobile phone?
+
+## Module Complete!
+
+Congratulations, you have finished the **Getting Started with HTML** module! Let's look back at everything you have accomplished:
+
+- โ Learned [what HTML is](./what-is-html.mdx) and how it structures the web.
+- โ Explored the [history of HTML](./html-history.mdx), from CERN to today's Living Standard.
+- โ Compared [HTML and HTML5](./html-vs-html5.mdx) and their key differences.
+- โ Understood [how the web works](./how-the-web-works.mdx), from URLs to rendering.
+- โ Mastered [HTML document structure](./html-document-structure.mdx).
+- โ Built [your first HTML page](./create-your-first-html-page.mdx) with your own hands.
+- โ Learned to use **browser developer tools** to inspect and debug any page.
+
+You now have a genuinely solid foundation. In the next module, you will start writing real HTML tags in depth, text elements, links, images, lists, and much more, and turn everything you have learned into real, structured web pages.
\ No newline at end of file
diff --git a/tutorials/html/01-getting-started/create-your-first-html-page.mdx b/tutorials/html/01-getting-started/create-your-first-html-page.mdx
index a6378983e..6c83013b2 100644
--- a/tutorials/html/01-getting-started/create-your-first-html-page.mdx
+++ b/tutorials/html/01-getting-started/create-your-first-html-page.mdx
@@ -1,16 +1,382 @@
---
id: create-your-first-html-page
title: "Create Your First HTML Page"
-sidebar_label: "First HTML Page"
+sidebar_label: "Your First HTML Page"
sidebar_position: 7
slug: /html/getting-started/create-your-first-html-page
-description: "Step-by-step hands-on tutorial on setting up a local code editor, writing basic HTML tags, and rendering your first webpage in a browser."
+description: "Follow this hands-on, step-by-step tutorial to write, save, and open your very first HTML page. Set up VS Code, use Live Server, and build a small personal profile page from scratch."
keywords:
- create first HTML page
- - HTML hands-on tutorial
- - VS Code setup for HTML
- - index.html file
- - beginner HTML project
+ - HTML tutorial for beginners
+ - how to write HTML
+ - VS Code HTML setup
+ - Live Server extension
+ - first web page tutorial
+ - HTML hello world
+ - build a webpage step by step
- CodeHarborHub HTML
-tags: [html, hands-on, beginner, tutorial]
----
\ No newline at end of file
+tags: [html, web-development, beginner, hands-on, vscode]
+image: /img/tutorials/html/create-your-first-html-page.png
+last_update:
+ author: CodeHarborHub
+---
+
+You have learned what HTML is, where it came from, how HTML5 improved it, how the web delivers pages, and how a document is structured. Time for the fun part: **building something real with your own hands.**
+
+By the end of this lesson, you will have written, saved, and opened your very first HTML page, and even built a tiny personal profile page. Let's get started!
+
+:::info What you will build
+A simple **"About Me"** page containing a heading, a photo placeholder, a short paragraph, a list of hobbies, and a link. Small, but 100% yours.
+:::
+
+
+
+
+## Step 1: Set Up Your Workspace
+
+You only need three things to write HTML: a **code editor**, a **browser**, and a **folder** to keep your files organized.
+
+
+
+
+**Recommended for this tutorial.**
+
+1. Download it for free from [code.visualstudio.com](https://code.visualstudio.com/).
+2. Install it like any other application.
+3. Open it once to make sure it launches correctly.
+
+VS Code gives you syntax highlighting, auto-completion, and helpful extensions, which make learning much smoother.
+
+
+
+
+If you cannot install anything right now, a plain text editor works too:
+
+- **Windows:** Notepad
+- **macOS:** TextEdit (make sure to use **Plain Text** mode, found under *Format โ Make Plain Text*)
+- **Linux:** gedit or any default text editor
+
+You will just need to remember to save your file with a `.html` extension.
+
+
+
+
+No installation at all? Try an online playground such as:
+
+- [CodePen](https://codepen.io/)
+- [JSFiddle](https://jsfiddle.net/)
+- [CodeSandbox](https://codesandbox.io/)
+
+These are great for quick experiments, though installing VS Code is worth it as soon as you can.
+
+
+
+
+### Create a project folder
+
+Create one folder on your computer to hold all your practice files, for example:
+
+```text
+html-practice/
+โโโ index.html
+```
+
+Keeping everything in one place will make it much easier to find your work later.
+
+## Step 2: Create the HTML File
+
+
+
+
+1. Open VS Code.
+2. Click **File โ Open Folder** and select your `html-practice` folder.
+3. In the sidebar, click the **New File** icon.
+4. Name the file exactly: `index.html`
+
+:::tip Why "index.html"?
+When a browser or server looks for a webpage in a folder without a specific filename, it automatically looks for a file called **`index.html`**. It is the standard "homepage" name across the entire web.
+:::
+
+
+
+
+1. Open your text editor.
+2. Create a new file.
+3. Save it inside your `html-practice` folder.
+4. When naming it, type `index.html` and make sure the extension is exactly `.html`, not `.html.txt`.
+
+:::warning Watch the file extension
+Some editors add `.txt` automatically. Choose **"All Files"** in the save dialog, or explicitly type the `.html` extension, to avoid this trap.
+:::
+
+
+
+
+## Step 3: Write the Boilerplate
+
+Open your empty `index.html` file and type this structure. Typing it yourself (rather than copying) really helps it stick in your memory.
+
+```html title="index.html"
+
+
+
+
+
+ My First Page
+
+
+
+
+
+```
+
+:::tip VS Code shortcut
+In VS Code, create an empty `.html` file, type a single **`!`**, then press **Tab**. It will generate this entire boilerplate for you automatically thanks to Emmet, a built-in shortcut tool.
+:::
+
+If you already forgot what any of these lines mean, that's completely fine. Revisit the [HTML Document Structure](./html-document-structure.mdx) lesson any time.
+
+## Step 4: Add Your First Content
+
+Inside the `` tags, add a heading and a paragraph:
+
+```html title="index.html" {9,10}
+
+
+
+
+
+ My First Page
+
+
+
Hello, World!
+
This is my very first web page, built with HTML.
+
+
+```
+
+Save the file now with **Ctrl+S** (Windows/Linux) or **Cmd+S** (macOS). Saving often is a great habit to build early.
+
+## Step 5: Open It in a Browser
+
+
+
+
+1. Open your file explorer or Finder.
+2. Navigate to your `html-practice` folder.
+3. **Double-click `index.html`.**
+
+It should open directly in your default browser, showing your heading and paragraph. The address bar will show something like `file:///C:/Users/you/html-practice/index.html`.
+
+
+
+
+**Live Server** is a free VS Code extension that opens your page in a real local server and **automatically refreshes** it every time you save. This mirrors how real websites work and saves you from constantly clicking "refresh."
+
+1. In VS Code, open the **Extensions** panel (the icon with four squares).
+2. Search for **"Live Server"** by Ritwick Dey.
+3. Click **Install**.
+4. Right-click anywhere inside `index.html` and choose **"Open with Live Server."**
+5. Your default browser opens automatically at an address like `http://127.0.0.1:5500/index.html`.
+
+From now on, every time you save your file, the browser refreshes instantly!
+
+
+
+
+Here is what your page should look like right now:
+
+
+<>
+
Hello, World!
+
This is my very first web page, built with HTML.
+>
+
+
+๐ **Congratulations!** You just built and viewed your first web page from scratch.
+
+
+
+
+## Step 6: Build a Small "About Me" Page
+
+Let's practice a bit more by expanding the page into something more personal. Replace the content inside your `` with the following, and feel free to change the details to describe yourself:
+
+```html title="index.html"
+
+
+
+
+
+ About Me
+
+
+
Hi, I'm Alex ๐
+
+
+
+
+ I am learning web development with
+ CodeHarborHub, starting with HTML.
+
+>
+
+
+Notice the new elements you just used:
+
+| Tag | Purpose |
+|-----|---------|
+| `` | Displays an image. `src` points to the file or URL, and `alt` describes it. |
+| `` | Marks text as important, usually shown in bold. |
+| `