aboutsummaryrefslogtreecommitdiffstats
path: root/sources/pyside6/doc/gettingstarted/index.rst
Commit message (Collapse)AuthorAgeFilesLines
* Documentation: Rearrange sectionsShyamnath Premnadh2024-08-121-572/+0
| | | | | | | | | | | | | | | | | | | | | - Rename 'Quick Start' to 'Getting Started'. Also, update the links accordingly. - The page 'Getting Started' is a building from source page. Hence renamed it accordingly with 3 sections - Linux, macOS and Windows. Each sections contains the steps to build from source for the specific platform. - Move 'Package Details' into the main table of contents - Move 'Porting from PySide2 to PySide6' into the 'Getting Started' section. - Additionally, fix the links accordingly and also fix some broken links - Additionally, increase the minumum Python version from 3.7 to 3.8 in the Getting Started section. Task-number: PYSIDE-2833 Task-number: PYSIDE-2837 Change-Id: I07f35dbe583533ff122f6ecb4deeb9c95389b3d1 Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io> Reviewed-by: Cristian Maureira-Fredes <cristian.maureira-fredes@qt.io>
* Documentation: Update versions for Qt 6.8Friedemann Kleint2024-05-281-2/+2
| | | | | | Task-number: PYSIDE-2620 Change-Id: Iff5ac3c8281893adfa0ba3cbd64936fd7c4d6257 Reviewed-by: Shyamnath Premnadh <Shyamnath.Premnadh@qt.io>
* Documentation: Use single emphasis for Qt toolsFriedemann Kleint2024-03-251-9/+9
| | | | | | | | Do some minor corrections. Pick-to: 6.7 Change-Id: If5b3f451a7d4005521bc78bc9683bf7b449d02fc Reviewed-by: Shyamnath Premnadh <Shyamnath.Premnadh@qt.io>
* Deprecation Python 3.8Cristián Maureira-Fredes2024-03-121-1/+1
| | | | | | | | | | | The changes related PYSIDE-939 can be removed when 3.9 support is dropped, because the problem was fixed and included in 3.9.13 so we cannot assume everyone will be on that version or superior. Change-Id: I78afc660edc6fbb3bb1a2438e17366e63b24e375 Reviewed-by: Shyamnath Premnadh <Shyamnath.Premnadh@qt.io> Reviewed-by: Qt CI Bot <qt_ci_bot@qt-project.org>
* Make Unity builds defaultFriedemann Kleint2024-01-301-2/+2
| | | | | | | | | | [ChangeLog][PySide6] setup.py now uses CMake Unity Build Mode by default. Change-Id: I50c892646c73ac636276460b0a1efa558531c76d Reviewed-by: Shyamnath Premnadh <Shyamnath.Premnadh@qt.io> Reviewed-by: Qt CI Bot <qt_ci_bot@qt-project.org> Reviewed-by: Adrian Herrmann <adrian.herrmann@qt.io>
* doc: remove double white spaceCristián Maureira-Fredes2023-11-211-4/+4
| | | | | | Pick-to: 6.6 Change-Id: I68b835bb5fa00d35fe5406deee2acc83c7bac7cb Reviewed-by: Adrian Herrmann <adrian.herrmann@qt.io>
* docs: deprecate 'build_rst_docs' in favor of 'build_base_docs'Dennis Oberst2023-10-261-12/+14
| | | | | | | | | | | | | | | | | | | The command for building documentation files has been renamed to 'build_base_docs' and the previous command, 'build_rst_docs', has been deprecated. All relevant occurrences of the command have been updated accordingly. In addition, the documentation config and build directory 'build/pyside6/doc/rst' has been renamed to 'build/pyside6/doc/base'. To ensure a fresh start when generating new documentation, the auto-generated `examples` and `html` directories are now deleted before generating new documentation. This change has been made because these directories are generated anyway, and starting fresh ensures that there are no conflicts or issues with the new documentation. Task-number: PYSIDE-2504 Change-Id: I395ad7e9482b0b68311820d58da362513ebb44b2 Reviewed-by: Cristian Maureira-Fredes <cristian.maureira-fredes@qt.io>
* Documentation: Link platform dependenciesFriedemann Kleint2023-04-131-0/+2
| | | | | | | Fixes: PYSIDE-2283 Pick-to: 6.5 Change-Id: I01aeb057dba1232ce38ef077d2a2e5e848544e9d Reviewed-by: Cristian Maureira-Fredes <cristian.maureira-fredes@qt.io>
* doc: fix issues with pyside rst filesCristián Maureira-Fredes2023-04-051-6/+6
| | | | | | | | | | Fixing extra indentation, syntax issues, and formatting. Adapting too some snippet line highlights, and many other details. Pick-to: 6.5 Change-Id: Ife4eb5cec03577b2902d409b4007ae6d12141747 Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io>
* Documentation: Add hints about intersphinx troubleshootingFriedemann Kleint2023-03-281-2/+13
| | | | | | | | Task-number: PYSIDE-1106 Pick-to: 6.5 Change-Id: Ib58321eb8e433b054aa6a8ce727309cb8cdf551c Reviewed-by: Adrian Herrmann <adrian.herrmann@qt.io> Reviewed-by: Shyamnath Premnadh <Shyamnath.Premnadh@qt.io>
* doc: migrate to sphinx-design and update sphinxCristián Maureira-Fredes2023-03-171-32/+38
| | | | | | | | | | | | | | | | | | | | sphinx-panels is deprecated, and sphinx-design is the better replacement. This patch migrates everything we had in pyside and shiboken, which was useful to remove many CSS related hacks for things we were forcing before. The example gallery was also adapted to generate sphinx-design valid code. Additional adaptation to some examples and files were included as well, which improved the overall example experience. We used this to change to update sphinx as well, which before was not possible to update due to sphinx-panels. Fixes: PYSIDE-2244 Change-Id: Ia3f57f536591ea299bf87302e930203b64fafd7e Reviewed-by: Shyamnath Premnadh <Shyamnath.Premnadh@qt.io>
* build_rst_docs: Inform of requirements-doc.txt requirementKeith Kyzivat2023-03-101-3/+3
| | | | | | | | | | Inform user that `pip install -r requirements-doc.txt` should be performed prior to invocation of build_rst_docs target. Task-number: PYSIDE-1106 Change-Id: Icb435fcd592dcd147cd3fb1867349530fae536fc Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io> Reviewed-by: Cristian Maureira-Fredes <cristian.maureira-fredes@qt.io>
* doc: update versions and broken linksCristián Maureira-Fredes2023-02-161-1/+1
| | | | | | | Pick-to: 6.2 6.4 Change-Id: Ib6223ac742b7c7777d2b6110a395b508e5031a75 Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io> Reviewed-by: Adrian Herrmann <adrian.herrmann@qt.io>
* Fix documentation on how to pass the source directory for doc buildsFriedemann Kleint2023-02-131-4/+2
| | | | | | | | | | | | It seems the querying of the environment variable is not implemented by d4764a4c514ec15f4cd680143cbd189482af6251. Pick-to: 6.4 Fixes: PYSIDE-2227 Task-number: PYSIDE-1067 Change-Id: Ib0bf038aee4d783ec303af1a5feeb5810911f812 Reviewed-by: Cristian Maureira-Fredes <cristian.maureira-fredes@qt.io> Reviewed-by: Keith Kyzivat <keith.kyzivat@qt.io>
* doc: use icons for the platform guidesCristián Maureira-Fredes2023-01-051-14/+32
| | | | | | | | | | | The links were broken, and also they were not highlighted enough for people to understand they were clickable, and that they should visit them for platform specific instructions. Change-Id: I848b394eac915889f9483dcc56893204dc43ab85 Pick-to: 6.4 Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io>
* build: split requirement.txt for docsCristián Maureira-Fredes2023-01-041-6/+9
| | | | | | | | | | | | | | | | | Removing the documentation packages from the main requirements.txt file, and adding a mention on the documentation to install the modules from the new requirements-doc.txt file. Additionally, dataclasses was removed from the requirements because it's a feature included in Python 3.7+ [ChangeLog][PySide6] To build the documentation, you need to install also the new requirements-doc.txt file Pick-to: 6.4 Change-Id: I2f6a5cc2f05a7a2e89d3aa06d18791a13a8127b4 Reviewed-by: Shyamnath Premnadh <Shyamnath.Premnadh@qt.io> Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io>
* Documentation: Mention Unity build modeFriedemann Kleint2022-12-201-0/+3
| | | | | | | Task-number: PYSIDE-2155 Change-Id: I1cdcbc8aa7500d685a138a3352632635519e323a Reviewed-by: Shyamnath Premnadh <Shyamnath.Premnadh@qt.io> Reviewed-by: Cristian Maureira-Fredes <cristian.maureira-fredes@qt.io>
* Fix up the documentation generation instructionsFriedemann Kleint2022-11-081-4/+7
| | | | | | | | | | The manual still mentioned sphinx_tabs, which conflicts with sphix-panels. Pick-to: 6.4 Change-Id: I24e6ca11f0d3de4ddc8c69534c1d325fe9f1e523 Reviewed-by: Adrian Herrmann <adrian.herrmann@qt.io> Reviewed-by: Cristian Maureira-Fredes <cristian.maureira-fredes@qt.io>
* doc: order the sidebar contentCristián Maureira-Fredes2022-11-031-0/+526
As a quick-access to all the documentation, the sidebar of the documentation was a mix of topics without any logical order. Creating directories with an index.rst file, and putting the content on the right topic toctree allow us to have a more clear and simple general toc. Change-Id: I43af890ce988946ababcd575d431fc66704c3e85 Pick-to: 6.4 Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io>