Bookmarklet on nodejs-moduuli kirjanmerkkien kääntämiseen palvelinpuolen koodiin ja suoraan komentotulkista. Voit ajaa sen millä tahansa JavaScript-tiedostolla – se pienentää sen uglify-js:n avulla, kietoo sen itse suoritettavaan funktioon ja palauttaa eskapedoidun bookmarkletin.

Lisäksi se tukee metatietolohkoa – joka on mallinnettu greasemonkeyn userscript-metatietolohkon mukaan – metatietojen, ulkoisten tyylilomakkeiden ja komentosarjojen sisällyttämisen määrittelemiseen, mikä voi näyttää tältä:

// ==Bookmarklet==// @name LoveGames// @author Old Gregg// @style !loadOnce https://mrcoles.com/media/css/silly.css// @script https://ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js// ==/Bookmarklet==

Huomionarvoisinta on, että voit määritellä kaikki ulkoiset komentosarjat, jotka haluat kirjanmerkkisi sisällyttävän, @script-säännön avulla, jonka voi toistaa niin monta kertaa kuin haluat.

Huomautus: tällä hetkellä skriptien sisällyttämisen kanssa joudut itse käsittelemään noConflict skenaarioita, esim, saatat haluta aloittaa skriptin var $ = jQuery.noConflict(true):lla.

Lisäksi kaikki css-tiedostot, jotka on sisällytetty @style:lla, injektoidaan.

Oletusarvoisesti joka kerta, kun kirjanmerkkiä painetaan, se lisää skripti- ja tyylitunnisteet uudelleen. Voit muokata jokaista rivikohtaisesti lisäämällä !loadOnce-ilmoituksen @style– tai @script-parametrin ja resurssin polun väliin. Katso esimerkki yllä.

V1.0.0:sta lähtien tämä käyttää nyt Babelia nykyisellä ”env”:llä tehdäkseen koodista taaksepäin yhteensopivaa ennen sen pienentämistä.

Tämä projekti on avoin ehdotuksille & pull request.

Ja jos etsit vain nopeaa tapaa heittää kirjanmerkkilehti kasaan, kokeile selainpohjaista kirjanmerkkilehden luojaani.

Asennus

Riippuvuus löytyy NPM:stä nimellä ”bookmarklet”. Voit asentaa sen:

npm install bookmarklet

Käyttö

Käytön näet helposti ajamalla bookmarklet -h:

> bookmarklet -h
Bookmarklet v0.0.1 usage: bookmarklet source 
-d | --demo - output a demo HTML page for sharing the bookmarklet
source - path to file to read from or `-` for stdin
destination - path to file to write to

Vakiotulosteena on bookmarletin raaka koodi. UUSI Lisää --demo-lippu, niin saat tulostettua testi-HTML-sivun, joka sisältää bookmarkletin siinä.

Testaus

Hyvin yksinkertainen testiskripti voidaan ajaa bash test/run.sh

kautta.