Templates

Updated 11 Novembre 2026

Les modèles sont un mécanisme des Outils Calculate qui configure les fichiers de configuration sans édition manuelle. Vous décrivez "ce qui doit être" dans le fichier, et les outils l'ajoutent à la configuration existante : ils conservent vos autres paramètres, l'ordre des lignes, les guillemets et les commentaires, associent le fichier à son paquet, et le réécrivent à partir de zéro à chaque mise à jour du paquet.

Cela résout deux problèmes à la fois. Le système reste à jour au fil des mises à jour continues : les paquets changent de version et de format de configuration, et les modèles entraînent les paramètres avec eux. Et les modifications restent lisibles : le modèle ne contient que ce que vous vouliez changer, et non des retouches éparpillées dans des dizaines de fichiers de /etc/.

Les modèles sont utilisés partout : lors de la création d'une image, de l'installation du système, du premier démarrage, de la mise à jour de l'arbre Portage, de la configuration d'un paquet et de la connexion de l'utilisateur à une session.

Premiers pas

• Démarrage rapide : votre premier modèle en cinq minutes - trois exemples complets avec vérification du résultat.
• Syntaxe du modèle - l'en-tête du modèle, les variables, les conditions, les fonctions et les préfixes !, +, -.
• Formats de fichiers de configuration - quel format choisir et en quoi ils diffèrent.

Références

• Manuel complet des modèles Calculate - une référence dans le style d'une page man : toute la syntaxe dans un seul fichier, les éléments de contrôle, les règles d'ajout, tous les formats et toutes les fonctions de modèles avec exemples.
• Référence complète des formats - les 29 noms format= avec leur comportement et des exemples issus de l'arbre calculate.
• Paramètres de l'en-tête - des listes distinctes pour un fichier et pour un répertoire : elles diffèrent.
• Variables des modèles - comment afficher les variables, où elles sont stockées et comment calculate.env diffère de ini.env.

Rubriques avancées

• Répertoires de modèles et niveaux de stockage - .calculate_directory, priorité des dépôts, /var/calculate/templates et les fichiers *.clt, répertoires d'événements de la forme N_ac_*, et un exemple d'outil qui crée lui-même des modèles (cl-kernel).
• Кто и когда налагает шаблоны — карта событий и матрица ac_*-переменных, а также избирательное отключение шаблонов для отдельных пакетов (cl_setup_skip_merge, cl_setup_skip_patch, cl_setup_skip_profile, cl_setup_skip_sync).
• Le modèle n'a pas été appliqué et n'a rien signalé : diagnostic - six causes courantes.
• La vie d'un fichier après le modèle - la propriété du fichier, protected, dispatch-conf et la suppression correcte.
• Fonctions personnalisées dans un overlay - scripts/functions et le protocole de retour.
• Un modèle à côté du fichier : .clt - quand vous n'avez pas besoin de déplacer le modèle dans /var/calculate/templates.