Modèle:Document/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 colonnes (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É (Fac-similé)
• divers = : NON DOCUMENTÉ (colonne divers). divers alpha= est possible.

Titre des têtières

voir le modèle {{Liste documents début}}.

Approfondissement

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.

 

Remarques

• 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.
• La clé de tri pour l’ordre alphabétique des arguments titre alpha=, vo alpha = ne devra pas comporter d’accent, le texte se mettrait à la fin.

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 Le Héros
	Art et figures de l’esprit Art et figures de l’esprit
	L’Homme de cour 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 Le Héros
1648 :	Art et figures de l’esprit Art et figures de l’esprit
1647 :	L’Homme de cour 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 É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 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 :	HerosLe Héros
1648 :	Art et figures de l’esprit Art et figures de l’esprit
1647 :	Homme de courL’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 :	HérosLe Héros	El HéroeEl 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 :	HérosLe Héros	HéroeEl Héroe

 

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

Voir aussi

• {{Liste documents début}} : dépendance de {{Document}}. Délimiteur de début.
• {{Liste documents fin}} : dépendance de {{Document}}. Délimiteur de fin.