Re: [pygtk] Documentation recommendations

2005-08-12 Thread David M. Cook
On Thu, Aug 11, 2005 at 05:33:06PM -0400, Andrew Conkling wrote:

 chintzy.  The only other option of which I can think is some HTML
 pages, but I don't know how I'd use them in my program (other than
 launching a browser).  

Well, that might not be so bad.  Take a look at the webbrowser module in the
standard lib.  It tries to be somewhat cross-platform, i.e. using KDE or
Gnome to launch the browser, or the default the user has set in OS X or
windows.

Dave Cook
___
pygtk mailing list   pygtk@daa.com.au
http://www.daa.com.au/mailman/listinfo/pygtk
Read the PyGTK FAQ: http://www.async.com.br/faq/pygtk/


Re: [pygtk] Documentation recommendations

2005-08-12 Thread Andrew Conkling
On 8/12/05, David M. Cook [EMAIL PROTECTED] wrote:
 Take a look at the webbrowser module in the
 standard lib.  It tries to be somewhat cross-platform, i.e. using KDE or
 Gnome to launch the browser, or the default the user has set in OS X or
 windows.

OK, Dave, I'll check it out; thanks.  What would it do in, say, Xfce? 
Many of my users (and I) use it and thusly I don't want to bank on
Gnome settings to launch a browser.  Perhaps Gian's suggestion to use
gtkhtml would be better  (One of my program's dependencies doesn't
run on Windows yet, anyway.)


-- 
http://aconkling.blogspot.com
___
pygtk mailing list   pygtk@daa.com.au
http://www.daa.com.au/mailman/listinfo/pygtk
Read the PyGTK FAQ: http://www.async.com.br/faq/pygtk/


Re: [pygtk] Documentation recommendations

2005-08-12 Thread David M. Cook
On Fri, Aug 12, 2005 at 07:15:01AM -0400, Andrew Conkling wrote:

 OK, Dave, I'll check it out; thanks.  What would it do in, say, Xfce?

If the default doesn't work, you can fall back on the Netscape('firefox') or
Netscape('mozilla') browser objects, e.g.

# untested code!
import webbrowser
# webbrowser doesn't know firefox yet, but you can use the 
# Netscape('firefox') browser object.
browsersToTry = [webbrowser, webbrowser.Netscape('firefox'), ...]
for browser in browsersToTry:
try:
   browser.open(...)
except webbrowser.Error:
   continue
break
else: # should be executed if we fall thru to the end
popupErrorDialog('Can't find a browser.')

Note that the user can configure the default browser if neccessary with the
BROWSER environment variable.

Dave Cook
___
pygtk mailing list   pygtk@daa.com.au
http://www.daa.com.au/mailman/listinfo/pygtk
Read the PyGTK FAQ: http://www.async.com.br/faq/pygtk/


Re: [pygtk] Documentation recommendations

2005-08-12 Thread dol-sen

On Fri, 2005-12-08 at 07:15 -0400, Andrew Conkling wrote:
 On 8/12/05, David M. Cook [EMAIL PROTECTED] wrote:
  Take a look at the webbrowser module in the
  standard lib.  It tries to be somewhat cross-platform, i.e. using KDE or
  Gnome to launch the browser, or the default the user has set in OS X or
  windows.
 
 OK, Dave, I'll check it out; thanks.  What would it do in, say, Xfce? 
 Many of my users (and I) use it and thusly I don't want to bank on
 Gnome settings to launch a browser.  Perhaps Gian's suggestion to use
 gtkhtml would be better  (One of my program's dependencies doesn't
 run on Windows yet, anyway.)
 
 

the webbrowser module is a python module not a desktop one.  If you
check the archives back a week ago I posted to the same question.  I
uncluded the code we use to launch our help pages as well as web pages.
It works on KDE, gnome, whatever.
-- 
Brian [EMAIL PROTECTED]


___
pygtk mailing list   pygtk@daa.com.au
http://www.daa.com.au/mailman/listinfo/pygtk
Read the PyGTK FAQ: http://www.async.com.br/faq/pygtk/


[pygtk] Documentation recommendations

2005-08-11 Thread Andrew Conkling
I'm brainstorming on how to provide documentation in my program.  I'd
rather not make use of Gnome help (i.e. yelp's browser) because I'm
trying to avoid the additional dependencies.  However, I'm not really
sure what else I could do that would be effective.  I don't really
want to provide just a simple textview with text, because that seems
chintzy.  The only other option of which I can think is some HTML
pages, but I don't know how I'd use them in my program (other than
launching a browser).  Does anyone have any middle-of-the-road
solution?

-- 
http://aconkling.blogspot.com
___
pygtk mailing list   pygtk@daa.com.au
http://www.daa.com.au/mailman/listinfo/pygtk
Read the PyGTK FAQ: http://www.async.com.br/faq/pygtk/


Re: [pygtk] Documentation recommendations

2005-08-11 Thread Gian Mario Tagliaretti
2005/8/11, Andrew Conkling [EMAIL PROTECTED]:

 [snip]
The only other option of which I can think is some HTML
 pages, but I don't know how I'd use them in my program (other than
 launching a browser).  Does anyone have any middle-of-the-road
 solution?

Did you thought to use gtkhtml to render your help pages?

If your app has to run on windows as well unfortunatly this is not a
solution, a few days ago we had a similar discussion, try to look in
the ML.

cheers
-- 
Gian Mario Tagliaretti
PyGTK GUI programming
http://www.parafernalia.org/pygtk/
___
pygtk mailing list   pygtk@daa.com.au
http://www.daa.com.au/mailman/listinfo/pygtk
Read the PyGTK FAQ: http://www.async.com.br/faq/pygtk/