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.

Utilisation

Permet de créer une liste triables d’œuvres structurées sous forme de tableau dans l’espace « Auteur » ou dans les pages d’éditions multiples.

Remarques

Ce modèle doit être utilisé conjointement avec {{liste documents début}}, pour ouvrir la liste des titres, et avec {{liste documents fin}}, pour la clôturer. Chaque ligne de cette liste doit être entrée avec {{document}}, dans lequel il faut obligatoirement préciser l’un des arguments titre=, éditions= ou traductions=.

Avantages : Versatilité et homogénéité dans la mise en forme sans avoir à connaître la syntaxe des tableaux.
Inconvénients : Plusieurs cas de figures sont possibles ce qui peut indisposer un nouvel utilisateur.

Syntaxe

Pour chaque ligne de la liste, il faut préciser un et un seul des trois paramètres titre=, éditions= ou traductions= ; les autres paramètres, entre crochets, sont facultatifs :

{{document|[date=] ou [dates=] | titre= ou éditions= ou traductions= | [titre alpha =] | [livre=] | [vo =] | [vo alpha =] | [auteur=] | [auteur alpha =] | [genre=] | [revue=] | [scan=] | [avancement=] | [export=] | [divers=] | [divers alpha=]}}

Voyez la section Remarques sur les paramètres pour la syntaxe spécifique à chaque paramètre.

Paramètres

Permet de créer une liste triables d’œuvres structurées sous forme de tableau

Paramètres du modèle[Modifier les données du modèle]
La mise en forme sur une seule ligne est préférée pour ce modèle.
Paramètre		Description	Type	État
Date de publication	`date`	Peut contenir une valeur différente ex : Inc. ou 195? Exemple 1908	Chaîne	facultatif
Dates de début et de fin	`dates`	Dates séparées par / Exemple 1883/1885	Chaîne	facultatif
Titre de l’œuvre	`titre`	Texte ou [lien suivi d’une description] avec ou sans [titre alpha] Exemple Arsène Lupin gentleman-cambrioleur ; [[Arsène Lupin gentleman-cambrioleur]], le premier d’une longue série	Chaîne	facultatif
Éditions multiples	`éditions`	Nom de la page contenant la liste avec ou sans [titre alpha] Exemple Madame Bovary	Chaîne	facultatif
Traductions multiples	`traductions`	Nom de la page contenant la liste des traductions avec ou sans [titre alpha] Exemple Le Roi Lear	Chaîne	facultatif
Clef alphabétique du titre	`titre alpha`	Titre tel qu’indiqué dans un dictionnaire, pour classement alphabétique Exemple Roi Lear	Chaîne	obligatoire
Nom du fac-similé	`livre`	Page d’index sans le préfixe ''Livre'' Exemple Desrosiers - Les Opiniâtres, 1941.djvu	Chaîne	facultatif
Avancement	`avancement`	Valeur de 1 à 5 ; 5 correspond à validé	Nombre	facultatif
Icônes pour exportations	`export`	Nom de la page à exporter, si différent de l’argument titre Exemple export= Arsène Lupin gentleman-cambrioleur	Chaîne	facultatif
Titre original	`vo`	Titre lors du lancement si différent avec ou sans [vo alpha] Exemple {{lang\|de\|Die Leiden des jungen Werthers}}	Chaîne	facultatif
Clef alphabétique du titre original	`vo alpha`	Titre original tel qu’indiqué dans un dictionnaire, pour classement alphabétique Exemple Leiden des jungen Werthers	Chaîne	facultatif
Auteur	`auteur`	Nom de l’auteur ou co-auteur avec ou sans [auteur alpha] Exemple Germaine de Staël ; [[Auteur:Germaine de Staël\|Madame de Staël]]	Chaîne	facultatif
Clef alphabétique de l’auteur	`auteur alpha`	Nom de l’auteur tel qu’indiqué dans un dictionnaire, pour classement alphabétique Exemple Staël, Germaine de	Chaîne	facultatif
Genre	`genre`	Genre de l’ouvrage Exemple roman	Chaîne	facultatif
Source	`scan`	lien URL	URL	facultatif
Divers	`divers`	Champ libre avec ou sans [divers alpha]	Chaîne	facultatif
Clef alphabétique du champ Divers	`divers alpha`	Contenu du champ Divers tel qu’indiqué dans un dictionnaire, pour classement alphabétique	Chaîne	facultatif
Revue	`revue`	Référence au numéro de la Revue Des Deux Mondes Exemple RDDM/numéro	Chaîne	facultatif

Remarques sur les paramètres

Pour les conventions appliquées au nommage des œuvres et à la construction de bibliographies dans l’espace Auteur:, reportez-vous à Aide:Conventions de nommages des œuvres et Aide:Espace « Auteur ».

Paramètres de données

date= : ce paramètre accepte n’importe quel texte (par exemple, — ; attention toutefois à ne pas y écrire un texte trop encombrant qui modifierait l’alignement des colonnes) ; lorsque ce texte est un nombre, un lien automatique vers la catégorie des livres publié en cette année sera créé.
dates= : ce paramètre accepte deux syntaxes ; dans les deux cas, un lien automatique est créé vers la catégorie des livres publié en ces dates :
- année et mois de publication (pour les revues) ; par exemple « 1902/04 ».
- années de début et de fin de publication ; par exemple : « 1909/1911 ».
livre= : crée un lien vers une page d’index de Wikisource (voyez Aide:Espace « Livre »), la page d’index étant donnée dans le paramètre sans le préfixe Livre: ; pour des œuvres en plusieurs volumes, plutôt que de créer un {{document}} par volume, on ne crée qu’une entrée avec lien vers l’index du premier volume.
titre= : titre en français ; le titre devient automatiquement un lien quand la page existe, mais on peut écrire titre=[[titre de la page|titre à afficher]] sous-titre/commentaire (dans ce cas, veiller à modifier le paramètre export=).
éditions= : utilisable à la place du paramètre titre=, pour créer un lien vers une page contenant une liste d’éditions ; la syntaxe est la même que pour titre=.
traductions= : utilisable à la place du paramètre titre=, pour créer un lien vers une page contenant une liste de traductions auteur ; la syntaxe est la même que pour titre=.
auteur= : prénom et nom de l’auteur ; le nom d’auteur devient automatiquement un lien quand existe une page Auteur:, mais on peut écrire auteur=[[Auteur:Prénom Nom|Nom différent]] en cas de pseudonyme ou d’existence d’une désignation plus courante que la désignation prénom-nom.
avancement= : admet un chiffre de 1 à 5 codant l’état d’avancement du livre : 1 pour un livre incomplet, 2 pour un livre complet non mis en forme, 3 pour un livre complet mis en forme mais non relu, 4 pour un livre complet relu par un contributeur, 5 pour un livre complet relu par deux contributeurs. Si ce paramètre n'est pas donné, l'état d'avancement est récupéré automatiquement de Wikidata s'il y est renseigné (voir État d'avancement des textes dans Wikidata).
export= : affiche trois icônes cliquables pour télécharger un livre à l’avancement ≥ 4 aux formats ePub, PDF et mobi (voir Catégorie:Bon pour export pour les critères d’utilisation) ; deux syntaxes sont possibles :
- écrire export seul, quand le paramètre « titre » est le titre exact de la page à exporter.
- préciser après export= le titre de la page à exporter : « export=titre » pour éviter une erreur lors de l’exportation.
genre= : genre de l’œuvre.
revue= : pour l’instant n’est utilisable que pour préciser les références d’un article de la Revue des Deux Mondes.
scan= : lien vers un fac-similé numérique de l’œuvre disponible hors de Wikisource (pour les fac-similés de Wikisource, voyez livre=). Ne sont autorisés que les liens vers des œuvres du domaine public en France ou dans le pays de publication ; si l’on veut faire un lien vers le fac-similé d’une œuvre encore protégée par le droit d’auteur, cela est autorisé seulement à titre d’indication pour faciliter le travail des futurs contributeurs, et doit donc être ajouté en page de discussion de la page Auteur:.
divers= : contenu libre, ajouté dans une colonne tout à droite de la liste ; si l’on veut donner un nom à cette colonne, il faut ajouter divers= Nom de la colonne à {{Liste documents début}}.

Paramètres de 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. Ces tris se fondent par défaut sur les arguments des paramètres date=, titre= (et apparentés), auteur= et vo=. Dans le cas où la fonction de tri est inutilisable, on pourra la désactiver en ajoutant class=unsortable dans {{Liste documents début}}.

Pour assurer un tri alphabétique cohérent, si les arguments des paramètres triables ne sont pas présentés tels qu’ils le seraient dans un dictionnaire, il faut utiliser les paramètres alpha :

titre alpha= : titre en français sans article (exemple : titre= Le Roi Lear | titre alpha= Roi Lear).
vo alpha= : titre original sans article (exemple : vo= {{lang|de|Die Leiden des jungen Werthers}} | vo alpha= Leiden des jungen Werthers).
auteur alpha= : nom de l’auteur avec nom de famille en tête (exemple : auteur= Germaine de Staël | auteur alpha= Staël, Germaine de).
divers alpha= : clef alphabétique pour la colonne « divers ».

Paramètres de l’en-tête

L’en-tête de la liste, qui précise le nom de chaque colonne, est défini par {{liste documents début}}. Trois paramètres d’affichage peuvent être utilisés avec {{Liste documents début}} : class, rules et largeur.

class= : désactive le tri avec {{Liste documents début|class=unsortable}}.
rules= : affiche des lignes à l’intérieur des listes ; par exemple, rules=rows est utilisé dans cet exemple.
largeur= : définit en pourcentage la largeur de la liste.

Utilisation détaillée et exemples

Exemple 1 - normal

On place {{liste documents début}} au début de la liste et {{Liste documents fin}} à la fin de la liste :

Code wiki

Rendu

{{document| date= |éditions=Arsène Lupin contre Herlock Sholmès | avancement=4}}

[…]

	Titre et éditions
1758 :	Exemple 1
1760 :	Exemple 2
	Arsène Lupin contre Herlock Sholmès

Exemple 2 - Titre et éditions

Colonne Titre et éditions

Code wiki Rendu

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}}

	Articles
1758 :	Exemple 1

Pour supprimer le titre :

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


1758 :	Exemple 1

Pour ajouter des colonnes prédéfinies: Des colonnes prédéfinies peuvent être ajoutées pour les titres originaux, les auteurs d’une liste bibliographique, des liens vers des fac-similés. Ces colonnes s’activent en ajoutant des paramètres dans {{liste documents début}}.

Liste des colonnes prédéfinies :

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}}
liste avec une colonne genre : fonctionne avec vo et scan (mais pas avec auteur), par exemple : {{liste documents début|vo|scan|genre}}

Deux remarques importantes :: Quand on ajoute plus d’une colonne prédéfinie, il faut le faire obligatoirement de l’une ou l’autre de ces manières : vo|auteur|scan, ou vo|scan, ou auteur|scan.; 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.

	Titre et éditions	Titre original

	Titre et éditions	Auteur

	Titre et éditions	Titre original	Auteur

	Titre et éditions	Fac-similé

	Titre et éditions	Titre original	Genre	Fac-similé

Exemple 3 - Différents cas de figures

Différents cas de figure

Code wiki Rendu

Utilisation minimale avec le titre seul

{{document|titre=[[Le Héros]] (première édition)}}

Pour indiquer seulement une date et un titre

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

Pour ajouter un lien vers un index (espace « Livre »)

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

ou, pour afficher un autre titre que le lien :

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

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|titre=Le Héros|titre alpha=Héros|vo=''El Héroe''|avancement=2}}

	Titre et éditions	Titre original
	Le Héros (première édition)
1637 :	Le Héros
1838 :	Éloge historique de Jean-Antoine Chaptal
1882 :	Ainsi parlait Zarathoustra, Albert 1901
1637 :	Le Héros
1637 :	Le Héros	El Héroe
1637 :	Le Héros	El Héroe

Exemple 4 - en contexte

Voir un exemple complet : Auteur:Baltasar Gracián