Any easy way to add simple HTML help system?

0 views
Skip to first unread message

Petasis George

unread,
Jan 14, 2000, 3:00:00 AM1/14/00
to
Hi all,
Is there an easy way to add a (simple) html help system in
an application? If no easy way, any alternatives?
George

laurent....@cgi.ca

unread,
Jan 14, 2000, 3:00:00 AM1/14/00
to

Iwidgets contain an HTML widget. There's the Tkhtml widget also. Probably
more elsewhere.

L

--
Penguin Power! Nothing I say reflects the views of my employer

Laurent Duperval mailto:laurent....@cgi.ca
CGI - FWFM Project Phone: (514) 350-3368

Petasis George

unread,
Jan 17, 2000, 3:00:00 AM1/17/00
to

What are Iwidgets? [incr Widgets]??
I have tried Tkhtml widget but I can't get it to compile :-)
George

D. Richard Hipp

unread,
Jan 17, 2000, 3:00:00 AM1/17/00
to
Petasis George wrote:
>
> I have tried Tkhtml widget but I can't get it to compile :-)
>

You mean "configure; make" didn't work? What OS are
you using?

--
D. Richard Hipp -- d...@acm.org -- http://www.hwaci.com/drh/

laurent....@cgi.ca

unread,
Jan 17, 2000, 3:00:00 AM1/17/00
to
On 17 Jan, Petasis George wrote:
>
> laurent....@cgi.ca wrote:
>>
>> On 14 Jan, Petasis George wrote:
>> >
>> > Hi all,
>> > Is there an easy way to add a (simple) html help system in
>> > an application? If no easy way, any alternatives?
>> > George
>> >
>>
>> Iwidgets contain an HTML widget. There's the Tkhtml widget also. Probably
>> more elsewhere.
>>
>> L
>>
>> --
>> Penguin Power! Nothing I say reflects the views of my employer
>>
>> Laurent Duperval mailto:laurent....@cgi.ca
>> CGI - FWFM Project Phone: (514) 350-3368
>
> What are Iwidgets? [incr Widgets]??

Yes.

> I have tried Tkhtml widget but I can't get it to compile :-)

Maybe I can help out if you've got a Unixish environment.

bria...@my-deja.com

unread,
Jan 20, 2000, 3:00:00 AM1/20/00
to
In article <387F1857...@iit.demokritos.gr>,

Petasis George <pet...@iit.demokritos.gr> wrote:
> Hi all,
> Is there an easy way to add a (simple) html help system in
> an application? If no easy way, any alternatives?
> George
>

This was posted April '99. It might be of use (I have not tried it yet).

Here is the code I use to display HTML help. It uses the default
browser in Windows but assumes netscape in UNIX and requires it to
be in the user's path.

if { $tcl_platform(platform) == "windows" } {

if {[file exists $env(COMSPEC)]} {
exec $env(COMSPEC) /c start $EnvDir/help/envhelp.htm &
}
} else {
exec netscape $EnvDir/help/envhelp.htm &
}

Greg Orchard
orc...@nortelnetworks.com

Sent via Deja.com http://www.deja.com/
Before you buy.

Petasis George

unread,
Jan 21, 2000, 3:00:00 AM1/21/00
to
"D. Richard Hipp" wrote:

>
> Petasis George wrote:
> >
> > I have tried Tkhtml widget but I can't get it to compile :-)
> >
>
> You mean "configure; make" didn't work? What OS are
> you using?
>
> --
> D. Richard Hipp -- d...@acm.org -- http://www.hwaci.com/drh/

Sorry my fault:-)
It seems that the version that I have tried to test was a quite old
one that didn't have a configure script. The latest version I downloaded
from your site compile ok with only one minor problem.
During the building time, does it try to build a program called
'hv' while there is also a directory called by that name?
Anyway, running "make -i" ignored the problem and the dynamic library
I wanted was build!
Well, this is a tottaly great extension! It is far beyond what I have
imagined.
It is really very good, fast and the html it displays is nice looking...
It would be very nice to have someting like this in tk core (I know many
will disagree, but html help system seems to be a need for many
applications.
Anyway :-))

The only thing that I haven't managed to do is to get the widget
underline the links... Any ideas?
Regards,
George

D. Richard Hipp

unread,
Jan 21, 2000, 3:00:00 AM1/21/00
to
Petasis George wrote:
>
> "D. Richard Hipp" wrote:
> >
> > Petasis George wrote:
> > >
> > > I have tried Tkhtml widget but I can't get it to compile :-)
> >
> > You mean "configure; make" didn't work?
>
> During the building time, does it try to build a program called
> 'hv' while there is also a directory called by that name?

Yeah. The configure script is really designed to be run from
outside the source tree. Like this:

tar xzf tkhtml.tar.gz ;# Create source tree in "htmlwidget"
mkdir bld ;# Build in a sibling directory "bld"
cd bld
../htmlwidget/configure
make

I should change some names so that the "hv" directory
does not conflict with the "hv" executable, though.
Someday...

> The only thing that I haven't managed to do is to get the widget
> underline the links... Any ideas?

This is a feature not a bug. :-) But I suppose underlined
hyperlinks is a reasonable request. So I've now added it to
the widget. You have to use the "-underlinehyperlinks" configure
option to turn it on, though. Hyperlink underlining is off by
default. New source code to support this feature is now on
the website (http://www.hwaci.com/sw/tkhtml/) and on the
anonymous CVS server. I did not update the precompiled binaries,
though.

Bob Techentin

unread,
Jan 21, 2000, 3:00:00 AM1/21/00
to
bria...@my-deja.com wrote:
>
>
> This was posted April '99. It might be of use (I have not tried it yet).
>

It is worth mentioning that there is a Wiki page that describes invoking
browsers at
http://purl.org/thecliff/tcl/wiki/InvokingBrowsers dated Aug. 1999.
The page contains a code snippet covering unix/mac/windows.

Bob
--
Bob Techentin techenti...@mayo.edu
Mayo Foundation (507) 284-2702
Rochester MN, 55905 USA http://www.mayo.edu/sppdg/sppdg_home_page.html

laurent....@cgi.ca

unread,
Jan 21, 2000, 3:00:00 AM1/21/00
to
On 21 Jan, Petasis George wrote:
>
> "D. Richard Hipp" wrote:
>>
>> Petasis George wrote:
>> >
>> > I have tried Tkhtml widget but I can't get it to compile :-)
>> >
>>
>> You mean "configure; make" didn't work? What OS are
>> you using?
>>
>> --
>> D. Richard Hipp -- d...@acm.org -- http://www.hwaci.com/drh/
>
> Sorry my fault:-)
> It seems that the version that I have tried to test was a quite old
> one that didn't have a configure script. The latest version I downloaded
> from your site compile ok with only one minor problem.
> During the building time, does it try to build a program called
> 'hv' while there is also a directory called by that name?
> Anyway, running "make -i" ignored the problem and the dynamic library
> I wanted was build!
> Well, this is a tottaly great extension! It is far beyond what I have
> imagined.
> It is really very good, fast and the html it displays is nice looking...
> It would be very nice to have someting like this in tk core (I know many
> will disagree, but html help system seems to be a need for many
> applications.
> Anyway :-))
>

Not the core. The TSL (Tcl Standard Library). What is needed (and which
Guido seems to have understood and used to his great benefit) is a maximum
number of functionality available with one single download. I'm talking
about stuff people keep asking about all the time: SMTP, FTP, sockets, HTML,
more image formats, etc. Put it all in a library that people can easily (as
in one click instead of 1000 clicks) download and use.

It seems like that is one of the main reasons people choose to program with
Python: the Python library allows you to do a great deal of programming
without needing to go back to the python.org site to download new
extensions. It's something that's been lacking in Tcl but TclGuy seems to
have a Master Plan tucked in his back pocket to fix this. And what's even
better is that I think he'll allow you to pick his pockets and run away with
the contents, if you promise to give it back in better shape than it was
when you took it.

L

P.S. It's -18C, temperature will drop to -25C with winds from 30-50 km/h,
generating an effective temperature of -57C or something. My brain's frozen.

lvi...@cas.org

unread,
Jan 21, 2000, 3:00:00 AM1/21/00
to

According to <laurent....@cgi.ca>:
:Not the core. The TSL (Tcl Standard Library). What is needed (and which

:Guido seems to have understood and used to his great benefit) is a maximum
:number of functionality available with one single download. I'm talking
:about stuff people keep asking about all the time: SMTP, FTP, sockets, HTML,
:more image formats, etc. Put it all in a library that people can easily (as
:in one click instead of 1000 clicks) download and use.
:
:It seems like that is one of the main reasons people choose to program with
:Python: the Python library allows you to do a great deal of programming
:without needing to go back to the python.org site to download new
:extensions. It's something that's been lacking in Tcl but TclGuy seems to

Note that the same is true basically true for Perl and Rebol. In Rebol's
case, what you download is basically it - from a binary point of view.
In Python and Perl's case, there _are_ other packages, extensions, etc. but
there is of course a variety of opinions regarding reuse vs reimplementation.

The puzzle I see is this. When I do a du against the build directories for
Perl, Python, and Tcl/TK I see:
21110 /ldatae/Misc/python/Python-1.5.2
42943 /ldatae/gnu/perl5.005_63
20566 /vol/tclsrcsol/tcl82/tcl/.
12929 /vol/tclsrcsol/tcl82/tk/.

What puzzles me is how Python can have so little additional diskspace and
yet so many people talk about how much more functionality it has.
--
<URL: mailto:lvi...@cas.org> <URL: http://www.usenix.org/events/tcl2k/>
<*> O- <URL: http://www.purl.org/NET/lvirden/> Tcl2K - Austin, Texas, US
Unless explicitly stated to the contrary, nothing in this posting
should be construed as representing my employer's opinions.

laurent....@cgi.ca

unread,
Jan 21, 2000, 3:00:00 AM1/21/00
to
On 21 Jan, lvi...@cas.org wrote:
>
> According to <laurent....@cgi.ca>:
> :Not the core. The TSL (Tcl Standard Library). What is needed (and which
> :Guido seems to have understood and used to his great benefit) is a maximum
> :number of functionality available with one single download. I'm talking
> :about stuff people keep asking about all the time: SMTP, FTP, sockets, HTML,
> :more image formats, etc. Put it all in a library that people can easily (as
> :in one click instead of 1000 clicks) download and use.
> :
> :It seems like that is one of the main reasons people choose to program with
> :Python: the Python library allows you to do a great deal of programming
> :without needing to go back to the python.org site to download new
> :extensions. It's something that's been lacking in Tcl but TclGuy seems to
>
> Note that the same is true basically true for Perl and Rebol. In Rebol's
> case, what you download is basically it - from a binary point of view.
> In Python and Perl's case, there _are_ other packages, extensions, etc. but
> there is of course a variety of opinions regarding reuse vs reimplementation.
>
> The puzzle I see is this. When I do a du against the build directories for
> Perl, Python, and Tcl/TK I see:
> 21110 /ldatae/Misc/python/Python-1.5.2
> 42943 /ldatae/gnu/perl5.005_63
> 20566 /vol/tclsrcsol/tcl82/tcl/.
> 12929 /vol/tclsrcsol/tcl82/tk/.
>
> What puzzles me is how Python can have so little additional diskspace and
> yet so many people talk about how much more functionality it has.

Wow. I get

968 libtcl8.2.sl
4 libtclstub8.2.a
62 libtclstub8.2g.a
1180 libtk8.2.sl
3 libtkstub8.2.a
17 tcl8.2/http2.1
11 tcl8.2/http1.0
34 tcl8.2/opt0.4
1346 tcl8.2/encoding
6 tcl8.2/msgcat1.0
53 tcl8.2/tcltest1.0
1582 tcl8.2
103 tk8.2/images
278 tk8.2/demos/images
551 tk8.2/demos
966 tk8.2
154 tclsh8.2
162 wish8.2

If you remove the demos and the encoding (does Python do I18n?), I find it
to be relatively small. But then, I haven't counted any extensions.

L

Reply all
Reply to author
Forward
0 new messages