aboutsummaryrefslogtreecommitdiffstats
path: root/sources/pyside6/doc/api.rst
diff options
context:
space:
mode:
authorCristián Maureira-Fredes <Cristian.Maureira-Fredes@qt.io>2023-03-14 15:24:13 +0100
committerShyamnath Premnadh <shyamnath.premnadh@qt.io>2023-03-17 15:37:09 +0100
commita922672c1c4f188cbab51b126b9cae4d7cd8706d (patch)
treed16932f2fbed8c9b2dfac6b6136c654eec4b798c /sources/pyside6/doc/api.rst
parent012e40e6af6355ff05feee899e60e041458ea741 (diff)
doc: migrate to sphinx-design and update sphinx
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>
Diffstat (limited to 'sources/pyside6/doc/api.rst')
-rw-r--r--sources/pyside6/doc/api.rst60
1 files changed, 20 insertions, 40 deletions
diff --git a/sources/pyside6/doc/api.rst b/sources/pyside6/doc/api.rst
index 62273c31f..7bbe2ce1c 100644
--- a/sources/pyside6/doc/api.rst
+++ b/sources/pyside6/doc/api.rst
@@ -8,33 +8,23 @@ Basic modules
These are the main modules that help you build a Widget-based UI.
-.. panels::
- :container: container-lg pb-3
- :column: col-lg-4 col-md-4 col-sm-6 col-xs-12 p-2
+.. grid:: 1 3 3 3
+ :gutter: 2
- :mod:`QtCore <PySide6.QtCore>`
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+ .. grid-item-card:: :mod:`QtCore <PySide6.QtCore>`
- Provides core non-GUI functionality, like signal and
- slots, properties, base classes of item models,
- serialization, and more.
+ Provides core non-GUI functionality, like signal and slots, properties,
+ base classes of item models, serialization, and more.
- ---
+ .. grid-item-card:: :mod:`QtGui <PySide6.QtGui>`
- :mod:`QtGui <PySide6.QtGui>`
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+ Extends QtCore with GUI functionality: Events, windows and screens,
+ OpenGL and raster-based 2D painting, as well as images.
- Extends QtCore with GUI functionality: Events, windows
- and screens, OpenGL and raster-based 2D painting, as
- well as images.
+ .. grid-item-card:: :mod:`QtWidgets <PySide6.QtWidgets>`
- ---
-
- :mod:`QtWidgets <PySide6.QtWidgets>`
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
- Provides ready to use Widgets for your application,
- including graphical elements for your UI.
+ Provides ready to use Widgets for your application, including graphical
+ elements for your UI.
QML and Qt Quick
----------------
@@ -42,31 +32,21 @@ QML and Qt Quick
Use these modules to interact with the `QML Language <https://doc.qt.io/qt-5.qmlapplications>`_,
from Python.
-.. panels::
- :container: container-lg pb-3
- :column: col-lg-4 col-md-4 col-sm-6 col-xs-12 p-2
-
- :mod:`QtQml <PySide6.QtQml>`
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
- The base Python API to interact with the
- module.
+.. grid:: 1 3 3 3
+ :gutter: 2
- ---
+ .. grid-item-card:: :mod:`QtQml <PySide6.QtQml>`
- :mod:`QtQuick <PySide6.QtQuick>`
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+ The base Python API to interact with the module.
- Provides classes to embed Qt Quick in Qt
- applications.
+ .. grid-item-card:: :mod:`QtQuick <PySide6.QtQuick>`
- ---
+ Provides classes to embed Qt Quick in Qt applications.
- :mod:`QtQuickWidgets <PySide6.QtQuickWidgets>`
- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+ .. grid-item-card:: :mod:`QtQuickWidgets <PySide6.QtQuickWidgets>`
- Provides the QQuickWidget class to embed Qt
- Quick in widget-based applications.
+ Provides the QQuickWidget class to embed Qt Quick in widget-based
+ applications.
All the modules
---------------