Development/Tutorials/Plasma/QML/GettingStarted - Revision history

KAMiKAZOW: /* Abstract */

2013-05-09T12:59:19Z

‎Abstract

Willem1: correct typo's

2013-02-22T11:48:53Z

correct typo's

Hefee: adding documentation to Row and Column

2013-02-06T00:36:01Z

adding documentation to Row and Column

Hefee: /* Anchors */ adds a wrong example and points to the documenation of qt-project

2013-02-06T00:12:30Z

‎Anchors: adds a wrong example and points to the documenation of qt-project

ThomasFischer: /* QML Basics */ Updating links from Nokia and 4.7 to Qt Project and 4.8

2012-11-29T20:56:00Z

‎QML Basics: Updating links from Nokia and 4.7 to Qt Project and 4.8

Zasdfgbnm: /* Plasma Widgets in QML */

2012-07-16T10:14:50Z

‎Plasma Widgets in QML

OpenIDUser85: those lines are needed to set SERVICES_INSTALL_DIR

2012-02-15T17:18:20Z

those lines are needed to set SERVICES_INSTALL_DIR

Icwiener: /* Minimum size */ Fix typo.

2011-10-15T22:38:36Z

‎Minimum size: Fix typo.

Icwiener: /* Package Structure */ Fix bullet points.

2011-10-11T00:21:58Z

‎Package Structure: Fix bullet points.

Icwiener: /* Localization */ Fix typo.

2011-10-11T00:20:39Z

‎Localization: Fix typo.

@@ Line 1: / Line 1: @@
 == Abstract ==
-Writing a Plasma applet in QML is very easy, in fact, with KDE 4.6 and Qt 4.7 it just works.
+Writing a Plasma applet in QML is very easy, in fact, with Workspaces 4.6 and Qt 4.7 it just works.
 == QML Basics ==

@@ Line 1: / Line 1: @@
 == Abstract ==
-Writing a plasma applet in QML is very easy, in fact, with KDE 4.6 and Qt 4.7 it just works.
+Writing a Plasma applet in QML is very easy, in fact, with KDE 4.6 and Qt 4.7 it just works.
 == QML Basics ==
@@ Line 7: / Line 7: @@
 It is recommended that you have read through the [http://qt-project.org/doc/qt-4.8/qtquick.html Qt QML Tutorials], as there are quite a few and they are explained thoroughly. There is also a list of all [http://qt-project.org/doc/qt-4.8/qdeclarativeelements.html standard QML elements].
-Essentially, most of the content is the same. The exceptions to be noted are how data is gathered...since we use Data Engines, it is a bit different. Text color and font should be made to use PlasmaCore.Theme.
+Essentially, most of the content is the same. The exceptions to be noted are how data is gathered... since we use Data Engines, it is a bit different. Text color and font should be made to use PlasmaCore.Theme.
-See the [https://projects.kde.org/projects/kde/kdeexamples/repository KDE Examples] repository for more KDE-related helpful resources. Also of use (which use QML and Plasma) are: [https://projects.kde.org/projects/playground/base/plasma-mobile/repository Plasma Mobile], [https://projects.kde.org/projects/playground/base/declarative-plasmoids/repository Declarative Plasmoids (playground)], for WIP ports of C++ originals
+See the [https://projects.kde.org/projects/kde/kdeexamples/repository KDE Examples] repository for more KDE-related helpful resources. Also of use (which use QML and Plasma) are: [https://projects.kde.org/projects/playground/base/plasma-mobile/repository Plasma Mobile], [https://projects.kde.org/projects/playground/base/declarative-plasmoids/repository Declarative Plasmoids (playground)], for WIP ports of C++ originals.
 === Root Item ===
@@ Line 101: / Line 101: @@
 Keep in mind, that you can only use elements that are a parent or a sibling.
-Here a WRONG example ('first'' and ''second'' are no siblings ):
+Here a WRONG example ('first'' and ''second'' are no siblings):
 <syntaxhighlight lang="javascript">
@@ Line 119: / Line 119: @@
+     }
 </syntaxhighlight>
-Plasmoidviewer you show you folloing explanation:
+Plasmoidviewer will show you the following explanation:
      file:///XXXX/contents/ui/main.qml:69:9: QML Text: Cannot anchor to an item that isn't a parent or sibling.
@@ Line 133: / Line 133: @@
 == Package Structure ==
-You create a .desktop file and the .qml file. They have to be in the usual plasma package structure:
+You create a .desktop file and the .qml file. They have to be in the usual Plasma package structure:
 * plasmoid-qml/metadata.desktop

@@ Line 18: / Line 18: @@
 ==== Row and Column ====
 ==== Anchors ====
-Anchor layouts offer a nice way of grouping UI elements nicely together. The idea is that you connect edges or corners of one element to the edge or corner of another widget.
+Anchor layouts offer a nice way of grouping UI elements nicely together. The idea is that you connect edges or corners of one element to the edge or corner of another widget. Available anchors are:
 Some examples:
 <syntaxhighlight lang="javascript">
@@ Line 79: / Line 124: @@
-More examples you will find on the  [http://qt-project.org/doc/qt-4.8/qml-anchor-layout.html Anchor-based Layout in QML from the qt-project].
+More examples you will find on the  [http://qt-project.org/doc/qt-4.8/qml-anchor-layout.html Anchor-based Layout in QML from the qt-project.org].
 === Buttons ===

@@ Line 53: / Line 53: @@
+}
 </syntaxhighlight>
 === Buttons ===

@@ Line 5: / Line 5: @@
 == QML Basics ==
-It is recommended that you have read through the [http://doc.qt.nokia.com/4.7/qtquick.html Qt QML Tutorials], as there are quite a few and they are explained thoroughly. There is also a list of all [http://doc.qt.nokia.com/4.7/qdeclarativeelements.html standard QML elements].
+It is recommended that you have read through the [http://qt-project.org/doc/qt-4.8/qtquick.html Qt QML Tutorials], as there are quite a few and they are explained thoroughly. There is also a list of all [http://qt-project.org/doc/qt-4.8/qdeclarativeelements.html standard QML elements].
 Essentially, most of the content is the same. The exceptions to be noted are how data is gathered...since we use Data Engines, it is a bit different. Text color and font should be made to use PlasmaCore.Theme.

← Older revision		Revision as of 10:14, 16 July 2012
Line 231:		Line 231:
	}		}
	</syntaxhighlight>		</syntaxhighlight>
		+	To get a list of icons installed on system, run the command:
		+	$ kdialog --geticon actions

@@ Line 117: / Line 117: @@
 <syntaxhighlight lang="cmake">
 project(helloqml)
 install(DIRECTORY package/

@@ Line 175: / Line 175: @@
 </syntaxhighlight>
-In the above example, the minimum size is binded to the paintedWidth/paintedHeight properties of the Text element, ensuring there will always be enough room for the whole text to be displayed.
+In the above example, the minimum size is bound to the paintedWidth/paintedHeight properties of the Text element, ensuring there will always be enough room for the whole text to be displayed.
 == Plasmoid object ==

@@ Line 63: / Line 63: @@
 You create a .desktop file and the .qml file. They have to be in the usual plasma package structure:
-- plasmoid-qml/metadata.desktop
+* plasmoid-qml/metadata.desktop
+* plasmoid-qml/contents/ui/main.qml
-- plasmoid-qml/contents/ui/main.qml
 === <tt>metadata.desktop</tt> ===

@@ Line 184: / Line 184: @@
 == Localization ==
-It's possible to localize strings with the usual i18n(), i18nc(), i18np() global functions
+It is possible to localize strings with the usual i18n(), i18nc(), i18np() global functions.
 == Extra types ==