Projects/Nepomuk/QuickStart - Revision history

Agateau: typo--

2013-01-08T15:51:03Z

typo--

Agateau: typo--

2013-01-08T15:12:33Z

typo--

AnneW: Marked this version for translation

2012-12-10T17:18:43Z

Marked this version for translation

Show changes

AnneW at 17:18, 10 December 2012

2012-12-10T17:18:11Z

Vishesh: Added links

2012-08-24T10:44:05Z

Added links

Vishesh: Removed the template

2012-08-24T10:36:25Z

Removed the template

Vishesh: Vishesh moved page Development/Tutorials/Metadata/Nepomuk/Quickstart to Projects/Nepomuk/QuickStart: More consistent with all the other Nepomuk pages

2012-08-24T10:34:53Z

Vishesh moved page Development/Tutorials/Metadata/Nepomuk/Quickstart to Projects/Nepomuk/QuickStart: More consistent with all the other Nepomuk pages

Vishesh: working example

2012-08-23T08:01:44Z

working example

Vishesh: /* Basic Terminology */

2012-08-01T17:48:25Z

‎Basic Terminology

Vishesh at 17:46, 1 August 2012

2012-08-01T17:46:57Z

@@ Line 107: / Line 107: @@
 <!--T:31-->
 Tag tag("Awesome-Tag-Name");
-QList<Resoruce> taggedResources = tag.tagOf();
+QList<Resource> taggedResources = tag.tagOf();
 <!--T:32-->

@@ Line 65: / Line 65: @@
 <!--T:20-->
-The [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Tag.html <tt>Nepomuk2::Tag</tt>] class will automatically look for for a tag called "Awesome-Tag-Name", it is finds it then [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Resource.html#a3c58ca2096f8424e12f31ddd73369597 Tag::exists()] will return true. Otherwise, the tag will be saved the first time the tag is used. In our case, when we add the tag to the Resource via [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Resource.html#a649e935b3557d0c5015ab7728f623f66 Resource::addTag()], the tag will be saved.
+The [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Tag.html <tt>Nepomuk2::Tag</tt>] class will automatically look for a tag called "Awesome-Tag-Name", if it finds it then [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Resource.html#a3c58ca2096f8424e12f31ddd73369597 Tag::exists()] will return true. Otherwise, the tag will be saved the first time the tag is used. In our case, when we add the tag to the Resource via [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Resource.html#a649e935b3557d0c5015ab7728f623f66 Resource::addTag()], the tag will be saved.
 === Retrieving Tags === <!--T:21-->

@@ Line 1: / Line 1: @@
-This page serves as a very simple overview to Nepomuk. It focuses on getting started with Nepomuk and tries not to deal with internal Nepomuk concepts. Please keep in the mind that the processes described here are targeted to the general use case. If you have a more specialized use case in mind, this might not be the best way to use the Nepomuk libraries.
+<languages />
-=Libraries and Headers=
+== Scope of this page ==
-Most of the non graphic parts of Nepomuk are present in the [https://projects.kde.org/projects/kde/kdelibs/nepomuk-core NepomukCore repository]. It is shipped with KDE 4.9, and should be provided by your distribution. When starting with Nepomuk development, it would be better to stick with your distribution version.
+This page serves as a very simple overview to '''Nepomuk'''. It focuses on getting started with '''Nepomuk''' and tries not to deal with internal '''Nepomuk''' concepts. Please keep in the mind that the processes described here are targeted to the general use case. If you have a more specialized use case in mind, this might not be the best way to use the '''Nepomuk''' libraries.
-With KDE 4.9, the Nepomuk libraries moved to the Nepomuk2 namespace. The headers also follow a similar convention.
+==Libraries and Headers==
-==Headers==
+Most of the non graphic parts of '''Nepomuk''' are present in the [https://projects.kde.org/projects/kde/kdelibs/nepomuk-core NepomukCore repository]. It is shipped with KDE 4.9, and should be provided by your distribution. When starting with '''Nepomuk''' development, it would be better to stick with your distribution version.
 All the Nepomuk headers in are preceded by Nepomuk2. Here are some common Nepomuk includes that are frequently used -
 <syntaxhighlight lang="cpp-qt">
@@ Line 17: / Line 23: @@
 </syntaxhighlight>
-==CMake==
+=== CMake ===
-KDE Projects generally use cmake as a build tool. Nepomuk is no different. In order to use Nepomuk you need to add the relevant macros for Nepomuk in your CMakeLists.txt.
+KDE Projects generally use cmake as a build tool. '''Nepomuk''' is no different. In order to use '''Nepomuk''' you need to add the relevant macros for '''Nepomuk''' in your CMakeLists.txt.
 <syntaxhighlight lang="cmake">
@@ Line 26: / Line 32: @@
 </syntaxhighlight>
-=Basic Terminology=
+== Basic Terminology ==
-At the lowest level Nepomuk is just a database which many applications use to store data. The main difference is that the data is not stored in rows and columns like traditional relational databases. Instead Nepomuk can be viewed as something similar to an object or document store. We store a large number of objects, and each of these objects have (key, value) pairs attached to them.
+At the lowest level '''Nepomuk''' is just a database which many applications use to store data. The main difference is that the data is not stored in rows and columns like traditional relational databases. Instead '''Nepomuk''' can be viewed as something similar to an object or document store. We store a large number of objects, and each of these objects have (key, value) pairs attached to them.
-Each object in our database is called a Resource. Everything in Nepomuk revolves around resources. All the higher level concepts such as files, tags, contacts, music albums, actors, etc. they are all Resources. Each of these resources has a number of (key, value) pairs associated with it. In the Nepomuk world, the keys are called properties or predicates, and have already been defined.
+Each object in our database is called a Resource. Everything in '''Nepomuk''' revolves around resources. All the higher level concepts such as files, tags, contacts, music albums, actors, etc. they are all Resources. Each of these resources has a number of (key, value) pairs associated with it. In the '''Nepomuk''' world, the keys are called properties or predicates, and have already been defined.
-Nepomuk is also based around a concept called the Semantic Web. However, understanding the ideas and details behind the Semantic Web is not necessary.
+'''Nepomuk''' is also based around a concept called the Semantic Web. However, understanding the ideas and details behind the Semantic Web is not necessary.
-=Tags and Ratings=
+== Tags and Ratings ==
-Every tag in Nepomuk is a Resource. In fact the [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Tag.html Tag class] is also derived from the [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Resource.html Resource class].
+Every tag in '''Nepomuk''' is a Resource. In fact the [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Tag.html Tag class] is also derived from the [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Resource.html Resource class].
-==Setting Tags==
+=== Setting Tags ===
 <syntaxhighlight lang="cpp-qt">
@@ Line 45: / Line 51: @@
 res.addTag( tag );
 </syntaxhighlight>
 The [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Tag.html <tt>Nepomuk2::Tag</tt>] class will automatically look for for a tag called "Awesome-Tag-Name", it is finds it then [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Resource.html#a3c58ca2096f8424e12f31ddd73369597 Tag::exists()] will return true. Otherwise, the tag will be saved the first time the tag is used. In our case, when we add the tag to the Resource via [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Resource.html#a649e935b3557d0c5015ab7728f623f66 Resource::addTag()], the tag will be saved.
-==Retrieving Tags==
+=== Retrieving Tags ===
 <syntaxhighlight lang="cpp-qt">
@@ Line 59: / Line 64: @@
      kDebug() << tag.genericLabel();
 </syntaxhighlight>
 Every resource has a predefined function for retrieving all the Tags any resource is tagged with - [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Resource.html#a286c2e37f975e58e38aaa83903040910 Resource::tags()]. The [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Resource.html#ad8d16485bdc9788de60bf5784141bcac Resource::genericLabel()] function tries to find a presentable name for any resource. In the case of tags, it returns the tags name.
-==Listing Tags==
+=== Listing Tags ===
-The simplest way to list all the tags that are present in Nepomuk is via a static function - [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Tag.html#a03bc6a42a14003aca17e8c3e02f43d17 Tag::allTags()]. You, however, need to be careful using this in a production environment as it executes a blocking query in the background. Depending on the number of tags on the system, it could take some time.
+The simplest way to list all the tags that are present in '''Nepomuk''' is via a static function - [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Tag.html#a03bc6a42a14003aca17e8c3e02f43d17 Tag::allTags()]. You, however, need to be careful using this in a production environment as it executes a blocking query in the background. Depending on the number of tags on the system, it could take some time.
 <syntaxhighlight lang="cpp-qt">
@@ Line 74: / Line 78: @@
      kDebug() << tag.genericLabel();
 </syntaxhighlight>
 There are also convenience functions to list all the resources that have been assigned a particular tag - [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Tag.html#a04256e4dda504e5b021afcab0ba4b714 Tag::tagOf]
@@ Line 88: / Line 91: @@
 </syntaxhighlight>
-==Ratings==
+=== Ratings ===
 Every resource in Nepomuk can be given a numeric rating. It is generally done on a scale of 0-10.
@@ Line 102: / Line 105: @@
 </syntaxhighlight>
-=Dealing with files=
+== Dealing with files ==
 Every file in Nepomuk is represented as a resource. Since dealing with files is very common, we provide a special [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1File.html File class] which is derived from the Resource class. We also provide convenience functions for checking if a resource is a file.
@@ Line 121: / Line 124: @@
 Internally Nepomuk Files are not very different from other Resources.
-= Working Example =
+== Working Example ==
-We understand that using a new framework such as Nepomuk can be quite intimidating at times. Therefore, we though it would be nice to have a working example for you to get started with - [http://quickgit.kde.org/index.php?p=kdeexamples.git&a=tree&h=eddcb1707a9e600db49fafdcb5ed8e8a195bcaba&hb=80a322af2bc5975c01c704173e937ccb8df605e3&f=nepomuk%2Ftest kdeexamples/nepomuk/test]. This example does nothing but it creates an executable called <code>nepomuk-test</code>. It serves as a simple starting point to Nepomuk where all the boiler plate code has been taken care of.
+[[Category: Documentation]]

@@ Line 3: / Line 3: @@
 =Libraries and Headers=
-Most of the non graphic parts of Nepomuk are present in the NepomukCore repositories. It is shipped with KDE 4.9, and should be provided by your distribution. When starting with Nepomuk development, it would be better to stick with your distribution version.
+Most of the non graphic parts of Nepomuk are present in the [https://projects.kde.org/projects/kde/kdelibs/nepomuk-core NepomukCore repository]. It is shipped with KDE 4.9, and should be provided by your distribution. When starting with Nepomuk development, it would be better to stick with your distribution version.
 With KDE 4.9, the Nepomuk libraries moved to the Nepomuk2 namespace. The headers also follow a similar convention.
@@ Line 36: / Line 36: @@
 =Tags and Ratings=
-Every tag in Nepomuk is a Resource. In fact the Tag class is also derived from the Resource class.
+Every tag in Nepomuk is a Resource. In fact the [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Tag.html Tag class] is also derived from the [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Resource.html Resource class].
 ==Setting Tags==
@@ Line 47: / Line 47: @@
-The 'Nepomuk2::Tag' class will automatically look for for a tag called "Awesome-Tag-Name", it is finds it then Tag::exists() will return true. Otherwise, the tag will be saved the first time the tag is used. In our case, when we add the tag to the Resource via Resource::addTag(), the tag will be saved.
+The [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Tag.html <tt>Nepomuk2::Tag</tt>] class will automatically look for for a tag called "Awesome-Tag-Name", it is finds it then [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Resource.html#a3c58ca2096f8424e12f31ddd73369597 Tag::exists()] will return true. Otherwise, the tag will be saved the first time the tag is used. In our case, when we add the tag to the Resource via [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Resource.html#a649e935b3557d0c5015ab7728f623f66 Resource::addTag()], the tag will be saved.
 ==Retrieving Tags==
@@ Line 61: / Line 61: @@
-Every resource has a predefined function for retrieving all the Tags any resource is tagged with - Resource::tags(). The Resource::genericLabel() function tries to find a presentable name for any resource. In the case of tags, it returns the tags name.
+Every resource has a predefined function for retrieving all the Tags any resource is tagged with - [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Resource.html#a286c2e37f975e58e38aaa83903040910 Resource::tags()]. The [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Resource.html#ad8d16485bdc9788de60bf5784141bcac Resource::genericLabel()] function tries to find a presentable name for any resource. In the case of tags, it returns the tags name.
 ==Listing Tags==
-The simplest way to list all the tags that are present in Nepomuk is via a static function - Tag::allTags(). You, however, need to be careful using this in a production environment as it executes a blocking query in the background. Depending on the number of tags on the system, it could take some time.
+The simplest way to list all the tags that are present in Nepomuk is via a static function - [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Tag.html#a03bc6a42a14003aca17e8c3e02f43d17 Tag::allTags()]. You, however, need to be careful using this in a production environment as it executes a blocking query in the background. Depending on the number of tags on the system, it could take some time.
 <syntaxhighlight lang="cpp-qt">
@@ Line 76: / Line 76: @@
-There are also convenience functions to list all the resources that have been assigned a particular tag - Tag::tagOf
+There are also convenience functions to list all the resources that have been assigned a particular tag - [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1Tag.html#a04256e4dda504e5b021afcab0ba4b714 Tag::tagOf]
 <syntaxhighlight lang="cpp-qt">
@@ Line 104: / Line 104: @@
 =Dealing with files=
-Every file in Nepomuk is represented as a resource. Since dealing with files is very common, we provide a special File class which is derived from the Resource class. We also provide convenience functions for checking if a resource is a file.
+Every file in Nepomuk is represented as a resource. Since dealing with files is very common, we provide a special [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk2_1_1File.html File class] which is derived from the Resource class. We also provide convenience functions for checking if a resource is a file.
 <syntaxhighlight lang="cpp-qt">

← Older revision		Revision as of 10:36, 24 August 2012
Line 1:		Line 1:
−
−
−	~~{{TutorialBrowser\|~~
−	~~series=[[../\|Nepomuk]]\|~~
−	~~name=Nepomuk Quickstart\|~~
−	~~pre=[[Getting_Started\|Getting started with KDE development]]\|~~
−	~~next=[[../Resources\|Handle Resource Metadata with Nepomuk]]\|~~
−	}}
−
−
	This page serves as a very simple overview to Nepomuk. It focuses on getting started with Nepomuk and tries not to deal with internal Nepomuk concepts. Please keep in the mind that the processes described here are targeted to the general use case. If you have a more specialized use case in mind, this might not be the best way to use the Nepomuk libraries.		This page serves as a very simple overview to Nepomuk. It focuses on getting started with Nepomuk and tries not to deal with internal Nepomuk concepts. Please keep in the mind that the processes described here are targeted to the general use case. If you have a more specialized use case in mind, this might not be the best way to use the Nepomuk libraries.

@@ Line 38: / Line 38: @@
 =Basic Terminology=
-Nepomuk is centred around a main 'Resource' class. For simple, non-high performance access to Nepomuk, it is recommended that you use the Resource class.
+At the lowest level Nepomuk is just a database which many applications use to store data. The main difference is that the data is not stored in rows and columns like traditional relational databases. Instead Nepomuk can be viewed as something similar to an object or document store. We store a large number of objects, and each of these objects have (key, value) pairs attached to them.
-Everything in Nepomuk is a Resource. Each Resource has a number of properties associated with it, which are stored as (key, value) pairs. They keys are referred to as properties or predicates, and the values are referred to as the objects.
+Each object in our database is called a Resource. Everything in Nepomuk revolves around resources. All the higher level concepts such as files, tags, contacts, music albums, actors, etc. they are all Resources. Each of these resources has a number of (key, value) pairs associated with it. In the Nepomuk world, they keys are called properties or predicates.
-Every file, folder, contact or tag is a Resource.
+Nepomuk is also based around a concept called the Semantic Web. However, understanding the ideas and details behind the Semantic Web is not necessary.
 =Tags and Ratings=