# Week 1

This week, we're starting with HTML and CSS. We'll use them to build a personal page with a heading, a picture, and some information about ourselves. We'll keep working on this page over the next few weeks, adding JavaScript and learning how to share changes through GitHub.

Later, we'll use what we've learned to build one shared Blueprint merch site. Teams will receive different tasks for that site. A product page needs a name, a picture, and a description, so a lot of what we do today will also apply there.

![week-01-preview.png](https://wiki.sitblueprint.com/uploads/images/gallery/2026-09/week-01-preview.png)

This is the page we'll be making. You can replace the example's name and interests with your own as we go.

## HTML and CSS

HTML describes the content and structure of a web page. It tells the browser which text is a heading, which text belongs in a paragraph, and where to place an image. CSS controls how that content looks, including its colors, font, and spacing.

[![image.png](https://wiki.sitblueprint.com/uploads/images/gallery/2026-09/scaled-1680-/image.png)](https://wiki.sitblueprint.com/uploads/images/gallery/2026-09/image.png)

For example, if we wanted to add a button to our page, we would use HTML to create the button and give it a label. We could then use CSS to change its color. Next week, we'll use JavaScript to make something happen when a button is clicked.

## Getting started

If you haven't set up your editor yet, follow the [setup checklist](https://wiki.sitblueprint.com/books/tech-team/page/setup). It also has a browser option if you can't install the editor.

1. Create a folder called `<span class="editor-theme-code">practice-page</span>` somewhere you can find again.
2. Open the folder in your editor and create two empty files, `<span class="editor-theme-code">index.html</span>` and `<span class="editor-theme-code">styles.css</span>`.
3. Save the supplied [avatar image](https://wiki.sitblueprint.com/attachments/17) into that folder as `<span class="editor-theme-code">avatar.svg</span>`. If the link opens the picture, use the browser's save option or ask for help downloading it.

The file endings matter. `<span class="editor-theme-code">index.html</span>` contains our HTML, and `<span class="editor-theme-code">styles.css</span>` contains our CSS. Make sure the editor hasn't added `<span class="editor-theme-code">.txt</span>` to either name.

When you edit a file, you need to save it before the browser can see your changes. Then refresh the browser to reload the saved version.

An HTML document has a `<span class="editor-theme-code">head</span>` and a `<span class="editor-theme-code">body</span>`. The `<span class="editor-theme-code">head</span>` contains information about the page, while the `<span class="editor-theme-code">body</span>` contains what people will see. Add this to `<span class="editor-theme-code">index.html</span>`:

```html
<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>My first page</title>
    <link rel="stylesheet" href="styles.css">
  </head>
  <body>
  </body>
</html>
```

Here, `<span class="editor-theme-code">title</span>` sets the text on the browser tab. The `<span class="editor-theme-code">link</span>` line tells the browser to load `<span class="editor-theme-code">styles.css</span>`, which is still empty. We'll add to it once we have some content on the page.

The other lines tell the browser how to read the document. `<span class="editor-theme-code"><!doctype html></span>` tells it to read the document as modern HTML, and `<span class="editor-theme-code">lang="en"</span>` says that the page is in English. `<span class="editor-theme-code">charset="utf-8"</span>` helps the browser read our letters, punctuation, and other text characters correctly. The viewport line makes the layout use the screen's width on mobile devices.

Save the file and open it in a browser. You should see a blank page with "My first page" on the tab. The page is blank because we haven't put anything inside the `<span class="editor-theme-code">body</span>` yet.

## HTML elements

HTML uses tags to describe content. For example, `<span class="editor-theme-code"><p></span>` begins a paragraph, and `<span class="editor-theme-code"></p></span>` ends it. The tags and the content between them make up an HTML element. The slash tells us which tag is the closing one.

We'll start with a heading and a paragraph. Add the following between `<span class="editor-theme-code"><body></span>` and `<span class="editor-theme-code"></body></span>`:

```html
<main>
  <h1>Hello, I'm Alex</h1>
  <p>I'm a student at Stevens.</p>
</main>
```

In this example, `<span class="editor-theme-code">main</span>` identifies the page's main content. Inside it, `<span class="editor-theme-code">h1</span>` marks the main heading, and `<span class="editor-theme-code">p</span>` marks a paragraph. The spaces at the start of the lines make it easier to see that the heading and paragraph are inside `<span class="editor-theme-code">main</span>`.

Headings also describe how the page is organized. We use `<span class="editor-theme-code">h1</span>` for the main heading, then `<span class="editor-theme-code">h2</span>` for headings within that page. This is helpful for screen readers, which read pages aloud. Someone using one can move between sections by their headings. If we want a heading to look different, we can change its CSS while keeping the right heading level.

Change Alex to your name, then save and refresh. You should see the heading change. Show the person next to you which part of the HTML you edited.

### Images and links

An image needs a little more information than a paragraph. We have to tell the browser where to find the image and provide text that describes it. Add this after the paragraph, before `<span class="editor-theme-code"></main></span>`:

```html
<img src="avatar.svg" alt="A blue smiling face" width="120" height="120">
<p>I like video games and photography.</p>
```

The extra information inside the opening tag is called an attribute. `<span class="editor-theme-code">src</span>` gives the image's location. Since `<span class="editor-theme-code">avatar.svg</span>` is in the same folder as `<span class="editor-theme-code">index.html</span>`, we can use its filename. `<span class="editor-theme-code">width</span>` and `<span class="editor-theme-code">height</span>` set its dimensions.

The `<span class="editor-theme-code">alt</span>` attribute provides a text alternative for the image. A screen reader can read it aloud, and the browser can display it if the image doesn't load. If you use a different picture, update this description to match. Unlike a paragraph, `<span class="editor-theme-code">img</span>` doesn't need a closing tag.

We can also add a link to another page. After the new paragraph, still before `<span class="editor-theme-code"></main></span>`, add:

```html
<a href="https://developer.mozilla.org/en-US/docs/Learn_web_development">MDN web development docs</a>
```

The `<span class="editor-theme-code">a</span>` element creates a link, and `<span class="editor-theme-code">href</span>` gives its destination. The words between the tags are what someone clicks. Here, the link takes us to MDN. It explains what HTML elements and CSS properties do and gives code examples. Giving the link a descriptive name helps someone know where it goes before opening it.

Save and refresh again. You should have a heading, two paragraphs, a picture, and a link. Try opening the link, then use the browser's Back button to return. Replace the interests sentence with something about yourself.

## CSS

So far, the browser has chosen the default font and spacing for our HTML. We can change those by writing CSS rules in `<span class="editor-theme-code">styles.css</span>`. Each rule selects part of the page and gives it a set of styles.

Open `<span class="editor-theme-code">styles.css</span>` and add:

```css
body {
  font-family: system-ui, sans-serif;
  background: #eef2ff;
  color: #172554;
  margin: 0;
  padding: 24px;
}
```

Here, `<span class="editor-theme-code">body</span>` is the selector. It tells the browser which element the rule applies to. Inside the braces, `<span class="editor-theme-code">{</span>` and `<span class="editor-theme-code">}</span>`, we write a property followed by its value. For example, in `<span class="editor-theme-code">color: #172554;</span>`, `<span class="editor-theme-code">color</span>` is the property and `<span class="editor-theme-code">#172554</span>` is the value. The colon separates them, and the semicolon marks the end.

This rule uses a system font, gives the page a pale background, and makes the text dark blue. The values beginning with `<span class="editor-theme-code">#</span>` are color codes. `<span class="editor-theme-code">margin: 0</span>` removes the body's default outside space, while `<span class="editor-theme-code">padding: 24px</span>` adds space inside it. This keeps the content away from the edge of the browser window. `<span class="editor-theme-code">px</span>` means CSS pixels, the units we're using for these sizes.

Save your files and refresh the browser. You should see the new colors and spacing. If the page still looks the same, check that the HTML links to `<span class="editor-theme-code">styles.css</span>` and that both files are in the same folder.

We can give `<span class="editor-theme-code">main</span>` its own styles as well. Add this below the first rule:

```css
main {
  max-width: 600px;
  margin: 0 auto;
  background: white;
  padding: 24px;
  border-radius: 16px;
}
```

Now the content sits inside a white card. `<span class="editor-theme-code">max-width</span>` stops the content area from becoming wider than 600 pixels. `<span class="editor-theme-code">margin: 0 auto</span>` gives it no top or bottom margin and uses automatic left and right margins to center it when there is room. The padding creates space inside the card, and `<span class="editor-theme-code">border-radius</span>` rounds its corners.

Try changing the padding in this rule from `<span class="editor-theme-code">24px</span>` to `<span class="editor-theme-code">48px</span>`. Before you refresh, think about which space should get larger. Compare the result, then change it back to `<span class="editor-theme-code">24px</span>`.

We can style the individual elements too. Add these rules below the others:

```css
h1 {
  color: #1d4ed8;
}

img {
  border-radius: 16px;
}

a {
  color: #1d4ed8;
}
```

The `<span class="editor-theme-code">h1</span>` rule changes the heading's color, the `<span class="editor-theme-code">img</span>` rule rounds the image's corners, and the `<span class="editor-theme-code">a</span>` rule changes the link's color. Each selector affects its matching element. If you changed the color in the `<span class="editor-theme-code">h1</span>` rule, would the paragraphs change too?

Keep the supplied colors for now. The dark text is readable against the pale and white backgrounds. Light text on a light background would be harder to read.

## Finding answers

Let's say we want the heading's text to be centered, but we want the paragraphs to stay as they are. We know where the heading's styles go, but we haven't learned which CSS property changes text alignment.

Search Google for `<span class="editor-theme-code">CSS center text W3Schools</span>` and open a result from `<span class="editor-theme-code">w3schools.com</span>`. Look for the property that controls text alignment and the value that centers it. Then add that property and value to the existing `<span class="editor-theme-code">h1</span>` rule in your CSS.

Save and refresh to see whether it worked. Only the heading's text should be centered. Compare your change with someone nearby and explain why you added it to `<span class="editor-theme-code">h1</span>`. If search isn't working, use the [W3Schools CSS text-align reference](https://www.w3schools.com/cssref/pr_text_text-align.php). You can also use the [MDN text-align reference](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/text-align) if you want a more detailed explanation.

You can use this approach whenever you need a property you haven't seen before. Start with the change you want to make, look for an example on W3Schools, and try it in your page. If you need more detail about how or why something works, check MDN. Check what the code does before adding more of it.

## Common problems

When something doesn't look right, start with the last thing you changed. Fixing one thing at a time makes it easier to tell what caused the problem.

<table id="bkmrk-what-you-see-what-to"><colgroup><col></col><col></col></colgroup><tbody><tr><th>What you see

</th><th>What to check

</th></tr><tr><td>Old words or colors

</td><td>Save the edited file, then refresh the correct browser tab.

</td></tr><tr><td>Raw HTML text instead of a page

</td><td>Check that the file is named `index.html`, and open it in a browser.

</td></tr><tr><td>Content appears, but none of the styling does

</td><td>Match `href="styles.css"` to the exact filename and folder.

</td></tr><tr><td>A broken picture

</td><td>Check that `avatar.svg` sits beside `index.html` and matches `src`.

</td></tr><tr><td>One CSS rule does nothing

</td><td>Check its selector, colon, semicolons, and both braces.

</td></tr><tr><td>Strange text or links

</td><td>Check that quotes and opening and closing tags are paired.

</td></tr></tbody></table>

Before next week

Save your work and keep the entire `<span class="editor-theme-code">practice-page</span>` folder. Next week, we'll add a button and use JavaScript to make it respond when clicked.

If you have time left, add a section called "Something I want to build" using `<span class="editor-theme-code">h2</span>` and a paragraph. Give the heading its own CSS rule.

The [completed example](https://wiki.sitblueprint.com/attachments/18) is available if you want to compare files or need help catching up. It includes the centered heading from the search exercise.

## Resources

Start with W3Schools for examples and quick references. Use MDN when you want a more detailed explanation or additional technical information.

### W3Schools

- [W3Schools: HTML Introduction](https://www.w3schools.com/html/html_intro.asp)
- [W3Schools: HTML Headings](https://www.w3schools.com/html/html_headings.asp)
- [W3Schools: HTML Images](https://www.w3schools.com/html/html_images.asp)
- [W3Schools: CSS Syntax](https://www.w3schools.com/css/css_syntax.asp)
- [W3Schools: CSS Padding](https://www.w3schools.com/css/css_padding.asp)
- [W3Schools: CSS text-align](https://www.w3schools.com/cssref/pr_text_text-align.php)

### MDN

- [MDN: HTML and document structure](https://developer.mozilla.org/en-US/docs/Learn_web_development/Getting_started/Your_first_website/Creating_the_content)
- [MDN: Heading elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/Heading_Elements)
- [MDN: Images](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/img)
- [MDN: CSS rules and styling](https://developer.mozilla.org/en-US/docs/Learn_web_development/Getting_started/Your_first_website/Styling_the_content)
- [MDN: Padding](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/padding)
- [MDN: text-align](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/text-align)

</body></html>