Cómo una página se edita sola.
Un nsite es alojamiento web en Nostr: archivos HTML enteros, servidos a quien abra la dirección. Eso es todo lo que es un nsite. nsite-clay le añade una cosa: la página se edita y se actualiza sola, así que el CMS vive dentro del HTML estático y no detrás de él.
Lo que cambias eres tú. Haz clic por la página y escribe, o abre el inspector del navegador y cambia el DOM desde ahí; a la página le da igual. La versión nueva se sube a tus servidores Blossom y se vuelve a publicar un evento reemplazable que dice a qué archivo apunta ahora / o /about-us. Cualquier gateway de nsites lo muestra.
Qué hace Guardar, exactamente.
- Instantánea. La página clona su propio DOM, lo limpia y serializa el documento entero. La barra de herramientas y la basura que dejan los navegadores al ejecutar comandos de edición nunca se guardan.
- Blossom. Esos bytes van a un servidor Blossom como un solo blob, direccionado por su propio sha256.
- Manifiesto. Un evento reemplazable NIP-5A asocia la ruta con ese hash. Publicarlo es el despliegue.
Los relays guardan el manifiesto, los servidores Blossom guardan los bytes y el navegador hace el resto. La propiedad es un par de claves, así que quién puede editar una página no es una fila en la base de datos de otro.
Toda la integración.
Un atributo dice de quién es el archivo, otro marca dónde se puede escribir y una etiqueta de script hace el resto.
<!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>
Guárdalo y abre el archivo en un editor de texto: tus palabras están dentro del HTML. El DOM es la base de datos, no hay otro sitio donde pueda vivir el estado.
Editar.
Marca un contenedor con editable y se convierte en texto enriquecido para el propietario y en marcado normal para los demás.
Enter empieza un párrafo nuevo. Al seleccionar texto aparece una barra flotante cuyo primer control es un menú de bloque: párrafo, títulos 1 a 3, cita y bloque de código.
Los atajos de teclado funcionan como esperarías, y escribir # , - o > al principio de una línea, también.
Lo que llega al archivo es marcado que una persona podría haber escrito a mano.
Gateways, y dónde se sirve tu página.
Un gateway resuelve tu manifiesto y sirve los archivos. Todos leen los mismos eventos, así que tu sitio no depende de ninguno en concreto. Si uno se cae, cambias el nombre de host.
- nsite.lol, nosto.re y nwb.tf son gateways públicos.
- nsite.run, nsite.cloud y shakespeare.to son implementaciones de referencia. nsite.run tiene además la explicación más clara de qué es un nsite.
- Un CNAME desde tu propio dominio a tu subdominio npub hace que cualquiera de ellos lo sirva, por HTTP simple. El HTTPS necesita un certificado para ese nombre, que hoy por hoy significa correr tu propio gateway.
npm run devnetlevanta uno en tu portátil. - Los recursos se publican en rutas que llevan su hash de contenido, y cada documento vigila su propio manifiesto y se recarga cuando aparece una versión más nueva. Nadie tiene que saber qué es una recarga forzada.