Table des matières
- The pagelayout -- Le template pagelayout.tpl
- The page head -- L'en-tête de page (page_head.tpl)
- Variables in pagelayout -- Variables du template pagelayout.tpl
The page head -- L'en-tête de page (page_head.tpl)
Date de publication: le lundi 28 mars 2011 à 22h18
Dernière modification: par Pascal BOYER le lundi 20 février 2012 à 18h49
versions 3.9, 3.10, 4.x
The standard design contains a page head template that can be used to automatically generate important tags that should be included in the head section of every HTML response. The output of the standard head template (/design/standard/template/page_head.tpl) can be broken down into the following group of tags:
Le design standard contient un template page_head.tpl utilisé pour générer automatiquement des balises importantes à inclure dans la section <head>...</head> de chaque page HTML. Le code généré par le template d'en-tête standard (situé dans design/standard/template/page_head.tpl) peut être décomposé en ce groupe de balises:
-
Title tag
La balise title
-
Meta tags
Les méta balises
-
Link tags
Les balises de liens
The following HTML dump shows an example of the output from the standard page head template.
Le code HTML proposé ci-dessous est un exemple de code produit par le template page_head.tpl standard:
<title>Current / Parent / Top - Site name</title> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> <meta http-equiv="Content-language" content="eng-GB" /> <meta name="author" content="eZ Systems" /> <meta name="copyright" content="eZ Systems" /> <meta name="description" content="Content Management System" /> <meta name="keywords" content="cms, publish, e-commerce, content management, development framework" /> <meta name="MSSmartTagsPreventParsing" content="TRUE" /> <meta name="generator" content="eZ Publish" /> <link rel="Home" href="/" title="Front page" /> <link rel="Index" href="/" /> <link rel="Top" href="/" title="Current / Parent / Top - Site name" /> <link rel="Search" href="/content/advancedsearch" title="Search Site name" /> <link rel="Shortcut icon" href="/design/standard/images/favicon.ico" type="image/x-icon" /> <link rel="Copyright" href="/ezinfo/copyright" /> <link rel="Author" href="/ezinfo/about" /> <link rel="Alternate" href="/layout/set/print/content/view/full/64" media="print" title="Printable version" />
Title / La balise <title>
The contents of the title tag is based on the location being viewed (the location within either the content node tree or the system itself) and the actual name of the site. The path to the element being viewed is reversed and thus the current element becomes the first component of the title. The components of the path are separated by slashes. When a node is viewed, the path elements will be the actual names of the objects which are encapsulated by the nodes that make up the path up to and including the target node. When a system function is being accessed (for example the login view of the user module: "/user/login"), the path will most likely be a reversed version of the module/view combination that was used. The name of the site is appended at the end of the path, separated by a dash. The site name can be configured using the "SiteName" directive in a configuration override for "site.ini".
Le contenu de la balise <title>, basé sur l’emplacement qui est affiché (l’emplacement soit dans l’arbre de nœuds de contenu soit dans le système lui-même) et sur le nom du site, contient le chemin inversé vers l’élément qui est affiché. Le non de l’élément affiché devient donc la première composante du titre et chaque composante du chemin est séparée de la prochaine par un slash ("/"). Lorsqu’un nœud est affiché, les éléments du chemin sont en fait les noms des objets encapsulés par les nœuds qui engendrent le chemin, le nœud cible inclus. Quand on accède à une fonction système (par exemple la vue login du module user: /user/login), le chemin ressemble le plus souvent à la version renversée de la combinaison module/vue utilisée. Le nom du site apparaît à la fin du chemin, séparé de ce qui le précède par un tiret. Le nom du site peut être configuré par le biais du paramètre SiteName présent dans l'un des fichiers de surcharge du fichier settings/site.ini
The example above demonstrates the output of the page head template when a node is being viewed. The name of the object encapsulating the node is "Current". The name of the other objects (encapsulated by the parent node and so on) are "Parent" and "Top". The name of the site is "Site name".
L’exemple ci-dessus montre le code source généré par le template page_head.tpl lorsqu’un nœud est affiché. Le nom de l’objet encapsulé dans le nœud est Current. Les noms des autres objets (encapsulés par les nœud parents et ainsi de suite) sont Parent et Top. Le nom du site est Site name.
Meta tags / Les balises <meta>
In addition to the actual information contained on a web page, the HTML of the page may also include information about the document itself. This is achieved by making use of so called meta tags. The information given by meta tags is usually not visible when the web page is viewed. However, the meta tags are used by the web browser and miscellaneous search engines that index and rank the contents of web pages. The standard page head template outputs the most commonly used meta tags. It can be broken down into three types of tags:
En plus des informations contenues dans une page web, le code HTML de la page peut également inclure des informations sur le document lui-même. Ces informations sont obtenues par l'emploi de ce que l’on appelle des méta balises. Les informations qu'elles renferment ne sont pas affichées par les navigateurs mais utilisées par ces derniers et par de nombreux moteurs de recherche qui indexent et classent le contenu des pages web. Le code généré par le template page_head.tpl standard contient les méta balises les plus couramment utilisées et que l'on peut regrouper en trois catégories:
-
HTTP-EQUIV meta tags
Les méta balises HTTP-EQUIV
-
Generic meta tags
Les méta balises génériques
-
Additional meta tags
D’autres méta balises
HTTP-EQUIV meta tags / Meta balises <meta http-equiv>
Meta tags with an HTTP-EQUIV attribute are equivalent to HTTP headers. These tags usually control the way a browser interprets the document. Tags using this form should have an equivalent effect when specified as an HTTP header. Some web servers automatically translate the contents of these tags to actual HTTP headers. The HTTP-EQUIV meta tags in the page head make sure that the browser (and also search engines) know which character set and language the document uses. The language and character set values are automatically set by eZ Publish based on the language and character set that the site uses.
Les méta balises comportant l’attribut <meta http-equiv> sont équivalentes aux en-têtes HTTP et contrôlent la façon dont les navigateurs interprètent les documents. Ces meta balises ont un effect équivalent aux en-têtes HTTP. et certains serveurs web convertissent d'ailleurs automatiquement le contenu de ces balises en véritables en-têtes HTTP. Les méta balises <meta http-equiv> du template page_head.tpl nous assurent que les navigateurs (et les moteurs de recherche) sauront quel jeu de caractères et quelle langue sont utilisés dans le document. La valeur de ces deux paramètres sont automatiquement définies par eZ Publish à partir de la langue et du jeu de caractères utilisés par le site.
Generic meta tags / Meta balises génériques
The generic meta tags make it possible to reveal meta information about the document itself. Although the specification of meta tags does not define a set of legal meta data properties, it is a common practice to include generic information such as the name of the author, description of the site, copyright notices, keywords, etc. By making use of the "MetaDataArray[...]" directive in a configuration override for "site.ini", the site administrator can set up a custom set of generic meta tags. eZ Publish will loop through and display the name and value of the specified tags. The example above shows the default meta tags that will be used if no custom meta tag configuration is present.
Les méta balises génériques donnent des méta informations sur document lui-même. Bien que les spécifications des méta balises ne définissent pas légalement un ensemble de propriétés de meta données, il est d’usage courant d’inclure les informations génériques suivantes: le nom de l’auteur, une description du site, un copyright, des mots clef etc... En utilisant le tableau MetaDataArray[...] d'une surcharge du fichier de configuration settings/site.ini, l’administrateur du site peut paramétrer un ensemble de méta balise génériques afin qu'eZ Publish en affiche les noms et valeurs. L’exemple ci-dessus présente les méta balises employées par défaut, c’est à dire sans aucune personnalisation ou configuration particulière du tableau MetaDataArray[...]
Additional meta tags / Meta balises supplémentaires
The last meta tags set by the standard page head template prevent the usage of smart tags and reveal the name of the software that was used to generate the output.
La dernière méta balise que l’on trouve dans le template page_head.tpl empêche l’utilisation de balises malicieuse et révèle le nom du logiciel utilisé pour générer la page web (en l’occurence eZ Publish).
Link tags / Les balises <link>
Link tags in the HTML head make it possible to relate the document to other documents. This is done by the way of REL and REV attributes. While REL links are used to establish relationships, REV links are used to establish reverse relationships. Some browsers make use of the link tags in order to produce a navigation bar that can be used to quickly navigate the site. The links tags generated by eZ Publish are specified in the "link.tpl" file within the templates directory of the standard design. The standard page head makes use of the "links.tpl" file. The default output of the standard page head template produces a basic set of links that can be used to navigate to different parts of the site. The following list shows the link tags that the page head generates:
Les balises <link> (lien) de l’en-tête HTML permettent de lier le document (la page web) à d’autres documents. On emploie pour cela les attributs rel et rev. Alors que les liens rel établissent une relation avec un document cible, les liens rev établissent une relation inverse avec un document cible. Certains navigateurs utilisent les balises <link> pour produire une barre de navigation permettant de naviguer rapidement sur le site. Les balises <link> générées par eZ Publish sont recensées dans le template link.tpl situé dans le répertoire design/standard/templates/ du design standard. L’en-tête standard d’une page utilise donc le template link.tpl dont le code généré par défaut produit un jeu de liens basiques pouvant être utilisés pour naviguer dans les différentes parties du site. Le tableau suivant recense les balises <link> générées par le template link.tpl:
| Lien | Description |
|---|---|
| Home |
The "Home" link points to the root/start of the site. It will always bring the user back to the front page (for example http://www.example.com). Le lien "Home" pointe vers la racine du site. Il renvoie toujours l’utilisateur vers la page d’accueil du site (par exemple http://www.example.com). |
| Index |
The "Index" link points to the root/start of the site. It will always bring the user back to the front page (for example http://www.example.com). Le lien "Index" pointe vers la racine du site. Il renvoie toujours l’utilisateur vers la page d’accueil du site (par exemple http://www.example.com). |
| Top |
The "Top" link points to the root/start of the site. It will always bring the user back to the front page (for example http://www.example.com). Le lien "Top" pointe vers la racine du site. Il renvoie toujours l’utilisateur vers la page d’accueil du site (par exemple http://www.example.com). |
| Search |
The "Search" link points to the "advanced search" view of the "content" module. It will bring the user to the advanced search interface (http://www.example.com/content/advancedsearch). Le lien "Search" pointe vers la vue advanced search (recherche avancée) du module content. Il renvoie l’utilisateur vers l’interface de recherche avancée (http://www.example.com/content/advancedsearch). |
| Shortcut icon |
The "Shortcut icon" defines the location of the favorite/shortcut icon. Most browsers will display this icon in front of URLs in the address field and in the bookmark list. The default shortcut icon is the double square white-orange eZ Systems logo. It can be easily replaced by putting a 16x16 pixel icon file (16 color BMP/Windows Icon Format) called "favicon.ico" in the images folder of a site design. Le lien "Shortcut icon" définit l’emplacement de l’icône de raccourci du site. La plupart des navigateurs affichent cet icône dans la barre d'URL à gauche de l'URL qui a été demandé. Il est également ajouté devant le nom des liens ajoutés à la liste des favoris (bookmarck). L’icône de raccourci par défaut est le double carré blanc et orange servant de logo à eZ Publish. Il peut être facilement remplacé par une autre icône de 16x16 pixels (au format BMP/Windows Icon Format 16 couleurs) qui devra se nommer favicon.ico et se situer dans le répertoire settings/standard/images/ |
| Copyright |
The "Copyright" link points to the "copyright" view of the "ezinfo" module. The default copyright page of eZ Publish will be displayed (http://www.example.com/ezinfo/copyright). Le lien "Copyright" pointe vers la vue copyright du module ezinfo. La page de copyright par défaut de eZ Publish sera alors affichée (http://www.example.com/ezinfo/copyright). |
| Author |
The "Author" link points to the "about" view of the "ezinfo" module. The default about page of eZ Publish will be displayed (http://www.example.com/ezinfo/about). Le lien "Author" pointe vers la vue about (à propos) du module ezinfo. La page "about" par défaut de eZ Publish sera alors affichée (http://www.example.com/ezinfo/about). |
| Alternate |
The "Alternate" link points to a alternate/printerfriendly version of the page. The printerfriendly version of a page is achieved by making use of the "set" view of the "layout" module. This technique makes it possible to use an alternative pagelayout which is usually stripped for everything (menus, logos, etc.) except the actual content that is being presented. Le lien "Alternate" pointe vers une version alternative/imprimable à la page affichée. La version imprimable d’une page est obtenue en utilisant la vue set du module layout. Cette technique permet d’obtenir une version alternative de la mise en page dénuée des éléments tels que les menus, les logos etc... Seul le contenu est conservé pour l’impression de la page. |
Link parameters / Les paramètres de la meta balise <link>
The links can be completely turned off by passing "enable_link=false()" when including the page head template:
Les liens peuvent être totalement inhibés par l'usage du paramètre enable_link=false() dans la syntaxe d'inclusion du template page_head.tpl:
{include uri='design:page_head.tpl' enable_link=false()}
The link to the alternate/print layout can be turned off by passing "enable_print=false()" when including the page head template:
Les liens de mise en page alternative ou d’impression peuvent être également inhibés par l'usage du paramètre enable_print=false() dans la syntaxe d'inclusion du template page_head.tpl:
{include uri='design:page_head.tpl' enable_print=false()}
Table des matières
- The pagelayout -- Le template pagelayout.tpl
- The page head -- L'en-tête de page (page_head.tpl)
- Variables in pagelayout -- Variables du template pagelayout.tpl