Improves readme and jsdoc

Author: RickCogley

README.md

@@ -1,18 +1,33 @@
 # hibana
 
-Hibana 火花 (lit "fire flowers") are little sparks, shareable Helpers and Filters for «[Lume ルメ](https://lume.land/)», the fast Deno SSG by [Óscar Otero](https://oscarotero.com/). 🙏🏻
+Hibana 火花 (lit "fire flowers") are little sparks, shareable Helpers and Filters for «[Lume ルメ](https://lume.land/)», the fast Deno typescript SSG by [Óscar Otero](https://oscarotero.com/). 🙏🏻
 
 With this repo I hope to learn more about Lume, Deno and typescript coding. 
 
 ## Usage
 
+This library is published to https://deno.land/x/hibana, so you can import it from there, or directly from github. 
+
 N.b. Github caches raw files for 10 min, so if you ever need the latest and don't want to wait, just "cache bust" it by appending `?1`, `?2` etc.
 
+Import the hibana version in your import map in `deno.json`:
+
+```json
+"imports": {
+  "lume/": "https://deno.land/x/lume@v3.0.3/",
+  "lume/cms/": "https://cdn.jsdelivr.net/gh/lumeland/cms@0.12.0/",
+  "lume/jsx-runtime": "https://deno.land/x/ssx@v0.1.10/jsx-runtime.ts",
+  "hibana/": "https://deno.land/x/hibana/v1.0.15/"
+ },...
 ```
-import { cssBanner, shuffle } from "https://raw.githubusercontent.com/RickCogley/hibana/v1.0.0/mod.ts";
-import cssBanner from "https://raw.githubusercontent.com/RickCogley/hibana/v0.5.0/plugins/css_banner.ts?1";
-import shuffle from "https://raw.githubusercontent.com/RickCogley/hibana/v0.5.0/plugins/shuffle.ts?1";
-import { cssBanner, shuffle, deferPagefind, externalLinksIcon } from "https://raw.githubusercontent.com/RickCogley/hibana/v1.0.0/mod.ts";
+
+Then in `_config.ts`, import the needed modules from `hibana`, no version needed. 
+
+```ts
+import { cssBanner, shuffle } from "hibana/mod.ts";
+import { cssBanner } from "https://raw.githubusercontent.com/RickCogley/hibana/v1.0.15/plugins/css_banner.ts?1";
+import { cssBanner, shuffle, deferPagefind, externalLinksIcon } from "hibana/mod.ts";
+etc
 ```
 
 ### css_banner.ts

deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@rick/hibana",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "license": "MIT",
   "exports": "./mod.ts",
   "imports": {

mod.ts

@@ -22,11 +22,14 @@
  *   "lume/": "https://deno.land/x/lume@v3.0.3/",
  *   "lume/cms/": "https://cdn.jsdelivr.net/gh/lumeland/cms@0.12.0/",
  *   "lume/jsx-runtime": "https://deno.land/x/ssx@v0.1.10/jsx-runtime.ts",
- *   "hibana/": "https://deno.land/x/hibana/v1.0.14/"
+ *   "hibana/": "https://deno.land/x/hibana/v1.0.15/"
  * },...
  * 
  * // Github Direct: 
- * "hibana/": "https://raw.githubusercontent.com/RickCogley/hibana/v1.0.14/"
+ * "hibana/": "https://raw.githubusercontent.com/RickCogley/hibana/v1.0.15/"
+ * 
+ * // Then import it in your Lume config:
+ * import { cssBanner, shuffle, deferPagefind, externalLinksIcon } from "hibana/mod.ts";
  */
 
 // Plugins