Modèle:Matisk/bac à sable/documentation

Description: Modèle pour créer dans la page d’un auteur une liste de titres triable sur une ou plusieurs colonnes. Il utilise les modèles {{Liste documents début}} et {{Liste documents fin}}.

Syntaxes: {{liste documents début}}; {{document|date=|titre=|livre=|avancement=}}; {{liste documents fin}}

ou avec la syntaxe complète :

{{liste documents début}}

{{document|date=|dates=|titre=|livre=|éditions=|avancement=|vo=|auteur=|scan=}}

{{liste documents fin}}

Arguments :

Date de la 1^re colonne (optionnel) :

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.

Chaque date aura un lien vers la catégorie. On peut remplacer la date par n’importe quoi, par exemple le tiret quadratin « — », en écrivant date=— (attention toutefois à ne pas remplacer la date par un texte trop encombrant qui risque de modifier l’alignement des colonnes).

Sans colonne Date : omettre l’argument ou argument laissé vide.

Titre de la 2^e colonne :

titre= : titre en français. Le titre ne devient pas automatiquement un lien, pour ce faire : titre=[[un titre]].
- titre alpha= : classement alphabétique du titre en français (permet de classer sans l’article du titre, à ajouter si nécessaire).
livre= : icône d’un livre ajoutée après le titre, il donne accès à la page d’index du livre (au mode Page de relecture et des fac-similés). Placer la valeur sans le préfixe Livre:.
éditions= : utilisable à la place de l’argument 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= : affiche l’icône de degré d’avancement de relecture de 0 à 5. 0 équivaut : , 1 : , 2 : , 3 : , 4 : et 5 : .

Des 3^e, 4^e et/ou 5^e (optionnels) :

vo= : titre original.
vo alpha= : classement alphabétique du titre original (permet de classer sans l’article de la vo, à ajouter si nécessaire).
auteur= : nom de l’auteur.
- auteur alpha= : classement alphabétique (permet de classer sans l’article de l’auteur, à ajouter si nécessaire).
scan = : NON DOCUMENTÉ

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.

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.

liste simple date + titre, livre ou éditions : {{liste documents début}}
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}}
liste avec les titres originaux : {{liste documents début|vo}}
liste bibliographique sur un auteur : {{liste documents début|auteur}}
liste bibliographique sur un auteur avec les titres originaux : {{liste documents début|vo|auteur}}

L’argument divers= permet en outre de définir sa propre colonne. -> INCOMPLET, À COMPLÉTER.

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

Libellé des têtières: 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}}; {{liste documents début|vo=Version originale}} (au lieu de Titre originale)

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

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

Exemples

Titre seul avec changement de la têtière :

{{liste documents début|type=Œuvres}}
{{document|titre=[[Le Héros]]}}
{{document|titre=Art et figures de l’esprit}}
{{document|titre=[[L’Homme de cour]]}}
{{liste documents fin}}

	Œuvres
	Le Héros
	Art et figures de l’esprit
	L’Homme de cour

Une date et un titre :

{{liste documents début|titre}}
{{document|date=1637|titre=[[Le Héros]]}}
{{document|date=1648|titre=Art et figures de l’esprit}}
{{document|date=1647|titre=[[L’Homme de cour]]}}
{{liste documents fin}}

	Titre et éditions
1637 :	Le Héros
1648 :	Art et figures de l’esprit
1647 :	L’Homme de cour

Icône de l’index page :

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

	Titre et éditions
1838 :	Éloge historique de Jean-Antoine Chaptal

Autre titre que le lien :

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

	Titre et éditions
1882 :	traduction H. Albert de 1901

Classement alphabétique correct d’une œuvre dans la liste :

{{liste documents début}}
{{document|date=1637|titre=[[Le Héros]]|titre alpha=Heros}}
{{document|date=1648|titre=Art et figures de l’esprit}}
{{document|date=1647|titre=[[L’Homme de cour]]|titre alpha=Homme de cour}}
{{liste documents fin}}

	Titre et éditions
1637 :	Le Héros
1648 :	Art et figures de l’esprit
1647 :	L’Homme de cour

Colonne du titre original :

{{liste documents début|vo}}
{{document|date=1637|titre=[[Le Héros]]|titre alpha=Héros|vo=''El Héroe''}}
{{liste documents fin}}

	Titre et éditions	Titre original
1637 :	Le Héros	El Héroe

Degré de progression de relecture :

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

	Titre et éditions	Titre original
1637 :	Le Héros	El Héroe

Voir la page de l’auteur Baltasar Gracián.

Voir aussi

{{Liste documents début}}
{{Liste documents fin}}