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édentes Révision précédente
Prochaine révision
Révision précédente
fr:devel:templates [2016-07-23 14:19]
Digitalin [Publier un thème sur dokuwiki.org]
fr:devel:templates [2018-05-12 21:04] (Version actuelle)
Digitalin [Fonctions] lien xref
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.
  
-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.1469276382.txt.gz · Dernière modification: 2016-07-23 14:19 par Digitalin