Comment ça marche
Vos entrées entrent, un site déployé sort — et tout l'opérationnel reste à côté.
Foundation se comprend le plus simplement comme un sens de flux unique avec une frontière claire : ce que vous détenez entre, et ce qui sort est un site statique que vous hébergez vous-même, connecté aux systèmes qui font tourner votre activité.
- Des entrées propres au site, la mécanique de Foundation, votre site déployé
- Les systèmes externes sont à côté de Foundation, jamais dedans
- Tout ce qui suit est vérifiable dans le dépôt
Ce que vous détenez entre
Tout ce qui est à gauche du flux vous appartient et le reste. Rien de tout cela n'est du code de plateforme.
Configuration
Identité, langues, navigation, interrupteurs de fonctionnalités et choix d'interface — des réglages validés plutôt que des constantes dispersées.
Contenu
Vos pages et collections sous forme de fichiers dans votre dépôt, chacune avec son propre titre et son propre corps.
Traductions
Un dictionnaire d'interface par langue, plus le dossier de contenu de cette langue.
Image de marque et ressources
Vos logos, favicon, aperçu social et toute illustration optionnelle, chacun dans un rôle nommé.
Vous pouvez modifier chacun de ces éléments sans toucher à l'architecture de la base.
Ce que Foundation en fait
Foundation lit vos entrées et produit le site. C'est la partie que vous n'avez pas eu à construire, et elle s'exécute quand vous compilez et déployez — pas pendant qu'un visiteur attend.
1
Validation
La configuration et les dictionnaires sont vérifiés contre leurs schémas, donc un réglage mal saisi fait échouer la compilation au lieu d'atteindre un visiteur.
2
Contenu et routage
Les pages sont chargées via une interface de contenu, reçoivent des adresses stables et reviennent par page à la langue par défaut quand une traduction manque.
3
Présentation
Votre contenu et votre identité sont composés par le système partagé de jetons, en clair ou en sombre, à toutes les largeurs d'écran.
4
Visibilité et métadonnées
Titres, adresses canoniques, annotations de langue, données structurées, sitemap et sortie robots sont générés depuis ce que vous avez configuré.
5
Points d'intégration
Là où vous avez activé une capacité, Foundation affiche la connexion et transmet l'intention du visiteur à votre fournisseur.
6
Sortie
Un site web statique, compilé et déployé sur votre propre compte et votre propre domaine.
Rien ici n'est un service que vous louez : le même dépôt peut être compilé partout où vous pouvez l'exécuter.
Ce qui tourne à côté de Foundation, pas dedans
Foundation exprime une intention — prendre rendez-vous, obtenir un itinéraire, envoyer un message — et la destination derrière cette intention vous appartient. Il ne devient pas ces systèmes.
- Réservation et planification
- Réception des demandes et des messages
- Cartes et itinéraires
- Mesure d'audience
- CRM et données clients
- Paiements et comptabilité
- Comptes clients et authentification
- Tout autre système que votre activité exploite déjà
Un service externe se connecte via un point d'intégration ; le service conserve ses données, ses règles et son propre compte.
De l'obtention de Foundation à un site que vous maintenez
Dix étapes concrètes. Les manuels du dépôt portent le détail — cette page montre la forme du travail.
1
L'obtenir
Clonez ou forkez le dépôt public sur votre propre compte.
2
L'exécuter
Installez-le et démarrez-le, pour voir un site fonctionner avant de changer quoi que ce soit.
3
Le configurer
Définissez votre identité, vos langues, votre navigation et vos interrupteurs de fonctionnalités dans la configuration.
4
Apporter votre identité
Remplacez les rôles graphiques nommés par vos propres logos, favicon et aperçus.
5
Rédiger votre contenu
Écrivez vos pages et vos collections sous forme de fichiers dans le dépôt.
6
Choisir vos capacités
N'activez que ce dont vous avez besoin ; une capacité inutilisée n'ajoute ni route ni contenu de remplissage.
7
Connecter vos fournisseurs
Pointez chaque point d'intégration activé vers le fournisseur que vous utilisez déjà.
8
Le valider
Exécutez la porte de qualité et la vérification navigateur, pour que les problèmes apparaissent avant vos visiteurs.
9
Le déployer
Compilez et déployez sur votre propre compte et votre propre domaine.
10
Le maintenir
Gardez votre contenu et votre configuration, et absorbez les améliorations futures quand vous le décidez.
Le site web ne devient jamais une seconde copie des manuels GitHub.
Qui possède quoi
Foundation est une infrastructure que vous détenez plutôt qu'un service que vous louez. La répartition est délibérément simple.
Vous possédez
- Configuration, identité et navigation
- Contenu et collections
- Dictionnaires de langue et traductions
- Image de marque et toutes les illustrations
- Choix des fournisseurs et leurs comptes
- Votre compte d'hébergement, votre domaine et votre déploiement
- Tout ce que vous ou votre prestataire ajoutez ensuite
Foundation possède
- L'architecture réutilisable et ses frontières appliquées
- La mécanique de présentation et les jetons
- Le routage et la chaîne de contenu
- La validation de la configuration
- Les points d'intégration
- L'infrastructure de vérification
Vous pouvez partir, et tout ce que vous détenez part avec vous — le dépôt est votre source.
Ce qui se passe quand vous modifiez quelque chose
Deux règles délibérées rendent cela prévisible : le contenu décide de l'existence, la configuration décide de la présentation — et ni l'un ni l'autre ne peut inventer l'autre en silence.
Le nom, le slogan ou la description du site
En-tête, pied de page, titres de page, métadonnées sociales et données structurées.
Le fichier propre à une page
Le contenu de cette page, et le sitemap généré.
Un fichier de dictionnaire
Les chaînes d'interface de cette langue.
Le jeton de couleur d'accent
Tous les éléments de marque et de mise en avant du site.
Un logo, un favicon ou un visuel d'aperçu
Le rôle visuel correspondant uniquement.
La configuration de navigation
L'ordre et les libellés du menu — jamais l'existence d'une page.
Un interrupteur de fonctionnalité
L'existence même des routes et de la surface de cette capacité.
Un lieu opérationnel
Son propre statut d'ouverture, son adresse, ses itinéraires et ses données structurées.
Un élément optionnel absent n'affiche rien : ni page de remplissage, ni illustration empruntée, ni coquille vide.
Pourquoi un mauvais changement échoue tôt
Votre configuration est vérifiée quand le site est compilé, et non quand un visiteur arrive : les erreurs apparaissent immédiatement.
- Un réglage inconnu ou mal orthographié est rejeté, pas ignoré
- Une valeur structurellement invalide fait échouer la compilation en nommant le réglage
- Une capacité configurée mais incomplète échoue au lieu de n'afficher rien en silence
- Une langue déclarée sans dictionnaire échoue au lieu de montrer discrètement une autre langue
C'est pourquoi la boucle est : modifier un fichier, compiler, et voir la vérité — plutôt que de la découvrir en production.
Adopter les améliorations sans perdre votre travail
Votre configuration, votre contenu, vos dictionnaires et vos ressources vivent dans leurs propres espaces, ce qui rend possible l'adoption ultérieure d'une amélioration sans réécrire votre site.
- Les espaces propres à votre site restent les vôtres lors d'une mise à niveau
- C'est vous qui décidez quand adopter une amélioration, plutôt que d'y être poussé
- Le dépôt consigne ce qui a changé et pourquoi, pour que la décision soit éclairée
Lire les consignes de mise à niveau
C'est le modèle documenté. Ce n'est pas un service de mise à jour automatique, et le projet n'en revendique aucun.
Partez d'une base qui fonctionne
Lisez les fonctionnalités, regardez deux entreprises qui tournent déjà dessus, puis partez de quelque chose qui fonctionne déjà.