Mise en page Agenda

De The Shifters Wiki
Sauter à la navigation Sauter à la recherche

Le guide ci-dessous décrit comment mettre à jour la page Agenda.

Transclusion et templates[modifier]

Le nouveau format de la table Agenda utilise de la transclusion pour permettre une saisie simplifiée de la table tout en garantissant un format de table standardisé. La transclusion consiste à utiliser des 'parties' standard de page pour écrire du texte ou du formatage. Dans le cadre de l'agenda, cela permet d'avoir un bloc d'information par ligne ou chaque élément est clairement identifié. Cela évite d'avoir à compter les séparateurs de la table et de saisir simplement une ligne à partir d'un format prédéfini.

La table Agenda se base sur deux templates (ou modèle, en français) qui sont des parties pré-formattées qui dépendent de paramètres d'appel dans leur affichage. Les deux templates sont celui de l'en-tête et de ligne. Le template d'en-tête doit juste être placé au démarrage du table d'Agenda et ne doit pas être modifié dans la page Agenda.

Le template de Ligne permet lui d'afficher une ligne unique à partir du block suivant :

{{Agenda_table_row
|Date=
|Type=
|Lieu=
|Titre=
|Organisateur=}}

En remplissant simplement ce block dans la page Agenda, sous le block d'en-tête ({{Agenda_table_header}}), cela créera une ligne dans le tableau d'Agenda. A noter qu'une valeur vide crée quand même la case, mais il faut cependant inclure la variable dans la liste pour avoir une case. Dans chacune des variables du template, on peut utilise tout format que l'on utiliserait normalement pour du texte Wiki et notamment les liens, les changements de police, les retours chariots etc... Il est important de noter qu'il est nécessaire de clore le tableau par le code |}. Sans cela, le texte écrit à la suite du tableau sera mal placé.

Voici un exemple d'utilisation du template :

{{Agenda_table_header}}
{{Agenda_table_row
|Date=19/01/19
|Type=Conférence, débat
|Lieu=ENS Paris,<br/> 24 rue Lhomond<br/>75005 Paris
|Titre=[https://www.sfpnet.fr/climat-energie-environnement-ou-va-t-on Climat, énergie, environnement : où va-t-on ?]
|Organisateur=}}
|}

Qui donnera une fois publié :

Date Type Lieu Titre Organisateur
19/01/19 Conférence, débat ENS Paris,
24 rue Lhomond
75005 Paris
Climat, énergie, environnement : où va-t-on ?

Derniers conseils[modifier]

Voici quelques conseil pour maintenir l'Agenda dans un format aussi clair que possible :

  • Eviter de mettre trop de texte en gras. On privilégie le gras pour les événements des Shifters.
  • Conserver le même format de date (dd/mm/yy)
  • Si le lieu contient une adresse (comme souvent), faire des retours chariots (<br/>) entre le lieu, la rue et le code postal ou la ville
  • Aussi souvent que possible, donner le lien des groupes et associations organisateurs
  • Le template fonctionne même sans faire de retour ligne (dans le code source Wiki) entre chaque variable, mais il est plus clair lorsqu'on applique cette règle
  • Les tables Agenda#Evénements à venir et Agenda#Evénements passés fonctionnent avec les mêmes templates, il suffit donc de transférer un bloc de template d'une table à l'autre pour transférer facilement la ligne correspondante.
  • Dans les titres, rester aussi court que possible mais signaler l'intervenant notamment lorsque c'est un membre du Shift ou un de ses collaborateurs réguliers