eg 2017 hatch review doc
authorBill Erickson <berickxx@gmail.com>
Mon, 13 Feb 2017 21:26:19 +0000 (16:26 -0500)
committerBill Erickson <berickxx@gmail.com>
Mon, 13 Feb 2017 21:26:19 +0000 (16:26 -0500)
Signed-off-by: Bill Erickson <berickxx@gmail.com>
hatch-review.adoc

index 02f9360..c0444bf 100644 (file)
@@ -16,9 +16,7 @@
 
 https://developer.chrome.com/extensions/nativeMessaging
 
-TODO: screen shot of hatch Icon and permission request dialog.
-
-Note perm request only happens.
+TODO: screen shot of hatch Icon.
 
 chrome://extensions/
 Background Page
@@ -26,7 +24,7 @@ Reload option
 
 == Native Messaging API
 
-TODO: Make this an image
+TODO: Make this an image -- see google drawing
 
 One instance of Hatch per browser (not per tab).
 
@@ -59,8 +57,24 @@ egCore.print.print({...}) is translated into:
 }
 ---------------------------------------------------------------------------
 
+== A Quick Word on Rendering Print Templates
+
+* Browser inserts template HTML into the page DOM.
+* Browser digests the template, replacing placeholders
+ ** For example, replacing <span>{{balance_owed | money}}<span> with 
+    <span>$2.25</span>
+* In non-Hatch mode, print CSS is added to the print DOM element and a call
+  to window.print() prints only the rendered template content from the page.
+* In Hatch mode, the compiled HTML content is extracted from the DOM as
+  an HTML string and sent to Hatch with a 'print' command.
+ ** Hatch does not inject any JS or CSS (but it can load remote content, 
+    i.e. scripts, css, images, etc.).
+
 == Hatch Files
 
+Where they live
+How to configure
+
 1. Settings locations / properties
 2. hatch.log