Thèmes

administrateurs (base)

Table des matières

Qu'est-ce qu'un thème?

Un thème est un ensemble de fichiers qui contrôle l'aspect des pages d'un PmWiki (couleurs, polices, bordures, etc.) et comment elles sont disposées. La meilleure manière de comprendre ce que fait un thème est d'essayer en utilisant les liens ci-dessous. Ils vont vers une page (PmWiki.Skins) sur le site pmwiki.org, et s'ouvrent dans une fenêtre indépendante.

Comme vous pouvez le voir, tous les thèmes affichent le même contenu de page, mais les autres éléments, comme le menu, l'en-tête, le pied de page, sont différents. Par exemple, différents thèmes peuvent afficher le menu sur la gauche, la droite, ou ne pas l'afficher. Quelques thèmes ont des liens vers des actions, d'autres non, en particulier si ils sont conçus pour profiter des fonctions de certaines recettes du cookbook.

Donc, un thème est juste un ensemble de fichiers qui définit comment les pages sont affichées dans PmWiki. Normalement les thèmes sont stockés dans des sous-répertoires de pub/skins/. Chaque thème comporte typiquement un ou plusieurs des fichiers suivants:

  • Un fichier de modèle, tels que skin.tmpl ou gemini.tmpl. Le modèle est écrit en HTML ou XHTML, et constitue le squelette du thème. Il contient des marqueurs spéciaux qui disent à PmWiki où insérer le contenu des pages.
  • Les fichiers CSS, qui contrôlent l'aspect du thème.
  • Les fichiers Image, pour décorer une page avec des images. Les formats courant d'image sont .jpg, .png, et .gif.
  • Les fichiers PHP, tels que skin.php. Ceci permet au thème d'avoir des possibilités de personnalisation étendues que les possibilité du HTML et des CSS ne permettent pas.
  • Les fichiers de Documentation, généralement du genre readme.txt ou skinname.txt. Ceci vous informe à propos des particularités d'installation ou des fonctionnalités spéciales du thème.

Où récupérer un thème?

Les thèmes sont disponibles dans la collection Skins:Skins. Les thèmes de cette collection ont été élaborés par des administrateurs PmWiki pour être utilisés par tous, et possèdent leur propres particularités de personnalisation. Quand vous avez trouvé un thème qui vous plaît, suivez le lien pour télécharger les fichiers.

Comment utiliser un thème?

La plupart des ensembles de thème sont des fichiers .zip, .tgz, ou .tar.gz files. Vous devez arriver à décompresser ces fichiers avec la plupart des logiciels d'archivage.

  1. Décomprimez le thème dans pub/skins/ dans votre répertoire pmwiki. La plupart des thèmes bien conçus vont créer un sous-répertoire dans pub/skins/ portant le nom du thème.
    • Si le thème ne crée pas lui-même un répertoire, créez le vous-même et déplacez les fichiers du thème vers celui-ci.
  2. Ouvrez votre fichier local/config.php, et ajoutez un ligne du style

    $Skin = 'mon-thème-favori';

    où 'mon-thème-favori' est le nom du répertoire de thème.

Rechargez une page de votre wiki dans votre navigateur, et vous devriez voir la différence.

Si vous souhaitez laisser vos visiteurs choisir leur thème parmi une sélection que vous avez installé, allez voir le module Skins:SkinChange (en anglais). (C'est ce que nous utilisons pour la démonstration ci-dessus.)

Il y a nombre de possibilités pour personnaliser l'apparence d'un thème, y compris l'ajout de déclarations dans le fichier /local/config.php compatibles avec le thème choisi; ajouter des fichiers css dans /pub/css/, tels que local.css (pour tout votre wiki) et MonGroupe.css (pour MonGroupe); et aussi l'édition directe des fichiers du thème. Si le thème est mis à jour régulièrement, vous devez éviter d'éditer directement les fichiers dans le répertoire du thème. Vérifiez la page du thème dans le Cookbook pour avoir des instructions particulières.

Comment créer un thème?

La meilleure méthode pour créer votre premier thème est de modifier une copie du thème par défaut de PmWiki.

  1. Faites une copie du répertoire pub/skins/pmwiki et renommez la avec le nom choisi pour votre thème.
  2. Dans votre fichier local/config.php, définissez le nom de votre thème dans la variable $Skin.
  3. Modifiez le modèle et les fichiers CSS à votre convenance.
  4. Testez votre nouveau thème.
  5. Répétez les étapes 3 et 4 jusqu'à ce que vous ayez trouvé votre bonheur.

La raison pour laquelle il est recommandé de commencer avec le thème par défaut de PmWiki est qu'il s'agit d'un thème relativement simple, beaucoup plus que ceux que vous trouverez dans Skins:Skins. Le point de départ est le fichier modèle (.tmpl), qui fournit la présentation générale de la page. Dans ce modèle on trouve les substitutions et les directives qui permettent à PmWiki d'insérer les données appropriées pour l'affichage de la page courante. SkinTemplates décrit le format et les directives plus en détail.

Ce n'est pas l'objet de cette page de décrire comment écrire en HTML (hypertext markup language), XHTML (extensible HTML, qui est plus récent) ou CSS (cascading style sheets), mais il existe nombre de bons tutoriels sur Internet pour ces trois sujets. Avertissement: si vous tombez sur un tutoriel HTML qui explique comment utiliser les balises <font> ou <blink> ou des gifs d'espacement, ce tutoriel a au moins cinq ans de retard, aussi cherchez en un autre.

Vous devriez tester votre thème avec un ensemble de navigateurs -- idéalement autant que vous pourrez -- mais au minimum vous devriez tester avec Internet Explorer 6 et Firefox ou Mozilla, car ce sont les navigateurs les plus courants, et ils ont chacun leurs problèmes. N'oubliez pas de redimensionner vos fenêtres et de changer la taille de la police durant vos tests.

Les outils dont vous avez besoin

Il y a de bon exemples de programmes disponibles gratuitement.

Les éditeurs HTML et CSS. Il y a deux types d'éditeurs: graphiques (WYSIWYG, "what you see is what you get") et des éditeurs manuels (pour programmeurs). Les éditeurs graphiques sont moins intimidants pour les novices mais vous apprendrez moins que si vous étudiez votre code en détail en utilisant un éditeur 'manuel'. Quelque soit celui que vous choisirez,prenez un éditeur qui possède un système de coloration de syntaxe pour le code, car il vous aidera à identifier les erreurs. Aussi, les prévisualisations ne sont pas d'une grande aide quand on écrit un thème PmWiki, car PmWiki effectue des tâches que le prévisualiseur ne fait pas, tels que la substitution des variables et l'insertion du contenu du menu 'sidebar'.

Tester le wiki. Vous ne voulez pas fracasser votre thème lorsque des visiteurs arrivent sur votre site. C'est une bonne idée de créer un wiki de test, soit sur le serveur, soit localement sur votre machine. Les propriétaires d'ordinateurs Linux ou MacOS devraient déjà avoir des serveurs web et PHP déjà opérationnels sur leurs machines, ce qui ne sera généralement pas le cas pour les utilisateurs de Windows. Si celà vous concerne, vous devriez aller voir la recette Cookbook:Standalone (en anglais), qui permet de lancer PmWiki sans installer un serveur web compliqué. Ou alors vous pouvez installer des ensembles complets qui comprennent un serveur web, le PHP et d'autres composants (par ex. MySQL), préconfigurés pour fonctionner ensemble. Essayez de trouver une ensemble qui possède les mêmes versions que celle de votre serveur, ceci devrait limiter les problèmes lors de la mise en ligne.

FTP client pour transférer les fichiers vers votre serveur web. Vous en avez probablement déjà un.

Palette de couleurs. Votre éditeur en possède probablement déjà une, sinon vous pouvez utiliser un programme autonome. Très utile pour créer et sauvegarder des palettes de couleur.

Voir aussi


<< Personnalisation par groupe | Index de la documentation | Modèles de thèmes >>


Traduction de PmWiki.Skins Page originale sur PmWikiFr.Skins - Référencé par
Dernières modifications:
PmWikiFr.Skins: 15 juillet 2013 à 16h52
PmWiki.Skins: 14 octobre 2023 à 03h50