Skip to content

Commit 5b4a709

Browse files
author
Matteo Menapace
committed
Content first
1 parent 2b93a83 commit 5b4a709

File tree

1 file changed

+64
-37
lines changed

1 file changed

+64
-37
lines changed

README.md

Lines changed: 64 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ The aims of today are:
1515

1616
* Organise your work to **tell the story** of your projects
1717
* Start building an **online one-page portfolio** for your work
18-
* Learn **HTML & CSS**
18+
* [Learn **HTML & CSS**](#html-css-crash-course)
1919
* **Publish and host** your portfolio online
2020

2121
Bringing storytelling and coding together to make something that is useful to you, today.
@@ -47,13 +47,13 @@ The **demo** is at [j.mp/html-css-portfolio-demo](http://j.mp/html-css-portfolio
4747

4848
## Step by step
4949

50-
Go to [thimble.mozilla.org](https://thimble.mozilla.org/) and sign up (it's free).
50+
> Go to [thimble.mozilla.org](https://thimble.mozilla.org/) and sign up (it's free).
5151
52-
Then log in and click on `Start a project from scratch`.
52+
> Then log in and click on `Start a project from scratch`.
5353
5454
### 1. Content first
5555

56-
It's good practice to build the **HTML** first, and then make it _stylish_ with CSS. Aka *content first*.
56+
It's good practice to build the **HTML** first, and then make it _stylish_ with CSS. This approach is called *content first*.
5757

5858
#### HTML skeleton
5959

@@ -75,64 +75,88 @@ Every HTML document, at the bare bones, needs to have this structure
7575

7676
#### Head
7777

78-
In the `head` we can change the `title`.
78+
> In the `head` you can change the `title`.
7979
80-
Later, we'll add links to external resources like *stylesheets* and *meta* information.
80+
Later, you'll add links to external resources like *stylesheets* and *meta* information.
8181

8282
What you put in the `head` is not visible in the page.
8383

8484
#### Body
8585

86-
We're dividing our page into sections, so let's create a few empty `section` tags inside the `body`.
86+
We're dividing our page into sections.
87+
88+
> Create a few empty `section` tags inside the `body`.
8789
88-
```html
89-
<section></section>
90-
<section></section>
91-
<section></section>
92-
<section></section>
93-
<section></section>
90+
> ```html
91+
...
92+
<body>
93+
<section></section>
94+
<section></section>
95+
<section></section>
96+
<section></section>
97+
<section></section>
98+
</body>
99+
</html>
94100
```
95101
96102
#### Headings
97103

98-
In the first section we'll add a `div`. Inside that, we'll add a **heading** (`h1`) and a **sub-heading** (`h2`). These will be the most important pieces of information in your page.
99-
100-
```html
101-
<section>
102-
<div>
103-
<h1>Your name</h2>
104-
<h2>Your specialties, eg: film maker</h2>
105-
</div>
106-
</section>
104+
> In the **first section** add a `div`. Inside that, add a **heading** (`h1`) and a **sub-heading** (`h2`).
105+
106+
> ```html
107+
...
108+
<body>
109+
<section>
110+
<div>
111+
<h1>Your name</h2>
112+
<h2>Your specialties, eg: film maker</h2>
113+
</div>
114+
</section>
115+
...
107116
```
108117
118+
These will be the most important pieces of information in your page (for search engines like Google).
119+
109120
#### Images
110121

111-
In that same `div`, underneath the headings, we can add an **image** which could serve as a logo or a profile picture.
112-
113-
```html
114-
<img src="profilepic.jpg" alt="Describe this image">
122+
Images are worth thousands of words, they say. So let's upload one to start with.
123+
124+
> To upload an image to Thimble, click on the green `+` on the top-left and the `Upload...`
125+
126+
The **image** to upload could be your logo or your profile picture.
127+
128+
> Once you've uploaded your picture, in that same `div`, underneath the headings, add an `<img>` code and set its `src` (source) to your image file, like so
129+
130+
> ```html
131+
...
132+
<h2>Your specialties, eg: film maker</h2>
133+
<img src="YOUR_IMAGE_FILE.jpg" alt="DESCRIBE THIS IMAGE">
134+
</div>
135+
...
115136
```
116137
117138
#### Text
118139

119-
We'll have two sections with **textual content**, so let's write something in there.
140+
> In the second section we'll have **textual content**, so let's write something in there.
120141
121-
```html
142+
> ```html
143+
...
144+
<section> ... this is the first section ... </section>
122145
<section>
123146
<p>Write something here to introduce your project and the ideas behind it.</p>
124147
<p>A little information about the process you took from research through to the development.</p>
125148
<p>You process is important!</p>
126149
</section>
150+
...
127151
```
128152
129153
`p` is for *paragraph*.
130154

131155
#### Hyperlinks
132156

133-
We can add **hyperlinks** to our content using the `a` element (`a` is for *anchor*).
157+
> Add **hyperlinks** to your content using the `a` element (`a` is for *anchor*).
134158
135-
```html
159+
> ```html
136160
<a href="http://example.com">the clickable text</a>
137161
```
138162
@@ -145,15 +169,18 @@ For instance:
145169

146170
#### Contact details
147171

148-
Let's add our **contact details** to the final section.
172+
> Add your **contact details** to the last section.
149173
150174
```html
151-
<section>
152-
<div>
153-
<h2>Say hello!</h2>
154-
<p>aimeebethmj@gmail.com</p>
155-
</div>
156-
</section>
175+
...
176+
<section>
177+
<div>
178+
<h3>Say hello!</h3>
179+
<p>YOUR_EMAIL@example.com</p>
180+
</div>
181+
</section>
182+
</body>
183+
</html>
157184
```
158185

159186
### 2. Style later

0 commit comments

Comments
 (0)