qiurui
/
qtdoc
mirror of https://github.com/qt/qtdoc.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Qt Documentation
5,190 Commits 55 Branches 266 Tags 98 MiB
C++ 77.4%
CMake 22.2%
QML 0.4%
Go to file
Tero Heikkinen e0781dc6e4 Update supported platforms documentation 
Task-number: QTBUG-137602
Pick-to: 6.9
Change-Id: I4a17ae885367977f6112da3f2ec08333f8df0827
Reviewed-by: Jani Heikkinen <jani.heikkinen@qt.io>
(cherry picked from commit df651ef001)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
 		2025-08-13 10:02:48 +00:00
LICENSES Add REUSE.toml files and missing licenses 2024-11-06 13:48:01 +01:00
coin Remove unnecessary comment 2025-03-05 16:06:00 +01:00
dist Remove year from Qt Copyright in REUSE.toml 2025-07-14 09:47:07 +02:00
doc Update supported platforms documentation 2025-08-13 10:02:48 +00:00
examples colorpalettteclient: Fix qmllint warnings 2025-08-11 17:48:16 +02:00
tests Change license for tests file 2024-04-04 07:32:33 +00:00
.cmake.conf Bump version to 6.11.0 2025-06-14 12:51:57 +01:00
.gitattributes Update the git-archive export options 2012-09-03 19:51:51 +02:00
.gitignore Don't gitignore /doc/ 2023-06-22 16:18:45 +02:00
.gitreview Add .gitreview file 2025-03-24 16:07:49 +01:00
.tag Update the git-archive export options 2012-09-03 19:51:51 +02:00
CMakeLists.txt Move `qt_internal_project_setup` as early as possible 2025-05-30 15:22:03 +02:00
README.md Update top-level README 2025-08-06 08:25:01 +02:00
REUSE.toml Doc: Remove the old sidebar configuration file 2025-07-16 13:49:51 +03:00
dependencies.yaml Update dependencies on 'dev' in qt/qtdoc 2025-08-07 05:19:02 +00:00
licenseRule.json Doc: Remove the old sidebar configuration file 2025-07-16 13:49:51 +03:00

README.md

Qt Documentation

This repository contains the main Qt Reference Documentation, including overviews, Qt topics, examples, and tutorials not specific to any Qt module.

Documentation Projects

The documentation is organized into several documentation projects:

QtDoc

The main Qt Reference Documentation.

Project File: doc/config/qtdoc.qdocconf

Sources: doc/src/ (excluding cmake/ and platformintegration/ subdirectories)

Content:

  • Getting started guides and tutorials
  • Platform-specific documentation (Android, iOS, macOS, Windows, etc.)
  • Qt modules overview and reference
  • Development tools and utilities
  • Legal information and licenses
  • Examples and demos

CMake Targets: docs_QtDoc or html_docs_QtDoc

This project also contains the documentation for examples and tutorials in the examples/ directory.

QtCMake

Documentation for using Qt with CMake.

Project File: doc/src/cmake/qtcmake.qdocconf

Sources: doc/src/cmake

Content:

  • CMake manual and getting started guide
  • Qt CMake API reference
  • Build system configuration

CMake Targets: docs_qtcmake or html_docs_qtcmake.

QtPlatformIntegration

Documentation for integrating Qt with native platforms.

Project File: doc/src/platformintegration/qtplatformintegration.qdocconf

Sources: doc/src/platformintegration/

Content:

  • Qt Platform Abstraction (QPA)
  • Platform-specific integration guides
  • Native API interaction

CMake Targets: docs_QtPlatformIntegration or html_docs_QtPlatformIntegration.

Building Documentation

The main QtDoc documentation contains links to pages from other documentation projects (QtCore, QtQuick, etc.). Similarly, these projects link back to pages and topics in QtDoc.

Therefore, the most reliable approach is to build Qt documentation as part of a complete Qt build that includes all supported Qt modules. Refer to the README.md in qt5.git for detailed instructions.

Building Examples

Build the examples by opening the CMakeLists.txt files in the respective example directory.

Writing and Improving Qt Documentation

Qt Documentation is written in QDoc syntax. See https://doc.qt.io/qt-6/qdoc-index.html for the QDoc manual.

For more information about Qt's documentation, refer to the Qt Project wiki: https://wiki.qt.io/Qt_Writing_Guidelines

Writing and Improving Qt Examples

See https://contribute.qt-project.org/quips/13 for some guidance around the Qt examples.