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-06-19 19:19] – [Convertir des thèmes existants] Digitalin | fr:devel:templates [2018-05-12 20:44] – [Guide de démarrage] lien fr popularity 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 16: | Ligne 14: | ||
- 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 52: | Ligne 50: | ||
* '' | * '' | ||
* '' | * '' | ||
- | * '' | + | * '' |
- | la manipulation des paramètres de configuration est analogue aux [[devel: | + | La manipulation des paramètres de configuration est analogue aux [[devel: |
===== Fonctionnement interne détaillé ===== | ===== Fonctionnement interne détaillé ===== | ||
Ligne 65: | Ligne 63: | ||
* **'' | * **'' | ||
tpl_content(false); | tpl_content(false); | ||
- | </ | + | </ |
- | * **'' | + | * **'' |
**Exemple: | **Exemple: | ||
Ligne 82: | 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' | ||
Ligne 119: | Ligne 114: | ||
==== 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 ' | ==== classe ' | ||
Ligne 148: | Ligne 143: | ||
Voici quelques problèmes que les développeurs de thèmes rencontrent et comment ils peuvent être évités: | Voici quelques problèmes que les développeurs de thèmes rencontrent et comment ils peuvent être évités: | ||
- | ===Don't put JavaScript commands in the < | + | ===Ne mettez pas de commandes Javascript dans l'étiquette |
- | This includes '' | + | |
- | ===Turn off " | + | Ceci inclut '' |
- | Some template developers experience problems with DokuWiki cacheing | + | ===Désactiver " |
- | ===Use " | + | 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. |
- | You can accomplish this by pressing Ctrl+F5 or by holding down shift-control-alt and hitting the refresh button in your browser. | + | |
+ | === Utiliser | ||
- | This is not due to how DokuWiki works, but how current browsers cache files. Browsers cache stylesheets even when new versions are available, so you will need to do this. | + | 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 ===== | ||
- | If you created a template, please share it with the community. Just create a page named after your template in the [[: | ||
- | The page should contain all needed documentation on how to install and use the template. | + | 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' |
- | At the top of the template | + | La page mérite de contenir toute la documentation sur l' |
- | From version Ponder Stibbons on an automated update signalling is possible. For the update process to work properly it is necessary that the date “Last updated on” on the template's wiki page equals the date in the file [[devel:template_info|template.info.txt]] in the source tarball/zip file. If this is not the case the update will not take place or the “Update” signal persists. | + | En haut de la page de thème, quelques champs de métadonnées ont besoin d' |
- | 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. | + | 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 |
+ | Les téléversements (upload) ne sont pas autorisés sur dokuwiki.org, | ||
+ | ===== Crédits ===== | ||
- | ===== Mise à jour de la page en cours ===== | + | * Actualisation et traduction --- [[user> |
- | * --- [[user> | ||
- | |||
- | **phrases laissées de côté le temps de la mise à jour de la page** | ||
- | |||
- | * (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