Eina per compartir text (pastebin)

Una eina per compartir text, sovint anomenada pastebin, és una pàgina web per publicar un bloc de text o codi i obtenir un enllaç que mostra aquest text a qualsevol persona que l’obri. Aquesta eina pastebin funciona íntegrament al navegador, no necessita cap compte i pot afegir ressaltat de sintaxi i un temps de caducitat opcionals a l’enllaç.

Com funciona l’eina per compartir text

La majoria dels serveis de pastebin emmagatzemen el text en un servidor i retornen un enllaç curt que apunta a una fila d’una base de dades. Aquesta eina funciona d’una manera diferent. No té servidor ni base de dades. En lloc d’això, inclou tot el text compartit dins del mateix enllaç.

Quan algú fa clic a «Crea l’enllaç», l’eina fa quatre coses:

1. Construeix un objecte petit que conté el text, el llenguatge seleccionat i el temps d'expiració (o res, per indicar «mai»).
2. Converteix aquest objecte en una línia de text JSON.
3. Converteix el JSON en bytes mitjançant la codificació UTF-8 que el web utilitza arreu.
4. Codifica aquests bytes com a base64url, un esquema que converteix bytes arbitraris en lletres, dígits, - i _, de manera que el resultat sigui segur dins d’un URL.

El text codificat es col·loca després de #p= al final de l’URL de la pàgina. Tot el que hi ha després de # s’anomena fragment. Quan carrega una pàgina, el navegador no envia mai el fragment a cap servidor, de manera que el contingut compartit no es transmet enlloc. La lectura inversa de l’enllaç segueix el mateix procés al revés: es descodifica el text base64url, es tornen a convertir els bytes en una cadena JSON amb UTF-8 i s’analitza el JSON per recuperar el text, el llenguatge i el temps de caducitat.

Com que el fragment conté tot el text compartit, un enllaç per compartir funciona en qualsevol dispositiu o navegador, no només en el que l’ha creat. No cal consultar res. Obrir l’enllaç és suficient per mostrar el contingut, igual que obrir un fitxer baixat no requereix preguntar a cap servidor què conté.

Per comoditat, l’eina també conserva una còpia local de cada text compartit a l’emmagatzematge del navegador com a esborrany. Aquesta còpia només ajuda el mateix navegador a tornar a trobar els seus textos compartits anteriors; no intervé en l’obertura d’un enllaç compartit, i esborrar-la no trenca cap enllaç compartit, perquè l’enllaç no en depenia.

Ressaltat de sintaxi

El ressaltat de sintaxi aplica colors a les parts del codi, com ara les paraules clau, les cadenes i els comentaris, perquè l’estructura sigui més fàcil de llegir. L’eina admet deu opcions:

• Text pla (sense ressaltat)
• JavaScript
• TypeScript
• Python
• Java
• HTML
• CSS
• JSON
• SQL
• Bash

El llenguatge seleccionat es desa dins del contingut codificat, de manera que el ressaltat s’aplica automàticament quan s’obre l’enllaç, sense que el lector hagi d’escollir res.

Fórmula de caducitat

Una opció de caducitat estableix una marca de temps absoluta, mesurada en mil·lisegons des de 1 de gener del 1970 (un punt de referència habitual en informàtica anomenat època Unix). L’eina afegeix un període de temps fix al moment en què es crea l’enllaç:

Per exemple, si es crea un enllaç quan el rellotge marca 1.700.000.000.000 ms i el creador tria «1 setmana», la caducitat emmagatzemada és:

1.700.000.000.000 + (7 × 24 × 60 × 60 × 1.000) = 1.700.604.800.000 ms

Quan un lector obre l’enllaç, l’eina compara aquesta marca de temps emmagatzemada amb l’hora actual. Si el temps emmagatzemat ja ha passat, l’eina mostra el missatge «This content has expired» en lloc del text. Com que la marca de temps de caducitat viatja dins de l’enllaç juntament amb el text, aquesta comprovació funciona de la mateixa manera en qualsevol dispositiu.

Exemple pràctic: com un text compartit es converteix en un enllaç

Suposem que algú comparteix el text pla Hello, world! sense caducitat. L’eina construeix aquest objecte JSON, amb noms de camp curts per mantenir l’enllaç compacte:

Codifica aquest JSON com a bytes UTF-8 i després com a base64url, i obté:

L’enllaç complet per compartir és l’adreça de la pàgina més aquest testimoni després de #p=:

Qualsevol persona que obri aquest enllaç utilitza un navegador que descodifica el testimoni, recupera Hello, world! com a text pla i el mostra. No s’ha demanat res a cap servidor.

Com compartir text o codi

1. Escriu o enganxa el text al quadre de text. El recompte de caràcters s’actualitza a mesura que s’escriu.
2. Opcionalment, tria un llenguatge al menú de ressaltat de sintaxi.
3. Opcionalment, tria quant de temps ha de continuar sent vàlid l’enllaç.
4. Fes clic a «Crea l’enllaç».
5. Copia l’enllaç generat amb el botó «Copia l’enllaç» i envia’l com prefereixis.

Com veure text compartit

1. Obre l’enllaç compartit.
2. El text apareix immediatament, amb ressaltat si s’havia triat un llenguatge.
3. Utilitza «Copia el text» per copiar el contingut al porta-retalls.
4. Utilitza «Crea’n un de nou» per començar un text compartit nou.

Un text compartit no es pot editar després de crear l’enllaç. Per canviar el text, cal crear un text compartit nou i compartir-ne l’enllaç nou.

Usos habituals

• Desenvolupadors que comparteixen un fragment de codi per revisar-lo o depurar-lo.
• Docents que comparteixen codi inicial o instruccions.
• Qualsevol persona que trasllada un bloc de text, com ara una llista o un conjunt de notes, entre dos dispositius propis.

Per al text que diverses persones han de poder editar alhora, una eina de documents compartits és més adequada. Per al codi que necessita un historial permanent, és més adequat un sistema de control de versions com Git.

Límits i privacitat

Com que tot el text compartit viu dins de l’enllaç, el límit pràctic és la longitud del mateix URL, no cap quota d’emmagatzematge. Els navegadors poden gestionar URL llargs, però molts programes de correu, aplicacions de xat i sistemes antics trunquen o rebutgen els URL molt llargs, de manera que els textos compartits extremadament grans poden no circular bé per tots els canals. Els textos compartits curts i mitjans no es veuen afectats.

El fragment no s’envia mai a cap servidor, de manera que l’eina no arriba a saber mai què s’hi ha enganxat. Qualsevol persona que tingui l’enllaç exacte pot obrir-lo, així que cal tractar un enllaç igual que el text que conté: no hi comparteixis contrasenyes ni altres dades sensibles, i no publiquis l’enllaç en un lloc públic si el contingut ha de mantenir-se privat.

Preguntes freqüents

On s’emmagatzema realment el text compartit? No s’emmagatzema enlloc separat de l’enllaç. El text, el llenguatge escollit i el temps de caducitat estan codificats directament al fragment de l’enllaç, la part posterior a #. L’enllaç mateix n’és l’única còpia.

L’enllaç funciona en un dispositiu o navegador diferent? Sí. Com que el contingut viatja dins de l’enllaç, qualsevol dispositiu que l’obri pot descodificar-lo i mostrar-lo. No cal cap compte ni el navegador original.

Què passa si esborro les dades del navegador? No passa res als enllaços compartits existents. No depenen de res emmagatzemat al navegador, sinó només de l’enllaç mateix. Esborrar les dades del navegador només elimina la còpia local de conveniència que el navegador conserva dels textos compartits creats en aquell dispositiu.

Puc editar un text compartit després de crear l’enllaç? No. Per a qualsevol canvi cal crear un enllaç nou, ja que el contingut queda integrat a l’enllaç en el moment de crear-lo.

Què passa quan caduca un text compartit? En obrir un enllaç caducat es mostra un missatge que indica que el contingut ha caducat, en lloc del text original. L’enllaç continua existint; simplement deixa de mostrar el contingut quan ha passat la marca de temps de caducitat emmagatzemada.

Hi ha un límit de mida? No hi ha cap límit fix d’emmagatzematge, però alguns clients de correu i aplicacions de missatgeria poden rebutjar o truncar els URL molt llargs, de manera que és millor utilitzar una eina específica per compartir fitxers per als textos compartits molt grans.

Referències

1. "UTF-8." MDN Web Docs, Mozilla, https://developer.mozilla.org/en-US/docs/Glossary/UTF-8
2. "Base64." MDN Web Docs, Mozilla, https://developer.mozilla.org/en-US/docs/Glossary/Base64
3. "URL." MDN Web Docs, Mozilla, https://developer.mozilla.org/en-US/docs/Web/API/URL
4. "Syntax highlighting." Viquipèdia, Wikimedia Foundation, https://en.wikipedia.org/wiki/Syntax_highlighting
5. "Unix time." Viquipèdia, Wikimedia Foundation, https://en.wikipedia.org/wiki/Unix_time