'''shtmlview::shtmlview'''
    
    * Project page: hhttps://github.com/mittelmark/DGTcl
    * Download: https://downgit.github.io/#/home?url=https://github.com/mittelmark/DGTcl/tree/master/lib/shtmlview
    * Manual: http://htmlpreview.github.io/?https://github.com/mittelmark/DGTcl/blob/master/lib/shtmlview/shtmlview.html
    * Version: 1.0.0

[DDG] 2018-11-09: A [snidget] widget based on [Stephen Uhler%|%Stephen Uhler's%|%] and [Clif Flynt%|%Clif Flynt's%|%] [HTML display] and [Robert Heller]'s [ftp://ftp.deepsoft.com/pub/deepwoods/Other/htmlhelp-packages.tar.gz%|%htmlhelp%|%] tool. The ''shtmlview::shtmlview'' widget can render a reasonable subset of HTML and since version 1.0, via tcllib Markdown library, of [Markdown].  It is useful where the developer has control over the content to be rendered. It is not a full fledged web browser and should be used only for local HTML and Markdown files.

[DDG] 2020-01-27: Version 0.9.1, just bug fixes and small extensions:
    * fixed typo in package provide
    * remove style section in body
    * mirror project on chiselapp
    * extension: `--version` option and standalone execution as html-browser: `tclsh shtmlview.tcl filename.html`

[DDG] 2022-03-10: Version 0.9.3:
    * support for mouse-wheel
    * bug fixes for text copy 
    * bug fix for http(s) links and anchor links
    * thanks to aplsimple for report as suggestions
 
[DDG] 2022-03-12: Version 1.0.0
    * support for Markdown markup via Tcllibs Markdown library
    * support for base64 encoded images in HTML code
    * anchor links now as well in history 
    * toolbar bugfix
    * file normalize used to avoid problems with directory changes in documentation

'''Installation as Tcl-module'''

Put the directory with the source code somewhere in a directory like /home/username/tcl/shtmlview/shtmlview-1.0.0.tm - in your Tcl code you would now have to write:

======
 tcl::tm::path add /home/username/tcl
 package require shtmlview::shtmlview
======

'''Installation as Tcl package'''

Just the usual copy of the shtmlview folder into your package path.

See [https://chiselapp.com/user/dgroth/repository/tclcode/doc/tip/shtmlview/shtmlview.html|manual page] on github for information of installation and usage. Below some example usage for creating a standalone script for viewing local HTML files.

'''Example'''
======
tcl::tm::path add /home/username/tcl
package require shtmlview::shtmlview
if {[info exists argv0] && $argv0 eq [info script]} {
    if {[llength $argv] == 1 && [file exists [lindex $argv 0]]} {
       wm title . "shtmlview widget demo"
       set help [::shtmlview::shtmlview .help \
                  -tablesupport true -home [lindex $argv 0]]
       $help browse [lindex $argv 0] 
       pack $help -side top -fill both -expand true
 } else {
    puts "Usage: $argv0 htmlfile"
    exit 0
 }
}
======

[img_shtmlview]

'''Discussion'''

Please discuss here.

<<categories>> Package | Widget | Snit Widgets | HTML