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.

  1. 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ží.
  2. Blossom. Ty bajty jdou na Blossom server jako jeden blob adresovaný vlastní sha256.
  3. 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 devnet rozjede 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.

Celý návod na nasazení