3,250
edits
Changes
Jump to navigation
Jump to search
Line 197:
Line 197: − + − From http://forums.contribs.org/index.php/topic,45855.0.html+ − In order to override a SME template, the filename in .../templates-custom/... should to be identical to the filename in .../templates/....+ − Here's how to go about creating a custom template: − # Identify the service performing the task I want to customize+ − # Identify the configuration file that needs to be customized − # Change the config file manually − # Restart the affected service − # Verify that restarting the service did not return the config file to the original configuration (dnscache, for example, regenerates .../dnscache/root/servers each time the service is restarted) − # Verify that the change introduced, fixes the problem I am addressing − # Locate the default template fragment that generates the piece of the config file I want to modify − # Copy the default template fragment into the appropriate .../templates-custom/... folder tree − # Edit the .../templates-custom/... copy of the template fragment − # Use expand-template to regenerate the target config file − # Verify (using file date and time, or by using a slightly different value for the new parameter than was used in step 3) that the config file now contains the output generated by the new custom template fragement. − # Re-test − # Document the operation in the wiki if it seems to me that the info would be useful to others − Not every config option of every program is templated; for example, there is no template (that I can find) to control /var/service/qpsmtpd/config.+ + + + + + + + + + + + + − Not every template is in the location you might expect (.../qpsmtpd/peers/0 is built using the template fragments in .../qpsmtpd/config/plugins due to the instructions in .../templates.metadata/...).+ − Not every function is controlled by only one template (or config file) - email attachment size, for example, is affected by settings in qmail, qpsmtpd, php and clamd.+ − Finally, template fragments are processed alpha-numerically - so be sure that your customizations are inserted into the target config file in a sensible location.+ + +
→Quick steps & tips
Vous pouvez ajouter d'autres exemples à cette section.
Vous pouvez ajouter d'autres exemples à cette section.
===Quick steps & tips===
===Étapes rapides et astuces concernant les fragments gabarits (templates)===
Source : http://forums.contribs.org/index.php/topic,45855.0.html
Afin de passer par dessus un gabarit SME, le nom de fichier du fragment dans .../templates-custom/... doit être identique au nom de fichier dans .../templates/... .
Voici comment créer un gabarit personnalisé:
# Identifier le service qui réalise la tâche que je veux personnaliser
# Identifier le fichier de configuration que j'ai besoin de personnaliser
# Modifier le fichier de configuration manuellement directement
# Redémarrer le service affecté
# Vérifier que le fait de redémarrer le service ne retourne pas le fichier à sa configuration d'origine (dnscache, par example, régénère.../dnscache/root/servers à chaque fois que le service est relancé)
# Vérifier que les changements faits, corrigent le problème qui a motivé cette modification
# Localiser le fragment de gabarit par défaut qui génère la partie du fichier de configuration que je veux modifier (ou les fragment qui sont autour de là où je veux insérer ma modification, pour créer un nom de fichier entre les deux)
# Copier le fragment de gabarit par défaut dans le dossier approprié dans l'arborescence /etc/e-smith/templates-custom/... (au besoin créer les sous-dossiers)
# Éditer la copie du fragment de gabarit dans .../templates-custom/...
# Utiliser expand-template afin de régénérer le fichier de configuration ciblé
# Vérifier (en utilisant la date et heure de modification du fichier, ou en utilisant des valeurs de configuration différentes pour les nouveaux paramètres que ceux utilisés à l'étape 3) aue le fichier de configuration contient maintenant la sortie générée par le nouveau fragment de gabarit personnalisé.
# Re-tester
# Documenter la modification dans le wiki s'il vous semble que cette action peut être profitable à d'autres utilisateurs
Tous les fichiers de configuration de tous les programmes ne sont pas dépendant de gabarits, par exemple, il n'y a pas de gabarit (que je puisse trouver) pour contrôler /var/service/qpsmtpd/config.
Tous les gabarits ne sont pas forcement localisés là où vous auriez pu vous y attendre (.../qpsmtpd/peers/0 est construit en utilsiant un fragment de gabarit situé dans .../qpsmtpd/config/plugins suivant les instructions trouvées dans .../templates.metadata/...).
Toutes les fonctions ne sont pas contrôlées par un seul et unique fragment (ou fichier de configuration) - la taille des pièces jointes aux courriels, par exemple, est affectée par les réglages dans qmail, qpsmtpd, php et clamd.
Enfin, les fragments de gabarit sont traités par ordre alpha-numérique - soyez donc sûres que votre personnalisation est insérée dans le fichier de configuration à la bonne ligne.
===References===
===References===