DokuWiki

It's better when it's simple

Outils pour utilisateurs

Outils du site


fr:devel:templates

Différences

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

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
Prochaine révisionLes deux révisions suivantes
fr:devel:templates [2016-07-23 14:25] – [Structure du répertoire d'un thème] Ajout lien vers fr Digitalinfr:devel:templates [2018-05-12 21:04] – [Fonctions] lien xref Digitalin
Ligne 21: Ligne 21:
   * Les caractères point "." ou trait souligné "_" ne sont pas autorisés car :   * 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       * 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    * Si le même nom est utilisé par deux thèmes différents 
       * ils s'excluent mutuellement et sont intrinsèquement incompatibles,       * ils s'excluent mutuellement et sont intrinsèquement incompatibles,
Ligne 59: Ligne 59:
 ==== Fonctions ==== ==== 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 [[https://xref.dokuwiki.org/reference/dokuwiki/nav.html?inc/template.php.html|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>   * **''[[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 114: Ligne 114:
 ==== Variables globales et constantes ==== ==== Variables globales et constantes ====
  
-Pour une liste complète des Variables globales et des constantes, consultez la page [[devel:environment|environnement]].+Pour une liste complète des variables globales et des constantes, consultez la page [[devel:environment|environnement]].
  
 ==== Indexation automatisée ==== ==== 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 ''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 [[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' ==== ==== classe 'dokuwiki' ====
Ligne 166: Ligne 166:
 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]]. 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 et il vous offre aussi un suivi de bug pour votre dépôt. +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. 
  
 ===== Crédits ===== ===== Crédits =====
fr/devel/templates.txt · Dernière modification : 2023-08-13 14:44 de Klap-in

Sauf mention contraire, le contenu de ce wiki est placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki