L'en-tête
C’est la partie du template commune à l’ensemble des pages chargée de produire le “haut” de la page HTML.
Il produit les éléments suivants :
- définition du type de document (DOCTYPE),
- ouverture du document (tag
<html>), - en-tête du document HTML (tag
<head>), - ouverture du corps du document (tag
<body>), - éléments HTML communs en haut de page (baniere etc.)
Implémentation
Dans le template, l’en-tête est dans le fichier header.tpl. il est utilisé par le script include/page_header.php lui-même appelé (include) par tous les scripts générant une page HTML. (
mettre en cohérence les deux noms de fichier)
L’appel de l’include doit se faire à la fin, juste avant de parser le template principal de la page afin de pouvoir utiliser toutes les variables intéressantes.
Exemple pour picture.php :
include(PHPWG_ROOT_PATH.'include/page_header.php'); $template->parse('picture'); include(PHPWG_ROOT_PATH.'include/page_tail.php');
Note : ce n’est pas respecté dans la plupart des cas dans PWG 1.6
Type de document
Le type de document (DOCTYPE) utilisé est HTML 4.01 strict :
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
Note : dans une discussion du forum yoDan expliquait l’intérêt de ce choix par rapport à XHTML 1.0 (en Anglais Improved HTML and layout)
Ouverture du document
L’en-tête est chargé d’ouvrir le tag <html> du document et de fixer la langue utilisée et la direction du texte selon les préférences de l’utilisateur.
En-tête HTML (''<head>'')
Déclaration du jeu de caractères
Le jeu de caractère est récupéré dans les informations de la langue utilisée et traité au niveau du protocole HTTP par la déclaration du Content-Type dans page_header.php, et au niveau du document HTML par un tag META http-equiv=”Content-Type”.
Note : Normalement le http-equiv devrait suffire, mais ce n’est pas le cas.
Le jeu de caractère utilisé actuellement (PWG 1.6) est iso8859-1 également appelé latin-1. Le jeu de caractère unicode (UTF8) se généralisant et permettant un meilleur support des caractères accentués et des caractères spéciaux, PWG doit basculer en UTF-8.
Impact sur les fichiers de langue, et probablement sur les informations IPTC récupérées des photos, ainsi que sur la base de donnée. : certains l’ont déjà réalisé sur leur galerie perso, retour d’expérience souhaité.
La migration des galleries existantes sera également un point à traiter.
Rafraichissement
Tag META http-equiv=”refresh” utilisé pour le mode diaporama.
Autre tags META
Les autres tags META de l’en-tête servent à donner de l’information sur le contenu du document HTML. Ils sont notamment utilisés par les robots et les moteurs de recherche.
Beaucoup de légendes circulent sur le rôle et l’utilité de ces tags. On se limitera à quelques uns qui semblent bien maîtrisés.
La valeur de ces tags sera différente suivant les pages :
| tag | Home | Category | Picture | autres pages |
|---|---|---|---|---|
| robots | “index, follow” | |||
| generator | “PhpWebGallery (aka PWG), see www.phpwebgallery.net” | |||
| author | : TBD | : TBD | Auteur | N/A |
| keywords | 20 mots clés les plus représentatifs de la galerie | 20 mots clés les plus représentatifs de la catégorie | mots clés de la photo | N/A |
| description | description de la galerie | description de la catégorie | description ed la photo | N/A |
Titre
Icone
[[En-tête 1]];-)
Liens de navigation
Ces liens sont utilisés par certains navigateurs (Opera, Mozilla, ...) pour construire une bare de navigation. Ces liens pourraient également être utiles aux robots et moteurs de recherche. Ils semblent que les liens “next” et “prev” soient également utiles pour le préchargement des pages dans Mozilla ( vérifier l’efficacité).
Ils sont déclarés dans un tag de la forme :
<link rel="___" title="___" href="___">
Ces liens sont utilisés dans les pages “picture” leur contenu est repris de la bare de navigation affichée au dessus de la photo. Les types de liens définis dans les spécifications HTML 4.01 sont complétés par des types usuels et l’usage peut être un peut différent de l’interprétation stricte de la norme.
| lien | destination | HTML 4.01 | Commentaire |
|---|---|---|---|
| start | x | La définition de “start” dans HTML 4.01 suggère un usage équivalent à “first”, Opéra et Mozilla l’utilisent pour le bouton “Home”. top est un synonyme défini en HTML 3.2 | |
| first | Première photo de la catégorie | ||
| prev | Photo précédente | x | Synonyme “previous” pour certains navigateurs (Opera et Mozilla acceptent les deux) |
| next | Photo suivante | x | |
| last | Dernière photo de la catégorie | ||
| up | Catégorie | ||
| search | Page de recherche | Défini en HTML 3.2 |
Note : les liens prev et up devraient être implémentés avec un attribut rev au lieu de rel car il s’agit de liens de retour. Opera et Mozilla ne semblent pas les accepter (testé avec les version respectives 8.54 et 1.73).
Note : Une implémentation complète de la navigation demanderait de définir la même chose pour les catégories comme cela a été demandé dans une fiche d’évolution ( : indiquer le numéro de fiche).
Feuilles de style
Scripts
Début du corps du document
Ouverture
Messages éventuels
Suite à un trop grand nombre d’impression des photos du blog Nous nous voyons dans l’obligation de bloquer certaines pages et d’inclure un copyright ainsi qu’un filigramme, veuillez nous excuser pour la gène occasionné