Persönliche Website einrichten
Begleite einen neuen Nutzer dabei, sein eigenes Portfolio unter https://<ihr-benutzername>.github.io zu veröffentlichen. Die Architektur ist festgelegt; das Aussehen, die Texte und die Chatbot-Persönlichkeit werden alle an den jeweiligen Nutzer angepasst.
Was sie bekommen
- Statische Einzelseite, kein Bundler. GitHub Pages serviert
mainaus dem Repository-Stammverzeichnis. - Hero-Bereich — ihr Porträt + Name + einzeiliger Standort + einzeiliger Slogan.
- Projekte-Bereich mit einer abgeblendeten vertikalen Zeitleiste im Bereichskopf (Schraubenschlüssel-Symbole für Arbeit, Buch-Symbole für Ausbildung, Glitzer-Symbole für Vibe / Nebenprojekt-Stationen; jede Station zeigt Firma, Rolle, Datum, Ort) und einem Raster aus Projektkarten im Hauptteil – beide werden aus dem Lebenslauf des Nutzers generiert.
- Zeitleisten-↔Karten-Filter — Bewege die Maus über eine Zeitleisten-Station oder fokussiere sie mit der Tastatur, um nicht verwandte Projektkarten auszublenden; klicke, um den Filter zu fixieren (erneutes Klicken hebt ihn auf). Nur Stationen, die mit mindestens einer Karte verknüpft sind, werden interaktiv; andere bleiben inaktiv.
- Gefaltete Karten — Jede Projektkarte zeigt standardmäßig nur ihre Kategorie + Titel + Tool-Tags; die Zusammenfassung und die Metrikzeile erscheinen beim Darüberfahren / Fokussieren, sodass das Raster gut scanbar bleibt.
- Chatbot (optional) — Ein schwebender Starter unten rechts + ein Pop-out-Panel (kein Inline-Bereich), unterstützt von DeepSeeks OpenAI-kompatibler API hinter einem Cloudflare-Worker, der den API-Schlüssel hält. Der Nutzer wählt den Namen des Bots; der Agent schlägt einen passenden Emoji-Avatar vor. Bot-Antworten rendern Markdown. Zweistufige Ratenbegrenzung.
- Connect-Bereich — E-Mail + die sozialen URLs des Nutzers.
Voraussetzungen
| Erforderlich für | Werkzeug | Installation |
|---|---|---|
| Alles | git | normalerweise bereits installiert |
| Alles | GitHub-Konto + gh CLI | brew install gh dann gh auth login |
| Alles | python3 (lokale Vorschau) | normalerweise bereits installiert |
| Chatbot | Cloudflare-Konto (kostenlose Stufe) | https://dash.cloudflare.com |
| Chatbot | wrangler CLI | npm install -g wrangler dann wrangler login |
| Chatbot | DeepSeek API-Schlüssel | https://platform.deepseek.com/ → API keys |
| Porträt-Verschiebung | Node.js | brew install node |
Schritt-für-Schritt-Anleitung
1. Eingaben vom Nutzer sammeln
Führe dies aus, bevor du irgendwelche Dateien anfasst. Sammle alles auf einmal, damit spätere Schritte automatisierte Bearbeitungen sind. Mische AskUserQuestion für Multiple-Choice und direkte Aufforderungen für Freitext.
Hole jeden dieser Punkte vom Nutzer:
| Eingabe | Wie fragen | Beispiel |
|---|---|---|
| GitHub-Benutzername | direkt | jane (das Repository wird jane.github.io sein) |
| Anzeigename | direkt | Jane Doe oder Jane "JD" Doe |
| Standortangabe | direkt, kurz | Ballungsraum NYC, Remote, Tokio |
| Slogan | direkt, ein Satz | Ich baue ML-Systeme und liebe es, Dinge auszuliefern. |
| Lebenslauf | Text einfügen oder Pfad zu einer Datei | vollständiger Lebenslauf — wird verwendet, um Zeitleiste, Projektkarten und Chatbot-Wissen zu füllen |
| Foto | Pfad zu einem quadratischen Bild auf der Festplatte | /Users/jane/Desktop/headshot.jpg. Der Nutzer kann es nach dem Klonen als raw.jpg im Repository-Stammverzeichnis ablegen. |
| Soziale URLs | direkt, jeweils optional | LinkedIn / GitHub-Profil / Medium / persönliche E-Mail |
| Chatbot? | AskUserQuestion | ja / nein |
| Chatbot-Name (falls ja) | direkt | Pot, Nova, Echo, etc. |
| Visueller Stil | AskUserQuestion | "Füge eine URL ein, die mir gefällt" ODER "Beschreibe es in Worten" |
Nachdem du den Chatbot-Namen gesammelt hast, schlage 2–3 Emoji-Avatare vor, die thematisch passen, und lass den Nutzer auswählen. Beispiele:
| Name | Vorgeschlagene Avatare |
|---|---|
| Pot | 🫖 (Teekanne) · 🍲 · 🎨 |
| Nova | 🌟 · 💫 · 🌠 |
| Echo | 📣 · 🔊 · 🌀 |
| Ember | 🔥 · 🪵 · ✨ |
| Atlas | 🗺️ · 🧭 · 🌍 |
| Bit | 💾 · 🔢 · 🤖 |
| Sage | 🌿 · 📖 · 🦉 |
Wenn nichts Offensichtliches passt, biete Neutrale an: 🤖, 💬, 🪄. Speichere das ausgewählte Emoji + den Namen – du wirst sie später in den Code einfügen.
2. GitHub-Repository erstellen
gh repo create <benutzername>.github.io --public --description "Persönliche Website"
GitHub Pages-Benutzerseiten MÜSSEN unter <benutzername>.github.io liegen.
3. Vorlage klonen
git clone https://github.com/donotdonuts/donotdonuts.github.io meine-site
cd meine-site
rm -rf .git
git init -b main
git remote add origin https://github.com/<benutzername>/<benutzername>.github.io.git
4. Einen visuellen Stil auswählen
Die Vorlage standardmäßig auf eine cremefarbene + IBM Plex Mono-Ästhetik. Überschreibe sie basierend auf der Antwort des Nutzers aus Schritt 1.
4a. Wenn der Nutzer eine URL angegeben hat
Hole das CSS der Seite und extrahiere die Tokens:
curl -sL "<url>" -o /tmp/ref.html
grep -oE 'href="[^"]+\.css[^"]*"' /tmp/ref.html | sort -u
curl -sL "<origin>/<css-pfad>" -o /tmp/ref-1.css
# tatsächlich auf body angewendete Schriftart
grep -oE 'body[^{]{0,30}\{[^}]+\}' /tmp/ref-1.css | head -5
# alle CSS-Custom-Property-Definitionen
grep -oE -- '--[a-zA-Z-]+:[^;}]+' /tmp/ref-1.css | sort -u | head -60
Suche nach: Hintergrund-Hex, Vordergrund-/Text-Hex, Rahmen-Hex, Akzent-Hex, Schriftfamilie, die auf body angewendet wird, @font-face URLs.
4b. Wenn der Nutzer eine Beschreibung gegeben hat
Übersetze die Beschreibung in konkrete Tokens. Heuristiken:
| Wörter | Implikation |
|---|---|
| "minimal", "redaktionell", "papier" | Cremefarbener / gebrochen weißer Hintergrund, dunkle Schrift, dünne Trennlinien |
| "dunkel", "terminal", "IDE" | Fast schwarzer Hintergrund (#0f1115), helle Schrift, dezente graue Rahmen |
| "warm", "analog" | Leicht gelbliches Cremeweiß (#faf5e8), braunschwarze Schrift |
| "brutalistisch" | Reines Weiß oder reines Schwarz, 2px+ durchgezogene Rahmen |
| "technisch", "daten" | Monospace (IBM Plex Mono, JetBrains Mono), kühle Grautöne |
| "magazin", "redaktionell" | Serife (EB Garamond, Fraunces), großzügiger Zeilenabstand |
| "verspielt" | Ein gesättigter Akzent, ansonsten gedämpft |
4c. Vorschlagen + anwenden
Stelle 13 Tokens + einen Schriftstapel zusammen. Zeige die vorgeschlagene Palette als Code-Block und hole die Genehmigung ein, bevor du Dateien bearbeitest.
:root {
--bg: <hex>; /* Seitenhintergrund */
--bg-soft: <hex>; /* Unterpanels — normalerweise --bg gemischt mit ~3% zu --ink */
--bg-hover: <hex>; /* Tag-/Chip-Hover */
--card-bg: <hex>; /* undurchsichtige Kartenfüllung (weiß, wenn helles Thema) */
--ink: <hex>; /* primärer Text */
--ink-soft: <hex>; /* ~80% von --ink */
--ink-mute: <hex>; /* ~60% */
--ink-faint: <hex>; /* ~40% */
--border: <hex>; /* dezente Trennlinien */
--border-strong: <hex>; /* tragende Trennlinien */
--up: <hex>; /* positive Metriken (standardmäßig grünlich) */
--down: <hex>; /* negative Metriken (standardmäßig rötlich) */
--accent-ink: <hex>; /* Links */
--font-mono: "<Familie>", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}
Dann:
- Öffne
css/styles.css, finde den:root-Block, ersetze die Werte. - Öffne
index.html, aktualisiere den Google Fonts<link>im<head>mit der neuen Schriftfamilie + den Gewichten.
5. Inhalt aus Lebenslauf + Eingaben generieren
Verwende den Lebenslauf und die anderen Eingaben aus Schritt 1, um index.html zu füllen:
-
<head>—<title>=<Anzeigename> — <erste-Rolle-aus-Lebenslauf>;<meta name="description">aus dem Slogan. -
Hero-Bereich:
<h1 class="hero-title">← Anzeigename<p class="hero-location">← Standortangabe<p class="hero-tagline">← Slogan
-
Zeitleiste — Analysiere den Lebenslauf in Stationen. Ein
<li class="tl-stop">pro Rolle, pro Abschluss UND pro laufender persönlicher Nebenprojekt-Kategorie, die der Nutzer hervorheben möchte. Reihenfolge Gegenwart → Vergangenheit (oben nach unten im DOM). Wähle einen kurzendata-experience-Slug für jede (z.B.mars,vibe,coach,gatech) – danach filtert der Filter, um Stationen mit Karten zu verknüpfen. Fügetabindex="0"nur bei Stationen hinzu, die mindestens eine zugehörige Projektkarte haben (andere bleiben inaktiv).<li class="tl-stop tl-stop-work" data-experience="<slug>" tabindex="0"> <!-- tl-stop-work | tl-stop-edu | tl-stop-vibe (eines auswählen) --> <svg class="tl-icon tl-icon-work" aria-hidden="true"> <use href="#icon-wrench"/> <!-- #icon-wrench | #icon-book | #icon-sparkle --> </svg> <div class="tl-info"> <strong>Firma / Schule</strong> <span>Rolle / Abschluss</span> <em>Start — Ende</em> <i class="tl-loc">Stadt, Bundesland</i> </div> </li>Entferne
tabindex="0"bei Bildungs-/Alt-Rollen-Stationen, die keine zugehörigen Projektkarten haben –js/main.jserkennt diese automatisch beim Laden und lässt sie nicht interaktiv. -
Projekte — ~sechs
<article class="project-card">-Blöcke, generiert aus bemerkenswerten Projekten/Errungenschaften im Lebenslauf. Jede Karte MUSS einendata-experience-Slug tragen, der mit der Station übereinstimmt, aus der sie stammt, sonst nimmt sie nicht am Filter teil:<article class="project-card" data-experience="<slug>"> <header class="project-head"> <span class="project-tag">Kategorie</span> <h3>Projekttitel</h3> </header> <p>1–2 Sätze Zusammenfassung, aus dem Lebenslauf-Aufzählungspunkt gezogen.</p> <dl class="project-metrics"> <div><dt>Metrik</dt><dd class="up">+wert</dd></div> <div><dt>Metrik</dt><dd>wert</dd></div> </dl> <ul class="tag-list small"><li>Werkzeug</li><li>Werkzeug</li></ul> </article>Verwende
<dd class="up">/<dd class="down">, um Metriken einzufärben. Karten werden standardmäßig gefaltet dargestellt – nur der Tag, der Titel und die Tool-Tags sind sichtbar, bis Hover / Fokus-innerhalb die Zusammenfassung + Metriken enthüllt. Halte Zusammenfassungen kurz; sie existieren nur, um einen Hover zu belohnen. -
Chat-Begrüßung — Die erste Nachricht des Bots ist Inline-HTML innerhalb von
#chat-panelinindex.html(innerhalb des<div class="chat-log">des Panels), sodass sie sofort gerendert wird, wenn der Nutzer das Pop-out zum ersten Mal öffnet. Schreibe sie mit dem gewählten Bot-Namen + Avatar-Emoji um. Format:<div class="chat-msg chat-msg-bot"> <span class="chat-avatar" aria-label="<Bot-Name>">EMOJI</span> <div class="chat-bubble"> <p>Hallo, ich bin <strong><Bot-Name></strong> — <Anzeigename>s KI-Assistent, <ge-verb> aus <seinem/ihrem> Lebenslauf.</p> <p>Frag mich nach:</p> <ul> <li>Unternehmen / Rollen</li> <li>Methoden / Ansätze</li> <li>Projekte / Fähigkeiten / Ausbildung</li> </ul> <p>Was möchtest du wissen?</p> </div> </div> -
Connect — E-Mail + jede angegebene soziale URL als
<li>in.connect-list. Lösche Zeilen für jede nicht bereitgestellte Plattform.
6. Porträt hinzufügen
Frage, wo das Foto ist. Kopiere es in das Repository-Stammverzeichnis als raw.jpg, dann ändere die Größe:
cp <nutzer-foto-pfad> raw.jpg
mkdir -p assets
sips -Z 720 raw.jpg --out assets/portrait.jpg
Wenn der Hintergrund des Fotos nicht zum neuen --bg passt, verschiebe ihn mit dem mitgelieferten Skript:
cd /tmp && rm -rf img-fix && mkdir img-fix && cd img-fix
npm init -y > /dev/null
npm install [email protected] --silent
node <dieses-skill-verzeichnis>/scripts/shift-portrait.js \
/pfad/zu/meine-site/raw.jpg \
/pfad/zu/meine-site/assets/portrait.jpg \
"#<dein-bg-hex>"
Standardmäßig auf #fbf7eb, wenn das dritte Argument weggelassen wird. raw.jpg ist in .gitignore.
7. Chatbot konfigurieren (überspringen, wenn der Nutzer nein gesagt hat)
7a. Worker
cd worker
wrangler login
wrangler secret put DEEPSEEK_API_KEY
worker/wrangler.toml:
ALLOWED_ORIGIN = "https://<benutzername>.github.io,http://localhost:8000,http://127.0.0.1:8000"
MODEL = "deepseek-chat"
worker/worker.js → SYSTEM_PROMPT — schreibe aus dem Lebenslauf des Nutzers um. Behalte die Abschnittsstruktur bei (Über / Aktuelle Rolle / Frühere Rollen / Ausbildung / Werkzeugkiste). Schreibe auch den einleitenden Persönlichkeitssatz mit dem Bot-Namen + Avatar um:
const SYSTEM_PROMPT = `Du bist "<Bot-Name>" <EMOJI> — ein freundlicher, präziser KI-Assistent, der auf <Anzeigename>s persönlicher Website eingebettet ist. …`;
Deploy:
wrangler deploy
7b. Client
js/config.js:
window.SITE_CONFIG = {
chatWorkerUrl: "https://<worker>.workers.dev",
};
js/chatbot.js — aktualisiere die Konstanten am Anfang:
const AVATAR = "<EMOJI>";
const AVATAR_LABEL = "<Bot-Name>";
8. Vorschau + Pushen
python3 -m http.server 8000 # http://localhost:8000
Klicke dich durch jeden Abschnitt. Teste den Chat. Ändere die Größe auf mobile Breite. Dann:
git add .
git commit -m "initial: persönliche Website"
git push -u origin main
Live unter https://<benutzername>.github.io/ innerhalb von ~60 Sekunden.
Vorlagenarchitektur (nicht ändern)
Abschnittslayout
Jeder Abschnitt verwendet .section-grid: 280px 1fr. Die 280px-Spalte passt für das längste Zeitleisten-Label. Verkleinere auf 240px, wenn alle Labels kurz sind, vergrößere auf 320px, wenn sie lang sind.
Zeitleiste
- Befindet sich innerhalb des Projekt-
section-head, direkt unter dem Titel, beiopacity: 0.45. Hover, Fokus oder ein aktiver Filter erhöht sie auf 0.95. - DOM-Reihenfolge = visuelle Reihenfolge von oben nach unten. Gegenwart → Vergangenheit. NICHT proportional zur Zeit – gleichmäßig verteilt über flex
gap. - Drei Symbolarten sind standardmäßig verfügbar:
#icon-wrench(Arbeit,.tl-stop-work),#icon-book(Bildung,.tl-stop-edu),#icon-sparkle(Vibe / Nebenprojekt,.tl-stop-vibe). Alle drei<symbol>-Definitionen leben im SVG-Sprite direkt nach<header>. Um eine neue Symbolkategorie hinzuzufügen:- Füge ein
<symbol id="icon-foo">mit deinem SVG-Pfad hinzu - Füge
.tl-icon-foo { color: var(--ink-mute); }hinzu - Referenziere mit
<svg class="tl-icon tl-icon-foo"><use href="#icon-foo"/></svg>
- Füge ein
- Jede Station trägt
data-experience="<slug>"; Stationen, deren Slug mit mindestens einer Projektkarte übereinstimmt, erhalten auchtabindex="0", damitjs/main.jssie filter-interaktiv machen kann.
Projektfilter (Klick + Hover)
Wird vollständig von js/main.js gesteuert, keine Konfiguration – es scannt das DOM beim Laden und verdrahtet Handler nur dort, wo sie zutreffen.
- Beim Laden erhält jede Station, deren
data-experience-Slug auf mindestens einer.project-cardvorhanden ist,.tl-stop-has-projects+role="button"+aria-pressed="false". Stationen ohne zugehörige Karten bleiben inaktiv. - Hover / Fokus auf eine interaktive Station → temporärer Filter: nicht übereinstimmende Karten erhalten
.is-dim(das Raster fügt.is-filteringhinzu, was CSS indisplay: nonefür abgedunkelte Karten übersetzt – sie werden aus dem Layout entfernt, nicht nur abgeblendet). - Klick (oder
Enter/Leertaste) → fixieren: Station erhält.is-locked, volle Deckkraft, mit Tintenfarbe gefärbtes Symbol, unterstrichener Firmenname. Klicke dieselbe Station erneut, um sie zu löschen; klicke eine andere, um zu wechseln. - Während sie fixiert ist, zeigt das Darüberfahren einer anderen Station eine Vorschau ihrer Karten an;
mouseleaveauf der Schiene (oderfocusoutdavon) stellt den vorherigen fixierten Filter wieder her oder löscht ihn, falls keiner fixiert war.