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:06] – fin d'actualisation page 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 50: Ligne 50:
     * ''style.ini'' -- voir [[fr:CSS#Style.ini]]     * ''style.ini'' -- voir [[fr:CSS#Style.ini]]
     * ''favicon.ico'' -- favicon (peut être écrasé en téléversant un autre à la racine ou dans l'espace de noms wiki quand  [[xref>tpl_favicon()|tpl_favicon()]] est utilisé)     * ''favicon.ico'' -- favicon (peut être écrasé en téléversant un autre à la racine ou dans l'espace de noms wiki quand  [[xref>tpl_favicon()|tpl_favicon()]] est utilisé)
-    * ''template.info.txt'' -- Un fichier texte avec [[devel:template info|information du thème]] **est requis !**+    * ''template.info.txt'' -- Un fichier texte avec [[fr:devel:template_info|information du thème]] **est requis !**
  
  
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 [[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.
  
-Uploads are not allowed on dokuwiki.org, so you need to host your template files somewhere else. We recommend to manage your source with a Revision Control System like [[git]]. If you do, it's easiest to use a public repository host like [[https://github.com|GitHub]] which also offers a bug tracker for your repository. +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. 
- +
-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]]. En effet, c'est le moyen le plus simple d'utiliser un dépôt public comme [[https://github.com|GitHub]] qui vous offre aussi 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