Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:devel:templates [2016-07-23 14:26] – [Variables globales et constantes] Digitalin
+++ fr:devel:templates [2023-08-13 14:44] (Version actuelle) – Klap-in
@@ Ligne 21: / Ligne 21: @@
   * Les caractères point "." ou trait souligné "_" ne sont pas autorisés car :
       * l'infrastructure logicielle de DokuWiki ne les prend pas en charge partout
-      * utiliser le trait souligné "_" donnera la valeur zéro à la [[:popularity|cote de popularité]].
+      * utiliser le trait souligné "_" donnera la valeur zéro à la [[fr:popularity|cote de popularité]].
   * Si le même nom est utilisé par deux thèmes différents
       * ils s'excluent mutuellement et sont intrinsèquement incompatibles,
@@ Ligne 59: / Ligne 59: @@
 ==== Fonctions ====
-Une liste des fonctions disponibles est accessible dans la [[http://dev.splitbrain.org/reference/dokuwiki/nav.html?inc/template.php.html|documentation de l'API]]. Certaines sont listées ci-dessous.
+Une liste des fonctions disponibles est accessible dans la [[xref>inc/template.php|documentation de l'API]]. Certaines sont listées ci-dessous.
   * **''[[xref>tpl_content()]]''** \\ Cette fonction affiche le contenu d'une page du wiki, y compris la [[fr:toc|table des matières]]. Il est possible d'empêcher cela en passant le paramètre ''false'' quand on appelle la fonction :<code php>
@@ Ligne 118: / Ligne 118: @@
 ==== Indexation automatisée ====
-Presque à la fin du fichier ''[[devel:templates:main.php]]'' du thème par défaut, vous verrez un appel à la fonction ''tpl_indexerWebBug()''. Elle génère une balise HTML ''%%<IMG>%%'' qui fait une requête à ''[[fr:indexer|lib/exe/indexer.php]]''. **C'est une partie vitale de DokuWiki** qui fournit une indexation automatique de la page pour l'outil de [[:search|recherche]] et d'autres fonctions importantes comme la génération d'une [[:sitemap|carte du site en XML]] (utilisée par les moteurs de recherche internet) ou la [[:metadata|mise à jour des méta-données]]. Tous les thèmes doivent inclure cette fonction, sans quoi le wiki pourrait ne pas fonctionner correctement (par exemple, [[fr:search|la recherche]] ne fonctionnera pas).
+Presque à la fin du fichier ''[[devel:templates:main.php]]'' du thème par défaut, vous verrez un appel à la fonction ''[[xref>tpl_indexerWebBug()]]''. Elle génère une balise HTML ''%%<IMG>%%'' qui fait une requête à ''[[fr:taskrunner|lib/exe/taskrunner.php]]''. **C'est une partie vitale de DokuWiki** qui fournit une indexation automatique de la page pour l'outil de [[:search|recherche]] et d'autres fonctions importantes comme la génération d'une [[fr:sitemap|carte du site en XML]] (utilisée par les moteurs de recherche internet) ou la [[:metadata|mise à jour des méta-données]]. Tous les thèmes doivent inclure cette fonction, sans quoi le wiki pourrait ne pas fonctionner correctement (par exemple, [[fr:search|la recherche]] ne fonctionnera pas).
 ==== classe 'dokuwiki' ====
@@ Ligne 125: / Ligne 125: @@
 Ceci pour être sûr que les styles de DokuWiki n'interfèrent pas avec d'autres styles dans le cas d'intégration à un autre site, ceci pouvant poser potentiellement des conflits entre fichiers CSS.
-==== Inclure des Hooks (hameçons) ====
+==== Inclure des connecteurs (Hooks) ====
-Les hooks (hameçons en français) permettent d'inclure du contenu statique dans votre [[fr:DokuWiki]] sans avoir besoin de toucher au [[fr:template|thème]]. Vous pouvez par exemple les utiliser pour ajouter une bannière, le logo de votre entreprise ou un avertissement en bas de chaque page.
+Les connecteurs (hooks), littéralement «hameçons» en français permettent d'inclure du contenu statique dans votre [[fr:DokuWiki]] sans avoir besoin de toucher au [[fr:template|thème]]. Vous pouvez par exemple les utiliser pour ajouter une bannière, le logo de votre entreprise ou un avertissement en bas de chaque page.
-Le thème par défaut de DokuWiki cherche des fichiers spécifiques dans le répertoire ''lib/tpl/default/'' et se contente de les inclure au bon endroit quand on affiche une page. **Vous pouvez y mettre n'importe quel code HTML ou PHP**. Bien entendu, cela ne fonctionne qu'en utilisant le thème par défaut ou un thème supportant [[template:dokuwiki#supported_include_hooks|les mêmes appels de hooks]](comme le thème starter).
+Le thème par défaut de DokuWiki cherche des fichiers spécifiques dans le répertoire ''lib/tpl/dokuwiki/'' et se contente de les inclure au bon endroit quand on affiche une page. **Vous pouvez y mettre n'importe quel code HTML ou PHP**. Bien entendu, cela ne fonctionne qu'en utilisant le thème par défaut ou un thème supportant [[template:dokuwiki#supported_include_hooks|les mêmes appels de hooks]](comme le thème starter).
@@ Ligne 135: / Ligne 135: @@
 Si vous manquez d'idées ou de compétences en design, vous pouvez aussi convertir des thèmes existants. Il y a de nombreuses options disponible pour ce faire. Si vous souhaitez publier l'un de ceux-là, merci de vérifier qu'il est bien [[https://www.gnu.org/philosophy/license-list.html#GPLCompatibleLicenses|GPL2-compatible]].
-  * [[devel:wp_to_dw_template|How to convert a WordPress theme to a DokuWiki template]]
@@ Ligne 143: / Ligne 141: @@
 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'étiquette <body> d'une page===
+=== Ne mettez pas de commandes Javascript dans l'étiquette <body> d'une page ===
 Ceci inclut ''onLoad'' et d'autres. Bien qu'ignorer cette règle n'affecte pas du tout Firefox, Internet Explorer (même IE7) aura des erreurs Javascript à cause du Javascript requis pour l'édition de page, ceci causant des problèmes d'affichage et rendant manquante la barre d'édition au moment de l'édition souhaitée d'une page.
-===Désactiver "Compact CSS and JavaScript files" quand vous développez un thème===
+=== Désactiver "Compact CSS and JavaScript files" quand vous développez un thème ===
 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 "forced refreshing" après avoir fait des changements aux fichiers CSS===
+=== Utiliser "forced refreshing" après avoir fait des changements aux fichiers CSS ===
 Pour ce faire, appuyez sur Ctrl+F5 ou en maintenant enfoncées les touches Maj-Ctrl-Alt tout en cliquant sur le bouton "rafraîchir" du navigateur.
@@ Ligne 166: / Ligne 164: @@
 En haut de la page de thème, quelques champs de métadonnées ont besoin d'être renseignés. Une description de chacun d'eux est disponible sur la page de [[plugin:repository#template_entry|dépôt des extensions]].
-Depuis la version Ponder Stibbons, un signalement de mise à jour automatique est possible. Pour que ce processus marche convenablement, il est indispensable que la date sur le champ “Last updated on” de la page du thème corresponde à la date indiquée par le fichier [[fr:devel:template_info|template.info.txt]] dans le fichier source tarball / zip du thème.
+Depuis la version Ponder Stibbons, un signalement de mise à jour automatique est possible. Pour que ce processus marche convenablement, il est indispensable que la date sur le champ “Last updated on” de la page du thème corresponde à la date indiquée par le fichier [[fr:devel:template_info|template.info.txt]] situé dans le fichier source tarball / zip du thème.
+Les téléversements (upload) ne sont pas autorisés sur dokuwiki.org, ce qui vous oblige à héberger votre thème ailleurs. Nous recommandons de gérer la source avec un logiciel de gestion de versions comme ''git''. Utiliser un dépôt public comme [[https://github.com|GitHub]]est le moyen le plus simple de gérer un dépôt public en vous offrant en même temps un suivi de bug pour votre dépôt.
+===== Voir aussi =====
+Si vous voulez convertir un thème WordPress en thème DokuWiki, vous pouvez vous appuyer sur cette [[devel:wp_to_dw_template|documentation ]].
-Les téléversements (upload) ne sont pas autorisés sur dokuwiki.org, ce qui vous oblige à héberger votre thème ailleurs. Nous recommandons de gérer la source avec un logiciel de gestion de versions comme ''git''. Utiliser un dépôt public comme [[https://github.com|GitHub]]est le moyen le plus simple de gérer un dépôt public et il vous offre aussi un suivi de bug pour votre dépôt.
 ===== Crédits =====
-  * Actualisation et traduction --- [[user>Digitalin|Digitalin]] //2016-05-13 10:52// et //2016-07-23 13:00//
+  * Actualisation et traduction --- [[user>Digitalin|Digitalin]] //2016-05-13 10:52// \\ //2016-07-23 13:00// et //2020-04-20 17:21//