Differential D10690 Diff 27625 source/introduction/architecture.rst

Changeset View

Standalone View

source/introduction/architecture.rst

This file was added.

1		Architecture
2		============
3
4		There are three different UI toolkits you can use to development for `KDE Application <https://www.kde.org/applications/>`_ or the `Plasma Workspace <https://www.kde.org/plasma-desktop.php>`_. Due to technical limitations the toolkits have slight visual differences, but the recomended interaction patterns to be used are consistent regardless of the toolkit.
	romanggUnsubmitted Not Done I would try minimizing links to pages outside of the HIG. It makes sense instead to link to the two sections below. romangg: I would try minimizing links to pages outside of the HIG. It makes sense instead to link to the…
5
6		KDE Applications
	romanggUnsubmitted Not Done Kirigami is not only for KDE Applications --> "Standalone apps" romangg: Kirigami is not only for KDE Applications --> "Standalone apps"
7		----------------
8		There are two UI toolkits that can be used to develop KDE Applications:
9
10		* `Kirigami <https://www.kde.org/products/kirigami/>`_
11		* `Qt Widgets <http://doc.qt.io/qt-5/qtwidgets-index.html>`_
12
13		Kirigami is KDE’s lightweight user interface framework for mobile and convergent applications. It allows Qt developers to easily create applications that run on most major mobile and desktop platforms without modification (though adapted user interfaces for different form-factors are supported and recommended for optimal user experience). It extends the touch-friendly Qt Quick Controls with larger application building blocks.
14
15		Use Qt Widgets only, if you plan to develop a desktop only application with a complex UI, like KDevelop.
16
17		.. figure:: /img/kirigami.jpg
18		:scale: 25%
19		:alt: Discover, a convergent application build with Kirigami
20
21		Discover, a convergent application build with Kirigami
22
23		Plasma Workspace
24		----------------
25		Plasma is built on widgets, allowing you to move, mix, add, and remove just about everything to perfect your personal workflow. Use `plasma components v3 <https://api.kde.org/frameworks/plasma-framework/html/plasmacomponents.html>`_ to develop widgets for the Plasma Mobile and Plasma Desktop workspace.
26
27		.. figure:: /img/plasma-workspace.jpg
28		:scale: 25%
29		:alt: Plasma desktop and mobile workspace
30
31		Plasma desktop and mobile workspace.
32
33		Theme
34		-----
35		There are three different kind of themes influencing the the look and feel of KDE Application and the Plasma workspace.
36
37		* Workspace
38		* Application
39		* Window decoration
40
41		The default for all there of them is Breeze.
42
43		.. note::
44		Only Breeze, Breeze dark, Breeze Light, Breeze Highcontrast are covered by the HIG, all other themes are not covered.
45
46		.. figure:: /img/breeze.jpeg
47		:scale: 50%
48		:alt: Overview of breeze controls
	romanggUnsubmitted Not Done Breeze romangg: Breeze
49
50		Overview of breeze controls