# Kuidas see leht töötab

*7. sept 2026* · Stella Ellervee

Staatiline Astro leht, mis on ehitatud nii, et seda saaksid lugeda nii inimesed kui ka agendid — pluss tähevärav, mis ei valva midagi.

---

See leht on all igav ja peal veidi rumal.

## Igav osa

See on [Astro](https://astro.build), mis ehitab lihtsa staatilise HTML-i ja
elab GitHub Pagesil. Tagarakendust, andmebaasi ega sisuhaldussüsteemi pole.
Kõik on fail git-repos:

- Mu CV on ühes YAML-failis, mida build'i ajal valideeritakse. Kui kirjutan
  välja nime valesti, katkeb build selle asemel, et vaikselt üks töökoht
  CV-st välja jätta.
- Märkmed on Markdown-failid kaustas. Uus märge tähendab uut faili.

## Osa, milles on tegelikult mõte

Enamik isiklikke lehti on kirjutatud ühele auditooriumile — inimestele, kellel
on brauser. See on kirjutatud kahele, sest üha sagedamini on see, mis sinu
kohta loeb, keelemudel, kes otsustab, kas sind üldse mainida.

Nii et iga leht siin on olemas kolmel kujul:

1. **HTML** inimestele.
2. **Lihtne Markdown**, samal aadressil `.md` lõpuga — `/et/cv` on ka
   `/et/cv.md`. Ei navigatsiooni, ei stiile, ei liigseid tokeneid.
3. **Struktureeritud andmed** JSON-LD `Person`-graafina iga lehe `<head>`-is,
   et masin saaks kätte "kus ta töötab, mida ta oskab" ilma proosat parsimata.

Lisaks on [`/llms.txt`](/llms.txt), mis loetleb iga lehe ühe lausega. Selle
mustri varastasin [Taivolt](https://www.taivo.ai/llms.txt), kes on mu juht ja
kes tegi seda enne mind.

## Tähevärav

Selle lehe märkmed on seitsme chevroni taga. Vihjed on lehel. See ei ole
turvameede ega ligipääsupiirang — märkmed on HTML-is kohe olemas, sitemapis,
`llms.txt`-is ja igaüks omal aadressil. Kõik, mis loeb seda lehte ilma
JavaScriptita, näeb kõike kohe ega saagi teada, et värav olemas oli.

Värav on mänguasi neile, kes tahavad mängida, ja selle kõrval on link, millega
selle vahele jätta. Väravat, mis roomajaid päriselt kinni hoiaks, oleks olnud
lihtne teha ja see oleks kogu lehe mõtte ära rikkunud.
