Concepts du desktop

Chantier en cours

Silex Desktop est en développement actif. Cette page fige le vocabulaire que nous avons arrêté. Tout ce qui n'y figure pas est encore en discussion, et les fonctionnalités décrites ne sont pas toutes disponibles.

Silex Desktop édite des sites sur votre propre disque. Tout ce qui va au-delà de l'écriture de fichiers — versionner un site, l'envoyer sur une forge, le publier en ligne — est confié aux outils déjà présents sur votre machine, que Silex ne réimplémente pas.

Intégration

Un outil externe que Silex Desktop sait utiliser : git, la ligne de commande d'une forge comme glab (GitLab), hut (SourceHut) ou tea/fj (Forgejo), un client git visuel…

Silex cherche les intégrations une fois, retient où elles se trouvent, et ne suppose jamais qu'il y en a une : un site est d'abord un dossier de fichiers, les intégrations viennent par-dessus.

Intégration activée

Une intégration n'est utilisée qu'une fois que vous l'y autorisez. Détecter un outil ne suffit pas : Silex vous demande, et retient votre réponse par machine. La désactiver ne supprime jamais rien — un site continue de fonctionner sans elle.

Action

Ce que Silex demande, nommé d'après l'intention et jamais d'après l'outil qui l'exécute. Les actions sont tout le vocabulaire entre Silex et ses intégrations :

Action	Ce que Silex demande
version	Garder une version du site tel qu'il est
sync	Envoyer le site vers son dépôt distant
deploy	Publier le site en ligne
status	Dire dans quel état est le site
open-repo	Ouvrir le site dans un outil dédié
create-repo / list-repos	Créer un dépôt, lister les vôtres
auth-status	Dire si vous êtes connecté

Silex ne demande jamais à une intégration de « commiter », « taguer » ou « pousser » : ces mots appartiennent à l'intérieur de l'intégration qui agit.

Fournisseur

Une intégration qui offre une action donnée. Plusieurs intégrations peuvent offrir la même — un site peut être ouvert par n'importe lequel de vos clients git visuels — et une action sans fournisseur n'apparaît tout simplement pas.

Pipeline de publication

Les étapes de build qu'une forge exécute pour transformer vos fichiers publiés en site en ligne. Un site possède ses étapes dans build.json ; Silex génère le reste — le script build.sh et le fichier CI de la forge. C'est ce qui fait qu'un site publié depuis Silex Desktop se construit exactement comme un site publié depuis la version en ligne.

Voir Personnaliser le build.

Dossier du site

Un dossier par site, contenant ses fichiers source (website.json, les pages), sa sortie publiée (public/) et, si le versionnage est actif, son historique. Rien d'autre : un site que vous pouvez copier, sauvegarder et ouvrir ailleurs.