p12tic/cppreference-doc

Styling of .qch document

Opened this issue · 7 comments

The styling of the latest qch book (20170409.tar.gz) is missing under Qt Creator 4.2 and 4.3.

Please, take a look at the attached screenshot:

image

Thanks, I was able to reproduce this too. Not sure how such an error got into release...

estan commented

When QtWebkit was deprecated, Qt Creator switched to using QTextBrowser for the help browser by default, which only supports a very limited HTML/CSS (http://doc.qt.io/qt-5/richtext-html-subset.html). It will still use QtWebkit if available when building Qt Creator I think, but the official binaries do not.

For the cppreference qch to look good with this, someone would have to write a special CSS that takes the limited capability of QTextBrowser into account. I'm not sure how feasible that is.

This problem is registered in the Qt issue tracker here

The fix for this issue is in progress. QTextBrowser does not support <style> tags, but it supports style attributes. We're currently looking into using premailer project to transfer this information around.

Should this be closed or are there still issues with the QCH archive?

It's readable right now, but there are still some visual issues that need fixing.

QtCreator 4.11 introduced a new help rendering backend which looks better than the old one, see #79 (comment)