JOB 16-08-22
Modified the source of the helpviewer package - based on Tkhtml2. Please see code below.
Some notes:
- Tkhtml3 html widget command has a different interface compared to Thktml2 and is not very well documented, which makes it hard to do any development, so for the moment Tkhtml2.0 - although not actively developed any more - is still an option to choose.
- There are various dependencies in order to run the helpviewer, which are non included here.
# #############################################################################
# This software is copyrighted by Ramon Ribó (RAMSAN) ramsan@cimne.upc.es.
# (http://gid.cimne.upc.es/ramsan) The following terms apply to all files
# associated with the software unless explicitly disclaimed
# in individual files.
# The authors hereby grant permission to use, copy, modify, distribute,
# and license this software and its documentation for any purpose, provided
# that existing copyright notices are retained in all copies and that this
# notice is included verbatim in any distributions. No written agreement,
# license, or royalty fee is required for any of the authorized uses.
# Modifications to this software may be copyrighted by their authors
# and need not follow the licensing terms described here, provided that
# the new terms are clearly indicated on the first page of each file where
# they apply.
# IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
# FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
# ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
# DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
# THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
# INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE
# IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE
# NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR
# MODIFICATIONS.
# #############################################################################
# -----------------------------------------------------------------------------
# (c) 2016, Johann Oberdorfer - Engineering Support | CAD | Software
# johann.oberdorfer [at] gmail.com
# www.johann-oberdorfer.eu
#
# helpviewer modified to work with actual BWidget packages
# and some various improvements done, respectively:
# - search dialog behavior
# - pan package added, ...
# - changes to implement tiled widget set, ...
# -----------------------------------------------------------------------------
# TO-DO:
# - Implement breadcrumps navigation info for a better
# user experience when browsing through various help files ...
# - zoom font size up/down (stylemanager)
# -----------------------------------------------------------------------------
lappend auto_path [file dirname [info script]]
package provide helpviewer 2.0
# requiring exactly 2.0 to avoid getting the one from Activestate
package require -exact Tkhtml 2.0
package require -exact BWidget 1.9.10
package require BWidget_patch
Widget::theme 1
package require fileutil
# package is optional
catch { package require Pan }
if { [info command tkTabToWindow] == "" } {
proc tkTabToWindow {w} {
focus $w
after 100 {
set w [focus]
if {[string equal [winfo class $w] Entry]} {
$w selection range 0 end
$w icursor end
}
}
}
}
set comms [list tkButtonInvoke tkTextSelectTo tkEntryInsert tkEntryBackspace \
tk_textCut tk_textCopy tk_textPaste tk_focusNext tk_focusPrev tkTextClosestGap \
tkTextAutoScan tkCancelRepeat]
foreach i $comms {
auto_load $i
if {![llength [info commands $i]]} {
tk::unsupported::ExposePrivateCommand $i
}
}
namespace eval History {
variable list ""
variable pos
variable menu
proc Add { name } {
variable list
variable pos
variable menu
lappend list $name
set pos [expr [llength $list]-1]
if { $pos == 0 } {
if { [info exists menu] && [winfo exists $menu] } {
$menu entryconf Backward -state disabled
}
} else {
if { [info exists menu] && [winfo exists $menu] } {
$menu entryconf Backward -state normal
}
}
if { [info exists menu] && [winfo exists $menu] } {
$menu entryconf Forward -state disabled
}
}
proc GoHome { w } {
variable list
variable pos
variable menu
set pos 0
if { [info exists menu] && [winfo exists $menu] } {
$menu entryconf Backward -state disabled
}
if { [info exists menu] && [winfo exists $menu] } {
$menu entryconf Forward -state normal
}
# HelpViewer::LoadRef $w [lindex $list $pos] 0
HelpViewer::LoadRef $w [file join $HelpViewer::HelpBaseDir index.htm] 0
}
proc GoBackward { w } {
variable list
variable pos
variable menu
incr pos -1
if { $pos == 0 } {
if { [info exists menu] && [winfo exists $menu] } {
$menu entryconf Backward -state disabled
}
}
if { [info exists menu] && [winfo exists $menu] } {
$menu entryconf Forward -state normal
}
HelpViewer::LoadRef $w [lindex $list $pos] 0
}
proc GoForward { w } {
variable list
variable pos
variable menu
incr pos 1
if { $pos == [expr [llength $list]-1] } {
if { [info exists menu] && [winfo exists $menu] } {
$menu entryconf Forward -state disabled
}
}
if { [info exists menu] && [winfo exists $menu] } {
$menu entryconf Backward -state normal
}
HelpViewer::LoadRef $w [lindex $list $pos] 0
}
}
namespace eval HelpPrefs {
variable tttrick 0
variable RunningAlone 0
}
# -----------------------------------------------------------------------------
# -----------------------------------------------------------------------------
namespace eval HelpViewer {
variable HelpBaseDir
variable LastFileList
# These images are used in place of GIFs or of form elements
#
if { [lsearch [image names] biggray] == -1 } {
image create photo biggray -data {
R0lGODdhPAA+APAAALi4uAAAACwAAAAAPAA+AAACQISPqcvtD6OctNqLs968+w+G4kiW5omm
6sq27gvH8kzX9o3n+s73/g8MCofEovGITCqXzKbzCY1Kp9Sq9YrNFgsAO///
}
image create photo smgray -data {
R0lGODdhOAAYAPAAALi4uAAAACwAAAAAOAAYAAACI4SPqcvtD6OctNqLs968+w+G4kiW5omm
6sq27gvH8kzX9m0VADv/
}
image create photo nogifbig -data {
R0lGODdhJAAkAPEAAACQkADQ0PgAAAAAACwAAAAAJAAkAAACmISPqcsQD6OcdJqKM71PeK15
AsSJH0iZY1CqqKSurfsGsex08XuTuU7L9HywHWZILAaVJssvgoREk5PolFo1XrHZ29IZ8oo0
HKEYVDYbyc/jFhz2otvdcyZdF68qeKh2DZd3AtS0QWcDSDgWKJXY+MXS9qY4+JA2+Vho+YPp
FzSjiTIEWslDQ1rDhPOY2sXVOgeb2kBbu1AAADv/
}
image create photo nogifsm -data {
R0lGODdhEAAQAPEAAACQkADQ0PgAAAAAACwAAAAAEAAQAAACNISPacHtD4IQz80QJ60as25d
3idKZdR0IIOm2ta0Lhw/Lz2S1JqvK8ozbTKlEIVYceWSjwIAO///
}
}
if { [lsearch [image names] imatge_fletxa_e] == -1 } {
image create photo imatge_fletxa_e -data {
R0lGODlhJwAeAJECAE5qmoWh0f///wAAACH5BAEAAAIALAAAAAAnAB4AAAJb
lI+py+0Po5y00mBzCCDf3XnRBooQWZoNmqoK27oHTNc2Y+c69+4+HJr9hqSg
gIjkIZJDo4Hpcz6hOemUSrNeUYCu9wsOdx1AGY5rPsfSyzVbqH0r34s4/Y4v
AAA7
}
image create photo imatge_fletxa_d -data {
R0lGODlhJwAeAJECAE5qmoWh0f///wAAACH5BAEAAAIALAAAAAAnAB4AAAJa
lI+py+0Po5y0WhfuDVlT3nkRGIoYaT4klzYr677yPMf0fTP4Ti/8/1IAh6AE
cQgAII6/pJGJcz6hM6kiic1qtwCZtWV4fcGC1ZhMOqM56nUb/SYLlPK63VAA
ADs=
}
image create photo imatge_quit -data {
R0lGODlhIAAeAJECAE5qmoWh0f///wAAACH5BAEAAAIALAAAAAAgAB4AAAJm
lI+py+0Powq02kulwNwC2YVfVAHmiaYgNWpP6QYvG8sNrFU3nesLHgr+eEFh
AlgMHYlJ5QHZxJiezKintalaA1METpAKm64T3oqLpXJr3fI613anIXPvtmet
D/MasT/uEig4eFAAADs=
}
image create photo imatge_save -data {
R0lGODlhIAAeAOcAAEdjk05qmktnl1VxoWuHt2yIuUhklUlllVJunmSAsHuX
x4ik1Iml1YSg0EhklE9rm197q3aSwoai0oej04Wh0YSg0V57q01pmVt3p3GN
vYGez3yazpuy2YGe0XWRwVdzo2yIuIGdzYKf0IGe0KC229Lc7vz9/v///4Og
0FFtnUpmllNvn2eDs32ZyX2bzn+cz5ev2MfU6vT3+6W63YSh02N/r1BsnGJ+
rnmVxYSh0X6cz4+o1bvL5uzw+Njh8HqWxkpnl4Cdz4ij0rDC4eLp9P7+/1Rw
oExomIKezoKg0miEtEdklGmFtY2o1Pj6/H6by4ql04+p1Yej1Fh0pNvj8evw
+L/N54mk022JuWSAsYOh06i83vT2+8bT6pau14Kez/r7/fv8/dHc7qC123iY
zVx4qHaTw36c0NDb7dzk8qq933mYzXuZz4ah0aK11ZSs04Kf0XKOvmB8rIWi
1J602ufs9rXG44ul03qZzXmYzoOf0Zmv1LvH2Nbb3OPk3b/K2X+d0Pn6/fH1
+sDP55Kr1niYzoCd0JKq07PC19HX297g3d3f3djc3Nfb3Iai0WF9rXGOvoOg
0pCq1X+dz3uZzn2bz42n07LD3MvT2tzf3d3g3dnd3KG11XiUxMXP2tXY16Kp
p8vPz9vf39ve3MPN2X+c0MnT4H+Kiic5PomTluLl5drd3Iul0mWBsaK32b7D
wDlKTlRjZt3h4eXl3qm61oqm1tne4FNiZTpKT7rAwd3h4Nre3MTO2aO21Yei
0V56qsLO4Y6Xlig7P3mFh+Pl5Kq71oum0oCe0YSi1Jmw1svOzIaPj8fLyLLB
15Gq04Oh1Iek1H6aylNvoM3U2sPP4Jyy14Kg04ej1YOg0YCe0oaj1XeTw3yY
yIWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh
0YWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh0YWh
0YWh0YWh0YWh0YWh0YWh0SH5BAEAAP8ALAAAAAAgAB4AAAj+AP8JHEiwoEEA
AQwqXHhQwAACBQwwnFjwAIIEChYwaJCQIkMHDyBEkMBgAoUKDCx4NOjgAoYM
DUpS0LCBAocOHg6s/AdAwAcQIRgsoCBiwwgSJUycQCEhhUcVK1i0WLBAAgoX
L2DEkHGi64kZNGowPGDjBo4JDCTk0OFiB48eXuP60PEDiMIUESjIDLJByBAi
cQOfKCJkghGFR5BIKIpiho8igiMPSaJkCUsmDJqUcBK58wkiOp4cUThgAhTP
qKNImaJQgAIdVFALrmLlCgMsDg5m0bJFdlcuXbywrUDhywWFCCRUAOM5jJgx
GsiIoEBdbxmFB8ycQRM5jRoKa9j+tHHzBk71BXF0GpQzh07cOnbu4MmjZw+f
Pn7+AKpO3YbCBw1oEIgggxCyQSGGHIJIIooswggjjTjCHwOPYAdJJJJMQkkl
llyCSSaabPLgg4pwMkJ1E3SigkIYMECdI558Akoooow44iik7IciAgpdEIIE
FJRiyimopKKKjSOuwgpx1DHQCgAsFTBUB668AksssiDJyCiz0NIBdRPUosBo
Bn0wFAU52HILLrno8uAuiuzCSy++oCWBB78EcJxBR7QAJCDABCPMMMRokgkm
xRhzDDIT/FBDCuotBAALLsKRjDLLMJNIM8508Aw00ShhxIorSWMSBXBMQ001
elhzDRI1WExxBJQ7/aPCWRRgQ0E22lAQRxkX5FYrQTekVdI2cjwQ6bAEpbAA
N60gQCqziK0gAK3UBgQAOw==
}
image create photo appbook16 -data {
R0lGODlhEAAQAIQAAPwCBAQCBDyKhDSChGSinFSWlEySjCx+fHSqrGSipESO
jCR6dKTGxISytIy6vFSalBxydAQeHHyurAxubARmZCR+fBx2dDyKjPz+/MzK
zLTS1IyOjAAAAAAAAAAAAAAAACH5BAEAAAAALAAAAAAQABAAAAVkICCOZGmK
QXCWqTCoa0oUxnDAZIrsSaEMCxwgwGggHI3E47eA4AKRogQxcy0mFFhgEW3M
CoOKBZsdUrhFxSUMyT7P3bAlhcnk4BoHvb4RBuABGHwpJn+BGX1CLAGJKzmK
jpF+IQAh/mhDcmVhdGVkIGJ5IEJNUFRvR0lGIFBybyB2ZXJzaW9uIDIuNQ0K
qSBEZXZlbENvciAxOTk3LDE5OTguIEFsbCByaWdodHMgcmVzZXJ2ZWQuDQpo
dHRwOi8vd3d3LmRldmVsY29yLmNvbQA7
}
image create photo appbookopen16 -data {
R0lGODlhEAAQAIUAAPwCBAQCBExCNGSenHRmVCwqJPTq1GxeTHRqXPz+/Dwy
JPTq3Ny+lOzexPzy5HRuVFSWlNzClPTexIR2ZOzevPz29AxqbPz6/IR+ZDyK
jPTy5IyCZPz27ESOjJySfDSGhPTm1PTizJSKdDSChNzWxMS2nIR6ZKyijNzO
rOzWtIx+bLSifNTGrMy6lIx+ZCRWRAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH5BAEAAAAALAAAAAAQABAAAAae
QEAAQCwWBYJiYEAoGAFIw0E5QCScAIVikUgQqNargtFwdB9KSDhxiEjMiUlg
HlB3E48IpdKdLCxzEAQJFxUTblwJGH9zGQgVGhUbbhxdG4wBHQQaCwaTb10e
mB8EBiAhInp8CSKYIw8kDRSfDiUmJ4xCIxMoKSoRJRMrJyy5uhMtLisTLCQk
C8bHGBMj1daARgEjLyN03kPZc09FfkEAIf5oQ3JlYXRlZCBieSBCTVBUb0dJ
RiBQcm8gdmVyc2lvbiAyLjUNCqkgRGV2ZWxDb3IgMTk5NywxOTk4LiBBbGwg
cmlnaHRzIHJlc2VydmVkLg0KaHR0cDovL3d3dy5kZXZlbGNvci5jb20AOw==
}
image create photo filedocument16 -data {
R0lGODlhEAAQAIUAAPwCBFxaXNze3Ly2rJSWjPz+/Ozq7GxqbJyanPT29HRy
dMzOzDQyNIyKjERCROTi3Pz69PTy7Pzy7PTu5Ozm3LyqlJyWlJSSjJSOhOzi
1LyulPz27PTq3PTm1OzezLyqjIyKhJSKfOzaxPz29OzizLyidIyGdIyCdOTO
pLymhOzavOTStMTCtMS+rMS6pMSynMSulLyedAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH5BAEAAAAALAAAAAAQABAAAAaQ
QIAQECgajcNkQMBkDgKEQFK4LFgLhkMBIVUKroWEYlEgMLxbBKLQUBwc52Hg
AQ4LBo049atWQyIPA3pEdFcQEhMUFYNVagQWFxgZGoxfYRsTHB0eH5UJCJAY
ICEinUoPIxIcHCQkIiIllQYEGCEhJicoKYwPmiQeKisrKLFKLCwtLi8wHyUl
MYwM0tPUDH5BACH+aENyZWF0ZWQgYnkgQk1QVG9HSUYgUHJvIHZlcnNpb24g
Mi41DQqpIERldmVsQ29yIDE5OTcsMTk5OC4gQWxsIHJpZ2h0cyByZXNlcnZl
ZC4NCmh0dHA6Ly93d3cuZGV2ZWxjb3IuY29tADs=
}
image create photo viewmag16 -data {
R0lGODlhEAAQAIUAAPwCBCQmJDw+PAwODAQCBMza3NTm5MTW1HyChOTy9Mzq
7Kze5Kzm7OT29Oz6/Nzy9Lzu7JTW3GTCzLza3NTy9Nz29Ize7HTGzHzK1AwK
DMTq7Kzq9JTi7HTW5HzGzMzu9KzS1IzW5Iza5FTK1ESyvLTa3HTK1GzGzGzG
1DyqtIzK1AT+/AQGBATCxHRydMTCxAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH5BAEAAAAALAAAAAAQABAAAAZ8
QIAQEBAMhkikgFAwHAiC5FCASCQUCwYiKiU0HA9IRAIhSAcTSuXBsFwwk0wy
YNBANpyOxPMxIzMgCyEiHSMkGCV+SAQQJicoJCllUgBUECEeKhAIBCuUSxMK
IFArBIpJBCxmLQQuL6eUAFCusJSzr7GLArS5Q7O1tmZ+QQAh/mhDcmVhdGVk
IGJ5IEJNUFRvR0lGIFBybyB2ZXJzaW9uIDIuNQ0KqSBEZXZlbENvciAxOTk3
LDE5OTguIEFsbCByaWdodHMgcmVzZXJ2ZWQuDQpodHRwOi8vd3d3LmRldmVs
Y29yLmNvbQA7
}
}
}
proc HelpViewer::GiveLastFile { w } {
variable LastFileList
set retval ""
catch {
set w [winfo toplevel $w]
set retval $LastFileList($w)
}
return $retval
}
proc HelpViewer::EnterLastFile { w file } {
variable LastFileList
set w [winfo toplevel $w]
set LastFileList($w) $file
}
# A font chooser routine.
#
# $base.h.h config -fontcommand pickFont
proc HelpViewer::pickFont {size attrs} {
global tcl_platform
if { [lsearch [font names] HelpFont] != -1 } {
set family [font conf HelpFont -family]
set fsize [font conf HelpFont -size]
} else {
set family "Helvetica"
switch $::tcl_platform(platform) {
windows { set fsize 12 }
default { set fsize 15 }
}
}
if { $HelpPrefs::tttrick } {
set a [expr {-1<[lsearch $attrs fixed]?{Symbol}:"$family"}]
} else {
set a [expr {-1<[lsearch $attrs fixed]?{Courier}:"$family"}]
}
set b [expr {-1<[lsearch $attrs italic]?{italic}:{roman}}]
set c [expr {-1<[lsearch $attrs bold]?{bold}:{normal}}]
set d [expr int($fsize*pow(1.2,$size-4))]
# if { $tcl_platform(platform) != "windows"} {
# set d [expr {3+int(12*pow(1.2,$size-4))}]
# } else {
# set d [expr {3+int(12*pow(1.2,$size-6))}]
# }
list $a $d $b $c
}
# This routine is called for each form element
#
proc HelpViewer::FormCmd {n cmd args} {
# puts "FormCmd: $n $cmd $args"
switch $cmd {
select -
textarea -
input {
set w [lindex $args 0]
label $w -image nogifsm
}
}
}
proc HelpViewer::ImageCmd {args} {
global OldImages Images showImages
if {!$showImages} {
return smgray
}
set fn [lindex $args 0]
set list [file split $fn]
if { [lindex $list 0] == "." } {
set list [lrange $list 1 end]
}
set fn [eval [concat "file join $list"]]
if { [file dirname $fn] == "." } {
set fn [file tail $fn]
}
if {[info exists OldImages($fn)]} {
set Images($fn) $OldImages($fn)
unset OldImages($fn)
return $Images($fn)
}
if {[catch {image create photo -file $fn} img]} {
return smgray
}
if {[image width $img]*[image height $img]>20000} {
global BigImages
set b [image create photo -width [image width $img] \
-height [image height $img]]
set BigImages($b) $img
set img $b
after idle "HelpViewer::MoveBigImage $b"
}
set Images($fn) $img
return $img
}
proc HelpViewer::MoveBigImage b {
global BigImages
if {![info exists BigImages($b)]} return
$b copy $BigImages($b)
image delete $BigImages($b)
unset BigImages($b)
update
}
# This routine is called for every <SCRIPT> markup
#
proc HelpViewer::ScriptCmd {args} {
# puts "ScriptCmd: $args"
}
# This routine is called for every <APPLET> markup
#
proc HelpViewer::AppletCmd {w arglist} {
# puts "AppletCmd: w=$w arglist=$arglist"
ttk::label $w -text "The Applet $w"
}
# This procedure is called when the user clicks on a hyperlink.
# See the "bind $base.h.h.x" below for the binding that invokes this
# procedure
#
proc HelpViewer::HrefBinding {w x y} {
set new [$w href $x $y]
catch {
if { [llength $new] == 1 } {
set new [lindex $new 0]
if { [llength $new] == 1 } {
set new [lindex $new 0]
}
}
}
LoadRef $w $new
}
proc HelpViewer::LoadRef { w new { enterinhistory 1 } } {
global tcl_platform
if { [regexp {http:/localhost/cgi-bin/man/man2html\?(\w+)\+(\w+)} $new {} sec word] } {
SearchManHelpFor $w $word $sec
return
} elseif { $new != "" && [regexp {[a-zA-Z]+[a-zA-Z]:.*} $new] } {
regexp {http:/.*} $new url
if { [regexp {:/[^/]} $url] } {
regsub {:/} $url {://} url
}
if { $tcl_platform(platform) != "windows"} {
set comm [auto_execok konqueror]
if { $comm == "" } {
set comm [auto_execok netscape]
}
if { $comm == "" } {
tk_messageBox -icon warning -message \
"Check url: $url in your web browser." -type ok
} else {
exec $comm $url &
}
} else {
global env
if {[file exists [file join $env(ProgramFiles) "internet explorer" iexplore.exe]]} {
exec [file join $env(ProgramFiles) "internet explorer" iexplore.exe] $url &
} else {
tk_messageBox -icon warning -message \
"Check url: $url in your web browser." -type ok
}
# set comm [freewrap::shell_getCmd_imp .html open]
# if { $comm == "" } {
# tk_messageBox -icon warning -message \
# "Check url: $url in your web browser." -type ok
# } else {
# regsub -all {\\} $comm {\\\\} comm
# exec "$comm" $url &
# }
}
return
}
if {$new!=""} {
set LastFile [GiveLastFile $w]
if { [string match \#* [file tail $new]] } {
set new $LastFile[file tail $new]
}
set pattern $LastFile#
set len [string length $pattern]
incr len -1
if {[string range $new 0 $len]==$pattern} {
incr len
$w yview [string range $new $len end]
if { $enterinhistory } {
History::Add $new
}
} elseif { [regexp {(.*)\#(.*)} $new {} file tag] } {
LoadFile $w $file $enterinhistory $tag
} else {
LoadFile $w $new $enterinhistory
}
}
}
proc HelpViewer::Load { w } {
set filetypes {
{{Html Files} {.html .htm}}
{{All Files} *}
}
global lastDir htmltext
set f [tk_getOpenFile -initialdir $lastDir -filetypes $filetypes]
if {$f!=""} {
LoadFile $w $f
set lastDir [file dirname $f]
}
}
# Clear the screen.
#
proc HelpViewer::Clear { w } {
global Images OldImages hotkey
$w clear
catch {unset hotkey}
}
proc HelpViewer::ClearOldImages {} {
global OldImages
# foreach fn [array names OldImages] {
# image delete $OldImages($fn)
# }
# catch {unset OldImages}
}
proc HelpViewer::ClearBigImages {} {
global BigImages
# foreach b [array names BigImages] {
# image delete $BigImages($b)
# }
# catch {unset BigImages}
}
proc HelpViewer::ReadFile {name} {
#
# read html file and try to detect charset
# return value is a string holding all the html stuff
#
if { [file dirname $name] == "." } {
set name [file tail $name]
}
if {[catch {open $name r} fp]} {
tk_messageBox -icon error -message $fp -type ok
return {}
} else {
fconfigure $fp -translation binary
set r [read $fp [file size $name]]
close $fp
# attempt to detect charset="UTF-8" !
if { [regexp {(?i)<meta\s+[^>]*charset=utf-8[^>]*>} $r] ||
[string first "charset=utf-8" [string tolower $r]] != -1 ||
[string first "charset=\"utf-8\"" [string tolower $r]] != -1 } {
set fp [open $name r]
fconfigure $fp -encoding utf-8
set r [read $fp]
close $fp
}
return $r
}
}
# Load a file into the HTML widget
#
proc HelpViewer::LoadFile {w name { enterinhistory 1 } { tag "" } } {
global HelpPriv
if { $name == "" } { return }
if { [file isdir $name] } {
set files [glob -dir $name *]
set ipos [lsearch -regexp $files {(?i)(index|contents|_toc)\.(htm|html)}]
if { $ipos != -1 } {
set name [lindex $files $ipos]
} else { return }
}
set html [ReadFile $name]
if {$html == ""} return
Clear $w
EnterLastFile $w $name
$w config -base $name
if { $enterinhistory } {
if { $tag == "" } {
History::Add $name
} else {
History::Add $name#$tag
}
}
$w sel clear
$w parse $html
ClearOldImages
if { $tag != "" } {
update idletasks
$w yview $tag
}
TryToSelect $name
variable SearchPos
set SearchPos ""
}
proc HelpViewer::GiveManHelpNames { word } {
if { [auto_execok man2html] == "" } { return "" }
set err [catch { exec man -aw $word } file]
if { $err } { return "" }
set words ""
foreach i [split $file \n] {
set ext [string trimleft [file ext $i] .]
if { $ext == "gz" } { set ext [string trimleft [file ext [file root $i]] .] }
if { [lsearch $words "$word (man $ext)"] == -1 } {
lappend words "$word (man $ext)"
}
}
return $words
}
proc HelpViewer::SearchManHelpFor { w word { mansection "" } } {
if { $mansection == "" } {
regexp {(\S*)\s+\(man\s+(.*)\)} $word {} word mansection
}
set err [catch { exec man -aw $word } file]
if { $err } { return }
set files [split $file \n]
if { [llength $files] > 1 } {
set found 0
foreach i $files {
set ext [string trimleft [file ext $i] .]
if { $ext == "gz" } { set ext [string trimleft [file ext [file root $i]] .] }
if { $mansection == $ext } {
set found 1
set file $i
break
}
}
if { !$found } { set file [lindex $files 0] }
} else { set file [lindex $files 0] }
if { [file ext $file] == ".gz" } {
set comm [list exec gunzip -c $file | man2html]
} else { set comm [list exec man2html $file] }
set err [catch { eval $comm } html]
#if { $err } { return }
Clear $w
$w sel clear
$w parse $html
ClearOldImages
variable SearchPos
set SearchPos ""
}
# Refresh the current file.
#
proc HelpViewer::Refresh {w args} {
set LastFile [GiveLastFile $w]
if {![info exists LastFile] || ![winfo exists $w] } return
LoadFile $w $LastFile 0
}
proc HelpViewer::ResolveUri { args } {
return [file join [file dirname [lindex $args 0]] [lindex $args 1]]
}
proc HelpViewer::ManageSel { htmlw w x y type } {
global HelpPriv tcl_platform
if { ![winfo exists $w] } { return }
if { [winfo parent $w] != $htmlw } { return }
if { [info exists HelpPriv(lastafter)] } {
after cancel $HelpPriv(lastafter)
}
switch -glob $type {
press {
update idletasks
$htmlw sel clear
set idx [$htmlw index @$x,$y]
if { $idx == "" } { return }
$htmlw insert $idx
$htmlw sel set $idx $idx
}
motion* {
if { $type == "motion" } {
#set ini [$htmlw index sel.first]
set ini [$htmlw index insert]
if { $ini == "" } {
$htmlw sel clear
} else {
set idx [$htmlw index @$x,$y]
if { $idx <= $ini } {
$htmlw sel set $idx $ini
} else {
$htmlw sel set $ini $idx
}
}
}
set isout 0
if { $x > [winfo width $htmlw] } {
$htmlw xview scroll 1 units
set isout 1
} elseif { $x <0 } {
$htmlw xview scroll -1 units
set isout 1
}
if { $y > [winfo height $htmlw] } {
$htmlw yview scroll 1 units
set isout 1
} elseif { $y <0 } {
$htmlw yview scroll -1 units
set isout 1
}
if { $isout } {
set HelpPriv(lastafter) [after 100 HelpViewer::ManageSel \
$htmlw $w $x $y motionout]
}
}
release {
#set ini [$htmlw index sel.first]
set ini [$htmlw index insert]
if { $ini == "" } {
$htmlw sel clear
return
}
set idx [$htmlw index @$x,$y]
if { $idx == $ini } {
$htmlw sel clear
} else {
if { $idx <= $ini } {
$htmlw sel set $idx $ini
} else {
$htmlw sel set $ini $idx
}
}
if { $tcl_platform(platform) != "windows"} {
selection own -command "HelpViewer::LooseSelection $htmlw" $htmlw
}
}
}
}
proc HelpViewer::LooseSelection { w } {
$w sel clear
}
proc HelpViewer::CopySelected { w { offset 0 } { maxBytes 0} } {
global tcl_platform
set ini [$w index sel.first]
set end [$w index sel.last]
if { $ini == "" || $end == "" } { return }
regexp {([0-9]+)[.]([0-9]+)} $ini {} initoc inipos
regexp {([0-9]+)[.]([0-9]+)} $end {} endtoc endpos
#puts [$w token list $initoc $endtoc]
set rettext ""
set iposlast [expr $endtoc-$initoc]
set ipos 0
foreach i [$w token list $initoc $endtoc] {
set type [lindex $i 1]
set contents [join [lrange $i 2 end]]
switch -- $type {
Text {
set inichar 0
set endchar [string length $contents]
if { $ipos == 0 } {
set inichar $inipos
}
if { $ipos == $iposlast } {
set endchar [expr $endpos-1]
}
append rettext [string range $contents $inichar $endchar]
}
Space {
if { [lindex $contents 1] == 0 } {
append rettext " "
} else {
append rettext "\n"
}
}
}
incr ipos
}
if { $tcl_platform(platform) == "windows"} {
clipboard clear -displayof $w
clipboard append -displayof $w $rettext
} else {
return [string range $rettext $offset [expr $offset+$maxBytes-1]]
}
}
# what can be: HTML or Word or CSV
proc HelpViewer::SaveHTMLAs { w what } {
set fromfile [GiveLastFile $w]
switch $what {
HTML {
set types {
{{HTML file} {.html .htm} }
{{All Files} * }
}
set ext ".html"
set initial [file tail $fromfile]
}
Word {
set types {
{{Word file} {.doc} }
{{All Files} * }
}
set ext ".doc"
set initial [file root [file tail $fromfile]].doc
}
CSV {
set types {
{{CSV file} {.csv .txt} }
{{All Files} * }
}
set ext ".csv"
set initial [file root [file tail $fromfile]].csv
}
}
if { [file exists ConcretePrefs::reportexportdir] && \
[file isdir $ConcretePrefs::reportexportdir] } {
set defaultdir $ConcretePrefs::reportexportdir
} else { set defaultdir "" }
if { $::tcl_platform(platform) == "windows" } {
set tofile [tk_getSaveFile -defaultextension $ext -filetypes $types \
-initialfile $initial -parent $w -initialdir $defaultdir \
-title "Save Results"]
} else {
set tofile [Browser-ramR file save]
}
if { $tofile == "" } { return }
catch {
set ConcretePrefs::reportexportdir [file dirname $filename]
}
if { [file ext $tofile] == ".html" || [file ext $tofile] == ".htm" } {
set reportexportdir [file dirname $tofile]
set imgdir [file join $reportexportdir timages]
if { [file exists $imgdir] } {
set retval [tk_dialogRAM $w._tmp Warning \
[concat "Are you sure to delete directory "\
" '$imgdir' and all its contents?"]\
warning 0 OK Cancel]
if { $retval == 1 } { return }
if { [catch {
file delete -force $imgdir
} err] } {
tk_messageBox \
-icon warning -message \
"error: Could not delete directory '$imgdir' ($err)" \
-type ok
return
}
}
if { [catch {
file copy -force [file join [file dirname $fromfile] "timages"] \
$imgdir
file copy -force $fromfile $tofile
} err] } {
tk_messageBox \
-icon warning -message \
[concat "Problems exporting report to '$tofile' ($err). "\
"Check write permissions and disk space"] \
-type ok
return
}
} elseif { [file ext $tofile] == ".doc" || [file ext $tofile] == ".rtf" } {
rtf:HTML2RTF $fromfile $tofile "Ram Series"
} elseif { [file ext $tofile] == ".csv" || [file ext $tofile] == ".txt" } {
rtf:HTML2CSV $fromfile $tofile "Ram Series"
} else {
tk_messageBox \
-icon warning -message \
"Unknown extension for file '$tofile'" \
-type ok
return
}
set comm [FindApplicationForOpening $tofile]
# do not visualize
set comm ""
if { $comm == "" } {
tk_messageBox \
-icon warning -message \
"Report exported OK to file '$tofile'" \
-type ok
} else {
set text "Report exported OK to file '$tofile' Do you want to visualize it?"
set retval [tk_messageBox -default no -icon question -message $text \
-parent $w -title "Report exported" -type yesno]
if { $retval == "yes" } {
eval exec $comm [list [file native $tofile]] &
}
}
}
proc HelpViewer::HTMLToClipBoardCSV { w } {
set fromfile [GiveLastFile $w]
rtf:HTML2CSV $fromfile "" "Ram Series"
tk_messageBox \
-icon warning -message \
"Done" \
-type ok
}
proc HelpViewer::FindApplicationForOpening { file } {
if { $::tcl_platform(platform) == "windows" } {
return [auto_execok start]
} else {
set comm ""
switch [string tolower [file extension $file]] {
".htm" - ".html" {
set comm [auto_execok konqueror]
if { $comm == "" } {
set comm [auto_execok netscape]
}
}
".csv" - ".txt" {
set comm [auto_execok kspread]
}
}
}
return $comm
}
proc HelpViewer::HelpSearchWord { word } {
variable notebook
set HelpViewer::searchstring $word
$notebook raise search
SearchInAllHelp
}
proc HelpViewer::FillDir { tree node } {
variable HelpBaseDir
if { $node == "root" } {
set dir $HelpBaseDir
} else {
set dir [lindex [$tree itemcget $node -data] 1]
}
set idxfolder 0
set files ""
foreach i [glob -nocomplain -dir $dir *] {
lappend files [file tail $i]
}
foreach i [lsort -dictionary $files] {
set fullpath [file join $dir $i]
regsub {^[0-9]+} $i {} name
regsub -all {\s} $fullpath _ item
if { [file isdir $fullpath] } {
# exclude special directories ...
if { [string equal -nocase $i "images"] } { continue }
if { [string equal -nocase $i "externals"] } { continue }
if { [string equal -nocase $i "lib"] } { continue }
$tree insert $idxfolder $node $item \
-image appbook16 -text $name \
-data [list folder $fullpath] -drawcross allways
incr idxfolder
} elseif { [string match .htm* [file ext $i]] } {
set name [file root $i]
$tree insert end $node $item \
-image filedocument16 -text $name \
-data [list file $fullpath]
}
}
}
proc HelpViewer::moddir { idx tree node } {
variable HelpBaseDir
if { $idx && [$tree itemcget $node -drawcross] == "allways" } {
FillDir $tree $node
$tree itemconfigure $node -drawcross auto
if { [llength [$tree nodes $node]] } {
$tree itemconfigure $node -image appbookopen16
} else {
$tree itemconfigure $node -image appbook16
}
} else {
if { [lindex [$tree itemcget $node -data] 0] == "folder" } {
switch $idx {
0 { set img appbook16 }
1 { set img appbookopen16 }
}
$tree itemconfigure $node -image $img
}
}
}
proc HelpViewer::KeyPress { a } {
variable tree
variable searchstring
set node [$tree selection get]
if { [llength $node] != 1 } { return }
append searchstring $a
after 300 [list set HelpViewer::searchstring ""]
if { [$tree itemcget $node -open] == 1 && [llength [$tree nodes $node]] > 0 } {
set parent $node
set after 1
} else {
set parent [$tree parent $node]
set after 0
}
foreach i [$tree nodes $parent] {
if { !$after } {
if { $i == $node } {
if { [string length $HelpViewer::searchstring] > 1 } {
set after 2
} else {
set after 1
}
}
}
if { $after == 2 && [string match -nocase $HelpViewer::searchstring* \
[$tree itemcget $i -text]] } {
$tree selection clear
$tree selection set $i
$tree see $i
return
}
if { $after == 1 } { set after 2 }
}
foreach i [$tree nodes [$tree parent $node]] {
if { $i == $node } { return }
if { [string match -nocase $HelpViewer::searchstring* [$tree itemcget $i -text]] } {
$tree selection clear
$tree selection set $i
$tree see $i
return
}
}
}
proc HelpViewer::Select { tree num node } {
variable html
if { $node == "" } {
set node [$tree selection get]
if { [llength $node] != 1 } { return }
} elseif { ![$tree exists $node] } {
return
}
if { $num >= 1 } {
if { [$tree itemcget $node -open] == 0 } {
$tree itemconfigure $node -open 1
set idx 1
} else {
$tree itemconfigure $node -open 0
set idx 0
}
moddir $idx $tree $node
if { $num == 1 && $idx == 0 } {
return
}
# set selection and ...
# hans: bring current selection onto the screen
$tree selection set $node
$tree see $node
if { [llength [$tree selection get]] == 1 } {
set data [$tree itemcget [$tree selection get] -data]
if { $num >= 1 && $num <= 2 } {
LoadFile $html [lindex $data 1]
}
}
return
}
}
proc HelpViewer::TryToSelect { name } {
variable HelpBaseDir
variable tree
set nameL [file split $name]
set level [llength [file split $HelpBaseDir]]
set node root
while 1 {
set found 0
foreach i [$tree nodes $node] {
if { [lindex [$tree itemcget $i -data] 1] == [eval file join [lrange $nameL 0 $level]] } {
set found 1
break
}
}
if { !$found } { return }
if { [lindex [$tree itemcget $i -data] 0] == "folder" } {
if { [$tree itemcget $i -open] == 0 } {
$tree itemconfigure $i -open 1
}
moddir 1 $tree $i
}
if { $level == [llength $nameL]-1 } {
Select $tree 3 $i
return
}
set node $i
incr level
}
}
proc HelpViewer::Search {} {
variable html
if { ![info exists ::HelpViewer::searchstring] } {
set msg "Before using 'Continue search', use 'Search'"
append msg [winfo toplevel $html]
tk_messageBox \
-icon warning -message $msg \
-type ok
return
}
if { $HelpViewer::searchstring != "" } {
set comm [list $html text find $HelpViewer::searchstring]
if { $::HelpViewer::searchcase == 0 } {
lappend comm nocase
}
if { $HelpViewer::SearchType == "-forwards" } {
if { $HelpViewer::SearchPos != "" } {
lappend comm after $HelpViewer::SearchPos
} else {
lappend comm after 1.0
}
} else {
if { $HelpViewer::SearchPos != "" } {
lappend comm before $HelpViewer::SearchPos
} else {
lappend comm before end
}
}
set idx1 ""
foreach "idx1 idx2" [eval $comm] break
if { $idx1 == "" } {
# bell
} else {
scan $idx2 "%d.%d" line char
set idx2 $line.[expr $char+1]
$html selection set $idx1 [$html index $idx2]
set y [lindex [$html coords $idx1] 1]
if { $y == "" } { set y 0 }
set height [lindex [$html coords end] 1]
foreach "f1 f2" [$html yview] break
set ys [expr $y/double($height)-($f2-$f1)/2.0]
if { $ys < 0 } { set ys 0 }
$html yview moveto $ys
$html refresh
set HelpViewer::SearchPos $idx1
}
}
}
proc HelpViewer::SearchCmd {} {
#
# perform search as well on the html viewer widget content
# search up to the 1st occurance of the search string
# so that the string item is highlighted an immediately shown
# on the screen...
#
variable searchstring
variable searchcase
variable SearchType
if {$searchstring == ""} {
return
}
# search in the html widget as well!
set searchcase 0
set SearchType "-forwards"
# html widget needs some time to establish screen...
# catch maybe not really required, just in case...
after 200 "catch {[namespace current]::Search}"
}
proc HelpViewer::CenterWindow {w wparent} {
wm withdraw $w
update idletasks
set top [winfo toplevel [winfo parent $w]]
set width [winfo reqwidth $w]
set height [winfo reqheight $w]
if { [wm state $top] == "withdrawn" } {
set x [expr [winfo screenwidth $top]/2-$width/2]
set y [expr [winfo screenheight $top]/2-$height/2]
} else {
set x [expr [winfo x $top]+[winfo width $top]/2-$width/2]
set y [expr [winfo y $top]+[winfo height $top]/2-$height/2]
}
if { $x < 0 } { set x 0 }
if { $y < 0 } { set y 0 }
wm geom $w ${width}x${height}+${x}+$y
wm deiconify $w
update idletasks
wm geom $w [wm geom $w]
focus $w
}
proc HelpViewer::SearchWindow {} {
#
# a modal search dialog window
# which stays on the screen until manually closed by the user
# allows to forward/backward browsing of all occurances of the
# given search pattern in the underlying html viewer widget
# note:
# once the search dialog gets closed, the <F3> binding in the
# html viewer widget is still working, the current search
# settings are only maintainable in the search dialog though
#
variable html
variable searchwin_close
set wparent $html
set w $wparent.search_dlg
catch { destroy $w }
toplevel $w
wm transient $w $wparent
wm title $w "Search"
bind $w <Escape> "set [namespace current]::searchwin_close 0"
bind $w <Return> "[namespace current]::Search"
bind $w <F3> "[namespace current]::Search"
# dialog gui declarations
set fb [ttk::frame $w.fb]
pack $fb -side bottom -padx 2 -pady 5 -expand true
ttk::button $fb.ok \
-text "Search" \
-command "[namespace current]::Search"
ttk::button $fb.cancel \
-text "Cancel" \
-command "set [namespace current]::searchwin_close 0"
pack $fb.ok $fb.cancel -side left -padx 10 -expand true
set f1 [ttk::frame $w.entry]
pack $f1 -side top -fill x
ttk::label $f1.l1 -text "Search Text: "
ttk::entry $f1.e1 \
-textvariable "[namespace current]::searchstring"
tkTabToWindow $f1.e1
pack $f1.l1 -side left
pack $f1.e1 -side right -fill x -expand true
set f25 [ttk::frame $w.f25]
pack $f25 -side top
ttk::radiobutton $f25.r1 \
-text "Forward" \
-variable "[namespace current]::SearchType" \
-value "-forwards"
ttk::radiobutton $f25.r2 \
-text "Backward" \
-variable "[namespace current]::SearchType" \
-value "-backwards"
pack $f25.r1 -side left
pack $f25.r2 -side right
set f3 [ttk::frame $w.f3]
pack $f3 -side top
ttk::checkbutton $f3.cb1 \
-text "Consider case" \
-variable "[namespace current]::searchcase"
ttk::checkbutton $f3.cb2 \
-text "From beginning" \
-variable "[namespace current]::searchFromBegin"
pack $f3.cb1 $f3.cb2
CenterWindow $w $wparent
# dialog data initialization...
if { ![info exists ::HelpViewer::searchstring] } {
set ::HelpViewer::searchstring ""
}
set ::HelpViewer::SearchPos ""
set ::HelpViewer::searchmode -exact
set ::HelpViewer::searchcase 0
set ::HelpViewer::searchFromBegin 0
set ::HelpViewer::SearchType -forwards
# ----------------------------------------------------
grab $w
tkwait variable "[namespace current]::searchwin_close"
grab release $w
destroy $w
# ----------------------------------------------------
}
proc HelpViewer::CreateIndex {} {
variable HelpBaseDir
variable Index
variable IndexFilesTitles
variable progressbar
variable progressbarStop
variable html
if { [array exists Index] } { return }
if { [file exists [file join $HelpBaseDir wordindex]] } {
set fin [open [file join $HelpBaseDir wordindex] r]
foreach "IndexFilesTitles aa" [read $fin] break
array set Index $aa
close $fin
return
}
WaitState 1
ProgressDlg $html.prdg -textvariable HelpViewer::progressbarT -variable \
HelpViewer::progressbar -title "Creating search index" \
-troughcolor \#48c96f -stop Stop -command "set HelpViewer::progressbarStop 1"
set progressbar 0
set progressbarStop 0
catch { unset Index }
set files [::fileutil::findByPattern $HelpBaseDir "*.htm *.html"]
set len [llength [file split $HelpBaseDir]]
set ipos 0
set numfiles [llength $files]
set IndexFilesTitles ""
foreach i $files {
set HelpViewer::progressbar [expr int($ipos*50/$numfiles)]
set HelpViewer::progressbarT $HelpViewer::progressbar%
if { $HelpViewer::progressbarStop } {
destroy .prdg
return
}
set fin [open $i r]
set aa [read $fin]
set file [eval file join [lrange [file split $i] $len end]]
set title ""
regexp {(?i)<title>(.*?)</title>} $aa {} title
if { $title == "" } {
regexp {(?i)<h([1234])>(.*?)</h\1>} $aa {} {} title
}
lappend IndexFilesTitles [list $file $title]
set IndexPos [expr [llength $IndexFilesTitles]-1]
foreach j [regexp -inline -all -- {-?\w{3,}} $aa] {
if { [string is integer $j] || [string length $j] > 25 || [regexp {_[0-9]+$} $j] } {
continue
}
lappend Index([string tolower $j]) $IndexPos
}
close $fin
incr ipos
}
proc IndexesSortCommand { e1 e2 } {
upvar freqs freqsL
if { $freqsL($e1) > $freqsL($e2) } { return -1 }
if { $freqsL($e1) < $freqsL($e2) } { return 1 }
return 0
}
set names [array names Index]
set len [llength $names]
set ipos 0
foreach i $names {
set HelpViewer::progressbar [expr 50+int($ipos*50/$len)]
set HelpViewer::progressbarT $HelpViewer::progressbar%
if { $HelpViewer::progressbarStop } {
destroy .prdg
return
}
foreach j $Index($i) {
set title [lindex [lindex $IndexFilesTitles $j] 1]
if { [string match -nocase *$i* $title] } {
set icr 10
} else { set icr 1 }
if { ![info exists freqs($j)] } {
set freqs($j) $icr
} else { incr freqs($j) $icr }
}
# if { $i == "variable" } {
# puts "-----variable-----"
# foreach j $Index($i) {
# puts [lindex $IndexFilesTitles $j]-----$j
# }
# parray freqs
# }
set Index($i) [lrange [lsort -command HelpViewer::IndexesSortCommand [array names freqs]] \
0 4]
# if { $i == "variable" } {
# puts "-----variable-----"
# foreach j [lsort -command HelpViewer::IndexesSortCommand [array names freqs]] {
# puts [lindex $IndexFilesTitles $j]-----$j
# }
# }
unset freqs
incr ipos
}
set HelpViewer::progressbar 100
set HelpViewer::progressbarT $HelpViewer::progressbar%
destroy $html.prdg
set fout [open [file join $HelpBaseDir wordindex] w]
puts -nonewline $fout [list $IndexFilesTitles [array get Index]]
close $fout
WaitState 0
}
proc HelpViewer::IsWordGood { word otherwords } {
variable Index
variable IndexFilesTitles
if { $otherwords == "" } { return 1 }
if { ![info exists Index($word)] } { return 0 }
foreach i $Index($word) {
set file [lindex [lindex $IndexFilesTitles $i] 0]
if { [HasFileTheWord $file $otherwords] } { return 1 }
}
return 0
}
proc HelpViewer::HasFileTheWord { file otherwords } {
variable HelpBaseDir
variable Index
variable IndexFilesTitles
variable FindWordInFileCache
set fullfile [file join $HelpBaseDir $file]
foreach word $otherwords {
if { [info exists FindWordInFileCache($file,$word)] } {
if { !$FindWordInFileCache($file,$word) } { return 0 }
continue
}
set fin [open $fullfile r]
set aa [read $fin]
close $fin
if { [string match -nocase *$word* $aa] } {
set FindWordInFileCache($file,$word) 1
} else {
set FindWordInFileCache($file,$word) 0
return 0
}
}
return 1
}
proc HelpViewer::SearchInAllHelp {} {
variable HelpBaseDir
variable Index
variable searchlistbox1
set word [string tolower $HelpViewer::searchstring]
CreateIndex
set HelpViewer::SearchFound ""
set HelpViewer::SearchFound2 ""
if { [string trim $word] == "" } { return }
set words [regexp -all -inline {\S+} $word]
if { [llength $words] > 1 } {
set word [lindex $words 0]
set otherwords [lrange $words 1 end]
} else { set otherwords "" }
set ipos 0
set iposgood -1
foreach i [array names Index *$word*] {
if { ![IsWordGood $i $otherwords] } { continue }
lappend HelpViewer::SearchFound $i
if { [string equal $word [lindex $i 0]] } { set iposgood $ipos }
incr ipos
}
if { $iposgood == -1 && [llength [GiveManHelpNames $HelpViewer::searchstring]] > 0 } {
lappend HelpViewer::SearchFound $HelpViewer::searchstring
set iposgood $ipos
}
if { $iposgood >= 0 } {
$searchlistbox1 selection clear 0 end
$searchlistbox1 selection set $iposgood
$searchlistbox1 see $iposgood
SearchInAllHelpL1
}
}
proc HelpViewer::SearchInAllHelpL1 {} {
variable Index
variable IndexFilesTitles
variable SearchFound2
variable SearchFound2data
variable searchlistbox1
variable searchlistbox2
set SearchFound2 ""
set SearchFound2data ""
set sels [$searchlistbox1 curselection]
if { $sels == "" } {
# bell
return
}
set words [regexp -all -inline {\S+} $HelpViewer::searchstring]
if { [llength $words] > 1 } {
set otherwords [lrange $words 1 end]
} else { set otherwords "" }
set ipos 0
set iposgood -1
set iposgoodW -1
foreach i $sels {
set word [$searchlistbox1 get $i]
if { [info exists Index($word)] } {
foreach i $Index($word) {
foreach "file title" [lindex $IndexFilesTitles $i] break
if { ![HasFileTheWord $file $otherwords] } { continue }
if { [lsearch $HelpViewer::SearchFound2 $title] != -1 } { continue }
lappend SearchFound2 $title
lappend SearchFound2data $i
if { [string match -nocase *$word* $title] } {
set W 1
foreach i $otherwords {
if { [string match -nocase *$i* $title] } { incr W }
}
if { [string match -nocase *$HelpViewer::searchstring* $title] } { incr W }
if { [string equal -nocase $HelpViewer::searchstring $title] } { incr W }
if { $W > $iposgoodW } {
set iposgood $ipos
set iposgoodW $W
}
}
incr ipos
}
}
foreach i [GiveManHelpNames $word] {
lappend SearchFound2 $i
if { $iposgood == -1 } {
set iposgood $ipos
} else { set iposgood -2 }
incr ipos
}
}
if { $iposgood < 0 && $ipos > 0 } { set iposgood 0 }
if { $iposgood >= 0 } {
focus $searchlistbox2
$searchlistbox2 selection clear 0 end
$searchlistbox2 selection set $iposgood
$searchlistbox2 see $iposgood
SearchInAllHelpL2
}
}
proc HelpViewer::SearchInAllHelpL2 {} {
variable HelpBaseDir
variable SearchFound2data
variable IndexFilesTitles
variable SearchFound2
variable SearchFound2data
variable html
variable searchlistbox2
set sels [$searchlistbox2 curselection]
if { [llength $sels] != 1 } {
# bell
return
}
if { [regexp {(.*)\(man (.*)\)} [lindex $SearchFound2 $sels]] } {
SearchManHelpFor $html [lindex $SearchFound2 $sels]
} else {
set i [lindex $SearchFound2data $sels]
set file [file join $HelpBaseDir [lindex [lindex $IndexFilesTitles $i] 0]]
LoadFile $html $file 1
}
}
proc HelpViewer::WaitState { what } {
variable tree
variable html
switch $what {
1 {
$tree configure -cursor watch
$html configure -cursor watch
}
0 {
$tree configure -cursor ""
$html configure -cursor ""
}
}
update
}
proc HelpViewer::ExitCmd {{wbase ""}} {
variable callbackcmd
if {$callbackcmd != ""} {
catch {uplevel $callbackcmd}
}
if {$wbase != "" && [winfo exists $wbase]} {
destroy $wbase
} else {
exit 0
}
}
proc HelpViewer::getTreeWidget {} {
variable tree
return $tree
}
proc HelpViewer::getTreeRootName {} {
return "root"
}
# -----------------------------------------------------------------------------
# main dialog
# -----------------------------------------------------------------------------
proc HelpViewer::HelpWindow { file {base .help} {geom ""} {title ""} {cmd ""} } {
variable HelpBaseDir
variable html
variable tree
variable searchlistbox1
variable searchlistbox2
variable notebook
variable callbackcmd
global lastDir tcl_platform argv0
if { [info command html] == "" } {
set msg "Package Tkhtml 2 is missing.\n"
append msg "You must get Tkhtml in order to use this function!\n"
append msg "Can not continue."
tk_messageBox \
-title "Error in [namespace current] procedure." \
-icon "error" \
-message $msg \
-type ok
return
}
set callbackcmd $cmd
if { $tcl_platform(platform) != "windows" } {
option add *Scrollbar*Width 10
option add *Scrollbar*BorderWidth 1
option add *Button*BorderWidth 1
}
option add *Menu*TearOff 0
catch { destroy $base }
if { $title == "" } { set title Help }
if { [file isdir $file] } {
set HelpBaseDir $file
} else {
# set HelpBaseDir [file dirname $file]
}
set HelpBaseDir [file normalize $HelpBaseDir]
if { [info procs InitWindow] != "" } {
InitWindow $base $title PostHelpViewerWindowGeom
} else {
toplevel $base
wm title $base $title
}
wm withdraw $base
wm protocol $base WM_DELETE_WINDOW "[namespace current]::ExitCmd $base"
################################################################################
# menu is not mapped in this version
################################################################################
# frame $base.mbar -bd 2 -relief raised
# menubutton $base.mbar.file -text File -underline 0 -menu $base.mbar.file.m
# pack $base.mbar.file -side left -padx 5
# set m [menu $base.mbar.file.m]
# $m add command -label Open -underline 0 -command "HelpViewer::Load $base.h.h"
# $m add command -label Refresh -underline 0 -command "HelpViewer::Refresh $base.h.h"
# $m add separator
# $m add command -label Index -acc Ctrl-i -command "\
# HelpViewer::LoadFile $base.h.h [list $file] ;\
# set HelpViewer::lastDir [list [file dirname $file]]"
# $m add command -label Refresh -acc Ctrl-r -command "HelpViewer::Refresh $base.h.h"
# $m add separator
# $m add command -label Close -acc Ctrl-q -command "destroy $base"
# bind $base <Control-o> "HelpViewer::Load $base.h.h"
# bind $base <Control-r> "$m invoke Refresh"
# bind $base <Control-i> "$m invoke Index"
# bind $base <Control-q> "$m invoke Close"
# menubutton $base.mbar.edit -text Edit -underline 0 -menu $base.mbar.edit.m
# pack $base.mbar.edit -side left -padx 5
# set m [menu $base.mbar.edit.m]
# $m add command -label Copy -acc Ctrl-c -command "HelpViewer::CopySelected $base.h.h"
# bind $base <Control-c> "$m invoke Copy"
# menubutton $base.mbar.go -text Go -underline 0 -menu $base.mbar.go.m
# pack $base.mbar.go -side left -padx 5
# set History::menu [menu $base.mbar.go.m]
# $History::menu add command -label Backward -acc Alt-<- -state disabled -command \
# "History::GoBackward $base.h.h"
# $History::menu add command -label Forward -acc Alt--> -state disabled -command \
# "History::GoForward $base.h.h"
# bind $base <Alt-Left> "$History::menu invoke Backward"
# bind $base <Alt-Right> "$History::menu invoke Forward"
global showImages
set showImages 1
# $m add checkbutton -label {Show Images} -variable showImages
#trace variable showImages w "Refresh $base.h.h"
################################################################################
# the HTML viewer
################################################################################
set pw [PanedWindow $base.pw -activator line -side top -pad 5]
set weight1 5
set weight2 12
set pane1 [$pw add -weight $weight1]
$pane1 configure -bg \#EDF3FE
NoteBook $pane1.nb -homogeneous 1 -bd 1 -internalborderwidth 3 -bg \#EDF3FE \
-activebackground \#EDF3FE -disabledforeground \#EDF3FE
pack $pane1.nb -side top -fill both -expand true
set notebook $pane1.nb
set f1 [$pane1.nb insert end tree -text "Contents" -image appbook16]
set sw [ScrolledWindow $f1.lf -relief sunken -borderwidth 1]
pack $sw -fill both -expand yes
set tree [Tree $sw.tree -bg white\
-relief flat -borderwidth 2 -width 15 -highlightthickness 0 \
-redraw 1 -deltay 18 -bg #EDF3FE\
-opencmd "HelpViewer::moddir 1 $sw.tree" \
-closecmd "HelpViewer::moddir 0 $sw.tree" \
-width 5 \
]
$sw setwidget $tree
set font [option get $tree font Font]
if { $font != "" } {
$tree configure -deltay [expr [font metrics $font -linespace]]
}
if { $::tcl_platform(platform) != "windows" } {
$tree configure -selectbackground \#48c96f -selectforeground white
}
$pane1.nb itemconfigure tree -raisecmd "focus $tree"
set f2 [$pane1.nb insert end search -text "Search" -image viewmag16]
set fs [frame $f2.search]
pack $fs -side top -fill x
label $fs.l1 -text "S:" -bg #EDF3FE
entry $fs.e1 -textvariable HelpViewer::searchstring -bg #EDF3FE
pack $fs.l1 -side left
pack $fs.e1 -side right -fill x -expand true
$pane1.nb itemconfigure search -raisecmd "tkTabToWindow $fs.e1"
bind $fs.e1 <Return> "focus $f2.lf1.lb; HelpViewer::SearchInAllHelp"
set sw [ScrolledWindow $f2.lf1 -relief sunken]
pack $sw -fill both -expand yes
set searchlistbox1 [listbox $f2.lf1.lb -listvar HelpViewer::SearchFound -bg #EDF3FE \
-exportselection 0]
$f2.lf1 setwidget $f2.lf1.lb
set sw [ScrolledWindow $f2.lf2 -relief sunken]
pack $sw -fill both -expand yes
set searchlistbox2 [listbox $f2.lf2.lb -listvar HelpViewer::SearchFound2 \
-bg #EDF3FE -exportselection 0]
$f2.lf2 setwidget $f2.lf2.lb
bind $f2.lf1.lb <FocusIn> "if { \[%W curselection] == {} } { %W selection set 0 }"
bind $f2.lf1.lb <ButtonPress-1> "focus $f2.lf2.lb; HelpViewer::SearchInAllHelpL1; HelpViewer::SearchCmd"
bind $f2.lf1.lb <Return> "focus $f2.lf2.lb; HelpViewer::SearchInAllHelpL1; HelpViewer::SearchCmd"
bind $f2.lf2.lb <FocusIn> "if { \[%W curselection] == {} } { %W selection set 0 }"
bind $f2.lf2.lb <ButtonPress-1> "HelpViewer::SearchInAllHelpL2; HelpViewer::SearchCmd"
bind $f2.lf2.lb <Return> "HelpViewer::SearchInAllHelpL2; HelpViewer::SearchCmd"
set HelpViewer::SearchFound ""
set HelpViewer::SearchFound2 ""
$pane1.nb compute_size
$pane1.nb raise tree
set pane2 [$pw add -weight $weight2]
set sw [ScrolledWindow $pane2.lf -relief sunken -borderwidth 0]
pack $sw -fill both -expand yes
set html [html $sw.h \
-padx 5 \
-pady 9 \
-formcommand HelpViewer::FormCmd \
-imagecommand HelpViewer::ImageCmd \
-scriptcommand HelpViewer::ScriptCmd \
-appletcommand HelpViewer::AppletCmd \
-underlinehyperlinks 0 \
-bg white -tablerelief raised \
-resolvercommand HelpViewer::ResolveUri \
-exportselection 1 \
-takefocus 1 \
-fontcommand HelpViewer::pickFont \
-width 550 \
-height 500 \
-borderwidth 0 \
]
$sw setwidget $html
bind $html.x <1> "focus $html; HelpViewer::HrefBinding $html %x %y"
bind $base <Control-c> "HelpViewer::CopySelected $html"
frame $base.buts -bg grey93
button $base.buts.b1 -image imatge_fletxa_e -bg grey93 -relief flat \
-command "History::GoBackward $html" -height 50 \
-highlightthickness 0
button $base.buts.b2 -image imatge_fletxa_d -bg grey93 -relief flat \
-command "History::GoForward $html" -height 50 \
-highlightthickness 0
menubutton $base.buts.b3 -text "More..." -bg grey93 -fg DarkGrey -relief flat \
-menu $base.buts.b3.m -activebackground grey93
menu $base.buts.b3.m
$base.buts.b3.m add command -label "Home" -acc "" -command \
"History::GoHome $html"
$base.buts.b3.m add command -label "Previus" -acc "Alt-Left" -command \
"History::GoBackward $html"
$base.buts.b3.m add command -label "Next" -acc "Alt-Right" -command \
"History::GoForward $html"
$base.buts.b3.m add separator
$base.buts.b3.m add command -label "Search in page..." -acc "Ctrl+F" -command \
"focus $html; HelpViewer::SearchWindow"
$base.buts.b3.m add command -label "Search more" -acc "F3" -command \
"focus $html; HelpViewer::Search"
$base.buts.b3.m add separator
$base.buts.b3.m add command \
-label "Close" -acc "ESC" -command \
"[namespace current]::ExitCmd $base"
if { $HelpPrefs::RunningAlone } {
button $base.buts.b4 -image imatge_quit -bg grey93 -relief flat \
-command "[namespace current]::ExitCmd" \
-height 50 \
-highlightthickness 0
} else {
button $base.buts.b4 -image imatge_quit -bg grey93 -relief flat \
-command "[namespace current]::ExitCmd $base" \
-height 50 \
-highlightthickness 0
}
pack $base.buts.b1 $base.buts.b2 $base.buts.b3 -side left
pack $base.buts.b4 -side right
# menubutton $base.buts.b3 -image imatge_save -bg grey93 -relief flat \
# -menu $base.buts.b3.m -height 50 -grid "2 e" -activebackground grey93
# menu $base.buts.b3.m
# $base.buts.b3.m add command -label "As HTML" -command \
# "HelpViewer::SaveHTMLAs $base HTML"
# $base.buts.b3.m add command -label "As RTF file (Word)" -command \
# "HelpViewer::SaveHTMLAs $base Word"
# $base.buts.b3.m add command -label "As CSV file (Excel)" -command \
# "HelpViewer::SaveHTMLAs $base CSV"
# $base.buts.b3.m add command -label "Copy to clipboard (Excel)" -command \
# "HelpViewer::HTMLToClipBoardCSV $base"
pack $base.buts -side top -fill x
pack $pw -side bottom -fill both -expand true
# This procedure is called when the user selects the File/Open
# menu option.
#
set lastDir [pwd]
if { [package provide Pan] != "" } {
pan bind $tree.c
pan bind $html.x
}
bind $html.x <3> [list tk_popup $base.buts.b3.m %X %Y]
# This binding changes the cursor when the mouse move over
# top of a hyperlink.
#
bind HtmlClip <Motion> {
set parent [winfo parent %W]
set url [$parent href %x %y]
if {[string length $url] > 0} {
$parent configure -cursor hand2
} else {
$parent configure -cursor {}
}
}
if {[string equal "unix" $::tcl_platform(platform)]} {
bind $html.x <4> { %W yview scroll -1 units }
bind $html.x <5> { %W yview scroll 1 units }
bind $tree.c <4> { %W yview scroll -5 units }
bind $tree.c <5> { %W yview scroll 5 units }
}
focus $html
bind $html
bind $html <Prior> {
%W yview scroll -1 pages
}
bind $html <Next> {
%W yview scroll 1 pages
}
bind $html <Home> {
%W yview moveto 0
}
bind $html <End> {
%W yview moveto 1
}
bind $base <1> "HelpViewer::ManageSel $html %W %x %y press"
bind $base <B1-Motion> "HelpViewer::ManageSel $html %W %x %y motion"
bind $base <ButtonRelease-1> "HelpViewer::ManageSel $html %W %x %y release"
if { $tcl_platform(platform) != "windows"} {
selection handle $html "HelpViewer::CopySelected $html"
}
$tree bindText <ButtonPress-1> "HelpViewer::Select $tree 1"
$tree bindText <Double-ButtonPress-1> "HelpViewer::Select $tree 2"
$tree bindImage <ButtonPress-1> "HelpViewer::Select $tree 1"
$tree bindImage <Double-ButtonPress-1> "HelpViewer::Select $tree 2"
$tree bindText <Control-ButtonPress-1> "HelpViewer::Select $tree 3"
$tree bindImage <Control-ButtonPress-1> "HelpViewer::Select $tree 3"
$tree bindText <Shift-ButtonPress-1> "HelpViewer::Select $tree 4"
$tree bindImage <Shift-ButtonPress-1> "HelpViewer::Select $tree 4"
# dirty trick
foreach i [bind $tree.c] {
bind $tree.c $i "+ [list after idle [list HelpViewer::Select $tree 0 {}]]"
}
bind $tree.c <Return> "HelpViewer::Select $tree 1 {}"
bind $tree.c <KeyPress> "if \[string is wordchar -strict {%A}] {HelpViewer::KeyPress %A}"
bind $tree.c <Alt-KeyPress-Left> ""
bind $tree.c <Alt-KeyPress-Right> ""
bind $tree.c <Alt-KeyPress> { break }
bind [winfo toplevel $html] <Alt-Left> "History::GoBackward $html; break"
bind [winfo toplevel $html] <Alt-Right> "History::GoForward $html; break"
FillDir $tree root
bind [winfo toplevel $html] <Control-f> "focus $html; HelpViewer::SearchWindow ; break"
bind [winfo toplevel $html] <F3> "focus $html; HelpViewer::Search ; break"
if { [info script] == $::argv0 } {
bind [winfo toplevel $html] <Escape> "[namespace current]::ExitCmd"
} else {
bind [winfo toplevel $html] <Escape> "[namespace current]::ExitCmd $base"
}
bind [winfo toplevel $html] <Control-f> "focus $html; HelpViewer::SearchWindow ; break"
bind [winfo toplevel $html] <Alt-KeyPress-c> [list $notebook raise tree]
bind [winfo toplevel $html] <Control-KeyPress-i> [list $notebook raise search]
bind [winfo toplevel $html] <Alt-KeyPress-i> [list $notebook raise search]
bind [winfo toplevel $html] <Control-KeyPress-s> [list $notebook raise search]
bind [winfo toplevel $html] <Alt-KeyPress-s> [list $notebook raise search]
update
# If an arguent was specified, read it into the HTML widget.
if {$file != ""} {
LoadFile $html $file
}
# set x [expr [winfo screenwidth $base]/2-400]
# set y [expr [winfo screenheight $base]/2-300]
# wm geom $base 650x400+${x}+$y
if { $geom == "" } {
# set width 400
# set height 500
# set x [expr [winfo screenwidth $base]/2-$width/2]
# set y [expr [winfo screenheight $base]/2-$height/2]
# wm geom $base ${width}x${height}+${x}+${y}
set x [expr [winfo screenwidth $base]/2-400]
set y [expr [winfo screenheight $base]/2-300]
wm geom $base 650x400+${x}+$y
} else {
wm geom $base $geom
}
update idletasks
wm deiconify $base
return $html
}
# -----------------------------------------------------------------------------
# test section
# -----------------------------------------------------------------------------
if { [info script] == $argv0 } {
wm withdraw .
package require Tkhtml 2.0
package require Img
if { $::tcl_platform(platform) != "windows"} {
set file {/c/TclTk/RamDebugger/help}
} else {
set file {/Documents and Settings/ramsan/Mis documentos/myTclTk/RamDebugger/help}
bind all <MouseWheel> {
set w %W
while { $w != [winfo toplevel $w] } {
catch {
set ycomm [$w cget -yscrollcommand]
if { $ycomm != "" } {
$w yview scroll [expr int(-1*%D/36)] units
break
}
}
set w [winfo parent $w]
}
}
}
HelpViewer::HelpWindow $file
} else {
set HelpViewer::HelpBaseDir [file join [info script] help]
}
set dir [file dirname [info script]]
lappend auto_path [file join $dir ".."]
lappend auto_path [file join $dir "../../lib"]
package require Tk
wm withdraw .
# requiring exactly 2.0 to avoid getting the one from Activestate
package require -exact Tkhtml 2.0
# same is required for BWidget ...
package require -exact BWidget 1.9.10
package require BWidget_patch
Widget::theme 1
package require helpviewer 2.0
# case 1: demo dir
# set demo_dir [file join [file dirname [info script]] "demo_doc"]
# set demo_dir [file join [file dirname [info script]] "demo_help"]
set demo_dir $::BWIDGET::LIBRARY
# start the viewer...
HelpViewer::HelpWindow $demo_dir
return
# case 2: demo file
set demo_file [file join [file dirname [info script]] "demo_doc/index.html"]
HelpViewer::HelpWindow $demo_file
set HelpViewer::HelpBaseDir $demo_dir
set hwidget [HelpViewer::HelpWindow ""]
HelpViewer::LoadRef $hwidget $demo_file
if {[catch {
package require starkit
if {[starkit::startup] eq "sourced"} { return } }]} {
namespace eval ::starkit {
if {[set this [info script]] == ""} {
set this [info nameofexecutable]
}
variable topdir [file normalize [file dirname $this]]
}
}
lappend auto_path [file join $::starkit::topdir "lib"]
lappend auto_path [file join $::starkit::topdir "lib3"]
package require Tk
package require tile
wm withdraw .
# requiring exactly 2.0 to avoid getting the one from Activestate
package require -exact Tkhtml 2.0
# same is required for BWidget ...
package require -exact BWidget 1.9.10
package require BWidget_patch
Widget::theme 1
package require helpviewer 2.0
set help_dir [file join $::starkit::topdir "../Docu"]
# start the help viewer...
HelpViewer::HelpWindow $help_dir
# Makefile.tcl ---
# -------------------------------------------------------------------------
# Purpose:
# Create (*)starkit and application binaries
# for unix and windows. This makefile might be used to
# "cross compile" binaries for any target OS.
#
# Copyright(c) 2016, Johann Oberdorfer
# mail-to: johann.oberdorfer <at> gmail.com
# -------------------------------------------------------------------------
# This source file is distributed under the BSD license.
package require Tk
wm withdraw .
catch { console show; update }
set t0 [clock milliseconds]
# main entry point:
set THIS_APP [file normalize [file dirname [info script]]]
set TCLKIT_DIR [file join $THIS_APP "../tclkit"]
set INSTALL_DIR [file join $THIS_APP "../Apps"]
# unix / win / osx ...
set OSX_KIT [file join $TCLKIT_DIR "Darwin_kbsvq8.6-gui"]
set WIN_KIT [file join $TCLKIT_DIR "WindowsNT_kbsvq8.6-gui.exe"]
set SDXUTIL [file join $TCLKIT_DIR "sdx.exe"]
set UPXUTIL [file join $TCLKIT_DIR "upx.exe"]
# set MAKETCL [file join $TCLKIT_DIR "make.tcl"]
# source $MAKETCL
# *edit* to reflect your build platform
# you are currently running on:
# -------------------------------------
set TCL_KIT [file join $TCLKIT_DIR "WindowsNT_kbsvq8.6-gui.exe"]
set VER "2.0"
set VFS "Ver${VER}"
set APP "HelpViewer"
# default operation mode
if {$argc == 0} {
set argv "win"
}
switch -- $argv {
"win" {
puts "Creating windows executable: ${APP}.exe ..."; update
file delete -force ${APP}.exe
file copy -force $WIN_KIT winkitbin.exe
exec $SDXUTIL wrap ${APP}.exe -vfs $VFS -runtime $TCL_KIT
file delete -force winkitbin.exe
# compressing the exe...
puts "Running UPX to compress executable ..."; update
exec $UPXUTIL ${APP}.exe
}
"sdx" {
puts "Creating windows executable: sdx.exe ..."; update
file delete -force sdx.exe
file copy -force $TCL_KIT tclkitbin.exe
exec $TCL_KIT $SDXUTIL wrap sdx.exe -vfs $SDXUTIL -runtime tclkitbin.exe
file delete -force tclkitbin.exe
}
default {
puts "Unknown or missing argument!"
}
}
puts "Done - [expr ( [clock milliseconds] - $t0 ) / 1000.0] sec."
