Je me suis récemment embarqué sur le grand voyage de Wordpress et j'ai lu la documentation de Wordpress pour écrire un thème. Une chose que je suis tombé sur here était que le fichier style.css
doit contenir un en-tête spécifique afin d'être utilisé par le moteur Wordpress. Ils donnent un bref exemple, mais je n'ai pas été en mesure d'obtenir une description formelle de ce qui doit être dans la partie style.css
en-tête. Cela existe-t-il sur le site Wordpress? Si ce n'est pas le cas, pourrions-nous le décrire ici?La syntaxe de l'élément de modèle Wordpress style.css est-elle disponible partout?
Répondre
Basé sur http://codex.wordpress.org/Theme_Development:
Voici un exemple des premières lignes de la feuille de style, appelé l'en-tête de feuille de style, pour le thème « Rose »:
/*
Theme Name: Rose
Theme URI: the-theme's-homepage
Description: a-brief-description
Author: your-name
Author URI: your-URI
Template: use-this-to-define-a-parent-theme--optional
Version: a-number--optional
Tags: a-comma-delimited-list--optional
.
General comments/License Statement if any.
.
*/
Le thème le plus simple comprend seulement un fichier style.css, plus des images, le cas échéant. Pour créer un tel thème, vous devez spécifier un ensemble de modèles à hériter pour utilisation avec le thème en modifiant la ligne Modèle: dans les commentaires d'en-tête style.css. Par exemple, si vous vouliez que le thème "Rose" hérite des modèles d'un autre thème appelé "test", vous incluez Template: test dans les commentaires au début de style.css de Rose. Maintenant "test" est le thème parent pour "Rose", qui consiste encore seulement en un fichier style.css et les images concomitantes, tous situés dans le répertoire wp-content/themes/Rose. (Notez que la spécification d'un thème parent héritera de tous les fichiers modèles de ce thème - ce qui signifie que les fichiers modèles du répertoire du thème enfant seront ignorés.)
Les lignes d'en-tête de commentaire de style.css sont obligatoires pour WordPress être capable d'identifier un thème et de l'afficher dans le panneau d'administration sous Conception> Thèmes en tant qu'option Thème disponible avec tous les autres thèmes installés. Les champs URI de nom de thème, de version, d'auteur et d'auteur sont analysés par WordPress et utilisés pour afficher ces données dans la zone Thème courant sur la ligne supérieure des informations de thème actuelles, où le nom de l'auteur est lié à l'auteur. URI. Les champs Description et Balise sont analysés et affichés dans le corps des informations du thème, et si le thème a un thème parent, ces informations sont également placées dans le corps de l'information. Dans la section Thèmes disponibles, seuls les champs Nom du thème, Description et Balises sont utilisés.
Aucun de ces champs n'a de restrictions - tous sont analysés en tant que chaînes. De plus, aucun d'entre eux n'est requis dans le code, mais en pratique les champs non marqués comme optionnels dans la liste ci-dessus sont tous utilisés pour fournir des informations contextuelles à l'administrateur WordPress et devraient être inclus pour tous les thèmes.
Vous pensez probablement à ce sujet:
/*
THEME NAME: Parallax
THEME URI: http://parallaxdenigrate.net
VERSION: .1
AUTHOR: Martin Jacobsen
AUTHOR URI: http://martinjacobsen.no
*/
Si je ne suis pas loin, Wordpress utilise cette information pour afficher dans la boîte de dialogue « Activer la conception » dans le backend admin.
Je pense que toutes les réponses à ce jour sont valides (évidemment, j'ai lié moi-même les docs). Ce que je cherche est une description plus formelle, c'est-à-dire Insensible à la casse, Quel est l'élément du modèle, Comment votre numéro de version peut-il être libre (Oracle style x.x.x.x.x?). Merci quand même! –
aha, cela fait un peu plus de sens. C'est à peu près autant de texte libre que je sache, pas d'exigences du tout. En fait, au moins en 2.7 (tronc saignant) même si ce bloc manque, le style est toujours disponible. Je documenterai plus quand j'aurai quelques minutes. – cori