Tekstin jakamistyökalu (paste bin)

Tekstin jakamiseen tarkoitettu työkalu, jota kutsutaan usein pastebiniksi, on verkkosivu, jolle voi julkaista tekstilohkon tai koodia ja saada vastineeksi linkin, joka näyttää tekstin kaikille sen avaaville. Tämä paste bin -työkalu toimii kokonaan selaimessa, ei vaadi tiliä, ja siihen voi lisätä valinnaisen syntaksin korostuksen sekä linkille vanhenemisajan.

Näin tekstin jakamistyökalu toimii

Useimmat paste bin -palvelut tallentavat tekstin palvelimelle ja palauttavat lyhyen linkin, joka viittaa tietokannan riviin. Tämä työkalu toimii eri tavalla. Sillä ei ole palvelinta eikä tietokantaa. Sen sijaan se pakkaa koko tekstin linkin sisään.

Kun joku napsauttaa ”Luo linkki”, työkalu tekee neljä asiaa:

1. Se muodostaa pienen olion, joka sisältää tekstin, valitun kielen ja vanhenemisajan (tai ei mitään, jos valitaan ”ei koskaan”).
2. Se muuntaa olion yhdeksi JSON-tekstiriviksi.
3. Se muuntaa JSONin tavuiksi käyttäen UTF-8-koodausta, jota verkko käyttää kaikkialla.
4. Se koodaa tavut base64url-muotoon. Tämä menetelmä muuntaa mielivaltaiset tavut kirjaimiksi, numeroiksi, merkeiksi - ja _, joten tulos on turvallinen URL-osoitteen sisällä.

Koodattu teksti sijoitetaan sivun URL-osoitteen loppuun merkin #p= jälkeen. Kaikkea #-merkin jälkeistä kutsutaan fragmentiksi. Selain ei koskaan lähetä fragmenttia palvelimelle sivua ladatessaan, joten paste-tekstin sisältöä ei siirretä mihinkään. Linkin lukeminen takaisin tapahtuu käänteisessä järjestyksessä: base64url-teksti puretaan, tavut muunnetaan takaisin JSON-merkkijonoksi UTF-8-koodauksella, ja JSON jäsennetään tekstin, kielen ja vanhenemisajan palauttamiseksi.

Koska fragmentti sisältää koko paste-tekstin, jakolinkki toimii millä tahansa laitteella tai selaimella, ei vain sillä, jolla se luotiin. Mitään ei tarvitse hakea erikseen. Linkin avaaminen riittää sisällön näyttämiseen, aivan kuten ladatun tiedoston avaaminen ei edellytä palvelimelta kysymistä siitä, mitä tiedosto sisältää.

Työkalu säilyttää lisäksi jokaisesta paste-tekstistä paikallisen kopion selaimen tallennustilassa luonnoksena. Tämä kopio auttaa vain samaa selainta löytämään aiemmin luodut pastet uudelleen; sillä ei ole mitään osuutta jaetun linkin avaamisessa, eikä sen tyhjentäminen riko yhtäkään jakolinkkiä, koska linkki ei koskaan perustunut siihen.

Syntaksin korostus

Syntaksin korostus värittää koodin osia, kuten avainsanoja, merkkijonoja ja kommentteja, jotta rakenne olisi helpompi lukea. Työkalu tukee kymmentä vaihtoehtoa:

• Pelkkä teksti (ei korostusta)
• JavaScript
• TypeScript
• Python
• Java
• HTML
• CSS
• JSON
• SQL
• Bash

Valittu kieli tallennetaan koodattuun sisältöön, joten korostus otetaan käyttöön automaattisesti linkkiä avattaessa ilman, että katsojan tarvitsee valita mitään.

Vanhentumisen kaava

Vanhenemisvaihtoehto määrittää absoluuttisen aikaleiman, joka mitataan millisekunteina ajankohdasta 1. tammikuuta 1970 (yleinen tietojenkäsittelyn vertailukohta, jota kutsutaan Unix-epookiksi). Työkalu lisää linkin luomishetkeen kiinteän ajan:

Jos linkki luodaan esimerkiksi kellon näyttäessä 1 700 000 000 000 ms ja luoja valitsee ”1 viikko”, tallennettava vanhenemisaika on:

1 700 000 000 000 + (7 × 24 × 60 × 60 × 1 000) = 1 700 604 800 000 ms

Kun katsoja avaa linkin, työkalu vertaa tallennettua aikaleimaa nykyiseen aikaan. Jos tallennettu aika on jo mennyt, työkalu näyttää tekstin sijaan viestin ”Tämä sisältö on vanhentunut”. Koska vanhenemisaikaleima kulkee linkin sisällä tekstin mukana, tarkistus toimii samalla tavalla millä tahansa laitteella.

Esimerkki: miten pastesta tulee linkki

Oletetaan, että joku jakaa pelkän tekstin Hello, world! ilman vanhenemisaikaa. Työkalu muodostaa tämän JSON-olion käyttämällä lyhyitä kenttänimiä linkin pitämiseksi lyhyenä:

Se koodaa JSONin UTF-8-tavuiksi ja sen jälkeen base64url-muotoon, jolloin tulokseksi saadaan:

Koko jakolinkki muodostuu sivun osoitteesta ja sen perään tulevasta tunnisteesta #p=:

Linkin avaava selain purkaa tunnisteen, lukee Hello, world!-sisällön takaisin pelkkänä tekstinä ja näyttää sen. Palvelimelta ei pyydetty mitään.

Näin jaat tekstiä tai koodia

1. Kirjoita tai liitä teksti tekstikenttään. Merkkimäärä päivittyy kirjoittamisen aikana.
2. Valitse halutessasi kieli syntaksin korostuksen valikosta.
3. Valitse halutessasi, kuinka kauan linkin tulee pysyä voimassa.
4. Napsauta ”Luo linkki”.
5. Kopioi luotu linkki ”Kopioi linkki” -painikkeella ja lähetä se haluamallasi tavalla.

Näin tarkastelet jaettua tekstiä

1. Avaa jaettu linkki.
2. Teksti tulee heti näkyviin ja korostus otetaan käyttöön, jos kieli on valittu.
3. Kopioi sisältö leikepöydälle toiminnolla ”Kopioi teksti”.
4. Aloita uusi paste toiminnolla ”Luo uusi”.

Pastea ei voi muokata linkin luomisen jälkeen. Tekstin muuttaminen edellyttää uuden pasten luomista ja uuden linkin jakamista.

Tavallisia käyttökohteita

• Kehittäjät, jotka jakavat koodikatkelman tarkistettavaksi tai virheenkorjauksen avuksi.
• Opettajat, jotka jakavat aloituskoodia tai ohjeita.
• Kuka tahansa, joka siirtää tekstilohkon, kuten luettelon tai muistiinpanot, omien laitteidensa välillä.

Jos tekstiä täytyy muokata samanaikaisesti usean henkilön toimesta, jaettujen asiakirjojen työkalu sopii paremmin. Jos koodille tarvitaan pysyvä muutoshistoria, versionhallintajärjestelmä, kuten Git, sopii paremmin.

Rajoitukset ja tietosuoja

Koska koko paste-teksti sijaitsee linkin sisällä, käytännön kokorajoitus on itse URL-osoitteen pituus, ei tallennustilan kiintiö. Selaimet pystyvät käsittelemään pitkiä URL-osoitteita, mutta monet sähköpostiohjelmat, keskustelusovellukset ja vanhat järjestelmät katkaisevat tai hylkäävät erittäin pitkät osoitteet, joten erittäin suuret pastet eivät välttämättä kulje hyvin kaikkien kanavien kautta. Lyhyet ja keskikokoiset pastet eivät kärsi tästä.

Fragmenttia ei koskaan lähetetä palvelimelle, joten työkalu ei itse saa tietää, mitä siihen liitettiin. Täsmällisen linkin saanut voi avata sen, joten linkkiä on käsiteltävä samalla tavalla kuin sen sisältämää tekstiä: älä jaa salasanoja tai muita arkaluonteisia tietoja tällä tavalla äläkä julkaise linkkiä julkisesti, jos sisällön pitäisi pysyä yksityisenä.

Usein kysyttyä

Missä jaettu teksti oikeastaan säilytetään? Sitä ei säilytetä missään linkistä erillisessä paikassa. Teksti, valittu kieli ja vanhenemisaika koodataan suoraan linkin fragmenttiin eli osaan, joka alkaa #-merkin jälkeen. Linkki itsessään on ainoa kopio.

Toimiiko linkki toisella laitteella tai selaimella? Kyllä. Koska sisältö kulkee linkin sisällä, mikä tahansa sen avaava laite voi purkaa ja näyttää sisällön. Tiliä tai alkuperäistä selainta ei tarvita.

Mitä tapahtuu, jos tyhjennän selaimen tiedot? Nykyisille jakolinkeille ei tapahdu mitään. Ne eivät riipu mistään selaimeen tallennetusta, vaan ainoastaan itse linkistä. Selaimen tietojen tyhjentäminen poistaa vain paikallisen mukavuuskopion, jonka selain säilyttää kyseisellä laitteella luoduista pasteista.

Voinko muokata pastea linkin luomisen jälkeen? Et. Jokaista muutosta varten on luotava uusi linkki, koska sisältö upotetaan linkkiin luomishetkellä.

Mitä tapahtuu, kun paste vanhenee? Vanhentuneen linkin avaaminen näyttää alkuperäisen tekstin sijaan viestin, että sisältö on vanhentunut. Linkki itsessään on edelleen olemassa; se ei vain enää näytä sisältöä, kun tallennettu vanhenemisajan aikaleima on ohitettu.

Onko koolla rajoitusta? Kiinteää tallennusrajaa ei ole, mutta jotkin sähköpostiohjelmat ja viestisovellukset voivat hylätä tai katkaista erittäin pitkät URL-osoitteet, joten erittäin suuret pastet sopivat paremmin erilliseen tiedostonjakotyökaluun.

Viitteet

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." Wikipedia, Wikimedia Foundation, https://en.wikipedia.org/wiki/Syntax_highlighting
5. "Unix time." Wikipedia, Wikimedia Foundation, https://en.wikipedia.org/wiki/Unix_time