From db615e81615ee993cac69a3477351427d798e31e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cristi=C3=A1n=20Maureira-Fredes?= Date: Wed, 7 Jul 2021 10:47:13 +0200 Subject: doc: improve tutorials and styling - Creating screenshots for tutorials. - Add gallery style for tutorials. - Add corporate Icons to the frontpage. - tools: Reduce example long names in the gallery. - videos: new order using panels - Add tutorial about "Why Qt for Python" Change-Id: I3ba50f74998399a47b4a34c1de029f3b746aa1e2 Reviewed-by: Christian Tismer Reviewed-by: Alex Blasche --- .../doc/tutorials/basictutorial/clickablebutton.png | Bin 0 -> 7059 bytes .../doc/tutorials/basictutorial/clickablebutton.rst | 5 +++++ .../pyside6/doc/tutorials/basictutorial/dialog.png | Bin 0 -> 21263 bytes .../pyside6/doc/tutorials/basictutorial/dialog.rst | 7 +++++++ .../pyside6/doc/tutorials/basictutorial/icons.png | Bin 3202 -> 1599 bytes .../doc/tutorials/basictutorial/player-new.png | Bin 7818 -> 3369 bytes .../pyside6/doc/tutorials/basictutorial/player.png | Bin 5835 -> 2631 bytes .../doc/tutorials/basictutorial/tablewidget.png | Bin 17237 -> 14509 bytes .../doc/tutorials/basictutorial/translations.png | Bin 0 -> 25318 bytes .../doc/tutorials/basictutorial/translations.rst | 3 +++ .../doc/tutorials/basictutorial/treewidget.png | Bin 10236 -> 3709 bytes .../pyside6/doc/tutorials/basictutorial/uifiles.png | Bin 0 -> 86503 bytes .../pyside6/doc/tutorials/basictutorial/uifiles.rst | 3 +++ .../pyside6/doc/tutorials/basictutorial/widgets.png | Bin 0 -> 23233 bytes .../pyside6/doc/tutorials/basictutorial/widgets.rst | 7 +++++++ .../tutorials/basictutorial/widgetstyling-no.png | Bin 26444 -> 11004 bytes .../basictutorial/widgetstyling-simple-no.png | Bin 3834 -> 1206 bytes .../basictutorial/widgetstyling-simple-yes.png | Bin 4743 -> 1596 bytes .../tutorials/basictutorial/widgetstyling-yes.png | Bin 32311 -> 24791 bytes 19 files changed, 25 insertions(+) create mode 100644 sources/pyside6/doc/tutorials/basictutorial/clickablebutton.png create mode 100644 sources/pyside6/doc/tutorials/basictutorial/dialog.png create mode 100644 sources/pyside6/doc/tutorials/basictutorial/translations.png create mode 100644 sources/pyside6/doc/tutorials/basictutorial/uifiles.png create mode 100644 sources/pyside6/doc/tutorials/basictutorial/widgets.png (limited to 'sources/pyside6/doc/tutorials/basictutorial') diff --git a/sources/pyside6/doc/tutorials/basictutorial/clickablebutton.png b/sources/pyside6/doc/tutorials/basictutorial/clickablebutton.png new file mode 100644 index 000000000..bfdc23fe0 Binary files /dev/null and b/sources/pyside6/doc/tutorials/basictutorial/clickablebutton.png differ diff --git a/sources/pyside6/doc/tutorials/basictutorial/clickablebutton.rst b/sources/pyside6/doc/tutorials/basictutorial/clickablebutton.rst index 894060e98..2221858bc 100644 --- a/sources/pyside6/doc/tutorials/basictutorial/clickablebutton.rst +++ b/sources/pyside6/doc/tutorials/basictutorial/clickablebutton.rst @@ -88,3 +88,8 @@ Here is the complete code for this example: button.show() # Run the main Qt loop app.exec() + +After a few clicks, you will get something like this on your terminal: + +.. image:: clickablebutton.png + :alt: Clickable Button Example diff --git a/sources/pyside6/doc/tutorials/basictutorial/dialog.png b/sources/pyside6/doc/tutorials/basictutorial/dialog.png new file mode 100644 index 000000000..ad5690927 Binary files /dev/null and b/sources/pyside6/doc/tutorials/basictutorial/dialog.png differ diff --git a/sources/pyside6/doc/tutorials/basictutorial/dialog.rst b/sources/pyside6/doc/tutorials/basictutorial/dialog.rst index 577db27d9..bc06d6d9b 100644 --- a/sources/pyside6/doc/tutorials/basictutorial/dialog.rst +++ b/sources/pyside6/doc/tutorials/basictutorial/dialog.rst @@ -139,3 +139,10 @@ Here is the complete code for this tutorial: form.show() # Run the main Qt loop sys.exit(app.exec()) + + +When you execute the code, and write down your name, +the button will display messages on the terminal: + +.. image:: dialog.png + :alt: Simple Dialog Example diff --git a/sources/pyside6/doc/tutorials/basictutorial/icons.png b/sources/pyside6/doc/tutorials/basictutorial/icons.png index 0bcfd7d77..a5a554eba 100644 Binary files a/sources/pyside6/doc/tutorials/basictutorial/icons.png and b/sources/pyside6/doc/tutorials/basictutorial/icons.png differ diff --git a/sources/pyside6/doc/tutorials/basictutorial/player-new.png b/sources/pyside6/doc/tutorials/basictutorial/player-new.png index e1f660e5f..8e45c757d 100644 Binary files a/sources/pyside6/doc/tutorials/basictutorial/player-new.png and b/sources/pyside6/doc/tutorials/basictutorial/player-new.png differ diff --git a/sources/pyside6/doc/tutorials/basictutorial/player.png b/sources/pyside6/doc/tutorials/basictutorial/player.png index 3060a990d..0563d3223 100644 Binary files a/sources/pyside6/doc/tutorials/basictutorial/player.png and b/sources/pyside6/doc/tutorials/basictutorial/player.png differ diff --git a/sources/pyside6/doc/tutorials/basictutorial/tablewidget.png b/sources/pyside6/doc/tutorials/basictutorial/tablewidget.png index 8eb1398a7..e2549f7d0 100644 Binary files a/sources/pyside6/doc/tutorials/basictutorial/tablewidget.png and b/sources/pyside6/doc/tutorials/basictutorial/tablewidget.png differ diff --git a/sources/pyside6/doc/tutorials/basictutorial/translations.png b/sources/pyside6/doc/tutorials/basictutorial/translations.png new file mode 100644 index 000000000..b9fc1ba17 Binary files /dev/null and b/sources/pyside6/doc/tutorials/basictutorial/translations.png differ diff --git a/sources/pyside6/doc/tutorials/basictutorial/translations.rst b/sources/pyside6/doc/tutorials/basictutorial/translations.rst index 44280580c..544218553 100644 --- a/sources/pyside6/doc/tutorials/basictutorial/translations.rst +++ b/sources/pyside6/doc/tutorials/basictutorial/translations.rst @@ -3,6 +3,9 @@ Translating Applications ======================== +.. image:: translations.png + :alt: Translation Image + Qt Linguist ----------- diff --git a/sources/pyside6/doc/tutorials/basictutorial/treewidget.png b/sources/pyside6/doc/tutorials/basictutorial/treewidget.png index 077eb5830..990fe977b 100644 Binary files a/sources/pyside6/doc/tutorials/basictutorial/treewidget.png and b/sources/pyside6/doc/tutorials/basictutorial/treewidget.png differ diff --git a/sources/pyside6/doc/tutorials/basictutorial/uifiles.png b/sources/pyside6/doc/tutorials/basictutorial/uifiles.png new file mode 100644 index 000000000..918efec6d Binary files /dev/null and b/sources/pyside6/doc/tutorials/basictutorial/uifiles.png differ diff --git a/sources/pyside6/doc/tutorials/basictutorial/uifiles.rst b/sources/pyside6/doc/tutorials/basictutorial/uifiles.rst index adf5ec6d2..b3429ac1f 100644 --- a/sources/pyside6/doc/tutorials/basictutorial/uifiles.rst +++ b/sources/pyside6/doc/tutorials/basictutorial/uifiles.rst @@ -12,6 +12,9 @@ standalone binary (``pyside6-designer``) or embedded into the is described at `Using Qt Designer `_. +.. image:: uifiles.png + :alt: Designer and the equivalent code + The designs are stored in `.ui` files, which is an XML-based format. It will be converted to Python or C++ code populating a widget instance at project build time by the `pyside6-uic `_ tool. diff --git a/sources/pyside6/doc/tutorials/basictutorial/widgets.png b/sources/pyside6/doc/tutorials/basictutorial/widgets.png new file mode 100644 index 000000000..de7a969f9 Binary files /dev/null and b/sources/pyside6/doc/tutorials/basictutorial/widgets.png differ diff --git a/sources/pyside6/doc/tutorials/basictutorial/widgets.rst b/sources/pyside6/doc/tutorials/basictutorial/widgets.rst index 89bd23f63..ef14c7e99 100644 --- a/sources/pyside6/doc/tutorials/basictutorial/widgets.rst +++ b/sources/pyside6/doc/tutorials/basictutorial/widgets.rst @@ -17,6 +17,12 @@ Here is a simple example of a Hello World application in PySide6: app.exec() +When you execute it the code, the application will look like: + +.. image:: widgets.png + :alt: Simple Widget + + For a widget application using PySide6, you must always start by importing the appropriate class from the `PySide6.QtWidgets` module. @@ -43,3 +49,4 @@ After the creation of the application object, we have created a Finally, we call `app.exec()` to enter the Qt main loop and start to execute the Qt code. In reality, it is only here where the label is shown, but this can be ignored for now. + diff --git a/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-no.png b/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-no.png index c30dd621b..f8346533f 100644 Binary files a/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-no.png and b/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-no.png differ diff --git a/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-simple-no.png b/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-simple-no.png index eb90e216d..d510a80cd 100644 Binary files a/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-simple-no.png and b/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-simple-no.png differ diff --git a/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-simple-yes.png b/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-simple-yes.png index 5a714977e..e7a0c0ef7 100644 Binary files a/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-simple-yes.png and b/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-simple-yes.png differ diff --git a/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-yes.png b/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-yes.png index 8ba49bd26..9b83b8267 100644 Binary files a/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-yes.png and b/sources/pyside6/doc/tutorials/basictutorial/widgetstyling-yes.png differ -- cgit v1.2.3