RE: [PyQt] Documentation
This problem seems to be unresolved. Suppose that one downloads the documentation separately, where should it be installed? In other words, where does the Demo documentation expect to find it? Colin W. Peter Stewart-2 wrote: > > Yes, I appreciate that I have access to the online documentation. However > I > cannot run the tutorial or the examples script: qtdemo.pyw. In fact when I > try to run it, I'm presented with a warning message "If you are using the > GPL version on PyQt from the binary installer, then you will probably see > warning messages about missing documentation." I'd sure like to see that > tutorial. > Thanks for the response Arve. > Peter > > > Sorry, the link should be doc.trolltech.com. > > Arve > > On 7/14/09, Arve Knudsen wrote: >> An alternative at least is to browse the online documentation at >> docs.trolltech.com. >> >> Arve >> >> On 7/14/09, Peter Stewart wrote: >>> I've just downloaded Pyqt4 using the binary package for windows option. >>> The >>> documentation wasn't included as it was too big. Now the Assistant >>> won't >>> load anything that's not a .qch file and I can't find the documentation >>> to >>> download in this form..thanks Peter >>> > > ___ > PyQt mailing listPyQt@riverbankcomputing.com > http://www.riverbankcomputing.com/mailman/listinfo/pyqt > > -- View this message in context: http://www.nabble.com/Documentation-tp24473474p24954426.html Sent from the PyQt mailing list archive at Nabble.com. ___ PyQt mailing listPyQt@riverbankcomputing.com http://www.riverbankcomputing.com/mailman/listinfo/pyqt
RE: [PyQt] Documentation
Yes, I appreciate that I have access to the online documentation. However I cannot run the tutorial or the examples script: qtdemo.pyw. In fact when I try to run it, I'm presented with a warning message "If you are using the GPL version on PyQt from the binary installer, then you will probably see warning messages about missing documentation." I'd sure like to see that tutorial. Thanks for the response Arve. Peter Sorry, the link should be doc.trolltech.com. Arve On 7/14/09, Arve Knudsen wrote: > An alternative at least is to browse the online documentation at > docs.trolltech.com. > > Arve > > On 7/14/09, Peter Stewart wrote: >> I've just downloaded Pyqt4 using the binary package for windows option. >> The >> documentation wasn't included as it was too big. Now the Assistant won't >> load anything that's not a .qch file and I can't find the documentation >> to >> download in this form..thanks Peter >> ___ PyQt mailing listPyQt@riverbankcomputing.com http://www.riverbankcomputing.com/mailman/listinfo/pyqt
Re: [PyQt] Documentation
Sorry, the link should be doc.trolltech.com. Arve On 7/14/09, Arve Knudsen wrote: > An alternative at least is to browse the online documentation at > docs.trolltech.com. > > Arve > > On 7/14/09, Peter Stewart wrote: >> I've just downloaded Pyqt4 using the binary package for windows option. >> The >> documentation wasn't included as it was too big. Now the Assistant won't >> load anything that's not a .qch file and I can't find the documentation >> to >> download in this form..thanks Peter >> >> ___ >> PyQt mailing listPyQt@riverbankcomputing.com >> http://www.riverbankcomputing.com/mailman/listinfo/pyqt >> > > -- > Sent from my mobile device > -- Sent from my mobile device ___ PyQt mailing listPyQt@riverbankcomputing.com http://www.riverbankcomputing.com/mailman/listinfo/pyqt
Re: [PyQt] Documentation
An alternative at least is to browse the online documentation at docs.trolltech.com. Arve On 7/14/09, Peter Stewart wrote: > I've just downloaded Pyqt4 using the binary package for windows option. > The > documentation wasn't included as it was too big. Now the Assistant won't > load anything that's not a .qch file and I can't find the documentation to > download in this form..thanks Peter > > ___ > PyQt mailing listPyQt@riverbankcomputing.com > http://www.riverbankcomputing.com/mailman/listinfo/pyqt > -- Sent from my mobile device ___ PyQt mailing listPyQt@riverbankcomputing.com http://www.riverbankcomputing.com/mailman/listinfo/pyqt
Re: [PyQt] Documentation Style (Was: PyQt4 feature request)
On 3/7/2009 6:50 PM, Phil Thompson wrote: On Sat, 7 Mar 2009 18:06:12 +0100, Detlev Offenbach wrote: Hi, please include the PyQt4 documentation as a compressed Qt Help files (*.qch) as well. eric4 will support Qt Help collections starting with the first 4.4 snapshot. An opportune moment to ask for opinions... When I (eventually) get round to improving the PyQt docs (particularly making the API reference more Pythonic) it will be designed to support (in theory) multiple output styles. In the Roadmap I specifically mention the traditional Qt style and Sphinx (ie. that used for the Python v2.6 documentation). Which of these two styles do people prefer? As long as I can open it in the Qt Assistant, it does not matter. Qt Assistant is several order of magnitudes faster than using Firefox, for browsing documentation. It's unvaluable, for instance, to start typing "setLab" and see all the matches in realtime and quickly find the correct method within whatever class it happens to be inside. -- Giovanni Bajo Develer S.r.l. http://www.develer.com ___ PyQt mailing listPyQt@riverbankcomputing.com http://www.riverbankcomputing.com/mailman/listinfo/pyqt
Re: [PyQt] Documentation Style (Was: PyQt4 feature request)
Il giorno Sun, 8 Mar 2009 15:02:36 +0100 Andreas Pakulat ha scritto: > On 08.03.09 12:32:37, Antonio Valentino wrote: > > > > .. but, just a question, what described in > > > > http://doc.trolltech.com/4.4/richtext-html-subset.html > > > > applies or not to QtAssistant? > > It applies to the QTextEdit class, but QtAssistant (from 4.4) doesn't > use that. It uses QWebView&Co which use Webkit behind the scenes for > rendering. So its basically a full HTML browser nowadays. OK, thanks Andreas. Unfortunately in this case I've no idea of why I experiment very odd things building qthelp docs with sphings. Hence I doubt I can get it working in the near future. thanks -- Antonio Valentino ___ PyQt mailing listPyQt@riverbankcomputing.com http://www.riverbankcomputing.com/mailman/listinfo/pyqt
Re: [PyQt] Documentation Style (Was: PyQt4 feature request)
On 08.03.09 12:32:37, Antonio Valentino wrote: > Il giorno Sun, 8 Mar 2009 12:04:51 +0100 > Detlev Offenbach ha scritto: > > > On Sonntag, 8. März 2009, Antonio Valentino wrote: > > > Il giorno Sun, 8 Mar 2009 10:40:38 +0100 > > > > > > Detlev Offenbach ha scritto: > > > > Hi, > > > > > > > > I think the Sphinx style should be prefered. As far as I know > > > > (please confirm) Sphinx has the capability to generate Qt Help > > > > files (*.qch) as well. If that is true, one could satisfy both > > > > parties. > > > > > > > > Regards, > > > > Detlev > > > > > > Detlev, > > > as far as I know QtAssistant don't fully support style-sheets > > > bundled with Sphinx (please correct me if I'm wrong) so results you > > > can achieve running sphinx out of the box to produce Qt docs are > > > very poor. > > > > Since Qt4.4 QtAssistant uses webkit based widgets. Eric uses these > > widgets as well and it will support QtHelp starting with the first > > 4.4 snapshot. > > Great! > > .. but, just a question, what described in > > http://doc.trolltech.com/4.4/richtext-html-subset.html > > applies or not to QtAssistant? It applies to the QTextEdit class, but QtAssistant (from 4.4) doesn't use that. It uses QWebView&Co which use Webkit behind the scenes for rendering. So its basically a full HTML browser nowadays. Andreas -- Today is the first day of the rest of your life. ___ PyQt mailing listPyQt@riverbankcomputing.com http://www.riverbankcomputing.com/mailman/listinfo/pyqt
Re: [PyQt] Documentation Style (Was: PyQt4 feature request)
Il giorno Sun, 8 Mar 2009 12:04:51 +0100 Detlev Offenbach ha scritto: > On Sonntag, 8. März 2009, Antonio Valentino wrote: > > Il giorno Sun, 8 Mar 2009 10:40:38 +0100 > > > > Detlev Offenbach ha scritto: > > > Hi, > > > > > > I think the Sphinx style should be prefered. As far as I know > > > (please confirm) Sphinx has the capability to generate Qt Help > > > files (*.qch) as well. If that is true, one could satisfy both > > > parties. > > > > > > Regards, > > > Detlev > > > > Detlev, > > as far as I know QtAssistant don't fully support style-sheets > > bundled with Sphinx (please correct me if I'm wrong) so results you > > can achieve running sphinx out of the box to produce Qt docs are > > very poor. > > Since Qt4.4 QtAssistant uses webkit based widgets. Eric uses these > widgets as well and it will support QtHelp starting with the first > 4.4 snapshot. Great! .. but, just a question, what described in http://doc.trolltech.com/4.4/richtext-html-subset.html applies or not to QtAssistant? If not that means I have a completely wrong understanding of the problem. > > I provided the initial patch but still haven't had the time to > > complete the job (also because I'm not to much familiar with HTML > > CSS ad such). > > > > I also have to point out that the qthelp builder is only available > > in the development version (presumably it will be included in > > Sphinx 0.6). > > > > In my opinion there is not too much work to do (a custom style-sheet > > and some tweaks on the template) but if you expect all works out of > > the box you will get disappointed. > > Isn't this occasion reason enough to complete the work? Yes, I'll do my best. It would help a lot if you (an all interested readers) could try to $ hg clone http://bitbucket.org/birkenfeld/sphinx/ $ cd sphinx/doc $ make qthelp $ qcollectiongenerator _build/qthelp/Sphinx.qhcp $ assistant -collectionFile _build/qthelp/Sphinx.qhc and tell me what you think about. thanks -- Antonio Valentino ___ PyQt mailing listPyQt@riverbankcomputing.com http://www.riverbankcomputing.com/mailman/listinfo/pyqt
Re: [PyQt] Documentation Style (Was: PyQt4 feature request)
On Sonntag, 8. März 2009, Antonio Valentino wrote: > Il giorno Sun, 8 Mar 2009 10:40:38 +0100 > > Detlev Offenbach ha scritto: > > Hi, > > > > I think the Sphinx style should be prefered. As far as I know (please > > confirm) Sphinx has the capability to generate Qt Help files (*.qch) > > as well. If that is true, one could satisfy both parties. > > > > Regards, > > Detlev > > Detlev, > as far as I know QtAssistant don't fully support style-sheets bundled > with Sphinx (please correct me if I'm wrong) so results you can achieve > running sphinx out of the box to produce Qt docs are very poor. Since Qt4.4 QtAssistant uses webkit based widgets. Eric uses these widgets as well and it will support QtHelp starting with the first 4.4 snapshot. > > I provided the initial patch but still haven't had the time to > complete the job (also because I'm not to much familiar with HTML CSS > ad such). > > I also have to point out that the qthelp builder is only available in > the development version (presumably it will be included in Sphinx 0.6). > > In my opinion there is not too much work to do (a custom style-sheet > and some tweaks on the template) but if you expect all works out of the > box you will get disappointed. Isn't this occasion reason enough to complete the work? Detlev -- Detlev Offenbach det...@die-offenbachs.de ___ PyQt mailing listPyQt@riverbankcomputing.com http://www.riverbankcomputing.com/mailman/listinfo/pyqt
Re: [PyQt] Documentation Style (Was: PyQt4 feature request)
Il giorno Sun, 8 Mar 2009 10:40:38 +0100 Detlev Offenbach ha scritto: > Hi, > > I think the Sphinx style should be prefered. As far as I know (please > confirm) Sphinx has the capability to generate Qt Help files (*.qch) > as well. If that is true, one could satisfy both parties. > > Regards, > Detlev Detlev, as far as I know QtAssistant don't fully support style-sheets bundled with Sphinx (please correct me if I'm wrong) so results you can achieve running sphinx out of the box to produce Qt docs are very poor. I provided the initial patch but still haven't had the time to complete the job (also because I'm not to much familiar with HTML CSS ad such). I also have to point out that the qthelp builder is only available in the development version (presumably it will be included in Sphinx 0.6). In my opinion there is not too much work to do (a custom style-sheet and some tweaks on the template) but if you expect all works out of the box you will get disappointed. regards -- Antonio Valentino ___ PyQt mailing listPyQt@riverbankcomputing.com http://www.riverbankcomputing.com/mailman/listinfo/pyqt
Re: [PyQt] Documentation Style (Was: PyQt4 feature request)
Hi, I think the Sphinx style should be prefered. As far as I know (please confirm) Sphinx has the capability to generate Qt Help files (*.qch) as well. If that is true, one could satisfy both parties. Regards, Detlev On Samstag, 7. März 2009, Phil Thompson wrote: > On Sat, 7 Mar 2009 18:06:12 +0100, Detlev Offenbach > > wrote: > > Hi, > > > > please include the PyQt4 documentation as a compressed Qt Help files > > (*.qch) > > as well. eric4 will support Qt Help collections starting with the first > > 4.4 > > > snapshot. > > An opportune moment to ask for opinions... > > When I (eventually) get round to improving the PyQt docs (particularly > making the API reference more Pythonic) it will be designed to support (in > theory) multiple output styles. In the Roadmap I specifically mention the > traditional Qt style and Sphinx (ie. that used for the Python v2.6 > documentation). > > Which of these two styles do people prefer? > > Phil > ___ > PyQt mailing listPyQt@riverbankcomputing.com > http://www.riverbankcomputing.com/mailman/listinfo/pyqt -- Detlev Offenbach det...@die-offenbachs.de ___ PyQt mailing listPyQt@riverbankcomputing.com http://www.riverbankcomputing.com/mailman/listinfo/pyqt
Re: [PyQt] Documentation Style (Was: PyQt4 feature request)
I prefer Sphinx. On Sat, Mar 7, 2009 at 12:50 PM, Phil Thompson wrote: > On Sat, 7 Mar 2009 18:06:12 +0100, Detlev Offenbach > wrote: > > Hi, > > > > please include the PyQt4 documentation as a compressed Qt Help files > > (*.qch) > > as well. eric4 will support Qt Help collections starting with the first > 4.4 > > > > snapshot. > > An opportune moment to ask for opinions... > > When I (eventually) get round to improving the PyQt docs (particularly > making the API reference more Pythonic) it will be designed to support (in > theory) multiple output styles. In the Roadmap I specifically mention the > traditional Qt style and Sphinx (ie. that used for the Python v2.6 > documentation). > > Which of these two styles do people prefer? > > Phil > ___ > PyQt mailing listPyQt@riverbankcomputing.com > http://www.riverbankcomputing.com/mailman/listinfo/pyqt > -- Doug Nichols dou...@gmail.com http://dnwnichols.home.comcast.net/ ___ PyQt mailing listPyQt@riverbankcomputing.com http://www.riverbankcomputing.com/mailman/listinfo/pyqt
Re: [PyQt] Documentation Style (Was: PyQt4 feature request)
On Sat, Mar 7, 2009 at 12:50 PM, Phil Thompson wrote: > On Sat, 7 Mar 2009 18:06:12 +0100, Detlev Offenbach > wrote: > > Hi, > > > > please include the PyQt4 documentation as a compressed Qt Help files > > (*.qch) > > as well. eric4 will support Qt Help collections starting with the first > 4.4 > > > > snapshot. > > An opportune moment to ask for opinions... > > When I (eventually) get round to improving the PyQt docs (particularly > making the API reference more Pythonic) it will be designed to support (in > theory) multiple output styles. In the Roadmap I specifically mention the > traditional Qt style and Sphinx (ie. that used for the Python v2.6 > documentation). > > Which of these two styles do people prefer? > I prefer Sphinx. ___ PyQt mailing listPyQt@riverbankcomputing.com http://www.riverbankcomputing.com/mailman/listinfo/pyqt