diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..266adbc --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,5 @@ +# Regler for dette projekt + +- Al tekst på siden, i filnavne og i commit-beskeder er på dansk. +- Siden er ren HTML, CSS og lidt JavaScript. Ingen frameworks, ingen build-trin. +- Hver ændring laves på sin egen gren og som en pull request, så den kan godkendes før den rammer `main`. diff --git a/README.md b/README.md index c803af7..23bdbe4 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,14 @@ # Personlig hjemmeside -Skoleprojekt 2026. Én `index.html` med indlejret CSS, alt indhold på dansk. +Skoleprojekt 2026. Alt indhold er på dansk. + +## Filer + +- `index.html` – forsiden med navn og tre linjer om mit arbejde +- `projekter.html` – underside med et udvalg af projekter +- `stil.css` – fælles stil for begge sider (rolig palet, lyst og mørkt tema) +- `tema.js` – knappen, der skifter mellem lyst og mørkt tema +- `TEKNIK.md` – kursets fire tekniske spor dokumenteret på min egen opsætning +- `CLAUDE.md` – projektets tre regler til Claude Code Åbn `index.html` i en browser for at se siden. diff --git a/TEKNIK.md b/TEKNIK.md new file mode 100644 index 0000000..f28ecbd --- /dev/null +++ b/TEKNIK.md @@ -0,0 +1,194 @@ +# Til de tekniske: de fire spor dokumenteret på min egen opsætning + +Kurset *AI i praksis* har fire valgfri spor for de tekniske: terminal og git, +Claude Code i terminalen, webhooks og en lokal sprogmodel. Jeg kører i forvejen +alle fire ting til daglig på mit eget hjemmelab, så i stedet for kursets +eksempler dokumenterer jeg her, hvordan jeg gør, og hvad kursets øvelser svarer +til hos mig. Alle kommandoer og alt output herunder er kørt rigtigt den 28. oktober 2026. + +Mit setup er en del større, end opgaven kræver. Det er med vilje: pointen er at +vise, at kursets fire byggeklodser er præcis de samme, uanset om de kører i +skyen eller på en server i kælderen. + +## Spor A: Terminalen og git + +**Kurset:** installér git, klon kursets repo fra GitHub, kig på historikken med +`git log`, lav en ændring og se den med `git status` og `git diff`. + +**Hos mig:** jeg bruger ikke GitHub til min egen kode. Jeg kører min egen +git-server, [Gitea](https://about.gitea.com/), i en container på min +Proxmox-server. Den har samme funktioner som GitHub (repos, pull requests, +issues), men data bliver hjemme. Dette repo ligger der. + +``` +$ git --version +git version 2.55.0 + +$ git clone https://git.powerdata.dk/masterdraco/personlig-hjemmeside.git +$ cd personlig-hjemmeside +$ git log --oneline --all +a3d9aab docs: README beskriver de nye filer +25b4ca3 feat: mørkt tema med knap, valget huskes i browseren +be57940 feat: underside med projekter og fælles stil.css +7de0837 feat: personlig hjemmeside som enkelt index.html +``` + +Historikken ovenfor er hele denne hjemmesides tilblivelse. Hvert commit svarer +til ét forslag (pull request), som jeg har godkendt på Gitea. + +**Hvad jeg bruger ud over kursets fire kommandoer:** + +- `git checkout -b feature/navn` laver en gren, så en ændring kan bedømmes for sig. +- `git push -u origin feature/navn` sender grenen op, og Gitea tilbyder straks at lave en pull request. +- Gitea har et API, så en pull request kan oprettes fra terminalen med `curl`, uden at åbne browseren. + +**Lært:** git er det samme, uanset hvor serveren står. GitHub er bare én +udbyder af git-hosting. Når man selv kører serveren, lærer man samtidig, hvad +der ligger under: en mappe med commits og en webflade ovenpå. + +## Spor B: Claude Code i terminalen + +**Kurset:** installér Claude Code med npm, stil dig i repo-mappen, giv agenten en +lille opgave på dansk og godkend dens forslag. Skriv en `CLAUDE.md` med tre +linjer om projektets regler. + +**Hos mig:** hele denne hjemmeside er bygget med Claude Code i terminalen, ikke +via browseren. Jeg gav opgaven på dansk, og agenten læste, skrev og testede +filerne, tog skærmbilleder af siden i en browser og lavede derefter én gren og +én pull request pr. opgave, som jeg selv godkender. + +``` +$ node --version +v26.12.1 +$ claude --version +2.1.312 (Claude Code) +``` + +Projektets `CLAUDE.md` ligger i roden af dette repo og har tre regler: alt på +dansk, ingen frameworks, og hver ændring som en pull request. Agenten læser den +automatisk, hver gang den starter i mappen. + +Derudover har jeg en global `CLAUDE.md` i min hjemmemappe. Den fortæller +agenten om hele mit hjemmelab: hvor min git-server er, at den aldrig må pushe +til GitHub, hvilke lokale sprogmodeller den kan bruge til kodegenerering, og +hvor min videnbank ligger. Det er "medarbejderhåndbogen" fra kurset, bare på +et par hundrede linjer i stedet for tre. + +**Lært:** arbejdsdelingen er den samme som i kurset: mål ind, forslag ud, +menneske i midten. Forskellen i terminalen er, at man ser hvert værktøjskald, +og at agenten kan bruge alt det, man selv har adgang til fra terminalen (git, +curl, ens egne servere). + +## Spor C: Webhooks + +**Kurset:** lav et Google Apps Script med en `doPost`, udrul det som webapp, og +kald det med `curl`. Scriptet sender en mail med det, der blev sendt. + +**Hos mig:** jeg kører [n8n](https://n8n.io/), et selvhostet flow-værktøj, på +mit hjemmelab. Det bruger jeg til daglig til at koble ting sammen: mails der +klassificeres af en lokal sprogmodel, besked til min telefon når noget sker på +en overvågning, og automatiske rapporter. Under hvert eneste af de flows ligger +en webhook. + +Til dokumentationen lavede jeg et flow på to knuder: en *Webhook*-knude, der +lytter på `/webhook/kursus-test`, og en *Respond to Webhook*-knude, der svarer +med det, den fik. Flowet blev oprettet gennem n8n's API fra terminalen, +aktiveret, kaldt og slettet igen. + +``` +$ curl -X POST -H "Content-Type: application/json" \ + -d '{"besked":"hej fra terminalen"}' \ + https://MIN-N8N-SERVER/webhook/kursus-test +{"ok":true,"modtaget":{"besked":"hej fra terminalen"}} +``` + +Kursets Apps Script og min n8n-knude gør det samme: en adresse plus kode, der +kører ved kald. Forskellen er, at n8n giver en grafisk flade til at hænge de +næste trin på (send mail, kald en sprogmodel, skriv i et regneark), og at det +hele kører på min egen maskine. + +**Lært:** en webhook er den mindste fællesnævner for al automatisering. Kan man +den, kan man koble næsten alt sammen, og man kan altid teste den med `curl` +før man bygger videre. + +## Spor D: Kør en sprogmodel på din egen maskine + +**Kurset:** installér LM Studio, hent en lille åben model, chat med den uden +wifi, start den lokale server og tal med den via `curl`. + +**Hos mig:** jeg kører to lokale sprogmodel-servere, begge med samme slags +API som kurset viser (OpenAI-kompatibelt `/v1/chat/completions`): + +1. **På min arbejdscomputer:** [llama.cpp](https://github.com/ggml-org/llama.cpp) + med modellen `qwen2.5-coder:7b` på grafikkortet (AMD RX 9070 XT via Vulkan). + Den kører som en systemd-tjeneste, jeg kan starte og stoppe. Claude Code + bruger den til at generere kode, så jeg sparer cloud-tokens. +2. **På hjemmeserveren:** [Ollama](https://ollama.com/) med et dusin større + modeller (bl.a. Gemma 4 i 31B og en Qwen3 i 32B), som mine automatiseringer + og min videnbank kalder. + +Kursets curl-kommando, kørt uændret mod min lokale llama.cpp-server: + +``` +$ curl http://localhost:8080/v1/chat/completions -H "Content-Type: application/json" \ + -d '{"messages":[{"role":"user","content":"Forklar hvad en webhook er, på dansk, i to sætninger"}]}' +``` + +Svar (78 tokens på 0,79 sekunder, altså omkring 100 tokens i sekundet): + +> En webhook er en måde, hvor et system automatisk sender en HTTP-besked til et +> andet system, når en bestemt begivenhed sker. Det gør det muligt for +> programmer og systemer at interagere og opdatere hverandre i realtid, uden at +> bruge traditionelle metoder for at anmode om opdateringer. + +Kursets sammenligning med en cloudmodel, ud fra min daglige brug: + +| | Lokal 7B-model (llama.cpp) | Lokal 26–32B-model (Ollama) | Cloudmodel (Claude) | +|---|---|---|---| +| Hastighed | Meget hurtig, ~100 tok/s | Langsom, flere minutter på lange svar | Hurtig | +| Kvalitet | God til afgrænset kode | God til resonnering og dansk | Bedst, især til lange opgaver | +| Dansk | Brugbart, små fejl ("hverandre") | Godt | Fejlfrit | +| Pris | Strøm | Strøm + et dyrt grafikkort | Abonnement pr. måned | +| Data | Forlader aldrig huset | Forlader aldrig huset | Sendes til udbyderen | + +**Lært:** en sprogmodel er en fil plus et program, der kører den. API'et er en +aftale, og den aftale er den samme for LM Studio, llama.cpp, Ollama og +cloududbyderne. Derfor kan man bytte model uden at skrive sin kode om. Det er +det stærkeste argument i enhver snak om databeskyttelse: man kan rent faktisk +beholde data hjemme, og det koster hastighed og kvalitet, ikke muligheder. + +## Bonus: min egen udgave af GitHub Pages + +Kursets side ligger på GitHub Pages, så repoet også er en hjemmeside. Gitea har +ikke den funktion indbygget, så jeg byggede den selv på hjemmelabbet, og den +viser i øvrigt alle fire spor i brug på én gang: + +1. **En lille container** (Debian) med webserveren nginx, der serverer mappen + med repoet. Repoet blev hentet med `git clone` (spor A). +2. **En webhook** (spor C) på containeren, lavet med det lille program + `webhook`. Når Gitea sender et push-signal, tjekker den signaturen og kører + `git pull`. Siden er opdateret få sekunder efter, at en pull request er + godkendt. +3. **Min reverse proxy** (Nginx Proxy Manager) sender `michael.powerdata.dk` + videre til containeren med et wildcard-certifikat, så siden har https. +4. **Hele opsætningen blev lavet af Claude Code i terminalen** (spor B): + containeren oprettet, pakker installeret, webhook registreret gennem + Giteas API og proxy-host oprettet gennem proxyens API. Sprogmodellen i spor + D er ikke med her, men den sidder i samme hjemmelab og kaldes af de samme + webhooks i n8n. + +Resultatet: https://michael.powerdata.dk, som opdaterer sig selv, når +noget rammer `main` i dette repo. Samme idé som GitHub Pages, bare på en +server i kælderen. Gitea kunne i første omgang ikke kalde webhooken, fordi den +som standard nægter at sende til private netværksadresser, så den indstilling +måtte slås til. Det er en god sikkerhedsregel, og et godt eksempel på, at +"det virker ikke" tit er "det er beskyttet". + +## Hvad de fire spor har til fælles + +Alle fire spor handler om det samme: at komme et lag ned under den grafiske +flade og se, at der ligger noget simpelt og genbrugeligt. Git er en mappe med +historik. Agenten er et program, der kalder værktøjer. En webhook er en adresse +med kode bag. En sprogmodel er en fil med et API foran. Når man kører tingene +selv, bliver det tydeligt, at skyen bare er en anden, der kører de samme fire +ting for én. diff --git a/index.html b/index.html index cd40502..ed3a9b7 100644 --- a/index.html +++ b/index.html @@ -9,125 +9,63 @@ - + +

Michael Laursen

Nørre Aaby, Fyn

- + + +
+

Det arbejder jeg med

+ +
+ +
+

Sjove detaljer

+ +

Skriv til mig på michael@bay-laursen.dk.

- + - + diff --git a/projekter.html b/projekter.html new file mode 100644 index 0000000..2d064e7 --- /dev/null +++ b/projekter.html @@ -0,0 +1,62 @@ + + + + + + Projekter – Michael Laursen + + + + + + + + + +
+

Projekter

+

Et udvalg af det, jeg bruger min tid på.

+ + + + +
+ + + + + + diff --git a/stil.css b/stil.css new file mode 100644 index 0000000..c71ba50 --- /dev/null +++ b/stil.css @@ -0,0 +1,245 @@ +:root { + --taage: #edf1f2; /* baggrund */ + --flade: #f7f9f9; /* lys flade */ + --blaek: #223036; /* tekst */ + --graa: #5f6f75; /* sekundær tekst */ + --soe: #4c7a80; /* accent */ + --lys-soe: #b9cdd0; /* landskab */ + --bakke-bag: #d3dfe1; + --bakke-midt: #b9cdd0; + --bakke-for: #9bb6ba; +} + +/* Mørkt tema: valgt med knappen, eller fra systemet hvis intet er valgt */ +:root[data-theme="dark"] { + --taage: #1b2428; + --flade: #222e33; + --blaek: #e6ecee; + --graa: #9fb0b5; + --soe: #8fbcc2; + --lys-soe: #2d3f45; + --bakke-bag: #243338; + --bakke-midt: #2d3f45; + --bakke-for: #395057; +} + +@media (prefers-color-scheme: dark) { + :root:not([data-theme="light"]) { + --taage: #1b2428; + --flade: #222e33; + --blaek: #e6ecee; + --graa: #9fb0b5; + --soe: #8fbcc2; + --lys-soe: #2d3f45; + --bakke-bag: #243338; + --bakke-midt: #2d3f45; + --bakke-for: #395057; + } +} + +* { box-sizing: border-box; } + +html, body { margin: 0; min-height: 100%; } + +body { + background: var(--taage); + color: var(--blaek); + font-family: "Instrument Sans", system-ui, -apple-system, "Segoe UI", sans-serif; + font-size: 1.125rem; + line-height: 1.6; + display: flex; + flex-direction: column; + min-height: 100vh; +} + +main { + flex: 1; + width: min(38rem, 100% - 2rem); + margin: 0 auto; + padding: clamp(4rem, 14vh, 9rem) 0 4rem; +} + +h1 { + font-size: clamp(2.4rem, 7vw, 4rem); + font-weight: 400; + line-height: 1.05; + letter-spacing: -0.02em; + margin: 0 0 0.5rem; +} + +.rolle { + color: var(--graa); + margin: 0 0 1.5rem; +} + +.menu { + display: flex; + gap: 1.5rem; + margin: 0 0 3rem; +} + +.menu a[aria-current="page"] { + color: var(--blaek); + text-decoration: none; +} + +.projekter { + list-style: none; + margin: 0; + padding: 0; + display: grid; + gap: 1.75rem; +} + +.projekter h2 a { + color: var(--blaek); + text-decoration-color: var(--soe); +} + +.projekter h2 { + font-size: 1.25rem; + font-weight: 500; + margin: 0 0 0.25rem; +} + +.projekter p { + margin: 0; + color: var(--graa); + max-width: 32rem; +} + +section + section { + margin-top: 2.5rem; +} + +section h2 { + font-size: 1rem; + font-weight: 500; + color: var(--graa); + margin: 0 0 0.75rem; +} + +.arbejde { + list-style: none; + margin: 0; + padding: 0; + border-left: 3px solid var(--soe); +} + +.arbejde li { + padding: 0.4rem 0 0.4rem 1.25rem; + max-width: 32rem; +} + +.detaljer { + list-style: none; + margin: 0; + padding: 0; + display: grid; + gap: 0.9rem; +} + +.detaljer li { + max-width: 34rem; + padding-left: 1.25rem; + position: relative; +} + +.detaljer li::before { + content: ""; + position: absolute; + left: 0; + top: 0.65em; + width: 0.5rem; + height: 0.5rem; + border-radius: 50%; + background: var(--soe); +} + +.kontakt { + margin-top: 3rem; + color: var(--graa); +} + +a { + color: var(--soe); + text-decoration-thickness: 1px; + text-underline-offset: 3px; +} + +a:focus-visible { + outline: 2px solid var(--soe); + outline-offset: 3px; + border-radius: 2px; +} + +.scene { + position: relative; + margin-top: auto; +} + +.bakker { + display: block; + width: 100%; + height: clamp(90px, 14vw, 180px); +} + +.bakke-bag { fill: var(--bakke-bag); } +.bakke-midt { fill: var(--bakke-midt); } +.bakke-for { fill: var(--bakke-for); } + +.rotte { + position: absolute; + right: 8%; + bottom: 4%; + width: clamp(54px, 7vw, 96px); + color: var(--blaek); + display: block; +} + +.rotte svg { display: block; width: 100%; height: auto; fill: currentColor; } +.rotte .oeje { fill: var(--taage); } + +.rotte:hover .hale, +.rotte:focus-visible .hale { + d: path("M27 44 C8 40, 4 26, 22 24"); +} + +@media (prefers-reduced-motion: no-preference) { + .rotte .hale { transition: d 0.4s ease; } +} + +footer p { + margin: 0; +} + +footer a { + color: var(--blaek); + text-decoration-color: var(--soe); +} + +footer { + background: var(--bakke-for); + color: var(--blaek); + font-size: 0.9rem; + padding: 1rem 1rem 1.5rem; + text-align: center; +} + +.tema-knap { + display: inline-block; + margin-top: 0.75rem; + padding: 0.35rem 0.9rem; + font: inherit; + font-size: 0.9rem; + color: var(--blaek); + background: transparent; + border: 1px solid var(--soe); + border-radius: 999px; + cursor: pointer; +} + +.tema-knap:focus-visible { + outline: 2px solid var(--soe); + outline-offset: 3px; +} diff --git a/tema.js b/tema.js new file mode 100644 index 0000000..d80288b --- /dev/null +++ b/tema.js @@ -0,0 +1,28 @@ +// Mørkt/lyst tema. Valget gemmes i browseren; uden valg følges systemet. +(function () { + var rod = document.documentElement; + var gemt = null; + try { gemt = localStorage.getItem('tema'); } catch (fejl) { /* privat vindue mv. */ } + if (gemt === 'dark' || gemt === 'light') { rod.dataset.theme = gemt; } + + function erMoerk() { + if (rod.dataset.theme) { return rod.dataset.theme === 'dark'; } + return window.matchMedia('(prefers-color-scheme: dark)').matches; + } + + function opdaterKnap(knap) { + knap.textContent = erMoerk() ? 'Skift til lyst tema' : 'Skift til mørkt tema'; + } + + document.addEventListener('DOMContentLoaded', function () { + var knap = document.querySelector('[data-tema-knap]'); + if (!knap) { return; } + opdaterKnap(knap); + knap.addEventListener('click', function () { + var nyt = erMoerk() ? 'light' : 'dark'; + rod.dataset.theme = nyt; + try { localStorage.setItem('tema', nyt); } catch (fejl) { /* ignorer */ } + opdaterKnap(knap); + }); + }); +})();