Lanceur d’application pour GNU/Linux
Go to file
wpetit 0f0ce28d55 Bump 2016-01-20 16:58:44 +01:00
css Meilleure gestion arbre immutable 2015-11-03 17:45:37 +01:00
debian Bump changelog + fix bug affichage titre 2015-10-29 17:39:36 +01:00
fonts Ajout police Sawaasdee, rename js to src 2015-10-16 15:12:49 +02:00
img Chargement des profils distant via HTTP 2015-11-05 16:40:42 +01:00
res Ajout mockup 2015-09-01 17:39:19 +02:00
src Edit mode: fix bug when XDG_DATA_DIRS is empty 2015-11-12 15:06:29 +01:00
test Chargement des profils distant via HTTP 2015-11-05 16:40:42 +01:00
.editorconfig Initial commit 2015-08-20 18:41:51 +02:00
.gitignore Pre-compilation des fichiers JSX avant build 2015-10-09 14:22:23 +02:00
LICENSE Initial commit 2015-08-20 18:41:51 +02:00
Makefile Packaging Debian fonctionnel 2015-10-22 13:49:38 +02:00
README.md Bump 2016-01-20 16:58:44 +01:00
default-profile.json Gestion des imports dans les profils 2015-11-05 14:39:48 +01:00
eleve.json Tentative mise en place crossfade sur le background 2015-10-20 13:15:27 +02:00
index.html Ajout police Sawaasdee, rename js to src 2015-10-16 15:12:49 +02:00
main.js Ajout mesures anti-disparition de Pitaya en mode desktop 2015-11-05 11:41:51 +01:00
package.json Chargement des profils distant via HTTP 2015-11-05 16:40:42 +01:00
partial-profile.json Chargement des profils distant via HTTP 2015-11-05 16:40:42 +01:00

README.md

Pitaya

Lanceur d'application pour GNU/Linux

Démarrer avec les sources

Dépendences de développement

  • NodeJS - Dernière version stable, testé sur la 0.12.*
  • NPM - Normalement automatiquement installé avec NodeJS.

Initialisation du projet & lancement de Pitaya

Récupérez préalablement les sources via Git.

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

Variables d'environnement

Vous pouvez configurer le comportement de Pitaya en passant des variables d'environnement:

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

Comment construire l'application depuis les sources

npm run build

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:

{
  "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

Ce projet utilise la méthodologie Git Flow.

Licence

GPLv3

Bump: 20160120