Modèle:Document

Documentation

Cette documentation est incluse dans la sous-page de documentation (voir | modifier | historique). Si vous voulez améliorer ce modèle et si celui-ci est protégé, demandez à un administrateur de vous aider.

Modèle pour créer dans la page d’un auteur une liste triable de références. Utilise les modèles {{liste documents début}} et {{Liste documents fin}}.

Présentation 

Le but de ce modèle est de pouvoir faire une liste triable correctement mise en forme, en indiquant au minimum un titre pour chaque ligne de la liste.

Chaque ligne de la liste est pour le moment formatée ainsi, avec, entre crochets, les données facultatives :

[Date :] Titre [Index], [avancement], [titre original], [auteur], [lien vers fac-similé]

Syntaxe de base 

{{liste documents début}}

{{document| date= |titre= | avancement=}}

{{document| date= |titre= | avancement=}}

[…]

{{liste documents fin}}

Choix du type de liste

La liste à mettre en forme peut être une liste de textes d’un auteur francophone, une liste d’œuvres traduites ou une liste de textes se rapportant à l’auteur.

Dans l’ordre : vo|auteur|scan, ou vo|scan, ou auteur|scan.

Important : l’ajout de plus d’une colonne oblige à mentionner les paramètres vo, auteur ou scan, même en les laissant vide, ceci pour conserver l’alignement des données de la liste.

• liste simple, date + titre, livre ou éditions, utiliser : {{liste documents début}}
• liste avec les titres originaux, utiliser : {{liste documents début|vo}}
• liste bibliographique sur un auteur, utiliser : {{liste documents début|auteur}}
• liste bibliographique sur un auteur avec les titres originaux, utiliser : {{liste documents début|vo|auteur}}
• liste simple, date + titre, livre ou éditions, avec liens externes (uniquement Gallica, Internet Archive ou Google Livres) vers un fac-similé : {{liste documents début|scan}}

Un paramètre divers= permet en outre de définir sa propre colonne.

Indiquer le type des documents

Le nom de la colonne des œuvres est par défaut Titre et éditions. Pour changer ce nom, par exemple pour faire une liste d’articles :

{{liste documents début|type=Articles}}

Pour supprimer le titre, en ne laissant que le bouton de tri :

{{liste documents début|type=}}

Paramètres

1^re colonne (optionnelle) 

• Date/dates (lien automatique vers la catégorie) :
  • date= : Date de publication unique, sous la forme d’un lien vers la catégorie quand elle existe.
  • dates= : Dates de début et de fin de publication, exemple : dates=1909/1911
• Autre : on peut remplacer la date par n’importe quoi, par exemple —, en écrivant date=— (attention toutefois à ne pas remplacer la date par un texte trop encombrant qui risque de modifier l’alignement des colonnes).
• Rien : ne pas utiliser le paramètre, ou le laisser vide.

2^ème colonne 

• titre= : Titre en français. Le titre ne devient pas automatiquement un lien, il faut écrire : titre=[[un titre]].
  • titre alpha= : Classement alphabétique du titre en français (si nécessaire)
• livre = : lien vers l’index sans le préfixe Livre.
• éditions= : utilisable à la place du paramètre titre, pour créer un lien vers une page contenant une liste d’éditions, suivi de [+] pour afficher cette liste directement dans la page auteur.
• avancement= : Avancement, de 0 à 5. 0 équivaut à {{0/4}}, et 5 équivaut à {{validé}}.

3^ème, 4^ème et/ou 5^ème colonnes (optionnelles) 

• vo= Titre original
  • vo alpha= Classement alphabétique du titre original (si nécessaire).
• auteur=
  • auteur alpha=
• scan =

Comment utiliser le tri

Les boutons de tri permettent de consulter la liste des textes par ordre chronologique et antéchronologique, par ordre alphabétique des titres, et par ordre alphabétique des auteurs et des titres originaux quand ces colonnes existent.

Les tris se font directement sur les paramètres date, titre, auteur et vo. Quand le paramètre livre est utilisé, le tri se fait également d’après le paramètre titre.

Pour que le tri fonctionne bien, il faut veiller à indiquer pour chaque ligne une date et un titre, et pour éviter de mélanger les éditions, on pourra utiliser le paramètre éditions plutôt que de faire la liste dans la page auteur (ce paramètre n’est pour le moment pas en fonction par défaut). Dans le cas où la fonction de tri est inutilisable, on pourra la désactiver (ce paramètre reste à ajouter).

Si un titre commence par un article, il sera trié d’après cet article. Pour qu’il soit trié correctement (dans le cas des articles le, la, les), il faut utiliser le paramètre titre alpha.

Exemples 

Utilisation minimale avec le titre seul 

{{document|titre=[[Le Héros]]}}

Pour indiquer seulement une date et un titre 

{{document|date=1637|titre=[[Le Héros]]}}

Index 

{{document|date=1838|livre=Mémoires de l’Académie des sciences, Tome 15.djvu|titre=Éloge historique de Jean-Antoine Chaptal}}

ou, pour afficher un autre titre que le lien :

{{document|date=1882|livre=Nietzsche - Ainsi parlait Zarathoustra (trad. Albert, 1903).djvu|titre=[[Ainsi parlait Zarathoustra|traduction H. Albert de 1901]]}}

Pour le classement alphabétique correct d’une œuvre dans la liste 

{{document|date=1637|titre=[[Le Héros]]|titre alpha=Héros}}

Pour ajouter le titre original 

{{document|date=1637|titre=[[Le Héros]]|titre alpha=Héros|vo=''El Héroe''}}

Pour ajouter l’avancement 

{{document|date=1637|avancement=2|titre=[[Le Héros]]|titre alpha=Héros|vo=''El Héroe''}}

Voir exemple complet 

Auteur:Baltasar Gracián