fr:devel:templates
Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédenteProchaine révisionLes deux révisions suivantes | ||
fr:devel:templates [2016-05-15 11:28] – lien template_info Digitalin | fr:devel:templates [2018-05-12 21:04] – [Fonctions] lien xref Digitalin | ||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
======Développement de thèmes DokuWiki====== | ======Développement de thèmes DokuWiki====== | ||
- | |||
- | :!: mise à jour en cours. Se reporter à la [[devel: | ||
Vous pouvez personnaliser l' | Vous pouvez personnaliser l' | ||
Ligne 8: | Ligne 6: | ||
===== Guide de démarrage ===== | ===== Guide de démarrage ===== | ||
- | La façon la plus simple | + | La façon la plus simple |
- Installer le thème [[template: | - Installer le thème [[template: | ||
- | - Renommer le répertoire '' | + | - Renommer le répertoire '' |
- Sélectionnez votre nouveau thème depuis le Gestionnaire de configuration | - Sélectionnez votre nouveau thème depuis le Gestionnaire de configuration | ||
- | - Changer ensuite votre thème selon vos envies. Pour comprendre comment les thèmes de DokuWiki sont construits, jetez un œil aux [[# | + | - Changer ensuite votre thème selon vos envies. Pour comprendre comment les thèmes de DokuWiki sont construits, jetez un œil aux [[# |
- Lorsque votre thème est prêt, vous pouvez le [[# | - Lorsque votre thème est prêt, vous pouvez le [[# | ||
- | ==== Conventions de nommage des thèmes | + | === Conventions de nommage des thèmes === |
Le nom (nom du répertoire) d'un thème valide : | Le nom (nom du répertoire) d'un thème valide : | ||
Ligne 23: | Ligne 21: | ||
* Les caractères point " | * Les caractères point " | ||
* l' | * l' | ||
- | * utiliser le trait souligné " | + | * utiliser le trait souligné " |
* Si le même nom est utilisé par deux thèmes différents | * Si le même nom est utilisé par deux thèmes différents | ||
* ils s' | * ils s' | ||
Ligne 33: | Ligne 31: | ||
===== Structure du répertoire d'un thème ===== | ===== Structure du répertoire d'un thème ===== | ||
- | Chaque | + | Chaque |
- | Les fichiers CSS sont spécifiés dans le fichier '' | + | Les fichiers CSS sont spécifiés dans le fichier '' |
* ''< | * ''< | ||
Ligne 45: | Ligne 43: | ||
* '' | * '' | ||
* '' | * '' | ||
- | * '' | + | * '' |
* '' | * '' | ||
* '' | * '' | ||
* ''< | * ''< | ||
- | * ''< | + | * ''< |
* '' | * '' | ||
+ | * '' | ||
+ | * '' | ||
- | la manipulation des paramètres de configuration est analogue aux [[devel: | ||
+ | La manipulation des paramètres de configuration est analogue aux [[devel: | ||
- | ===== Fonctions | + | ===== Fonctionnement interne détaillé |
- | Une liste des fonctions disponibles est accessible dans la [[http://dev.splitbrain.org/ | + | ==== Fonctions ==== |
+ | |||
+ | Une liste des fonctions disponibles est accessible dans la [[https://xref.dokuwiki.org/ | ||
* **'' | * **'' | ||
tpl_content(false); | tpl_content(false); | ||
- | </ | + | </ |
- | * **'' | + | * **'' |
**Exemple: | **Exemple: | ||
Ligne 78: | Ligne 80: | ||
</ | </ | ||
- | La fonction '' | + | La fonction '' |
- | * une variable d' | + | |
- | * les métadonnées de la page | + | |
- | * la méthode '' | + | |
- | Comme il n'y a pas de métadonnées pour les anciennes révisions ou l' | + | Comme il n'y a pas de métadonnées pour les anciennes révisions ou l' |
**Exemple: | **Exemple: | ||
Ligne 105: | Ligne 104: | ||
- | * **'' | + | * **'' |
* **'' | * **'' | ||
- | * Further many other useful template functions are available. Please have a look in [[xref> | + | * De très nombreuses autres fonctions utiles pour les thèmes sont disponibles. Merci de jeter un œil dans la [[xref> |
- | ===== Variables globales et constantes | + | ==== Variables globales et constantes ==== |
- | Pour une liste complète des Variables | + | Pour une liste complète des variables |
- | ===== Indexation automatisée | + | ==== Indexation automatisée ==== |
- | Presque à la fin du fichier '' | + | Presque à la fin du fichier '' |
+ | ==== classe ' | ||
- | ===== Hooks ===== | + | Une classe nommée |
+ | Ceci pour être sûr que les styles de DokuWiki n' | ||
- | Les hooks (hameçons | + | ==== Inclure des Hooks (hameçons) |
- | Le template par défaut de DokuWiki | + | Les hooks (hameçons en français) permettent d' |
- | ==== Hooks disponibles ==== | + | Le thème par défaut de DokuWiki cherche des fichiers spécifiques dans le répertoire '' |
- | Tous ces fichiers sont recherchés dans le répertoire '' | ||
- | ^ Nom de fichier | + | ===== Convertir |
- | | '' | + | |
- | | '' | + | |
- | | '' | + | |
- | | '' | + | |
- | | '' | + | |
- | | '' | + | |
- | DokuWiki est fourni avec un exemple | + | Si vous manquez d' |
+ | |||
+ | * [[devel: | ||
+ | |||
+ | |||
+ | ===== Problèmes courants à éviter ===== | ||
+ | |||
+ | Voici quelques problèmes que les développeurs de thèmes rencontrent et comment ils peuvent être évités: | ||
+ | |||
+ | ===Ne mettez pas de commandes Javascript dans l' | ||
+ | |||
+ | Ceci inclut '' | ||
+ | |||
+ | ===Désactiver " | ||
+ | |||
+ | Certains développeurs de thèmes ont rencontré des problèmes avec la mise en cache de fichiers CSS et JS de DokuWiki à cause de cette option active, bien que cela a été difficile à cerner. Pour être tranquille, désactiver cette option temporairement. | ||
+ | |||
+ | === Utiliser " | ||
+ | |||
+ | Pour ce faire, appuyez sur Ctrl+F5 ou en maintenant enfoncées les touches Maj-Ctrl-Alt tout en cliquant sur le bouton " | ||
+ | |||
+ | Ceci n'est pas dû à DokuWiki mais plutôt au fonctionnement des navigateurs actuels concernant le cache. Les navigateurs mettent en cache les feuilles de style, d'où cette nécessaire manipulation. | ||
===== Publier un thème sur dokuwiki.org ===== | ===== Publier un thème sur dokuwiki.org ===== | ||
- | ---- | ||
+ | Si vous créez un thème, merci de le partager avec la communauté. Il vous suffit de créer une page du nom de votre thème dans l' | ||
+ | La page mérite de contenir toute la documentation sur l' | ||
- | ===== Mise à jour de la page en cours ===== | + | En haut de la page de thème, quelques champs de métadonnées ont besoin d' |
- | * --- [[user> | + | Depuis la version Ponder Stibbons, un signalement de mise à jour automatique est possible. Pour que ce processus marche convenablement, |
- | **phrases laissées | + | Les téléversements (upload) ne sont pas autorisés sur dokuwiki.org, |
+ | |||
+ | ===== Crédits ===== | ||
+ | |||
+ | | ||
- | * (voir '' | ||
- | * Voila un petit script pour déterminer dans quel partie du site vous êtes: | ||
- | <code php> | ||
- | $url_blog= preg_replace('/ | ||
- | if(substr($url_blog, | ||
- | $ma_page=" | ||
- | } | ||
- | //Utilisez switch pour plusieurs catégories. | ||
- | [...] | ||
- | if($ma_page==" | ||
- | echo '< | ||
- | tpl_toc(); | ||
- | echo '</ | ||
- | } | ||
- | </ |
fr/devel/templates.txt · Dernière modification : 2023-08-13 14:44 de Klap-in