← Back to branch summary

~ubuntu-branches/ubuntu/jaunty/kde4libs/jaunty-updates

« back to all changes in this revision

Viewing changes to knewstuff/doc/tutorial.txt

  • Committer: Bazaar Package Importer
  • Author(s): Harald Sitter
  • Date: 2008-12-11 18:26:08 UTC
  • mfrom: (1.1.24 upstream)
  • Revision ID: james.westby@ubuntu.com-20081211182608-tsu6p8ncbw1gnqxt
Tags: 4:4.1.85-0ubuntu1
* New upstream release
* Patches:
  + Removed 15_kfreebsd_support.diff from patches/series (doesn't apply and
    has no use for Ubuntu)
  + Redid 20_use_dejavu_as_default_font.diff
  + Completely removed kubuntu_09_fix_application_menu.diff (applied upstream)
  + Refreshed kubuntu_54_use_xdg_menu_prefix.diff
  + Dropped plasma/widgets/toolbutton.cpp from kubuntu_qt_ftbfs.diff (applied
    upstream)
  + Global quilt refresh

Show diffs side-by-side

added added

removed removed

Lines of Context:
knewstuff/doc/tutorial.txt
7
7
http://developer.kde.org/documentation/tutorials/knewstuffsecure/ as well.
8
8
 
9
9
Techbase looks like the best place for it once it's done.
 
10
In fact, there is now a tutorial and list of KNS2-using applications available at:
 
11
http://techbase.kde.org/Development/Tutorials/K_Hot_New_Stuff2
10
12
 
11
13
Revision 2.0.0preX (26.03.2007)
12
14
 
37
39
Vocabulary
38
40
----------
39
41
 
40
 
A lot of specific terms have been created. The following list should eliminate the confusion. 
 
42
A lot of specific terms have been created. The following list should eliminate the confusion.
41
43
* Get Hot New Stuff:
42
 
  The general framework which is involved client- and server-side. 
 
44
  The general framework which is involved client- and server-side.
43
45
* KNewStuff2:
44
46
  The KDE library written to use GHNS efficiently and easily.
45
 
  An alternative library would be SDLNewStuff, for example. 
 
47
  An alternative library would be SDLNewStuff, for example.
46
48
* Hotstuff:
47
49
  Server-side scripts to allow for unattended data processing for traditional KNewStuff
48
50
  uploads/downloads and their new-style GHNS and DXS counterparts. No alternative is known,
49
 
  although the kde-look family of sites also do data processing. 
 
51
  although the kde-look family of sites also do data processing.
50
52
* GHNS web frontend:
51
53
  A generic term for a web frontend to allow user ratings, reviews and data overviews.
52
54
  Cocodrilo is a freely available frontend, whereas the kde-look site family provides a nice
53
 
  but not free alternative. 
 
55
  but not free alternative.
54
56
* Provider: Server provider hosting directory information and/or contributed data.
55
57
 
56
58
Preparations
119
121
 
120
122
# # How to name the files?
121
123
  #doesn't use payload file name
122
 
# CustomName=true 
 
124
# CustomName=true
123
125
 
124
126
# # What to do after installation? Any number of the lines below
125
127
# # unpack the downloaded archive
126
128
# Uncompress=true
127
 
# # post-installation command 
128
 
# InstallationCommand=dbus-send ... %f ... 
 
129
# # post-installation command
 
130
# InstallationCommand=dbus-send ... %f ...
129
131
 
130
132
Downloading data
131
133
----------------
140
142
# KNS::Entry::List entries = KNS::Engine::download()
141
143
 
142
144
Please note that entry pointers in the returned list are allocated, and you should delete them
143
 
with something like: 
 
145
with something like:
144
146
 
145
147
# qDeleteAll(entries);
146
148
 
172
174
or even run one by oneself?
173
175
 
174
176
There will be separate documentation on this topic. For the time being, there is
175
 
GHNS hosting tested with KNewStuff2 being offered at new.kstuff.org, a server sponsored
176
 
by OSU-OSL for the advancement of collaborative data sharing. The KDE-Look server
177
 
also provides GHNS feeds.
 
177
GHNS hosting suitable for KNewStuff2 being offered at newstuff.kde.org, a server
 
178
sponsored by OSU-OSL for the advancement of collaborative data sharing. The KDE-Look
 
179
server also provides GHNS feeds. Some KDE applications also host data on their
 
180
own, e.g. on edu.kde.org. This is not recommended if you want to allow uploads
 
181
- and you certainly want those to get more data!
 
182
For hosting your data on newstuff.kde.org, please read the repository information
 
183
at http://newstuff.kde.org/development.php.
178
184
 
179
185
http://newstuff.kde.org/
180
186
http://www.kde-look.org/help/ghns.php