Modèle:Matisk/bac à sable/documentation
Apparence
- 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 1re 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 2e 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 letitre
, 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éfixeLivre:
.éditions=
: utilisable à la place de l’argumenttitre=
, 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
: et5
: .
- Des 3e, 4e et/ou 5e (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
, ouvo|scan
, ouauteur|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}}
- liste simple
- 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
ouscan
, 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 |
- Voir la page de l’auteur Baltasar Gracián.
- Voir aussi