1c729b931f
The qt-html-templates-online include adds a source for the results page, but because it was included before the main project .qdocconf, the latter overrode this setting. Pick-to: 6.0 Change-Id: I10d9491aa481eec958bdb8744e1c0bbd36e4763c Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io> Reviewed-by: Johanna Vanhatapio <johanna.vanhatapio@qt.io>
Writing Qt Design Studio Documentation
The Qt Design Studio Manual is based on the Qt Creator Manual, with additional topics. When building the Qt Design Studio Manual, parts of the Qt Creator Manual are pulled in from Qt Creator sources. This is enabled by creating separate table of contents files for each Manual and by using defines to hide and show information depending on which Manual is being built.
Because branding information is needed to use the correct product name and
version, you must run qmake -r on qtcreator.pro with the IDE_BRANDING_PRI
option set to the absolute path of ide_branding.pri in the Qt Design Studio
repository.
For example, on Windows enter (all on one line):
C:\dev\qtc-super\qtcreator>..\..\..\Qt\5.14.1\msvc2017_64\bin\qmake.exe qtcreator.pro -r IDE_BRANDING_PRI=C:\dev\tqtc-plugin-qtquickdesigner\studiodata\branding\ide_branding.pri
Building the Qt Design Studio Manual
- Run
qmakefrom Qt 5.14.0, or later with the path to the branding information as a parameter:<relative_path_to>\qmake.exe qtcreator.pro -r IDE_BRANDING_PRI=<absolute_path_to>\tqtc-plugin-qtquickdesigner\studiodata\branding\ide_branding.pri - Run
make docson Linux and macOS ornmake docson Windows.
The docs are generated in qtcreator\doc\html\qtdesignstudio with the
Qt Design Studio branding.