| 1 | Information on SVN-backed GHNS repositories |
|---|
| 2 | =========================================== |
|---|
| 3 | |
|---|
| 4 | GHNS entries can take several paths until they end up in a GHNS repository. |
|---|
| 5 | They could be uploaded by FTP, manually or through the KNS2 upload dialogue, |
|---|
| 6 | or they can be maintained through SVN. The latter means that users are not |
|---|
| 7 | able to upload easily, but it's a suitable mode for application maintainers |
|---|
| 8 | who want to keep control of what data is being offered. |
|---|
| 9 | |
|---|
| 10 | On newstuff.kde.org, a repository is available for hosting entries. Any |
|---|
| 11 | other repository can also be used, in this case newstuff.kde.org only |
|---|
| 12 | maintains the provider meta information. |
|---|
| 13 | The repository URLs are: |
|---|
| 14 | svn://newstuff.kde.org/kdedata/trunk |
|---|
| 15 | http://newstuff.kde.org/kdedata/browser/trunk |
|---|
| 16 | |
|---|
| 17 | Two types of information are stored there: an ADMIN directory, and directories |
|---|
| 18 | for the applications and data types. For new applications, a new configuration |
|---|
| 19 | file needs to be created in ADMIN/hotstuff.d. Other than that, this complicated |
|---|
| 20 | part is not really needed. |
|---|
| 21 | |
|---|
| 22 | In each application directory, new entries and changes can be committed at |
|---|
| 23 | any time. They will be picked up by Hotstuff automatically every minute or |
|---|
| 24 | every couple of minutes. The SVN scripts will automatically perform some sanity |
|---|
| 25 | checks. Here are the rules: |
|---|
| 26 | - Each entry needs to have a .meta file, for syntax please look here: |
|---|
| 27 | http://ghns.freedesktop.org/spec/ghns-spec.html |
|---|
| 28 | - Each entry also needs to have a payload file. If multiple files are needed, |
|---|
| 29 | create an archive out of them. |
|---|
| 30 | - Each entry can optionally have a preview file. |
|---|
| 31 | - Payload and preview are referenced without path information from the .meta |
|---|
| 32 | file. |
|---|
| 33 | |
|---|
| 34 | Meta files can be written by hand, or generated using the 'ghnsmetatemplate' |
|---|
| 35 | script from Hotstuff SVN. Additionally, translations often found in desktop |
|---|
| 36 | files can be merged in using the 'ghns-from-desktop.py' script. |
|---|
| 37 | |
|---|
