Menu

practical knowledge, questions and wishes

Help
2006-10-30
2013-03-12
  • Ulrich Althoefer

    Thanks for your work.

    I tested my own HTML-helpfiles with your tkhelpbrowser-Tool Version 1.2 but I detected some problems:

    My Original-SourceCode:

    tkhelpbrowser_setHome [file join I:/speci htmlhelp 01-index.html]
    tkhelpbrowser_showDoc $Home

    gives me errormessages from the ASED-IDE:

    SyntaxCheck Results for I:/speci/htmlhelp/tkhelpbrowser/tkshowhelp.tk:
    Used Syntax-Checker: Frink 2.2.2 patch level 4
    *** I:/speci/htmlhelp/tkhelpbrowser/tkshowhelp.tk Warning : variable "Home" might be used before being set (line 47)

    To prevent this message I changed the SourceCode:

    global Home
    set Home [file join I:/speci htmlhelp 01-index.html]
    #tkhelpbrowser_setHome [file join I:/speci htmlhelp 01-index.html]
    tkhelpbrowser_showDoc $Home

    Furthermore I detected problems, probably because of my Windows-Volume-Components starting with "I:/". I did the following workaround, but its not universally valid!:

    In I:/speci/htmlhelp/tkhelpbrowser/htmlbrowser.tcl:
                 proc setupBrowser
                 set titlename [lindex [split $titlesearch :] 3]
    (instead of: set titlename [lindex [split $titlesearch :] 2])

    the same problem in:

                 proc runHelpSearch
                 set filebase [lindex [split $item :] 1]
    (instead of: set filebase [lindex [split $item :] 0]
                 set filetext [lindex [split $item :] 3]
    (instead of: set filetext [lindex [split $item :] 2]

    I would appreciate a general and portable solution.

    I found difficulties with displaying some characters e.g. the TM-sign: ™(Trademark) in my helptext.

    My special german characters "Umlaute:" äöüÄÖÜ and ß are o.k. but if I find those characters in the listed search-text, the displaying is wrong.

    My additional wishes are the following ones:
    - I would like to have all Buttons (Back-Button, Home-Button etc.) on the top of the window, not the bottom.
    - The background-Color of the "Configure Text"-Button is similar to the foreground-color, so its bad to detect, that it is a Button-Function (on my Windows-XP-OS).
    - The Indent-Level of the text-paragraphs: is it possible to set it to Zero?
    - The Content- and Search-Frames appears generally. I wish to get it only, if I press a special button to display these frames. Thus there is direct enough place for my underlying help-function.
    - I want to place the geometry-entries for my own help-window at the beginning of my script.
    - I wish to control the background-color of my own help-window.

    And still one question: what is about the "Hippo" HTML display library. I dont know it.

    I plan to realize the complete help-function in my spec-i-project (http://spec-i.de/) with this tkhelpbrowser-Tool. Its a USB-spectrometer with a complete integration of the free math-tool scilab and taking full control to Tcl/Tk.

    What do you think, when will the next version of your tkhelpbrowser appear?

    Thanks for your work again.

    Greetings from Germany

    Ulrich Althöfer

     
    • Kevin Walzer

      Kevin Walzer - 2006-11-08

      I'm releasing a new version today, although it doesn't have all of these changes that you are requesting. I don't have time to implement such an ambitious set of changes: I develop this to meet my own needs and hope others can make use of it. The source code, of course, can be freely modified.

       

Log in to post a comment.

Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.