Bookmarklet ist ein nodejs Modul zum Kompilieren von Bookmarklets in serverseitigen Code und direkt aus der Shell. Man kann es auf jede beliebige JavaScript-Datei anwenden – es verkleinert sie mit uglify-js, verpackt sie in eine selbstausführende Funktion und gibt ein escaped Bookmarklet zurück.

Darüber hinaus unterstützt es einen Metadaten-Block, der dem Greasemonkey-Userscript-Metadaten-Block nachempfunden ist, um Metadaten, externe Stylesheets und Skript-Includes zu spezifizieren, die wie folgt aussehen können:

// ==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==

Vor allem können Sie alle externen Skripte angeben, die Ihr Bookmarklet über die @script-Regel einbinden soll, die so oft wiederholt werden kann, wie Sie möchten.

Hinweis: Derzeit müssen Sie bei Skript-Includes selbst noConflict Szenarien behandeln, z.B., Sie könnten ein Skript mit var $ = jQuery.noConflict(true) beginnen.

Außerdem werden alle mit @style eingeschlossenen CSS-Dateien injiziert.

Standardmäßig werden die Skript- und Style-Tags jedes Mal, wenn das Lesezeichen aufgerufen wird, erneut hinzugefügt. Sie können jedes einzelne pro Zeile anpassen, indem Sie eine !loadOnce-Deklaration zwischen dem @style– oder @script-Param und dem Pfad für das Asset hinzufügen. Siehe das obige Beispiel.

Ab v1.0.0 verwendet dies nun Babel mit dem aktuellen „env“, um den Code rückwärtskompatibel zu machen, bevor er minifiziert wird.

Dieses Projekt ist offen für Vorschläge & Pull Requests.

Wenn du auch nur einen schnellen Weg suchst, um ein Bookmarklet zu erstellen, probiere meinen Browser-basierten Bookmarklet-Creator.

Installation

Die Abhängigkeit kann bei NPM als „bookmarklet“ gefunden werden. Du kannst es installieren mit:

npm install bookmarklet

Verwendung

Die Verwendung kannst du leicht sehen, indem du 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

Die Standardausgabe ist der rohe bookmarlet-Code. NEW fügt das --demo Flag hinzu, um eine Test-HTML-Seite auszugeben, die das Bookmarklet enthält.

Testing

Ein sehr einfaches Testskript kann über bash test/run.sh

ausgeführt werden.