~/tilder/, fr/, Documentation/, Référence/, La référence Markdown/, Entrées

entries - les titres ###, leur ligne meta, leur corps et leurs marqueurs

Une entrée est un titre ### dans une section : une conférence d'un programme, une personne d'une liste, une carte d'une grille. Elle peut porter une ligne meta de dates, de lieux et d'étiquettes, et un corps de blocs en retrait sous elle. Les cartes qu'une collection écrit dans une liste sont aussi des entrées, bâties de la même façon. Chaque exemple ci-dessous est suivi de l'entrée qu'il produit.

Un titre ### ouvre une entrée dans la section en cours. Les blocs de son corps sont en retrait de deux espaces ; le premier bloc qui n'est pas en retrait termine l'entrée, et la page revient à la section.

### Rencontre de printemps

  Trois conférences et un atelier, ouverts à tous.

De retour dans la section, après l'entrée.

Voici le rendu de cette source.

De retour dans la section, après l'entrée.

Le titre peut contenir du balisage en ligne, un lien par exemple. Une entrée n'a pas d'identifiant à elle, et un {#id} sur son titre est ignoré : pour y mener, faites un lien vers sa section. Les entrées ne s'imbriquent pas : un titre #### n'en est pas une.

Dans le miroir en texte, le titre est imprimé au retrait de la section et le corps quatre espaces plus loin.

Une liste juste après le titre, en retrait comme le corps, est la ligne meta de l'entrée et non une liste. Chaque élément est de l'une de ces trois sortes :

### Rencontre d'automne

  - 2026-10-17 | samedi 17 octobre 2026
  - Grande salle, 1 rue de l'Exemple, Exempleville
  - `conférences`

  Deux conférences, puis des questions.

Voici le rendu de cette source.

Sur la page web, les éléments tiennent sur une ligne, séparés par des points. La partie avant | va telle quelle dans l'attribut datetime : écrivez la date sous la forme AAAA-MM-JJ. Les éléments de la ligne meta sont du texte brut : un lien ou du gras s'y affiche tel qu'il est écrit. Seule la première étiquette passe dans le miroir en texte.

Pour un élément d'une collection, la construction écrit elle-même cette ligne, à partir de l'en-tête (types de contenu).

Comme une section, le titre d'une entrée peut se terminer par des marqueurs entre accolades. Chacun devient une classe de l'entrée, entry--<marqueur> ; trois d'entre eux ont un sens pour tilder et pour tout thème.

### Rencontre d'hiver {next}

  - `prochain`

### Permanence {full}

  - `complet`

### [Types de contenu](docs/content-types) {link}

  Les collections, et les types qui leur donnent forme.

Voici le rendu de cette source.

{next} et {full} ne changent que l'étiquette ; la carte elle-même ressemble à toutes les autres. La construction les pose sur les cartes qu'elle écrit : {next} sur le premier événement d'une liste {upcoming} et sur l'unique carte de {next-event}, {full} sur un membre dont l'en-tête dit full: yes. Elle pose {link} sur les cartes des articles et des événements d'une liste, dont le titre mène à la page de l'élément ; la dernière entrée ci-dessus est une telle carte, cliquable partout. Dans une section marquée {grid}, les entrées sont disposées en cartes côte à côte (sections).

Le thème de ce site met en forme un marqueur de plus, {example} : le cadre pointillé marqué Rendu autour de chaque exemple vivant de la page des blocs.

### Rendu {example}

  | un exemple | vivant |
  |---|---|
  | d'un | tableau |

Tout bloc peut entrer dans le corps d'une entrée : paragraphes, listes, encadrés, code, tableaux, images. Chacun est en retrait de deux espaces, ses lignes suivantes comprises, et des lignes vides les séparent comme partout ailleurs.

### Version 2.0

  - `version`

  Une nouvelle mise en page du programme.

  > [!INFO]
  > Lisez les notes avant de mettre à jour.

  - une liste après le premier bloc est une liste
  - et non une ligne meta

Voici le rendu de cette source.

Une liste n'est la ligne meta que si elle vient en premier, juste après le titre. Un corps qui doit s'ouvrir sur une liste commence par un autre bloc avant elle : une phrase, ou un commentaire, que personne ne voit.

• les sections
• les blocs
• les types de contenu, pour les cartes d'une liste
• les classes