Redox

Cet article a pour but d’expliquer les éléments composant la structure du design de TextPattern ainsi que leurs relations mutuelles. Bien appréhender les concepts et l’objet de TextPattern apportera de l’eau au moulin de la joie et de la satisfaction.

La grande idée : 2 hiérarchies différentes

Ceci est plutôt évident dès le début : TextPattern  organise les sites selon deux structures séparées : le Contenu et la Présentation.

Le schéma ci-dessous vous montre exactement à quoi servent ces deux hiérarchies  et comment leurs fonctions sont reliées entre elles.

Rappelez-vous ce principe de base : le Contenu gère l’information, la Présentation gère les différentes manières de visualiser cette information. Notez également que les Images et les Liens sont des blocs d’information séparés qui peuvent être appelés depuis chaque article, page ou module.

A propos, si vous souhaitez entrer plus dans le détail des liens relationnels, mattmos a publié un schéma très détaillé.

Enfin, voici le sens précis de tous ces termes dans TextPattern :

Les termes suivants sont issus de la dernière traduction française de TextPattern.

• Catégorie : une méthode d’organisation des articles selon la nature de leur contenu (et non pas leur emplacement dans la structure de navigation)
• Catégorie : Article : Plus généralement, un bloc unique de contenu. TextPattern attribue des propriétés à ces blocs telles le titre, l’auteur, la date de publication, la catégorie, etc.
• Section : c’est comme les sections d’un journal. Elles sont accessibles dans votre butineur par l’url: http://www.votreblog.com/apropos vous amène à la section apropos de votreblog.com. La section elle-même ne contient que très peu d’informations, à part quel modèle de page et quel style utiliser. La page d’accueil est une section interne, distincte qui n’apparaît pas dans la liste des sections.
• Section : Style : les sections renvoient à des styles, qui contiennent des données CSS détaillant la police de caractère, le positionnement des éléments, etc. Les styles sont liés aux sections, pas aux pages ni aux catégories.
• Section : Page : Ceci fournit l’ensemble de la structure XHTML pour les pages d’une section. Les pages font appel à des modules ainsi qu’à des étiquettes TextPattern dites étiquettes de pages pour accéder aux articles ou à tout autre contenu (liens, images).
• Section : Page : Module : Un module est un morceau bien défini et réutilisable de contenu, qui peut contenir du texte, des marques XHTML et des étiquettes TextPattern dites ”étiquettes de modules”. Les modules peuvent aussi faire référence à d’autres modules.

Une petite remarque sur le code

Comme noté ci-dessus, différentes parties de TextPattern peuvent utiliser le code de TextPattern, appelées étiquettes. Il y a deux types principaux d’étiquettes : les étiquettes de pages et les étiquettes de modules.

Pedro Palazon donne assez une bonne explication des types de code de TextPattern dans son Manuel des étiquettes de TextPattern.

Sur les Catégories et les Sections

Il semblerait que la plupart des utilisateurs de TextPattern confondent les rôles des catégories et des sections, l’erreur courante étant d’utiliser les catégories comme des structures de navigation. Ces individus vont avoir du mal à comprendre à quoi servent les sections.

Les sections délimitent les articles en segments distincts, totalement séparés les uns des autres. Une catégorie n’est rien de plus qu’une étiquette à rajouter à un article, servant à trier l’information au sein d’une section.

Au sein d’une section, vous pouvez afficher :

• soit tous les articles de cette section,
• soit seulement les articles de certaines catégories, mais toujours seulement ceux appartenant à cette section.

(Exception : avec la nouvelle étiquette <txp:article_custom /> (qui, au fait, est une étiquette de page), vous pourrez forcer TextPattern à afficher les articles de plusieurs sections. Par contre, l’étiquette normale <txp:article /> n’affichera que les articles de la section concernée.)

Ceci devrait aussi expliquer pourquoi TextPattern ne fait pas de pagination entre les sections.

Les catégories sont universelles et ne sont aucunement liées aux sections. Si vous avez une catégorie “Apple” vous pouvez l’attribuer à n’importe quel article, quelle que soit la section dans laquelle il se trouve. Là encore, c’est possible parce que les catégories et les sections. appartiennent à deux hiérarchies différentes.

L’usage tant des catégories que des sections est optionnel. Si vous avez choisi de ne pas utiliser de sections (dans la partie Admin), tous vos articles seront affichés en utilisant la même page (“default”). Si vous choisissez de ne pas utiliser de catégories, alors vous n’aurez simplement pas la possibilité de mettre ces étiquettes dans vos articles.

La section “Page d’accueil”

La page d’accueil est en fait une section à elle toute seule. Elle possède sa propre page (“default”) et son propre style (“default”). Toutefois, vous ne pourrez pas assigner un article à la page d’accueil comme vous le pourriez pour les autres sections. La page d’accueil n’a pas ses propres articles, elle affiche seulement les articles des autres sections qui ont coché l’option “Afficher sur la page d’accueil ?”.

Permaliens ou liens permanents

Les liens permanents sont utilisés comme des références permanentes à un article spécifique. Quand vous cliquez sur le lien permanent d’un article, vous voyez l’article s’afficher, employant la page de la section à laquelle il appartient. C’est parce que, si votre site utilise les sections, le lien permanent inclut la section dans l’URL. Notez bien que l’on accède aux sections par l’URL.

Voici un exemple de lien permanent : http://www.etiennedepaulis.com/blog/30/flower-power. en le regardant on remarque qu’il se réfère à un article dans la section blog, avec un titre qui serait quelque chose comme Flower Power (TextPattern mutile les titres d’articles dans les liens permanents). Si vous entriez cette adresse dans votre navigateur, TextPattern vous afficherait l’article en utilisant le modèle assigné à la section blog.

Parce que TextPattern dépend de l’URL pour savoir quel modèle utiliser pour un article, on peut effectivement “l’arnaquer” pour lui faire utiliser la page d’une autre section. Par exemple, http://www.etiennedepaulis.com/portfolio/30/flower-power  afficherait l’article en utilisant la page de la section portfolio bien que l’article soit stocké dans une autre section. C’est d’une utilité douteuse, mais cela vous montre bien comment TextPattern utilise l’URL pour afficher le contenu.

Crédits et remerciements

Cet article est traduit de l’anglais, d’après Textpattern Semantics de Joel Dueck avec son aimable autorisation.
Je tiens à remercier la femme de Damelon pour avoir relu et revu cette traduction.
Si vous avez des questions n’hésitez pas à vous rendre dans ce topic du forum de TextPattern.

Ce billet a été posté le 16 juillet 2005 à 8:33 dans la rubrique Tout et rien. Vous pouvez suivre les réponses à ce billet au travers du flux RSS 2.0. Vous pouvez aussi effectuer un trackback depuis votre site.