
Mini lesson 19 of 30 · Connect data and AI
Decide what the reader will learn
Who is this for?
People who want to publish writing on a small website. You can supply ordinary text while a coding assistant creates the page and links; HTML knowledge is not required.
A real article must sit behind the list card.
Purpose of this lesson
- Turn an ordinary draft into a readable article page.
- Connect it from the blog list with a usable direct address.
- Check reading and navigation without relying on client-side effects.
Explanation, worked example and practice
Before you start
The supplied three-article workshop and a coding assistant to open its local HTTP preview. No CMS account or personal project history is required; a provided small repair exercise can give you something real to write about.
Check your starting skills
These are useful skills, not locked course requirements. If you can already do them, start this lesson; otherwise open the linked preparation. The supplied starter files mean you do not need an existing personal website.
- How to build your first personal website
Create an introduction, project section and contact route from a supplied starter.
Estimated time: 19–31 min
Estimates for the supplied starter files with prerequisite accounts and tools ready. Setup, deployment queues and delivery/DNS waits take additional time. Writing and editorial review can take longer than wiring the HTML.
Understand the idea
Open the supplied blog and its three sample posts. Choose one small useful subject. If you have no previous project, perform the supplied contact-link repair exercise and write about what you actually did.
Keep fictional practice writing labeled. A card and empty destination are not a published explanation.
A concrete example
A short account of a reproduced problem, repair and check can teach more than a vague opinion.
Use the supplied blog files. Turn my ordinary text into one new readable article with a clear title, honest byline/date, useful opening and return link. Add its matching index entry without replacing the existing posts. Handle the HTML and styling paths. Show the direct page and help test reading, return navigation and a narrow screen.Files for this step
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Try it yourself
What will your new article explain, and what evidence or real exercise supports it?
Show a worked solution
Illustrative article plan: “I will explain how a mismatched page link can be found, repaired and checked. I will use the supplied repair exercise, so the article will say it is a fictional practice case.”
My reader should leave knowing what failed, what changed and which visitor action checked the repair. A claim such as “I fixed this for a client” would invent history that the supplied exercise does not establish.
What a sound answer includes
- Chooses a specific subject and explains the truthful experience or supplied exercise behind it.
- Keeps a fictional practice case labeled rather than claiming it as personal project history.
How it works (optional)
Add a blog people can actually read
Start with a complete article and a reliable way to find it.
A blog is more than a grid of cards. Each article needs a clear subject, readable body, author/date and an address that another person can open directly.
This workshop supplies three short teaching posts, an index and return links. They use HTML so the writing is available without running browser JavaScript. The author is deliberately a fictional practice label.
Worked example
Open public/blog/test-one-task.html. Its first paragraph proposes a concrete visitor task, then explains what to observe and what to change. The card summary helps people choose it; it does not replace the article.
Extra implementation exercise
A card says “Read more”, but its link opens the same empty page for every article. What is missing?
Show a worked solution
Each card needs a real article at its own stable URL. Give that page a useful body and a route back to the index.
- Requires a distinct working article address.
- Requires substantive body content.

Step 1 · How to add a blog to your website
Have the assistant create the article
Supply text and judge the reading result.
Explanation, worked example and practice
Understand the idea
Give the assistant your title, opening and body text. Ask it to use the supplied article structure, keep author/date truthful and preserve the existing blog style and return route.
Open the new article directly and read it. Check that text and styling appear correctly, including on a narrow screen. You do not need to edit the HTML structure yourself.
A concrete example
A copied article one folder deeper can lose its styling if its paths are wrong.
Files for this step
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Try it yourself
Does the direct new article show the intended content and readable presentation?
Show a worked solution
Illustrative article result: “The new page opens directly with the title Fix a mismatched page link, a labeled practice byline and a body describing the failure, repair and retest. Its text remains readable in a narrow view.”
A partial result could be “The article text appears, but its stylesheet is missing on the direct URL.” That calls for a focused file-path repair, not a claim that the page is finished.
What a sound answer includes
- Opens the new article directly and checks its title, body, truthful byline/date and styling.
- Records a narrow-screen reading result or a specific missing-content/path issue.
How it works (optional)
Make the article structure repeatable
Reuse presentation while keeping each article's meaning specific.
Inspect the article HTML: one h1, a byline, a machine-readable time, an opening summary and body paragraphs. Its stylesheet path goes up one directory because the article sits inside blog/.
Keep a descriptive slug stable after sharing. If you rename a published URL, add a redirect rather than leaving inbound links broken. Publication dates should reflect actual publication, not automatically change on every build.
In ../index.html, '..' moves up from blog/ to the parent site folder. The same rule makes ../style.css reach the shared stylesheet. If you add another nesting level, work out the destination from the article's actual folder rather than copying a path by appearance.
Worked example
A relative link ../index.html returns from blog/test-one-task.html to the index. Copying index.html without the ../ would look for a different page inside blog/.
<time datetime="2026-11-15">15 November 2026</time>
<a href="../index.html">All notes</a>Extra implementation exercise
Why can a stylesheet work on the blog index but fail on an article copied one directory deeper?
Show a worked solution
A relative style.css now points inside blog/. Use ../style.css for this folder layout or a correct site-root path, then verify the request returns CSS.
- Resolves paths relative to the article location.
- Checks the actual stylesheet request.

Step 2 · How to add a blog to your website
Connect the list and return route
Check the same path a reader will use.
Explanation, worked example and practice
Understand the idea
Ask the assistant to add a unique title, short summary and link for the new post on the blog index. Follow that link, then the article’s return link.
Each card should open its own substantive article. A small file-based blog is enough unless your real editing workflow needs another tool.
A concrete example
Three articles alone do not require a CMS; a nontechnical publishing workflow might.
Files for this step
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Try it yourself
What happened when you opened the new card and returned to the list?
Show a worked solution
Illustrative navigation record: “The fourth list entry opens my new repair article, while the other three entries still open their original posts. All notes on the new article returns to the blog index.”
If the new entry opens an empty page or the wrong existing post, the route failed even if its title looks right. The article must contain the explanation promised by its summary.
What a sound answer includes
- Follows the new list entry to the correct substantive article.
- Uses the article’s return link to reach the intended blog list.
How it works (optional)
Choose tools when the workflow needs them
A CMS is valuable when it solves an editorial problem you actually have.
For a few posts maintained by one person, files and Git can be enough. A static generator such as Astro can reduce duplicated templates as the archive grows.
A CMS can help multiple editors, drafts, asset management and nontechnical publishing. It also adds access control and operating dependencies. Compare against your publishing workflow, not a list of fashionable stacks.
Worked example
If an editor cannot use Git but must publish independently, a CMS addresses a real need. If one author posts occasionally, introducing an editor backend may add work before it saves any.
Extra implementation exercise
Which would justify a CMS more clearly: having three articles, or needing a nontechnical editor to manage drafts?
Show a worked solution
The nontechnical editor requirement is stronger evidence. Article count alone does not tell you whether a CMS improves the workflow.
- Uses an actual workflow requirement.
- Acknowledges additional operational complexity.

Step 3 · How to add a blog to your website
Publish one complete explanation
Finish both the writing and the navigation.
Explanation, worked example and practice
Understand the idea
Complete the fourth article and its list entry. Ask someone to describe its main point from the opening, or do a careful fresh read yourself. Use the complete reference as a comparison after your attempt.
Try the direct URL, list link, stylesheet and return route. Keep actual test observations separate from the reference’s expected behavior.
A concrete example
The article should still contain meaningful writing when fancy browser effects are unavailable.
Files for this step
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- public/blog/test-one-task.htmlDownload this file
- public/index.htmlDownload this file
- publication-checklist.txtDownload this file
- worksheet.htmlDownload this file
- reference/assignment-walkthrough.txtDownload this file
- reference/public/index.htmlDownload this file
- reference/public/blog/contact-anchor-check.htmlDownload this file
Try it yourself
Provide your article and the observed reading/navigation checks.
What to produce: The new article, working list entry and observed direct-open/read/return checks.
Show a worked solution
Illustrative handoff: “The fourth article explains one link failure, the small repair and the repeated visitor action. It is labeled as practice, has a matching index entry and opens directly with its stylesheet. The list-to-article and All notes return routes worked; narrow-screen reading was checked.”
If no other reader was available, say “I did a fresh self-read; an independent reader check was not run.” A complete record shows what was tested rather than claiming another person understood the article without observing them.
What a sound answer includes
- Provides a complete fourth article and its matching list entry with truthful practice context.
- Records direct-page, list, return-link and reading checks, marking any unrun check.
How it works (optional)
Your assignment: publish one useful explanation
Write a specific lesson from your own work, with an example a reader can follow.
Add a fourth article explaining one problem you actually solved. Include the starting situation, the change and how you checked it. Use a small concrete example, not a fictional experience presented as yours.
Add its index entry and verify direct opening, stylesheet loading and return navigation. Ask someone to describe the article's main point after reading the opening.
Worked example
“I reduced an image from an oversized original to responsive sources and checked the downloaded file” teaches more than “Performance is important”. Your numbers must come from your own measurement.
The complete reference walkthrough is available in reference/assignment-walkthrough.txt. Compare its steps with your own result; fill the test record from observations in your own project.
Extra implementation exercise
Produce the fourth article and a working index entry.
Show a worked solution
Use the complete reference fourth article as a structural example: it explains how a mismatched contact anchor is diagnosed, changed and retested. It is explicitly a fictional practice case, not your or Emre's personal history.
For your submission, choose a problem you actually solved. Describe the starting symptom, exact change and observed check in your own words. Keep a truthful byline/date and a stable filename; then add the article's title/summary/link to the index.
Open the article directly with JavaScript disabled, verify the stylesheet and use its return link. A working card without substantive article content is not complete.
- Contains a specific example and an accurate author/date.
- Direct URL, styling and return navigation work without JavaScript.
Was this lesson useful?
Leave a like, or share it with someone who could use it.