pitaya-launcher/README.md

98 lines
3.7 KiB
Markdown
Raw Permalink Normal View History

<style>h1 > img { vertical-align: bottom; }</style>
2017-07-24 15:12:00 +02:00
# ![Logo Pitaya](img/icons/pitaya-logo.png) Pitaya [![Build Status](https://drone.cadol.es/api/badges/Cadoles/pitaya-launcher/status.svg?branch=develop)](https://drone.cadol.es/Cadoles/pitaya-launcher)
2015-08-20 18:41:51 +02:00
2015-08-28 10:06:25 +02:00
Lanceur d'application pour GNU/Linux
2015-08-20 18:41:51 +02:00
## Démarrer avec les sources
### Dépendences de développement
- [NodeJS](https://nodejs.org/) - Dernière version stable, testé sur la 0.12.*
- [NPM](https://www.npmjs.com/) - Normalement automatiquement installé avec NodeJS.
2015-10-10 14:33:41 +02:00
### Initialisation du projet & lancement de Pitaya
2015-08-20 18:41:51 +02:00
2015-11-12 15:07:27 +01:00
Récupérez préalablement les sources via [Git](http://git-scm.com/).
2015-08-20 18:41:51 +02:00
```
2015-11-12 15:07:27 +01:00
cd pitaya-launcher # Se placer dans le répertoire des sources de pitaya-launcher
git checkout develop # Basculer sur la branche de développement
npm install # Installer les dépendances
PITAYA_LOG_LEVEL=debug NODE_ENV=development npm start # Lancer l'application
2015-08-20 18:41:51 +02:00
```
## Variables d'environnement
Vous pouvez configurer le comportement de Pitaya en passant des variables d'environnement:
2015-08-20 18:41:51 +02:00
| Variable | Description | Valeurs possibles | Valeur par défaut |
|-------------------|-----------------------------------------------|-------------------------------|-------------------------------|
| PITAYA_MODE | Mode d'exécution de Pitaya | launcher, edit | launcher |
| PITAYA_PROFILE | Chemin ou URL du fichier profil à charger | -- | ./default-profile.json |
| PITAYA_AS_DESKTOP | Afficher Pitaya en mode "Bureau" | 1, 0 | 0 |
| PITAYA_LOG_FILE | Enregistrer les logs dans un fichier | Chemin absolu vers un fichier | aucune (pas d'enregistrement) |
| PITAYA_LOG_LEVEL | Niveau de log | debug, info, error, fatal | info |
2015-08-20 18:41:51 +02:00
## Comment construire l'application depuis les sources
```bash
ARCH=<ARCH> npm run build # Où ARCH peut être "x64", "ia32" ou "all"
```
2015-10-10 18:44:31 +02:00
Un dossier `pitaya-<target>-<arch>` sera créé dans le répertoire `./build`. Celui ci contient tous les fichiers nécessaires à l'application.
## Profils
Un fichier de profil est utilisé par Pitaya afin de définir l'arborescence d'applications affichée par le lanceur.
Ce fichier est au format JSON et a la structure récursive suivante:
```json
{
"items": [
{
"label": "Label de mon item de type catégorie",
"icon": "Chemin vers l'image d'icône",
"background": "Chemin vers l'image de fond, si besoin",
"items": [
{
"label": "Label de mon sous-item 1 de type application",
"icon": "Chemin vers l'image d'icône",
"exec": "Commande d'exécution de mon application"
},
{
"label": "Label de mon sous-item 2 de type catégorie",
"items": [
{
"label": "etc..."
}
]
}
]
}
]
}
```
### Différence entre catégories et applications
Un item comprenant un tableau `items` sera automatiquement considéré comme une catégorie et non plus une application, même si la propriété `exec` est également définie.
### Import de profils externes
Il est possible d'ajouter une propriété `import` avec comme valeur un chemin de fichier ou une URL sur un item.
Lors du chargement du profil, le lanceur "montera" automatiquement le fichier externe désigné sur l'item portant la propriété.
Voir le fichier `default-profile.json` pour un exemple.
## Comment contribuer
2015-08-20 18:41:51 +02:00
Ce projet utilise la méthodologie [Git Flow](http://nvie.com/posts/a-successful-git-branching-model/).
2015-08-28 10:06:25 +02:00
## Licence
GPLv3
2016-01-20 16:58:44 +01:00
2017-03-07 15:05:56 +01:00
Bump: 20170307-1