Commit Graph

231 Commits

Author SHA1 Message Date
Sadegh Taghavi db0658e8ea Add OSM Buildings To the Doc highlights
Change-Id: I707ae2a2bf84604a403c1416d32229a811c94a3c
Reviewed-by: Janne Koskinen <janne.p.koskinen@qt.io>
2024-02-06 13:06:09 +02:00
Kai Köhne e6f034d212 Improve StocQt example metadata
Rename to just 'StocQt', as we don't talk about demos
anymore. Also mark example as to be highlighted.

Pick-to: 6.6 6.7
Change-Id: I2b88db8b505ea628702484eaf21e896c2097ed65
Reviewed-by: Sakaria Pouke <sakaria.pouke@qt.io>
Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>
2024-02-02 08:31:31 +01:00
Kai Köhne cf31f8a694 Update examplecategories list
Amends d741f3d9cb

Pick-to: 6.6 6.7
Task-number: QTBUG-117884
Change-Id: Ie25c08f5af1652ca054e2f16edc9da97ede79e97
Reviewed-by: Jaishree Vyas <jaishree.vyas@qt.io>
2024-01-17 09:35:57 +01:00
Kai Köhne 625b277c58 Doc: drop 'example' from title of application examples
There is no need to keep the example in the title, see also
https://wiki.qt.io/Qt6/Example-Guideline .

Pick-to: 6.7
Change-Id: If173285c2e0f0ef7d21a113e4e0713aef84511dc
Reviewed-by: Pranta Ghosh Dastider <pranta.dastider@qt.io>
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
2024-01-10 16:02:48 +01:00
Kai Köhne e66b74498a Doc: Highlight Lightning Viewer Example
Application Examples by definition should be highlighted.

Pick-to: 6.7
Task-number: QTBUG-116750
Change-Id: Ie7aafa387d5ccdd02d7f4b8bed5d501152d97246
Reviewed-by: MohammadHossein Qanbari <mohammad.qanbari@qt.io>
Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
Reviewed-by: Lars Sutterud <lars.sutterud@qt.io>
2024-01-08 15:14:44 +00:00
Kai Köhne f4469d6cd1 Doc: Highlight Car Configurator Application Example
Pick-to: 6.7
Task-number: QTBUG-120287
Change-Id: If747777f13821191a80275cd6f76a2e91d778483
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2023-12-21 17:32:56 +01:00
Kai Köhne c31ad31f02 Doc: Remove tweetsearch example
The documentation for the example was disabled since commit
012384be6a (6.0), so the example was little used. It also
requires a Twitter developer account, which costs at least
100$ / month (https://developer.twitter.com/en/docs/twitter-api).
So probably not worth to keep the example.

Change-Id: I75e4a67a5525d49e9857703d5932081d697a68a6
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
Reviewed-by: Alex Blasche <alexander.blasche@qt.io>
2023-12-03 10:38:23 +01:00
Kai Köhne 2dd01f4182 Doc: Enable documentation for Same Game example
The documentation for this example - among others - was blacklisted
in commit 012384be6a. It's unclear what exactly caused this
example to be considered 'broken', but it seems to work now and
is popular, so let's revive it.

Pick-to: 6.6
Task-number:  QTBUG-119203
Change-Id: Iabdbc2b8b5c84f86e8086a71cfaad4ca8a493f0b
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
2023-12-03 10:38:20 +01:00
Kai Köhne 662d283ba3 Categorize Same Game as Application Example
Also simplify name to 'Same Game'.

Pick-to: 6.5 6.6
Task-number: QTBUG-117207
Change-Id: I6c16698bea3bc853ac7632d058e5f6c65a55a1d8
Reviewed-by: Mats Honkamaa <mats.honkamaa@qt.io>
2023-10-17 06:56:02 +00:00
Kai Köhne 0519c51e96 Doc: Fix list of highlighted examples
Highlight all 'Application Examples' for now. This avoids WebEngine
examples to be shown too prominently (as they are highlighted, too).

Pick-to: 6.5 6.6 6.6.0
Change-Id: Ica3075ef8e29bad6babafd0491e8c0d1e0bc1bc1
Reviewed-by: Joerg Bornemann <joerg.bornemann@qt.io>
2023-09-19 08:06:41 +00:00
Jaishree Vyas e5020dd289 Doc: All overviews list categorization
The \generate list names are added for each categorized section with
some explanation. Here, calling the overviews as
explanations-(name of the section). The idea is to give general terms
instead of specific phrases like 'core' etc, for better understanding.

Allow two warnings for \generatelist commands as the related \group
pages live in modules external to qtdoc and are not loaded when
testing documentation in the CI.

Task-number: QTBUG-115347
Pick-to: 6.5 6.6
Change-Id: Ia8307d42fdb137808ae75cb9bcfeb58de30ba550
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
2023-09-11 07:40:39 +00:00
Kai Köhne 329c9dda0b Add 'User Interface Components' example category
Pick-to: 6.5 6.6
Task-number: QTBUG-115174
Change-Id: Ia9b6214bf82146ad5b6c485379c2abc6fe2c4c1c
Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>
Reviewed-by: Tuukka Turunen <tuukka.turunen@qt.io>
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
2023-09-04 09:48:21 +02:00
Topi Reinio abb30aff0c Doc: Fix ill-placed */ in WebAssembly documentation
The closing C-style comment delimiter causes the entire documentation
block to terminate early.

In passing, fix some formatting issues, converting documented steps
to an ordered \list.

Mark the qtdoc module clear of documentation warnings.

Pick-to: 6.6
Change-Id: I55973e5ed84038fcd7a164e091c112f929af32be
Reviewed-by: Andreas Eliasson <andreas.eliasson@qt.io>
2023-08-31 11:22:59 +00:00
Kai Köhne 51c5b597aa Add full list of example categories to examples metadata
Add the full list of all example categories in the right order
to QtDoc metadata. This will generate a matching list in the
matching examples-manifest.xml file, and allows Qt Creator to sort
the categories correctly.

Pick-to: 6.5 6.6
Change-Id: I45dccf4d7fd0020e25f19e22a5bfebb44f640cca
Reviewed-by: Eike Ziller <eike.ziller@qt.io>
2023-08-07 10:38:31 +02:00
Topi Reinio 5c017d6571 Doc: Remove warninglimit .qdocconf variable
The most common limit for the maximum number of allowed documentation
warnings is zero. As all Qt module docs include() a common configuration
from qtbase, it's better to control the base warninglimit from a central
location in qtbase/doc/global.

This allows for a temporary increase of the limit across all modules as
needed - for example, when updating the QDoc binary that the CI
provisions to a version that introduces new types of documentation
warnings.

Task-number: QTBUG-113326
Change-Id: I51cccfed5fe4ff27c99cb280db1f0959be16df1d
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
2023-06-27 10:42:33 +00:00
Leena Miettinen bdf675dbd6 Doc: Consolidate internationalization documentation
- Combine the "Internationalization with Qt" and
  "Internationalization and Localization with Qt Quick"
  topics
- Add a "Localizing Applications" topic
- Move information from the Qt Linguist Manual developer
  section to the new topics
- Add a link to a YouTube video about localizing apps
- Use active voice and present tense

Fixes: QTBUG-71876
Change-Id: If2db1d4865e47a85e0b63adac326fc123ad65e50
Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
Reviewed-by: Joerg Bornemann <joerg.bornemann@qt.io>
Reviewed-by: Kai Köhne <kai.koehne@qt.io>
Reviewed-by: Edward Welbourne <edward.welbourne@qt.io>
2023-01-25 12:16:23 +01:00
Topi Reinio 02e20838fe Doc: Set example root URL in documentation configuration
This sets 'url.examples' that is used for generating the link to
the example project under code.qt.io in example documentation.

Pick-to: 6.5 6.4
Change-Id: I5f7647d38b622503c3b1e1d568d64762ef4c55bf
Reviewed-by: Vladimir Minenko <vladimir.minenko@qt.io>
Reviewed-by: Venugopal Shivashankar <Venugopal.Shivashankar@qt.io>
2023-01-16 09:52:11 +00:00
Jaishree Vyas 3711e001f0 Data input output overview
Modified Data storage page to I/O and various ways to
retrieve and save data.

Fixes: QTBUG-104786
Fixes: QTBUG-104353
Pick-to: 6.4 6.5
Change-Id: Ie4f7c3ebec2f2c2179680ad36e59e97cefd163fc
Reviewed-by: Kai Köhne <kai.koehne@qt.io>
2022-12-22 14:55:52 +01:00
Jaishree Vyas a7c8136d37 Link whats new in Qt 6
Fixes: QTBUG-107723
Pick-to: 6.4 6.4.2
Change-Id: I34d6b72363049ffa105778e696a0d4e956c28d65
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Vladimir Minenko <vladimir.minenko@qt.io>
2022-12-09 14:36:17 +01:00
Nicholas Bennett 23d41aaf79 Docs: Add Android platform documentation
How it works page, host environment variables page,
and relevant CMake information page added.

Fixes: QTBUG-107704
Pick-to: 6.4 6.2
Change-Id: I823d3f9d97f49e79da867660bd4cd41a8378266a
Reviewed-by: Assam Boudjelthia <assam.boudjelthia@qt.io>
2022-11-29 13:50:52 +02:00
Thibaut Cuvelier e25fb22d4b Adapt qdoc macros for DocBook
Change-Id: I96ae4df88465eeecd40d8c32dae2a9302fda1bfc
Reviewed-by: Nicholas Bennett <nicholas.bennett@qt.io>
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
2022-11-02 16:28:26 +02:00
Topi Reinio aafbdd1fd4 Doc: Add documentation for Qt educational license
Add step-by-step install instructions for installing Qt for application
development and Qt Design Studio for Qt educational license holders.

These steps differ from normal procedure with the online installer as
it involves the creation of Qt Account via the education license
program, and the available packages differ from those in the open-source
edition.

Add instructions for using Raspberry Pi as a target hardware via QBSP,
also available as part of the educational license.

Link to the new pages from Getting Started, and add information about
the educational license to Licensing page.

Pick-to: 6.4
Fixes: QTBUG-106537
Done-with: Hanna Humaljoki <hanna.humaljoki@qt.io>
Change-Id: Icce481c50f19580363e25e07b084bc80d7e1132a
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2022-10-14 09:27:57 +02:00
Topi Reinio 4ed4407167 Fix path for YouTube video thumbnail
A relative path was used to refer to a thumbnail image for a video link
on Qt for Android overview page. While QDoc was able to locate and copy
the image to the output directory, the relative path appears as-is in
the generated .qhp file and is no longer correct, causing qhelpgenerator
to ignore it.

Consolidate all 'extra images' into the same source directory and handle
them in one location in the .qdocconf file.

Pick-to: 6.4
Change-Id: I66531da883bac57fcf32e75c11eb087a648d9798
Reviewed-by: Luca Di Sera <luca.disera@qt.io>
2022-10-13 12:38:14 +02:00
Kai Köhne bc21f7f606 Examples: Add tags for the welcome screen
Only the coffee machine example had some tags already. Add them
also for the rest, but inside the .qdoc file, instead of the
more clunky/verbose tagging in the .qdocconf file.

Pick-to: 6.4
Change-Id: I37640c2296c67413361f7987122c5e7daa1f12b0
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
2022-10-09 21:10:07 +02:00
Nicholas Bennett 0fbb595b7f Docs: Fix getting started with android YouTube video ID
The YouTube ID copied from the browser was incorrect.

This patch fixes this.
Will build locally and check embedded YouTube videos work in future
before pushing.

Pick-to: 6.4
Change-Id: Ib48500a2b49abb17177353bc544dcb05d10c219b
Reviewed-by: Assam Boudjelthia <assam.boudjelthia@qt.io>
2022-10-07 21:19:25 +03:00
Nicholas Bennett 1908dac337 Docs: Embed getting started with android video in relevant docs page
Embedded the YouTube video in the getting started with android docs.

Fixes: QTBUG-107151
Pick-to: 6.4
Change-Id: I9b4e77de6f6be19eb29efd7241a9e7ee1ddefa02
Reviewed-by: Assam Boudjelthia <assam.boudjelthia@qt.io>
2022-10-04 10:41:04 +00:00
Andy Shaw 01a3127498 Update link to new online installer walkthrough
Pick-to: 6.3 6.2 5.15
Change-Id: I4951e7dc546d78ef2b69a5bd7e9a52b005141850
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
2022-04-28 11:30:01 +00:00
Topi Reinio feda50b5bb Doc: Revise online sidebar
* Drop the link to 'Qt Creator' under the 'Reference' section; it's not
  really a reference, and can be reached via the 'Developer Tools'
  link easily.
* Shorten 'All Qt Reference Documentation' to 'All Qt Reference Pages'

Pick-to: 6.3
Change-Id: Iad3dec5607cee0c13420834feb5db6362eae5fa3
Reviewed-by: Kai Koehne <kai.koehne@qt.io>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
2022-04-28 09:06:00 +00:00
Topi Reinio d19f9f7573 Doc: Rename "What's New in Qt 6" page
While the page links to dedicated pages that list new features in each
6.x release, the page itself no longer serves as the authoritate source
for new features. Rename it to 'Introduction to Qt', adjust links and
the sidebar.

Pick-to: 6.3.0 6.3
Fixes: QTBUG-96459
Change-Id: I6c5c17444fcbd456f7b35f485da7cd2b347f09ac
Reviewed-by: Kai Koehne <kai.koehne@qt.io>
2022-03-25 11:13:43 +01:00
Venugopal Shivashankar 875f54103d Doc: Enable zero warning limit
Change-Id: I157ef93d8a5c07528de267fe51ea9ed7f161a7ee
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
2021-11-15 21:32:46 +01:00
Venugopal Shivashankar 867604297d Doc: Fix qdoc warnings
Change-Id: I10434c5231794ce91ddb170882ce8e55ca829cd0
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
2021-11-15 12:56:09 +01:00
Oliver Eftevaag 1c92e55a07 Highlight calqlatr example in creator
Adding the calqlatr as a highlighted example in the qt creator welcome
page.

Pick-to: 6.2
Change-Id: Ib87d0f731d2922d1f5c697479a2a4f936d9a836f
Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>
2021-09-23 08:37:24 +00:00
Kai Köhne ef5fc78a0b Doc: Remove unsupported customFilters
customFilters defined in .qdocconf are not supported anymore by Qt
Assistant since Qt 5.13. Therefore remove them from all .qdocconf files,
also to avoid cargo-culting them to new help modules.

Task-number: QTBUG-95987
Change-Id: I83562b30c2fa039b7a207caaf7b3705ae0e4aa70
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
2021-09-06 10:06:28 +00:00
Paul Wicking 72cf92501c Doc: update location for youtube thumbnail in config
Pick-to: 6.2
Change-Id: Ic9a98d9f75de3d7a6cb2830547cc80c46072b57e
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
2021-08-04 14:40:35 +00:00
Paul Wicking bee16ca5b6 Doc: Update getting started video link
Pick-to: 6.2 6.1 5.15
Change-Id: I3f4abc05d7c8d82a7051fa0de29407cf8442771f
Reviewed-by: Andy Shaw <andy.shaw@qt.io>
2021-07-29 12:20:45 +00:00
Tor Arne Vestbø 47fe7bccc9 Add Extras modules porting guide
Pick-to: 6.2
Task-number: QTBUG-83251
Task-number: QTBUG-84382
Task-number: QTBUG-89564
Task-number: QTBUG-93629
Task-number: QTBUG-93633
Change-Id: I3b56cb19459814a0ebfd00195a9856fb742d1288
Reviewed-by: Assam Boudjelthia <assam.boudjelthia@qt.io>
Reviewed-by: Venugopal Shivashankar <Venugopal.Shivashankar@qt.io>
2021-07-19 14:53:06 +02:00
Topi Reinio fa36fe4c60 Doc: Update thumbnail for the installation video
Offline documentation needs a thumbnail image which acts a link to
open the video in an external browser.

Task-number:  QTBUG-91675
Pick-to: 6.1 6.0 5.15
Change-Id: Ief7a1cea4e3df139fcb1819d9b6a65da302e1b2d
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
2021-03-29 21:46:13 +02:00
Ivan Solovev 49073d33f1 Update examples to use XmlListModel from QtDeclarative
Now when the XmlListModel is a part of QtDeclarative, we
can udpate the examples, which were using the model.

This patch introduces the following changes:
- Uses XmlListModel from QtDeclarative, removes the custom
implementation from shared subdir.
- Improves photoviewer and rssnew examples to get rid of
some qml and C++ warnings and deprecation notifications.
- Updates the documentation for photoviewer and rssnew
examples to reflect the usage of the XmlListModel from
QtDeclarative.
- Enables documentation build for rssnews example

Task-number: QTBUG-89817
Change-Id: If3736a18070dc19492058f7c184d5c9cfab74663
Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>
2021-03-16 04:23:24 +01:00
Ralf Habacker 7b36723f3f Add documentation for qt6.conf
Task-number: QTBUG-88635
Change-Id: Iffd93a0654daa3b26d354340445825ab87fd8ad1
Reviewed-by: Oswald Buddenhagen <oswald.buddenhagen@gmx.de>
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
2021-01-22 10:05:01 +01:00
Andreas Buhr 72b5a14c90 Correct file path to YouTube video preview
Pick-to: 6.0
Change-Id: If5649cffb3cda16611702159acd3a83e26a804b7
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
2020-12-09 18:09:34 +01:00
Kai Koehne 7b78c362b3 Add manual tags to coffeemachine example
Pick-to: 6.0
Change-Id: I0b288bb3b3f23986b2af394062b3a9d470e7faf5
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
2020-12-08 13:09:11 +01:00
Venugopal Shivashankar 012384be6a Doc: Exclude docs for broken examples
This should avoid unnecessary attention
to these examples, at least till they are fixed.

Change-Id: Iffbbfa06c56c9cf66e9b70a632ced175206ac78a
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
2020-11-19 20:51:53 +01:00
Kai Koehne dd54d5fc28 Highlight Coffee Machine Example in Qt Creator
Change-Id: I88a9a53d17456446f908b4a0832bb1fb7ef0ed9a
Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>
2020-11-19 16:27:45 +00:00
Jerome Pasion c99776facd Update Mobile Development overview
Qt 6.0 doesn't support many of the Qt 5 mobile APIs
and we need to re-emphasize the other parts of the
mobile story.

Task-number: QTBUG-87158
Change-Id: I08fb6d1941f8229d2f66971eddabe9f964f9ad8a
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
2020-10-20 18:44:15 +02:00
Jerome Pasion 5bb71e60fb Remove Multimedia link on sidebar
Multimedia overview removed for Qt 6.0

Task-number: QTBUG-87158
Change-Id: I3895e3b753b20790a64da32e36190c134643746c
Reviewed-by: Venugopal Shivashankar <Venugopal.Shivashankar@qt.io>
2020-10-15 12:19:55 +02:00
Tor Arne Vestbø bc312e64a9 First steps towards documenting our platform APIs
Adds a new top level topic for platform integration, moving
the QPA docs under that, and cleans up and rewrites the QPA docs
for Qt 6.

Task-number: QTBUG-80233
Change-Id: I658e5e2c402a25ce391102675cee6ada0563e71f
Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io>
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
2020-10-14 11:52:18 +02:00
Jerome Pasion edd31749d5 Update What's New in Qt 6 page
-Added link to the Qt 6 version from main page
-Updated sidebar link

Task-number: QTBUG-85517
Change-Id: Ide5e931b37340c0a6ce103c1a8b051e8cd9ab605
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
2020-10-07 12:16:35 +02:00
Martin Smith 8c8dd0d12f doc: Make QtDoc depend on all modules
This update sets the depends variable in qtdoc.qdocconf to '*'.

Change-Id: Ib202a7a9aa1a3990a303cfe5d19a158d1ecc1b6b
Task-number: QTBUG-77126
Reviewed-by: Martin Smith <martin.smith@qt.io>
2019-11-14 15:37:33 +01:00
Topi Reinio 9e7fbb542a Doc: Fix documentation warnings
- Fix linking and replace mentions of deprecated add-ons in
  'OpenGL and 3D' section of the graphics topic.

- Fix linking to (generated) license documentation pages in
  licensechanges.qdoc. The links failed because now, the version
  information for the component is part of the generated title.
  Use a \target name instead, as it continues to work even when
  the versions change.

- Remove linking for removed licenses, use \e instead.

- Add missing dependencies

Fixes: QTBUG-79820
Change-Id: Ie74ba5e7b5cff6d286ece6b362b4622e9cafabf3
Reviewed-by: Paul Wicking <paul.wicking@qt.io>
2019-11-08 11:52:03 +01:00
Tomi Korpipaa 0f0d86a2f8 Add linking to QtQuick3D TP module
Fixes: QTBUG-79516
Change-Id: Idcb74f0fd1c69d352fcaabaaa09e92e8a3fc512a
Reviewed-by: Antti Määttä <antti.maatta@qt.io>
Reviewed-by: Inho Lee <inho.lee@qt.io>
Reviewed-by: Andy Nichols <andy.nichols@qt.io>
Reviewed-by: Venugopal Shivashankar <Venugopal.Shivashankar@qt.io>
2019-10-30 12:00:56 +02:00