Quelques balises Dotclear2 : les balises "en ligne"

Etant en pleine création d'un blog Dotclear 2, j'ai du partir à la recherche de documentation à se sujet. Si il a été facile de trouver des présentations sur le mode de fonctionnement du mécanisme de thème comme par exemple cet excellent article sur le site dcTips(), je n'ai pas trouvé un descriptif complet des balises. Une seule option se présentait à moi : analyser des thèmes existants pour en comprendre le fonctionnement. Je vous présente ici les premières balises. Avant de commencer, lisez l'article de présentation de fonctionnement de DC2 mis en lien ci dessus.

Comme vous l'avez vu dans l'introduction, et dans le reste du site dcTips(), un thème DC2 se compose en fait de pages html dans lequel on insère des balises spécifiques. Voici les balises dites "en ligne", celles ci renvoient du texte pour l'intégrer à la page finale, soit sous forme de mots, de phrase ou même parfois de code XHTML. cette liste n'est pas fixée, je la compléterais au fur et à mesure de mes trouvailles.

Balises relatives au blog

{{tpl:BlogURL}} : Renvoie l'URL racine du blog, par exemple http://www.monsite.ext/blog/

{{tpl:BlogName encode_html="1"}} : Renvoie le titre du blog. La partie encore_html="1" permet d'obtenir une chaîne de caractère encodée en XHTML.

{{tpl:BlogDescription}} : Renvoie la description du blog.

{{tpl:BlogLanguage}} : renvoie l'abréviation de la langue principale du blog, pour notre part : fr.

{{tpl:lang Archives}} : renvoie la traduction dans la langue du blog du mot ou le la liste de mot contenu après tpl:lang, ici, renvera la tradution d'Archives. La traduction se fait toujours depuis l'anglais, par exemple, pour auteur nous devrions mettre {{tpl:lang Author}}. Tout l'intérêt est de pouvoir distribuer ses thèmes dans le monde entier sans passer par une phase de localisation.

{{tpl:BlogArchiveURL}} : renvoie l'URL de la page d'archive du blog, par exemple http://www.monsite.ext/index.php?archive

Balises relatives aux catégories

{{tpl:CategoryURL}} : renvoie l'URL de la catégorie en cours, s'utilise entre les balises de boucle[1]<tpl:Categories>...</tpl:Categories> (liste des catégories). La page pointée par ce lien utilisera comme gabarit le fichier categiry.html de votre theme. Exemple d'URL retournée : http://www.monsite.ext/blog/index.php?category/macategorie

{{tpl:CategoryTitle encode_html="1"}} : renvoie le nom de la catégorie en cous, s'utilise comme la balise ci-dessus. la partie encore_html="1" permet d'obtenir une chaîne de caractère encodée en XHTML.

Balises relatives aux billets

ces balises s'utilisent entre les balises de boucle <tpl:Entries>...</tpl:Entries>(liste des billets) ou dans le fichier post.html de votre thème (affichage d'un seul billet).

{{tpl:EntryID}} : renvoie le numéro d'identification du billet en cours

{{tpl:EntryURL}} : renvoie l'URL du billet en cours, s'utilise comme {{tpl:EntryID}}. Exemple d'URL retournée : http://www.monsite.ext/blog/blog/index.php?post/2007/09/06/Un-autre-Article

{{tpl:EntryAuthorLink}} : renvoie le nom de l'auteur du billet en cours ainsi qu'un lien vers son site perso, renvoie une chaine de caractère sous la forme : <a href="site_de_l_auteur">nom_de_l_auteur</a>.

{{tpl:EntryDate}} : renvoie la date à laquelle le billet en cours a été publié. Par défaut, la date renvoyée sera au format spécifiée dans les paramètres d'administration du blog, mais vous pouvez le personnaliser grâce à l'arguments format=, suivi du format que vous voulez employé. Le format utilisé par cet argument est le même que la fonction PHP strftime[2], si vous voulez obtenir par exemple Mardi, 11 septembre 2007 votre balise ressemblera alors à {{tpl:EntryDate format="%A, %e %Y %B"}}.

{{tpl:EntryTime}} : renvoie l'heure à laquelle le billet en cours a été publié.Tout comme la fonction précédente, vous pouvez personnaliser le format d'affichage de l'heure grâce à l'argument format= (voir ci-dessus).

{{tpl:EntryCategory encode_html="1"}} : renvoie la catégorie dans laquelle le billet en cours a été publiés.

{{tpl:EntryExcerpt}} : renvoie le chapeau du billet en cours.

{{tpl:EntryContent}} : renvoie le contenu (hors chapeau) du billet.

{{tpl:EntryTrackbackLink}} : donne l'URL qui permet a toute personne à faire un rétrolien vers l'article en cours de notre blog.

Balises relatives au commentaires

ces balises s'utilisent entre les balises de boucle <tpl:Comments>...</tpl:Comments>.

{{tpl:CommentID}} : renvoie l'identifiant du commentaire en cours.

{{tpl:CommentOrderNumber}} : renvoie le numéro d'ordre du commentaire en cours. Le numéro d'ordre représente l'ordre dans lequel le commentaire a été saisi pour le billet en cours, contrairement à l'identifiant qui représente le numéro du commentaire dans la base de données.

{{tpl:CommentDate}} : renvoie la date à laquelle le commentaire en cours a été saisi. Se personnalise aussi grâce à l'argument format= (cf {{tpl:EntryDate}}).

{{tpl:CommentTime}} : renvoie l'heure à laquelle le commentaire en cours a été saisi. Se personnalise aussi grâce à l'argument format= (cf {{tpl:EntryDate}}).

{{tpl:CommentAuthorLink}} : renvoie le nom de l'auteur du commentaire avec un lien vers son site internet s'il l'a renseigné. renvoie une chaine de caractère sous la forme <a href="site_de_l_auteur">nom_de_l_auteur</a>. S'utilise comme {{tpl:CommentID}}.

{{tpl:CommentContent}} : renvoie le contenu du commentaire. S'utilise comme {{tpl:CommentID}}.

Balises relatives au formulaire d'ajout de commentaire

Ces balises s'utilisent dans la page post.html (Affichage complet d'un billet), dans le formulaire d'ajout de commentaire.

{{tpl:CommentPreviewContent}} : renvoie l'aperçu du commentaire que l'utilisateur a envoyé. Si vous avez activé la syntaxe wiki dans les commentaires, cet aperçu sera alors mis en forme. S'utilise entre les balise de boucle <tpl:IfCommentPreview>...</tpl:IfCommentPreview>.

{{tpl:CommentPreviewName encode_html="1"}} : renvoie le nom ou pseudonyme que l'utilisateur a saisi dans le formulaire de commentaire.

{{tpl:CommentPreviewEmail encode_html="1"\} : renvoie l'adresse courriel que l'utilisateur a saisi dans le formulaire de commentaire.

{{tpl:CommentPreviewSite encode_html="1"}} : renvoie l'adresse URL que l'utilisateur a saisi dans le formulaire de commentaire.

{{tpl:CommentPreviewContent raw="1" encode_html="1"}} : renvoie le corps du commentaire "brut" que l'utilisateur a saisi dans le formulaire de commentaire.

Balises relatives au rétroliens

ces balises s'utilisent entre les balises de boucle <tpl:Pings>...</tpl:Pings>.

{{tpl:PingID}} : renvoie l'identifiant du rétrolien en cours.

{{tpl:PingOrderNumber}} : renvoie le numéro d'ordre du commentaire en cours. Le numéro d'ordre représente l'ordre dans lequel le rétrolien a été saisi pour le billet en cours, contrairement à l'identifiant qui représente le numéro dans la base de données.

{{tpl:PingDate}} : renvoie la date à laquelle le rétrolien en cours a été ajouté. Se personnalise aussi grâce à l'argument format= (cf {{tpl:EntryDate}}).

{{tpl:PingTime}} : renvoie l'heure à laquelle le rétrolien en cours a été ajouté. Se personnalise aussi grâce à l'argument format= (cf {{tpl:EntryDate}}).

\{tpl:PingBlogName encode_html="1"}} : revoie le nom du blog pointé par le rétrolien en cours.

{{tpl:PingAuthorURL}} : renvoie l'adresse URL de l'article pointé par le rétrolien.

{{tpl:PingTitle encode_html="1"}} : renvoie le titre de l'article pointé par le rétrolien.

{{tpl:PingContent}} : renvoie un résumé de l'article vers lequel le rétrolien est fait.

Notes

[1] nous verrons ces balises dans un prochain article.

[2] Voici le lien vers la page du manuel en ligne de cette fonction.

Ajouter un rétrolien

URL de rétrolien : http://www.xieme-art.org/trackback/44

Haut de page