Jak se stránka edituje sama.
Nsite je webhosting na Nostru: celé HTML soubory, které se servírují každému, kdo otevře adresu. Víc nsite není. nsite-clay k tomu přidává jedinou věc: stránka se upravuje a aktualizuje sama, takže CMS sedí uvnitř statického HTML, ne za ním.
Ty měníš stránku. Klikej po ní a piš, nebo si otevři inspektor v prohlížeči a změň DOM tam. Stránce je to jedno. Nová verze se nahraje na tvoje Blossom servery a znovu se zveřejní jeden nahraditelný event, který říká, na jaký soubor teď ukazuje / nebo /about-us. Vykreslí to kterákoli nsite gateway.
Co přesně dělá Uložit.
- Snapshot. Stránka naklonuje vlastní DOM, uklidí ho a serializuje celý dokument. Lišta a smetí, které prohlížeče po editačních příkazech nechávají, se nikdy neuloží.
- Blossom. Ty bajty jdou na Blossom server jako jeden blob adresovaný vlastní sha256.
- Manifest. Nahraditelný event podle NIP-5A přiřadí cestě ten hash. Zveřejnit ho znamená nasadit.
Manifest drží relaye, bajty drží Blossom servery a zbytek udělá prohlížeč. Vlastnictví je pár klíčů, takže kdo smí stránku upravovat, není řádek v cizí databázi.
Celá integrace.
Jeden atribut říká, kdo soubor vlastní, druhý označí, kam se dá psát, a jeden script tag udělá zbytek.
<!DOCTYPE html> <html lang="en" autosave nc:owner="npub1…"> <head><meta charset="utf-8"><title>Notes</title></head> <body> <h1 editable="single-line">My notes</h1> <div editable> <p>Type anything here.</p> </div> <script src="/nsite-clay.js"></script> </body> </html>
Ulož a otevři soubor v textovém editoru: tvoje slova jsou v HTML. Databází je DOM, takže stav nemá kde jinde bydlet.
Úpravy.
Označ kontejner jako editable a pro vlastníka se z něj stane formátovaný text, pro všechny ostatní obyčejné značky.
Enter začne nový odstavec. Když označíš text, vyjede plovoucí lišta a jejím prvním ovládacím prvkem je nabídka bloků: odstavec, nadpis 1 až 3, citace, blok kódu.
Klávesové zkratky fungují, jak čekáš, a napsat # , - nebo > na začátek řádku funguje taky.
Do souboru se dostane značkování, jaké mohl napsat člověk ručně.
Gateway, a odkud se servíruje tvoje stránka.
Gateway přeloží tvůj manifest a naservíruje soubory. Všechny čtou stejné eventy, takže tvůj web na žádné z nich nevisí. Když jedna nejede, vyměň hostname.
- nsite.lol, nosto.re a nwb.tf jsou veřejné gateway.
- nsite.run, nsite.cloud a shakespeare.to jsou referenční implementace. Na nsite.run navíc najdeš nejsrozumitelnější vysvětlení, co to nsite vlastně je.
- Stačí CNAME z tvé domény na npub subdoménu a stránku tam servíruje kterákoli z nich, přes obyčejné HTTP. HTTPS na tom jméně potřebuje certifikát, a to dnes znamená provozovat gateway sám.
npm run devnetrozjede jednu na notebooku. - Soubory se publikují na cestách, které nesou hash obsahu, a každý dokument sleduje vlastní manifest a načte se znovu, jakmile se objeví novější verze. Nikdo nemusí vědět, co je to tvrdý refresh.