diff options
Diffstat (limited to 'sources/pyside6/doc/tutorials/index.rst')
| -rw-r--r-- | sources/pyside6/doc/tutorials/index.rst | 307 |
1 files changed, 126 insertions, 181 deletions
diff --git a/sources/pyside6/doc/tutorials/index.rst b/sources/pyside6/doc/tutorials/index.rst index ae29da9d9..8a69a3c6f 100644 --- a/sources/pyside6/doc/tutorials/index.rst +++ b/sources/pyside6/doc/tutorials/index.rst @@ -1,5 +1,5 @@ -|project| Tutorials -==================== +Tutorials +========= A collection of tutorials with walkthrough guides are provided with |project| to help new users get started. @@ -8,64 +8,6 @@ Some of these documents were ported from C++ to Python and cover a range of topics, from basic use of widgets to step-by-step tutorials that show how an application is put together. -Before you start ----------------- - -Here you can find a couple of common questions and situations that will -clarify questions before you start programming. -If you have not installed PySide yet, remember to check the -`Quick Start <../quickstart.html>`_ section. - -.. panels:: - :container: container-lg pb-1 - :column: col-lg-4 col-md-4 col-sm-6 col-xs-12 p-2 - - .. link-button:: pretutorial/whatisqt - :type: ref - :text: Qt, QML, Widgets... What is the difference? - :classes: btn-link btn-block stretched-link - --- - - .. link-button:: pretutorial/whichide - :type: ref - :text: Which IDEs are compatible with PySide? - :classes: btn-link btn-block stretched-link - --- - - .. link-button:: pretutorial/whatisshiboken - :type: ref - :text: Binding Generation: What is Shiboken? - :classes: btn-link btn-block stretched-link - --- - - .. link-button:: pretutorial/typesoffiles - :type: ref - :text: File Types in PySide - :classes: btn-link btn-block stretched-link - --- - - .. link-button:: pretutorial/distribution - :type: ref - :text: Distributing your application to other systems and platforms - :classes: btn-link btn-block stretched-link - - --- - - .. link-button:: pretutorial/whyqtforpython - :type: ref - :text: As a Qt/C++ developer, why should I consider Qt for Python? - :classes: btn-link btn-block stretched-link - -.. toctree:: - :hidden: - - pretutorial/whatisqt.rst - pretutorial/whichide.rst - pretutorial/whatisshiboken.rst - pretutorial/typesoffiles.rst - pretutorial/distribution.rst - pretutorial/whyqtforpython.rst - Qt Widgets: Basic tutorials --------------------------- @@ -73,86 +15,78 @@ If you want to see the available widgets in action, you can check the `Qt Widget Gallery <https://doc.qt.io/qt-6/gallery.html>`_ to learn their names and how they look like. -.. panels:: - :container: container-lg pb-1 - :column: col-lg-4 col-md-4 col-sm-6 col-xs-12 p-2 - :img-top-cls: d-flex align-self-center - - :img-top: basictutorial/widgets.png - - .. link-button:: basictutorial/widgets - :type: ref - :text: Your First QtWidgets Application - :classes: btn-link btn-block stretched-link - --- - :img-top: basictutorial/clickablebutton.png - - .. link-button:: basictutorial/clickablebutton - :type: ref - :text: Using a Simple Button - :classes: btn-link btn-block stretched-link - --- - :img-top: basictutorial/signals_slots.png - - .. link-button:: basictutorial/signals_and_slots - :type: ref - :text: Signals and Slots - :classes: btn-link btn-block stretched-link - --- - :img-top: basictutorial/dialog.png - - .. link-button:: basictutorial/dialog - :type: ref - :text: Creating a Dialog Application - :classes: btn-link btn-block stretched-link - --- - :img-top: basictutorial/tablewidget.png - - .. link-button:: basictutorial/tablewidget - :type: ref - :text: Displaying Data Using a Table Widget - :classes: btn-link btn-block stretched-link - - --- - :img-top: basictutorial/treewidget.png - - .. link-button:: basictutorial/treewidget - :type: ref - :text: Displaying Data Using a Tree Widget - :classes: btn-link btn-block stretched-link - - --- - :img-top: basictutorial/uifiles.png - - .. link-button:: basictutorial/uifiles - :type: ref - :text: Using .ui files from Designer or QtCreator with QUiLoader and pyside6-uic - :classes: btn-link btn-block stretched-link - - --- - :img-top: basictutorial/player-new.png - - .. link-button:: basictutorial/qrcfiles - :type: ref - :text: Using .qrc Files (pyside6-rcc) - :classes: btn-link btn-block stretched-link - - --- - :img-top: basictutorial/translations.png - - .. link-button:: basictutorial/translations - :type: ref - :text: Translating Applications - :classes: btn-link btn-block stretched-link - - --- - :img-top: basictutorial/widgetstyling-yes.png - - .. link-button:: basictutorial/widgetstyling - :type: ref - :text: Styling the Widgets Application - :classes: btn-link btn-block stretched-link +.. grid:: 1 3 3 3 + :gutter: 2 + + .. grid-item-card:: Basic Widget + :class-item: cover-img + :link: basictutorial/widgets.html + :img-top: basictutorial/widgets.png + + Your first QtWidgets Application + + .. grid-item-card:: Basic Button + :class-item: cover-img + :link: basictutorial/clickablebutton.html + :img-top: basictutorial/clickablebutton.png + + Using a Simple Button + + .. grid-item-card:: Basic Connections + :class-item: cover-img + :link: basictutorial/signals_and_slots.html + :img-top: basictutorial/signals_slots.png + + Signals and Slots + + .. grid-item-card:: Basic Dialog + :class-item: cover-img + :link: basictutorial/dialog.html + :img-top: basictutorial/dialog.png + + Creating a Dialog Application + + .. grid-item-card:: Basic Table + :class-item: cover-img + :link: basictutorial/tablewidget.html + :img-top: basictutorial/tablewidget.png + + Displaying Data Using a Table Widget + + .. grid-item-card:: Basic Tree + :class-item: cover-img + :link: basictutorial/treewidget.html + :img-top: basictutorial/treewidget.png + + Displaying Data Using a Tree Widget + .. grid-item-card:: Basic ``ui`` files + :class-item: cover-img + :link: basictutorial/uifiles.html + :img-top: basictutorial/uifiles.png + + Using .ui files from Designer or QtCreator with QUiLoader and pyside6-uic + + .. grid-item-card:: Basic ``qrc`` files + :class-item: cover-img + :link: basictutorial/qrcfiles.html + :img-top: basictutorial/player-new.png + + Using .qrc Files (pyside6-rcc) + + .. grid-item-card:: Basic Translations + :class-item: cover-img + :link: basictutorial/translations.html + :img-top: basictutorial/translations.png + + Translating Applications + + .. grid-item-card:: Basic Widget Style + :class-item: cover-img + :link: basictutorial/widgetstyling.html + :img-top: basictutorial/widgetstyling-yes.png + + Styling the Widgets Application .. toctree:: :hidden: @@ -172,39 +106,43 @@ names and how they look like. Quick/QML: Basic tutorials -------------------------- -.. panels:: - :container: container-lg pb-1 - :column: col-lg-4 col-md-4 col-sm-6 col-xs-12 p-2 - :img-top-cls: d-flex align-self-center +.. grid:: 1 3 3 3 + :gutter: 2 + + .. grid-item-card:: Basic Quick + :class-item: cover-img + :link: basictutorial/qml.html + :img-top: basictutorial/greenapplication.png - :img-top: basictutorial/greenapplication.png + Your First QtQuick/QML Application - .. link-button:: basictutorial/qml - :type: ref - :text: Your First QtQuick/QML Application - :classes: btn-link btn-block stretched-link - --- - :img-top: qmlintegration/textproperties_material.png + .. grid-item-card:: Basic QML Integration + :class-item: cover-img + :link: qmlintegration/qmlintegration.html + :img-top: qmlintegration/textproperties_material.png - .. link-button:: qmlintegration/qmlintegration - :type: ref - :text: Python-QML integration - :classes: btn-link btn-block stretched-link - --- - :img-top: qmlapp/qmlapplication.png + Python-QML integration - .. link-button:: qmlapp/qmlapplication - :type: ref - :text: QML Application Tutorial (QtCreator) - :classes: btn-link btn-block stretched-link - --- - :img-top: qmlsqlintegration/example_list_view.png + .. grid-item-card:: QML Application + :class-item: cover-img + :link: qmlapp/qmlapplication.html + :img-top: qmlapp/qmlapplication.png - .. link-button:: qmlsqlintegration/qmlsqlintegration - :type: ref - :text: QML, SQL and PySide Integration Tutorial - :classes: btn-link btn-block stretched-link + QML Application Tutorial (QtCreator) + .. grid-item-card:: Advanced QML Integration + :class-item: cover-img + :link: qmlsqlintegration/qmlsqlintegration.html + :img-top: qmlsqlintegration/example_list_view.png + + QML, SQL and PySide Integration Tutorial + + .. grid-item-card:: Extended Explorer + :class-item: cover-img + :link: extendedexplorer/extendedexplorer.html + :img-top: extendedexplorer/resources/extendedexplorer.webp + + Extending an Qt Quick Controls example .. toctree:: :maxdepth: 1 @@ -214,28 +152,27 @@ Quick/QML: Basic tutorials qmlintegration/qmlintegration.rst qmlapp/qmlapplication.rst qmlsqlintegration/qmlsqlintegration.rst + extendedexplorer/extendedexplorer.md General Applications -------------------- -.. panels:: - :container: container-lg pb-1 - :column: col-lg-4 col-md-4 col-sm-6 col-xs-12 p-2 - :img-top-cls: d-flex align-self-center +.. grid:: 1 3 3 3 + :gutter: 2 + + .. grid-item-card:: Data Visualization + :class-item: cover-img + :link: datavisualize/index.html + :img-top: datavisualize/images/datavisualization_app.png - :img-top: datavisualize/images/datavisualization_app.png + Data Visualization Tool - .. link-button:: datavisualize/index - :type: ref - :text: Data Visualization Tool - :classes: btn-link btn-block stretched-link - --- - :img-top: expenses/expenses_tool.png + .. grid-item-card:: Expenses Application + :class-item: cover-img + :link: expenses/expenses.html + :img-top: expenses/expenses_tool.png - .. link-button:: expenses/expenses - :type: ref - :text: Expenses Tool - :classes: btn-link btn-block stretched-link + Expenses administration tool .. toctree:: :hidden: @@ -243,6 +180,13 @@ General Applications datavisualize/index.rst expenses/expenses.rst +Qt Overviews +------------ + +.. toctree:: + :maxdepth: 1 + + ../overviews/overviews-main.rst C++ and Python -------------- @@ -258,4 +202,5 @@ Debug a PySide6 Application :maxdepth: 1 debugging/mixed_debugging.rst + debugging/qml_debugging.rst |