README.md 1.54 KB
Newer Older
Jonathan Riddell's avatar
Jonathan Riddell committed
1 2
# Intro

Jonathan Riddell's avatar
Jonathan Riddell committed
3 4
https://community.kde.org/KDE.org/applications

Jonathan Riddell's avatar
Jonathan Riddell committed
5 6 7 8 9
This uses build.kde.org and its ci-tooling to download builds and extract the
appstream data from them.

You will needs some space in /tmp and lots of space (20GB) in /srv.

Jonathan Riddell's avatar
Jonathan Riddell committed
10 11 12 13 14 15
It uses repo-metadata to get a list of projects
- https://cgit.kde.org/sysadmin/repo-metadata.git/

which is available through the API at
- https://projects.kde.org/api/

Harald Sitter's avatar
Harald Sitter committed
16 17 18 19
# Tools

## appstream.rb

Jonathan Riddell's avatar
Jonathan Riddell committed
20 21 22
Needs appstream 0.12 or newer and some other bits:
`apt install imagemagick appstream hicolor-icon-theme imagemagick-6.q16`

Harald Sitter's avatar
Harald Sitter committed
23 24 25 26 27 28 29 30 31 32 33 34
Collects **desktop application** appdata from CI install dirs and as a fallback
from Git.

Requires valid screenshots and icons to be available!
Limited functionality with Git fallback. All software should be CI'd really.

Twiddles the following dirs:

- `../appdata/` appdata cache. contains json blobs converted from appdata
- `../icons/` icons cache. contains icons named from their appid (org.kde.foo.svg)
- `../thumbnails` thumbnails cache. scaled to 540 width. subdir per appid

Jonathan Riddell's avatar
Jonathan Riddell committed
35
## appstream_mkindex.rb
Harald Sitter's avatar
Harald Sitter committed
36

37
Iters `../appdata/` and generates an `../index.json` mapping category
Harald Sitter's avatar
Harald Sitter committed
38 39 40
names to appids. The icons for the categories are generated by appstream.rb
and in `../icons/categories/` as downcased version of the name.

Jonathan Riddell's avatar
Jonathan Riddell committed
41
## old_apps_compat.rb
Harald Sitter's avatar
Harald Sitter committed
42

43 44 45
This is a one-time only script which generates appdata-extensions/ from the old data.
It no longer needs to be used as you can edit the files in appdata-extensions directly now.

Jonathan Riddell's avatar
Jonathan Riddell committed
46 47
In parent directory:
`svn co svn+ssh://svn@svn.kde.org/home/kde/trunk/www/sites/www/applications/apps`