Difference between revisions of "Projects/KNS2/Layout"

Revision as of 09:14, 15 March 2007

Warning
Things you see here are work in progress. Please don't trust them.

KNewStuff 2 will have all its files in one dir, one for each app using it. Default will be KStandardDirs::locate("appdata", "addons").

To initialize it call Handler::initLayout();

NOTE: .desktop (metadata) files will be copied in $KDEHOME/services/. You can use KTrader to locate them.

They will be namespaced this way: $appname-$pkgname-$pkgversion-addon.desktop

Packages will be renamed as: $pkgname-$pkgversion.kns

And the file containing release notes will be called $pkgname-$pkgversion.txt

The following layout will be used:

addons/ <-- Note: this name may change
- installed-list <-- List of installed packages?
- May we store here infos/configs that applies appwide?
- $packageName-$packageVersion/
  - metadata file (see the packager section for additional informations)
  - (optional) Icon
  - (optional) Release notes for package
  - $packageName/
    - $file1
    - ...
- $packageName2-$packageVersion2/
  - metadata file
  - (optional) Icon
  - (optional) Release notes for package2
  - $package2Name/
    - $file1
    - ...
- Packages/
  - package.kns
  - package2.kns
- ...

@@ Line 2: / Line 2: @@
 == Main ==
-KNewStuff 2 will have all its files in one dir, one for each app using it. Default will be KStandardDirs::locate("appdata", "newstuff").
+KNewStuff 2 will have all its files in one dir, one for each app using it. Default will be KStandardDirs::locate("appdata", "addons").
-To initialize it call [[../Bundler|Bundler::initLayout(QString dir)]];
+To initialize it call [[../Handler|Handler::initLayout()]];
+'''NOTE:''' .desktop (metadata) files will be copied in $KDEHOME/services/. You can use KTrader to locate them.
+They will be namespaced this way:
+$appname-$pkgname-$pkgversion-addon.desktop
+Packages will be renamed as:
+$pkgname-$pkgversion.kns
+And the file containing release notes will be called
+$pkgname-$pkgversion.txt
 == Layout ==
@@ Line 10: / Line 21: @@
 * '''addons/''' ''<-- Note: this name may change''
-** installed-list ''<-- List of installed packages''
+** installed-list ''<-- List of installed packages?''
 ** ''May we store here infos/configs that applies appwide?''
 ** '''$packageName-$packageVersion/'''
@@ Line 16: / Line 27: @@
 *** (optional) Icon
 *** (optional) Release notes for package
+*** '''$packageName/'''
+**** $file1
+**** ...
 ** '''$packageName2-$packageVersion2/'''
 *** metadata file
 *** (optional) Icon
 *** (optional) Release notes for package2
+*** '''$package2Name/'''
+**** $file1
+**** ...
 ** '''Packages/'''
 *** package.kns
 *** package2.kns
 ** ...