Ako upravuje sama seba jedna stránka.

Nsite je webhosting na Nostri: celé HTML súbory, ktoré sa podajú každému, kto otvorí adresu. Nič viac za tým nie je. nsite-clay k tomu pridáva jednu vec: stránka sa upravuje a aktualizuje sama, takže CMS sedí vnútri statického HTML, nie za ním.

Ty meníš stránku. Môžeš po nej klikať a písať, alebo si otvoriť inšpektor v prehliadači a zmeniť DOM tam. Stránke je to jedno. Nová verzia sa nahrá na tvoje Blossom servery a znovu sa zverejní jeden nahraditeľný event s tým, na ktorý súbor teraz ukazuje / alebo /about-us. Vykreslí ju hociktorý nsite gateway.

Čo presne robí Uložiť.

  1. Snímka. Stránka si naklonuje vlastný DOM, upratie ho a serializuje celý dokument. Panel s nástrojmi ani smetie, ktoré prehliadače po úpravách nechávajú, sa neukladá.
  2. Blossom. Tie bajty idú na Blossom server ako jeden blob adresovaný vlastným sha256.
  3. Manifest. Nahraditeľný event podľa NIP-5A priradí ceste tento hash. Zverejniť ho znamená nasadiť.

Manifest držia relaye, bajty držia Blossom servery a zvyšok spraví prehliadač. Vlastníctvo je pár kľúčov, takže to, kto smie stránku upraviť, nie je riadok v cudzej databáze.

Celá integrácia.

Jeden atribút hovorí, komu súbor patrí, druhý označí, do čoho sa dá písať, a zvyšok spraví jeden script tag.

<!DOCTYPE html>
<html lang="sk" autosave nc:owner="npub1…">
<head><meta charset="utf-8"><title>Poznámky</title></head>
<body>
  <h1 editable="single-line">Moje poznámky</h1>
  <div editable>
    <p>Sem môžeš písať čokoľvek.</p>
  </div>
  <script src="/nsite-clay.js"></script>
</body>
</html>

Ulož a otvor si súbor v textovom editore: tvoje slová sú priamo v HTML. Databázou je DOM, takže stav nemá kde inde byť.

Úpravy.

Označ kontajner ako editable. Vlastníkovi sa z neho stane formátovaný text, všetkým ostatným obyčajné HTML.

Enter začne nový odsek. Keď označíš text, vyskočí nad ním plávajúci panel a jeho prvý ovládač je ponuka blokov: odsek, nadpis 1 až 3, citát, blok kódu.

Klávesové skratky fungujú tak, ako čakáš, a # , -  alebo >  na začiatku riadka tiež.

Do súboru sa dostane taký kód, aký by človek napísal aj ručne.

Gatewaye a kde stránka beží.

Gateway nájde tvoj manifest a vydá súbory. Všetky čítajú tie isté eventy, takže stránka nie je viazaná na žiadny z nich. Keď jeden nejde, vymeníš hostname.

  • Verejné gatewaye sú nsite.lol, nosto.re a nwb.tf.
  • Na nsite.run, nsite.cloud a shakespeare.to beží referenčná implementácia. Na nsite.run je aj najzrozumiteľnejšie vysvetlenie toho, čo nsite vlastne je.
  • Vďaka CNAME z tvojej domény na npub subdoménu ju vie podávať hociktorý z nich, cez obyčajné HTTP. HTTPS na tomto mene potrebuje certifikát, čo dnes znamená prevádzkovať vlastný gateway. npm run devnet rozbehne jeden na notebooku.
  • Súbory sa zverejňujú na cestách, ktoré nesú hash ich obsahu, a každý dokument sleduje vlastný manifest a sám sa načíta znova, keď sa objaví novšia verzia. Nikto nemusí vedieť, čo je tvrdý refresh.

Celý návod na nasadenie