-------------------------------------------------------------------------------
A recent run on Mac OS.  Runs in '.' unless script settings changed.
Also note that the 'latin1' propagates 'cp1252' characters properly.
-------------------------------------------------------------------------------

/MY-STUFF/Code/genhtml$ py3 genhtml.py
Will replace all:
	$AHEADER$
	$FOOTER-COMMON$
	$FOOTERBLUE$
	$FOOTERGREY$
	$FOOTERMAIN$
	$HEADERLEFT-UNUSED$
	$ICON$
	$SCRIPT$
	$SIMPLETEXT$
	$STYLE$
	$_DATELONG$
	$_DATELONG2$
	$_DATENUM$
	$_DATESHORT$
	$_DATESHORTER$
	$_DATETIME$
	$_DATEYEAR$

=> test3.html: unchanged, skipped
=> test4.txt: unchanged, skipped
=> test2.html: GENERATED, using ascii
=> subdir: non-file, skipped
=> main.css: COPIED unchanged
=> test1.html: GENERATED, using latin1

Done: 2 generated, 1 copied, 3 skipped, 0 failed.

-------------------------------------------------------------------------------
Inserts and templates folders
-------------------------------------------------------------------------------

c:\...\genhtml> dir /B Html-inserts
AHEADER.txt
FOOTER-COMMON.txt
FOOTERBLUE.txt
FOOTERGREY.txt
FOOTERMAIN.txt
HEADERLEFT-UNUSED.txt
ICON.txt
SCRIPT.txt
SIMPLETEXT.txt
STYLE.txt

c:\...\genhtml> dir /B Html-templates
main.css
subdir
test1.html
test2.html
test3.html
test4.txt

-------------------------------------------------------------------------------
Change/save some site files
-------------------------------------------------------------------------------

c:\...\genhtml> notepad Html-templates\test1.html

c:\...\genhtml> notepad Html-templates\test2.html

c:\...\genhtml> notepad Html-templates\test4.txt

-------------------------------------------------------------------------------
Generate all changed files (command line or script icon click)
-------------------------------------------------------------------------------

c:\...\genhtml> genhtml.py
Will replace all: 
        $AHEADER$
        $FOOTER-COMMON$
        $FOOTERBLUE$
        $FOOTERGREY$
        $FOOTERMAIN$
        $HEADERLEFT-UNUSED$
        $ICON$
        $SCRIPT$
        $SIMPLETEXT$
        $STYLE$
        $_DATELONG$
        $_DATENUM$
        $_DATESHORT$
        $_DATETIME$
        $_DATEYEAR$

=> main.css: unchanged, skipped
=> subdir: non-file, skipped
=> test1.html: GENERATED, using latin1
=> test2.html: GENERATED, using ascii
=> test3.html: unchanged, skipped
=> test4.txt: COPIED unchanged

Done: 2 generated, 1 copied, 3 skipped, 0 failed.
Press enter to close.

-------------------------------------------------------------------------------
Open result file in target folder
-------------------------------------------------------------------------------

c:\...\genhtml> start Complete\test1.html

-------------------------------------------------------------------------------
Changing inserts triggers regens of its template users (only)
-------------------------------------------------------------------------------

c:\...\genhtml> notepad Html-inserts\ICON.txt

c:\MARKS-STUFF\Code\genhtml> genhtml.py
Will replace all:
        $AHEADER$
        $FOOTER-COMMON$
        $FOOTERBLUE$
        $FOOTERGREY$
        $FOOTERMAIN$
        $HEADERLEFT-UNUSED$
        $ICON$
        $SCRIPT$
        $SIMPLETEXT$
        $STYLE$
        $_DATELONG$
        $_DATENUM$
        $_DATESHORT$
        $_DATETIME$
        $_DATEYEAR$

=> main.css: unchanged, skipped
=> subdir: non-file, skipped
=> test1.html: GENERATED, using latin1
=> test2.html: unchanged, skipped
=> test3.html: unchanged, skipped
=> test4.txt: unchanged, skipped

Done: 1 generated, 0 copied, 5 skipped, 0 failed.
Press enter to close.

-------------------------------------------------------------------------------
No regens if no template or insert changes
-------------------------------------------------------------------------------

c:\...\genhtml> genhtml.py
Will replace all:
        $AHEADER$
        $FOOTER-COMMON$
        $FOOTERBLUE$
        $FOOTERGREY$
        $FOOTERMAIN$
        $HEADERLEFT-UNUSED$
        $ICON$
        $SCRIPT$
        $SIMPLETEXT$
        $STYLE$
        $_DATELONG$
        $_DATENUM$
        $_DATESHORT$
        $_DATETIME$
        $_DATEYEAR$

=> main.css: unchanged, skipped
=> subdir: non-file, skipped
=> test1.html: unchanged, skipped
=> test2.html: unchanged, skipped
=> test3.html: unchanged, skipped
=> test4.txt: unchanged, skipped

Done: 0 generated, 0 copied, 6 skipped, 0 failed.
Press enter to close.

-------------------------------------------------------------------------------
Changing insert used by inserts regens templates transitively (nested inserts)
-------------------------------------------------------------------------------

c:\...\genhtml>notepad  Html-inserts\FOOTER-COMMON.txt

c:\...\genhtml>genhtml.py
Will replace all:
        $AHEADER$
        $FOOTER-COMMON$
        $FOOTERBLUE$
        $FOOTERGREY$
        $FOOTERMAIN$
        $HEADERLEFT-UNUSED$
        $ICON$
        $SCRIPT$
        $SIMPLETEXT$
        $STYLE$
        $_DATELONG$
        $_DATENUM$
        $_DATESHORT$
        $_DATETIME$
        $_DATEYEAR$

=> main.css: unchanged, skipped
=> subdir: non-file, skipped
=> test1.html: GENERATED, using latin1
=> test2.html: GENERATED, using ascii
=> test3.html: unchanged, skipped
=> test4.txt: unchanged, skipped

Done: 2 generated, 0 copied, 4 skipped, 0 failed.
Press enter to close.

-------------------------------------------------------------------------------
Regen selected files after changing an insert used by some templates
-------------------------------------------------------------------------------

c:\...\genhtml> notepad Html-inserts\SCRIPT.txt

c:\...\genhtml> genhtml.py test1.html test3.html
Will replace all:
        $AHEADER$
        $FOOTER-COMMON$
        $FOOTERBLUE$
        $FOOTERGREY$
        $FOOTERMAIN$
        $HEADERLEFT-UNUSED$
        $ICON$
        $SCRIPT$
        $SIMPLETEXT$
        $STYLE$
        $_DATELONG$
        $_DATENUM$
        $_DATESHORT$
        $_DATETIME$
        $_DATEYEAR$

=> test1.html: GENERATED, using latin1
=> test3.html: unchanged, skipped

Done: 1 generated, 0 copied, 1 skipped, 0 failed.
Press enter to close.

-------------------------------------------------------------------------------
Later generate-all picks up other file impacted by prior insert change
-------------------------------------------------------------------------------

c:\...\genhtml> genhtml.py
Will replace all:
        $AHEADER$
        $FOOTER-COMMON$
        $FOOTERBLUE$
        $FOOTERGREY$
        $FOOTERMAIN$
        $HEADERLEFT-UNUSED$
        $ICON$
        $SCRIPT$
        $SIMPLETEXT$
        $STYLE$
        $_DATELONG$
        $_DATENUM$
        $_DATESHORT$
        $_DATETIME$
        $_DATEYEAR$

=> main.css: unchanged, skipped
=> subdir: non-file, skipped
=> test1.html: unchanged, skipped
=> test2.html: GENERATED, using ascii
=> test3.html: unchanged, skipped
=> test4.txt: unchanged, skipped

Done: 1 generated, 0 copied, 5 skipped, 0 failed.
Press enter to close.

-------------------------------------------------------------------------------
Use in another folder
-------------------------------------------------------------------------------

c:\...\Websites\Books\Current> genhtml.py index-book-links.html index.html
Will replace all:
        $FOOTER-COMMON$
        $FOOTERBLUE$
        $FOOTERGREY$
        $FOOTERMAIN$
        $FOOTERSIENNA$
        $FOOTERTAN$
        $ICON$
        $SCRIPT$
        $STYLE$
        $_DATELONG$
        $_DATENUM$
        $_DATESHORT$
        $_DATETIME$
        $_DATEYEAR$

=> index-book-links.html: GENERATED, using ascii
=> index.html: unchanged, skipped

Done: 1 generated, 0 copied, 1 skipped, 0 failed.
Press enter to close.