Commit Graph

124 Commits

Author SHA1 Message Date
Pranta Dastider
0a54933c8d QmlDesigner: Create a document for the Design Effect Demo Example
This patch creates a document for the Design Effect Demo Example
in Qt Design Studio. It updates a macro, include images and creates text to
support the usage of this demo.

Fixes: QDS-13034
Change-Id: Ifc3634d388d8e27c64ecd2b244669d60757ad33c
Reviewed-by: Brook Cronin <brook.cronin@qt.io>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2024-08-05 09:55:52 +00:00
Tim Jenssen
4515fba526 Merge remote-tracking branch 'origin/qds/dev'
Conflicts: src/plugins/qmldesigner/CMakeLists.txt

Change-Id: I250c8e5284ddb0f335c440999b8920762419c89b
2024-05-28 19:06:18 +02:00
Eike Ziller
8b5f5744dc Rename Qt Designer -> Qt Widgets Designer
Fixes: QTCREATORBUG-30756
Change-Id: Icb4a2513e230b71b5bb5033ead6a09ad3a8963ab
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2024-05-23 11:37:08 +00:00
Pranta Dastider
5f23a07ba7 QmlDesigner: Update Qt Academy course links in documents
This patch adds some of the Qt Academy course links in
the relevant documents.

Fixes: QDS-12747
Change-Id: I8309681869922be3277e775c312ffa1210d64a29
Reviewed-by: Jaishree Vyas <jaishree.vyas@qt.io>
2024-05-23 08:46:38 +00:00
Eike Ziller
90b3068ecf Merge remote-tracking branch 'origin/13.0'
Conflicts:
	doc/qtcreator/src/editors/creator-only/creator-language-server.qdoc

Change-Id: If93df2592a66679eeff9c8a337372e3aad65f1f1
2024-05-21 09:40:46 +02:00
Tim Jenssen
cbd36f93fa Merge remote-tracking branch 'origin/13.0' into qds/dev
Change-Id: Ief07ead0b4cf513c70bd74d4f5e28e4642edc78e
2024-05-17 17:57:18 +00:00
Leena Miettinen
c7803fe6ae Doc: Mention QML Language Server in "Adding Language Servers"
- Add a link to "Turn on QML Language Server".
- Add the \QMLLS macro and use it everywhere.

Fixes: QTCREATORBUG-30823
Change-Id: I75ff67967ad6bf592dceeae46486713012aafd50
Reviewed-by: David Schulz <david.schulz@qt.io>
Reviewed-by: Sami Shalayel <sami.shalayel@qt.io>
Reviewed-by: Fabian Kosmale <fabian.kosmale@qt.io>
2024-05-17 09:07:23 +00:00
Leena Miettinen
5b5c61c519 Doc: Restructure info on developing for Boot2Qt devices
- Split the topic into how-to and reference topics
- Remove redundant information
- Make the instructions consistent with the remote Linux topics
- Include info about SSH connections from the remote Linux topic
- Add the \B2Q macro for "Boot to Qt" and use it where possible
  (some UI text still says "Boot2Qt"

Task-number: TCREATORBUG-29361
Change-Id: I7fe5f957049d84ec7402f4c11a070ac2d44fcb38
Reviewed-by: hjk <hjk@qt.io>
Reviewed-by: Inkamari Harjula <inkamari.harjula@qt.io>
Reviewed-by: Samuli Piippo <samuli.piippo@qt.io>
2024-05-16 07:42:09 +00:00
Pranta Dastider
18c2a8e02c QmlDesigner: Create the documentation for Qt UI Viewer
This patch creates the documentation for the
Android app Qt UI Viewer.

Fixes: QDS-11807
Change-Id: Ieabc7f986fa6470bf3c674062e10d3b3e4c10d42
Reviewed-by: Mats Honkamaa <mats.honkamaa@qt.io>
Reviewed-by: Thomas Hartmann <thomas.hartmann@qt.io>
2024-02-27 10:08:36 +00:00
Riitta-Leena Miettinen
0fe891678a Doc: Use a link to "Find preferences" as value of \preferences
- Add the instructions for finding the Preferences menu to the
  "Find a particular preference" topic and rename it "Find preferences".
- Remove the "Find menu items on macOS" topic

Change-Id: I627e5c20d2c63efb4490d446608b923ac15a6aac
Reviewed-by: <github-actions-qt-creator@cristianadam.eu>
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2023-10-24 09:00:36 +00:00
Leena Miettinen
81898c675c Doc: Add a \preferences macro and use it everywhere
The macro can be used to show the path to Preferences
on Windows, Linux, and macOS. The current value expands to:
"Edit (or Qt Creator on macOS) > Preferences".
We can now change this in one place if we so wish.

Task-number: QTCREATORBUG-29734
Change-Id: I9afe4f7093dbcc8e62a2b18e1ae3f6f243bbb72b
Reviewed-by: hjk <hjk@qt.io>
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2023-10-18 14:43:29 +00:00
Mats Honkamaa
781e9dd5e3 Doc: Unify product naming
Unify naming for Qt Online Installer and Qt Maintenance Tool. Ass macros for theses
as well.

Task-number: QTBUG-116573
Change-Id: I90247956300607b852a17df96aa667bf55805e36
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Qt CI Patch Build Bot <ci_patchbuild_bot@qt.io>
2023-09-12 16:22:28 +00:00
Mats Honkamaa
239d8882a9 Doc: Update QQEM parts in doc
Task-number: QDS-9588
Change-Id: I3ae76bf708549e18e8024122d809bd15cb63de05
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2023-05-11 09:31:18 +00:00
Esa Törmänen
53ce5d6dff Doc: Add Qt Quick Ultralite macro
Task-number: QDS-9613
Change-Id: I8b3dc970d2ca335f9efb320eb22b41891d96f498
Reviewed-by: Mats Honkamaa <mats.honkamaa@qt.io>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2023-04-04 08:51:14 +00:00
Esa Törmänen
ae6c686836 Doc: Add Qt for MCUs macro
Added a new Qt for MCUs macro and modified a number of related topics
accordingly.

Task-number: QDS-9609
Change-Id: I6506a9cb6671c29d5b164d53cb01c827639ecb16
Reviewed-by: Mats Honkamaa <mats.honkamaa@qt.io>
2023-04-04 06:39:19 +00:00
Pranta Dastider
a34401eae2 QmlDesigner: Create Figma Quick Control Template merge doc
There is a new feature, which lets to have Figma users templates
from Qt Design studio on Figma end. And later getting components
imported from Figma to Qt Design studio to have them accurately
as local components. This document aims to note that process.

Fixes: QDS-8719
Change-Id: I8b375730c32c8a41bbeebcacc616ed2a295bf881
Reviewed-by: Thomas Hartmann <thomas.hartmann@qt.io>
2023-02-22 09:51:12 +00:00
Vikas Pachdha
624df6ec44 Doc: Add Qt-Bridge plugin docs for adobe XD
Task-number: QDS-4615
Change-Id: Ie3c7d814fbf59841f112315cf71553076ec7e0d7
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2021-09-29 10:02:06 +00:00
Leena Miettinen
428ac96dd1 Doc: Describe using Qt Bridge for Figma
Task-number: QDS-2525
Change-Id: I5c574c291bfb526452a2429a91920a875e1573a5
Reviewed-by: Thomas Hartmann <thomas.hartmann@qt.io>
2020-12-11 16:26:06 +00:00
Leena Miettinen
b9886a4b04 Doc: Fix the \youtube macro for use with liteHTML help backend
Create a common directory for extra image files, and move the video
thumbnails there. This folder structure is required to work around
the fact that relative image paths passed to qhp.<project>.extraFiles
are not resolved correctly when loading the generated help project.

Change-Id: Iff5583a9a318670571b7f706182723e54e0ec466
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
2020-12-01 10:40:02 +00:00
Leena Miettinen
7f28237915 Doc: Add support for the \youtube macro
Show links to Youtube videos using thumbnails with a play button.

Change-Id: I131f24b1fb723c817c2387429bbf52997003f105
Reviewed-by: Thomas Hartmann <thomas.hartmann@qt.io>
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
2020-11-27 13:51:31 +00:00
Johanna Vanhatapio
784420e911 Doc: Describe converting projects from Qt 3D Studio to Qt Design Studio
Draft of the migration guide describing the best practices and including
a step-by-step guide for the converting process.

Fixes: QDS-2252
Change-Id: I501b57450525cd3122510d5f9d784804996dd70f
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Alessandro Portale <alessandro.portale@qt.io>
Reviewed-by: Mahmoud Badri <mahmoud.badri@qt.io>
2020-07-01 12:50:48 +00:00
Leena Miettinen
f51258a17c Doc: Move Qt Bridge product name macros to the common macros file
..from the Qt Design Studio Manual doc configuration file.

Change-Id: Iebbfb5404cae4ef277f05c867e7259997b19a27e
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
2020-05-14 10:18:31 +00:00
Eike Ziller
a467e34e58 Fix qdoc call after it moved to LLVM/Clang
For some unknown reason qdoc does not add the include paths for
Qt modules, so we need to do that manually.
Also, if we do that, we need to pass it the default include paths, so
standard C++ headers are found.

Qt includes and standard headers are found now, but

Framework style includes on macOS still fail ("QtCore/QString"), which are
used in Qt headers as well. Looks like the framework path that is passed
with -F to qdoc is not passed on correctly.

Task-number: QTCREATORBUG-22451
Change-Id: I04b2c75ecdeb1f0e70ba9adfea039f0ff16ec96b
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2020-02-17 15:45:48 +00:00
Leena Miettinen
5fc456dd22 Doc: Rearrange files in the doc folder
Source and configuration files for each manual are now located in a
separate subdirectory, with common configuration files in doc/config.

doc
|_config
|_qtcreator
|_qtcreatordev
|_qtdesignstudio

Edit the config files accordingly.

Change-Id: Idc747a7c16e84f3e06add91234dc5fc908e64cc5
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2020-01-27 09:05:07 +00:00
Leena Miettinen
0f148f479d Doc: Add dependency to qtcmake for links to CMake docs to work
Fixes a QDoc warning.

Change-Id: I7248cbc6471830039f6399696416de40ceacb595
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
2019-12-18 08:20:28 +00:00
Leena Miettinen
3228d2626f Doc: Update info about Clang tools
Change-Id: I86fecea5e5bc6d1b514cca4b8ad7a865cbf87c7e
Reviewed-by: Nikolai Kosjar <nikolai.kosjar@qt.io>
2019-11-25 09:45:36 +00:00
Leena Miettinen
fea693d9f9 Doc: Update info about enabling the Timeline view in Qt Creator
Qt Quick Timeline module is delivered with Qt 5.14 and later.

Change-Id: I5666fa0fd190607a1bb6224dcff5ac7f39db61f7
Reviewed-by: Thomas Hartmann <thomas.hartmann@qt.io>
2019-10-28 07:53:57 +00:00
Leena Miettinen
999564d393 Doc: Describe using Qt Design Viewer
For running Qt Quick UI projects (.qmlproject) in web
browsers.

Change-Id: Ied9b971755ccef9f94e9e0ffb578d3ecbd0ef6c0
Reviewed-by: Thomas Hartmann <thomas.hartmann@qt.io>
2019-10-25 07:56:23 +00:00
Leena Miettinen
526163cc16 Doc: Add info on Live Preview
The documentation was moved from the Qt Design Studio repository
and edited to make it applicable to Qt Creator, too.

Change-Id: I3072fc712b5ee002cd6e7486927de31f9117d7bc
Reviewed-by: Brook Cronin <brook.cronin@qt.io>
Reviewed-by: Tim Jenssen <tim.jenssen@qt.io>
2019-07-11 12:51:31 +00:00
Leena Miettinen
5b68dde3ca Doc: Fix the path to Timeline editor images
The icon files were moved to a new location.

Change-Id: I45b2ed9e78cb9fd3b00a75a37598df2beba745e2
Reviewed-by: Thomas Hartmann <thomas.hartmann@qt.io>
2019-07-02 13:19:55 +00:00
Leena Miettinen
8d0cd98d4d Doc: Move Timeline editor docs to the Qt Creator repository
Reorganize the Qt Quick Designer docs.

Change-Id: I844f2ffa6c8337eef1d9aa5dbd23610c706a8c33
Reviewed-by: Brook Cronin <brook.cronin@qt.io>
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
Reviewed-by: Alessandro Portale <alessandro.portale@qt.io>
2019-05-03 13:55:11 +00:00
Leena Miettinen
aacac48908 Doc: Replace "Qt Quick Controls 2" with "Qt Quick Controls"
- Qt Quick Controls 1 has been removed and most link targets have
  been changed
- Leave some link targets where links would break
- Leave strings that still have the "2" in Qt Creator
- Remove the obsolete dependency (QDoc complained about it)

Change-Id: I05148df3b07b4499f802557252c028b11ca29213
Reviewed-by: Thomas Hartmann <thomas.hartmann@qt.io>
2019-04-09 07:15:56 +00:00
Leena Miettinen
6ee855a2bc Doc: Describe launching KCachegrind from Qt Creator
...for profile data visualization.

Change-Id: I878ab4a3dfff0fc43903e482603a516514e79c10
Reviewed-by: hjk <hjk@qt.io>
2019-04-05 15:18:21 +00:00
Leena Miettinen
fdd8650657 Doc: Describe converting Qt Quick UI Prototypes to Applications
Qt Quick UI Prototype projects (.qmlproject) are used in Qt Design
Studio, but they must be converted to Qt Quick Application projects
for building and running them in Qt Creator.

Add example files and quote code from them.

Task-number: QDS-357
Change-Id: Ib0bf1b342ec54faeca108e5586389730a85b5116
Reviewed-by: Thomas Hartmann <thomas.hartmann@qt.io>
2019-01-16 10:59:30 +00:00
Leena Miettinen
c76db4d085 Doc: Use defines to enable hiding device-related information
Currently, only Android and embedded Linux devices are supported
by Qt Design Studio.

Change-Id: I10005f6a9cfeb93c99447796c1c9e6d47ab578de
Reviewed-by: Vikas Pachdha <vikas.pachdha@qt.io>
Reviewed-by: Thomas Hartmann <thomas.hartmann@qt.io>
2018-08-16 07:34:50 +00:00
Eike Ziller
2e1f0c2578 Fix documentation build when renaming IDE
Do not rename documentation qhp file. The documentation qmake files
currently depend on the files having the same base name as the qdocconf file.
Also do not change the documentation namespace. There are places where
these are mentioned in translated strings.

Fixup of 54208113ee

Change-Id: Iace171535ea5be6e22fec9760a5d96722b052341
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Thomas Hartmann <thomas.hartmann@qt.io>
Reviewed-by: Tim Jenssen <tim.jenssen@qt.io>
2018-07-04 07:42:14 +00:00
Eike Ziller
54208113ee Pass IDE_DISPLAY_NAME et al to qdoc and use it for manual
Change-Id: I5d52c9561d4c49df503c0e99c8765979516e5b5c
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2018-06-20 10:01:52 +00:00
Leena Miettinen
b1fcbfecce Doc: Add a link to a site map (TOC) listing all topics
Change-Id: Ibb71a67874d0146298c6bbed420549660426e0ca
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2018-05-25 09:30:31 +00:00
Leena Miettinen
66a22bb608 Doc: Describe the new toolbar in Qt Quick Designer
Some regularly used context-menu items can now be selected
on the toolbar. Some of the icons are constructed at runtime,
so images are needed for them. Some are in a new location that
has to be added to the configuration file.

Change-Id: Ibfc38ec21ed5526702abf89e64899efa5b978700
Reviewed-by: Thomas Hartmann <thomas.hartmann@qt.io>
2017-05-04 06:44:03 +00:00
Leena Miettinen
b7d1be77e9 Doc: Remove dependencies to deprecated modules
To suppress QDoc warnings.

Change-Id: Ic1eb077701d9e9bdcaee63af9af8eaff8d2ec26f
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2017-03-23 12:37:10 +00:00
Eike Ziller
33fa4b401c Create a reusable docs.pri for generating documentation
Since we cannot directly use qt_docs.prf since it contains
various Qt specific details, adapt it for use in Qt Creator.
This can then be used e.g. by plugins that are not part of the
Qt Creator repository.

Change-Id: I87511cad74cbcae5cb58087e9a9386130d635aa9
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
Reviewed-by: Oswald Buddenhagen <oswald.buddenhagen@qt.io>
2017-03-09 09:30:42 +00:00
Leena Miettinen
0ed42f1c9f Doc: Move the TOC to a separate page that is used as indexTitle value
This fixes the problem that the whole TOC is not visible in the
Qt Creator Help mode Contents view (because it was generated based on
the \table entries, not the \list entries).

Task-number: QTCREATORBUG-10585
Change-Id: I86607e10db7172b2a7492e4ce1660c39390ef9ed
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
2017-03-09 09:13:27 +00:00
Eike Ziller
461a7483e3 Doc: Remove unused QTC_LICENSE_TYPE define
Change-Id: Iba49e6fc6b1d857cc0f87b5bf833f42a4a8a976f
Reviewed-by: Kai Koehne <kai.koehne@qt.io>
2017-03-06 07:46:13 +00:00
Leena Miettinen
d2e99f9e55 Doc: Add docs for SCXML Editor
Change-Id: I563a2a06b101e3954c3365baba4a596ef29517ab
Reviewed-by: Ulf Hermann <ulf.hermann@qt.io>
2016-10-06 14:05:26 +00:00
Leena Miettinen
1d39d8aba7 Doc: Remove reference to obsolete qtquicklayouts.index file
Add a link to the Layout QML type and fix the name of the import
to stop an autolink from being generated to the wrong target.

Change-Id: Id2ca5e418ea6d254813a20f00b6623ff21dda09a
Reviewed-by: Topi Reiniö <topi.reinio@theqtcompany.com>
2016-08-19 07:48:16 +00:00
hjk
1e8ffa20d0 Doc: Introduce a macro \macos to adapt to upcoming renamings
Start with an initial value 'macOS' and use in uncontroversial
places in the docs. Some explicit references to older versions
are untouched in this patch.

Change-Id: Ibea4115c45fc2ff2c9a0518d92797df26fd4138f
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2016-08-03 15:30:06 +00:00
Leena Miettinen
ecbd1fa408 Doc: Update creating components and screens with Qt Quick Designer
Add dependency to the Qt Quick Controls 2 docs

Change-Id: Idcbb856cf38d8867dc781ade572cf18f87983912
Reviewed-by: Tim Jenssen <tim.jenssen@qt.io>
2016-07-29 12:10:13 +00:00
Leena Miettinen
2ab466ea04 Doc: Describe model and state chart wizards
Add the Qt SCXML index file to be able to link to the module
docs.

Change-Id: Ibd28071cdc3c98c07fb91c73732d809ffed5333b
Reviewed-by: Ulf Hermann <ulf.hermann@qt.io>
2016-07-27 14:21:04 +00:00
Alessandro Portale
a6683575c4 Icons: Move "next/prev", "[un]locked" and "zoom" from Core to Utils
They are needed in the timeline view.
The change in qtcreator-project.qdocconf makes sure
that qdoc still finds the referenced icons.

Change-Id: I812fba8e57d06d93efc00c295467c83c08cd1784
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Alessandro Portale <alessandro.portale@theqtcompany.com>
2016-05-31 08:51:12 +00:00
Leena Miettinen
4021a2a902 Doc: Use icons from source in the manual
This removes the need to take screenshots of icons.

- Add icon source directories for the .qdocconf file
- Remove screenshots of icons from doc\images (except completion
  icons)
- Copy images that do not have unique names from src or libs
  to \docs\images
- Create images that use overlays and update them in docs\images
- Fix paths and filenames in \inlineimage commands
- Fix text where one screenshot was replaced by two icons

Change-Id: Ib98206890bd15a843566de8d709e45487c70dfbd
Reviewed-by: Alessandro Portale <alessandro.portale@theqtcompany.com>
2016-05-03 14:26:35 +00:00