|project| Tutorials
====================

A collection of tutorials with walkthrough guides are
provided with |project| to help new users get started.

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
----------------

If you have not installed PySide yet, remember to check the
`Quick Start <../quickstart.html>`_ section.

.. toctree::
    :maxdepth: 1

    pretutorial/whatisqt.rst
    pretutorial/whichide.rst
    pretutorial/whatisshiboken.rst
    pretutorial/typesoffiles.rst
    pretutorial/distribution.rst

Qt Widgets: Basic tutorials
---------------------------

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.

.. toctree::
    :maxdepth: 1

    basictutorial/widgets.rst
    basictutorial/clickablebutton.rst
    basictutorial/dialog.rst
    basictutorial/tablewidget.rst
    basictutorial/treewidget.rst
    basictutorial/uifiles.rst
    basictutorial/qrcfiles.rst
    basictutorial/widgetstyling.rst


Quick/QML: Basic tutorials
--------------------------

.. toctree::
    :maxdepth: 1

    basictutorial/qml.rst
    qmlintegration/qmlintegration.rst

Real use-cases applications
---------------------------

.. toctree::
    :maxdepth: 1

    qmlapp/qmlapplication.rst
    qmlsqlintegration/qmlsqlintegration.rst
..
    datavisualize/index.rst
..
    expenses/expenses.rst

C++ and Python
--------------

.. toctree::
    :maxdepth: 1

    portingguide/index.rst
