cppreference-doc icon indicating copy to clipboard operation
cppreference-doc copied to clipboard

Styling of .qch document

Open szotsaki opened this issue 7 years ago • 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

szotsaki avatar May 29 '17 08:05 szotsaki

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

p12tic avatar Jun 02 '17 05:06 p12tic

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.

estan avatar Oct 07 '17 17:10 estan

This problem is registered in the Qt issue tracker here

andoks avatar May 08 '18 06:05 andoks

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.

p12tic avatar May 08 '18 07:05 p12tic

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

PeterFeicht avatar Oct 20 '18 18:10 PeterFeicht

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

p12tic avatar Oct 20 '18 20:10 p12tic

QtCreator 4.11 introduced a new help rendering backend which looks better than the old one, see https://github.com/p12tic/cppreference-doc/issues/79#issuecomment-565230866

ilyapopov avatar Dec 12 '19 23:12 ilyapopov