Voir la source de Modèle:Bibliographie/Documentation

{{Sous-page de documentation}}

{{Modèle utilisant les données de Wikidata}}
{{Modèle utilisant les modules Lua|Wikidata/Références}}

Le modèle a pour vocation d'être un équivalent de {{m|Ouvrage}} et {{m|Article}} généré à partir d'un élément Wikidata. Si l'élément [[Wikidata]] est identifié comme '''édition''' d'un livre<ref>C'est-à-dire si la valeur principale de [[:d:Property:P31|P31 (nature de l'élément)]] est [[:d:Q3331189|Q3331189 (édition)]] ou une autre valeur de type « ouvrage » (voir les valeurs de la liste <code>p.ouvrage</code> dans [[Module:Wikidata/Références/Types]]).</ref>, la mise en forme est celle de {{m|Ouvrage}}. S'il est identifié comme un '''article'''<ref>C'est-à-dire si la valeur principale de [[:d:Property:P31|P31 (nature de l'élément)]] est [[:d:Q191067|Q191067 (article)]] ou une autre valeur de type « article » (voir les valeurs de la liste <code>p.article</code> dans [[Module:Wikidata/Références/Types]]).</ref>, elle rejoint celle de {{m|Article}}. '''Il ne faut pas l'employer avec des éléments Wikidata qui ne sont pas des éditions ou des articles''', cela risque fortement de générer des erreurs d'affichage<ref>Par exemple, il ne faut pas l'utiliser avec [[:d:Q208002|l'élément générique sur ''La Fraternité de l'anneau'']] mais avec [[:d:Q22137041|une édition spécifique du premier tome]]</ref>. Certains champs ne peuvent être gérés que manuellement et non importés de Wikidata.

Les valeurs Wikidata peuvent s'écraser en remplissant manuellement les champs de {{m|Ouvrage}} ou {{m|Article}} ; attention aux champs interdépendants (vous ne pouvez pas ajouter « responsabilité1 » si vous n'avez pas défini « auteur1 »).

== Syntaxe ==
* minimum <code><nowiki>{{Bibliographie|<Qidentifiant-dans-wikidata>}}</nowiki></code>
* avec paramètres disponibles <code><nowiki>{{Bibliographie|<Qidentifiant-dans-wikidata>|libellé=<intra-lien-nom-affiché>|page=222}}</nowiki></code><ref><code><nowiki>{{Bibliographie|Q61053290|libellé=Ballereau 2010|page=222}}</nowiki></code> <br>donne<br>{{Bibliographie|Q61053290|libellé=Ballereau 2010|page=222}}.</ref>


{{notice|Si <intra-lien-nom-affiché> n'existe pas dans {{m|Harvsp}};<br>
Si dans le renvoi en bas de page {{m|Sfn}},  l''''[[Aide:Lien ancré (wikicode)|ancre]] prévue''' ne fonctionne pas<ref>Ex {{Bibliographie|Q24238086|libellé=Henri Coursier}} soit <code><nowiki>{{Harv|id=Q24238086}}</nowiki></code> qui n'a pas de P1932 donne : {{Harv|id=Q24238086}} <br>
Le lien sur ''La croix-rouge internationale'' n'existe pas<!--wikilien qui a un | à la fin (== nil) -->;<br>
Mais <code><nowiki>{{Harv|id=Q24238086|H. Coursier}} </nowiki></code> qui a un texte donne : {{Harv|id=Q24238086|H. Coursier}}<br>
Cependant le lien sur ''La croix-rouge internationale'' n'aboutit pas<br>
De même <code><nowiki>{{Sfn|id=Q24238086|texte=Henri Coursier|ps=Sfn avec un id et un texte appuyé sur Harvard}}</nowiki></code> n'aboutira pas plus.<!-- testé le 6/4/2022, se pose de plus le problème du trim de sfn qui supprime les espaces-->
</ref>;<br>
Si l''''[[Aide:Lien ancré (wikicode)|ancre]] prévue''' est affichée correctement (en {{bleu|bleu}}) mais ne fonctionne pas<!--return wd.addRefAnchor(wd.addLinkBack(val, entity), wd.entityId(entity)) -- problématique --> : <br>
Il est raisonnable<ref name="ancreKO">Si l'ancre prévue ne fonctionne pas, et que {{m|wdref}} est hors service, utiliser {{m|Citeref}} ou {{m|Ahcdo}} et {{m|Harv}} : Benchmark du 12 mars 2022 à 14:36‎</ref> pour profiter de l'affichage  de l'entité cataloguée sous wikidata d'écrire 
*<code><nowiki>{{Citeref|<intra-lien-nom>|{{Bibliographie|<Qidentifiant-dans-wikidata>}}}}</nowiki></code>
ou bien selon les [[Wikipédia:Conventions bibliographiques#Renvois bibliographiques (références Harvard et autres)|Conventions bibliographiques]]
*<code><nowiki>{{Ahcdo|petit=oui|<intra-lien-nom>}} {{Bibliographie|<Qidentifiant-dans-wikidata>}}</nowiki></code><ref>{{m|Ahcdo}} est une ancre entre crochets. Selon les Conventions bibliographiques -avec appel bref- pour {{m|Bibliographie}}, fonctionne avec des {{m|sfn}} et {{m|Harvsp}}):<br>
<code><nowiki>*{{Ahcdo|petit=oui|Schmitt 2021}} {{Bibliographie|Q111181029}}</nowiki></code><br><code><nowiki>*{{Harv|Schmitt 2021|p=100}}</nowiki></code><br>donne<br>
*{{Ahcdo|petit=oui|Schmitt 2021}} {{Bibliographie|Q111181029}}<br>
*{{Harv|Schmitt 2021|p=100}}</ref>.}}

== Comment utiliser ce modèle ==
Le modèle a pour vocation d'être un équivalent de {{m|Ouvrage}} et {{m|Article}}. Il peut s'employer dans des cas similaires. Il peut être appelé avec tous les paramètres de ces modèles, selon que le [[:d:Wikidata:Introduction|'''document dans le projet wikidata''']]  est considéré comme un ouvrage ou comme un article.

L'ouvrage utilisé devrait faire apparaître un [[ISBN]] ou un identifiant [[OCLC]], pour cela, veillez à utiliser un Élément Wikidata qui soit une édition et non une œuvre. C'est-à-dire que l'Élément Wikidata doit avoir {{WD P|P31}} avec la valeur {{WD Q|Q3331189}}. Exemples des différences :
*Le format à utiliser avec ISBN, l'édition d'une œuvre, {{m|Bibliographie|Q60412367}} donne {{Bibliographie|Q60412367}}
*L'œuvre elle-même, {{m|Bibliographie|Q1638148}} donne {{Bibliographie|Q1638148}}

Pour l'utiliser avec des modèles de référence comme {{m|sfn}}, {{m|harvsp}} ou {{m|wdref}}, il faut savoir que le modèle génère une [[Aide:Lien ancré (wikicode)|ancre]] correspondant à l'identifiant Wikidata, par exemple <code>Q11927173</code>. 

* Pour {{m|sfn}} et {{m|harvsp}}, les modèles ne fonctionnent pas avec la paire <code>nom de famille/année</code> mais avec un <code>id</code>, qui est ici celui de l'élément Wikidata appelé utilisant l’identifiant Wikidata (<code>Q11927173</code> dans l’exemple), qui est unique pour chaque ouvrage<ref>Sauf doublon fusionné.</ref>. Il vaut donc mieux utiliser le « paramètre positionnel 1 » pour un affichage compréhensible, comme à chaque fois que ces modèles sont utilisés avec un identifiant Wikidata. Par exemple :
** {{m|harvsp|2=id=Q11927173|3=Haynes p.122}} donne {{harvsp|id=Q11927173|Haynes p.122}}
** {{m|sfn|2=id=Q11927173|3=Haynes p.122}} donne {{sfn|id=Q11927173|Haynes p.122}} (le modèle génère automatiquement les balises de référence)
:Il est toutefois possible de générer un autre id que l'identifiant Wikidata en remplissant manuellement le paramètre nommé <code>|id=</code> ; ce nouvel identifiant plus explicite peut alors être utilisé pour ancrer les modèles de référence :
:*{{m|sfn|Marin|1972|4=p=255}} donne {{sfn|Marin|1972|p=155}} (cas où {{m|Bibliographie}} est appelé avec le paramètre <code>id=Marin1972</code>, ce qui permet d'appeler {{m|sfn}} et {{m|harvsp}} de la même manière que si la référence bibliographique était construite avec {{m|ouvrage}} ou {{m|article}}).
* Pour {{m|wdref}}, {{incise|puisque l'élément wikidata Q11927173 a P31 (nature de l'élément) avec la valeur Q3331189 (édition)}}, {{m|wdref|Q11927173|Haynes}} donne {{wdref|Q11927173|Haynes}} qui est un lien vers l’exemple ci-dessus (<code>Haynes</code> peut être remplacé par n’importe quoi d'autre) ; par exemple <code>{{m|wdref|Q11927173|Haynes p.122}}</code> donne {{wdref|Q11927173|Haynes p.122}} qui pointe vers la même référence, seul l'intitulé du lien change<ref name="ancreKO"/>.

== Comment remplir l'élément Wikidata ==
Il faut d'abord s'assurer qu'il n'existe pas déjà un Élément. Pour pouvoir remplir correctement le modèle, il est possible que vous soyez obligés de créer des éléments sur Wikidata. '''Petit rappel :''' Comme Wikidata s'occupe de données, les Libellés, les Descriptions et les Alias commencent par une minuscule (sauf les cas évidents) et les ponctuations sont à éviter. Les Descriptions sont le plus succinct possible.
{{boîte déroulante/début|titre=pour une édition (=Modèle:Ouvrage)}}
Voici les propriétés à ajouter sur l'élément Wikidata pour que les paramètres soient renseignés par le modèle. L'élément doit impérativement avoir {{WD P|P31}} avec la valeur {{WD Q|Q3331189}} et {{WD P|P629}} avec comme valeur l'élément Wikidata général de l'œuvre citée<ref>[[:d:Q22137041|Cette édition spécifique de la ''Fraternité de l'anneau'']] est une {{WD P|P629}} [[:d:Q208002|''La Fraternité de l'anneau'' (élément générique)]]</ref>.

S'il n'existe qu'un élément générique sur l'œuvre, vous devez créer l'élément d'édition pour utiliser avec ce modèle. S'il n'existe ni l'œuvre ni l'édition, pensez à créer les deux et à les relier en utilisant <code>édition spécifique <P629 (édition de)> œuvre</code> et <code>œuvre <P747 (édition)> édition spécifique</code>. L'élément-œuvre doit avoir également une {{WD P|P31}} (généralement {{WD Q|Q571}} mais cela peut être plus précis) et un {{WD P|P50}}. Vous travaillez ensuite sur l'élément-édition.

Si la propriété indiquée appelle un élément, il faut que celui-ci existe sur Wikidata (vous êtes potentiellement amené à le créer).

* langue : utiliser {{WD P|P407}} (appelle un élément)
* prénom1-2-3-4  / nom1-2-3-4 / postnom1... / auteur1... / lien auteur1... / auteur institutionnel = remplir seulement {{WD P|P50}}. Attention, si votre auteur n'est pas un auteur principal mais un collaborateur, vous devez utiliser {{WD P|P767}} (appelle un élément)
* les auteurs collaborateurs peu importants qui ne sont pas fichés dans wikidata (et n'ont pas à l'être) peuvent être mis avec {{WD P|P2093}}
* directeur1 = {{WD P|P98}} (appelle un élément)
* responsabilité1 = fonctionne en utilisant des [[:d:Help:Qualifiers/fr|qualificatif]] sur les valeurs entrées dans {{WD P|P50}} et {{WD P|P767}}. Vous pouvez utiliser soit {{WD P|P518}} avec les valeurs {{WD Q|Q670787}}, {{WD Q|Q7234272}}, {{WD Q|Q125191}} ; soit {{WD P|P794}} avec les valeurs {{WD Q|Q19839393}} ou {{WD Q|Q33231}}, '''dans l'état actuel de développement du modèle ce sont les seuls cas gérés'''.
* traducteur : {{WD P|P655}} (appelle un élément)
* illustrateur : {{WD P|P110}} (appelle un élément)
* préface : voir l'explication au champ "responsabilité1"
* postface : voir l'explication au champ "responsabilité1"
* photographe : voir l'explication au champ "responsabilité1"
* titre : {{WD P|P1476}} (champ texte). Si la valeur n'est pas remplie, s'appuie sur le label de l'élément libellé en français.
* sous-titre : {{WD P|P1680}} (champ texte)
* titre d'origine : s'affiche automatiquement si une "langue d'origine" est précisée et que le {{WD P|P1476}} est entré sur l'élément de l'œuvre.
* lieu : {{WD P|P291}} (appelle un élément)
* éditeur : {{WD P|P123}} (appelle un élément)
* lien éditeur : se fait automatiquement si l'éditeur a un article
* jour / mois / année / date : {{WD P|P577}}
* numéro d'édition : {{WD P|P393}} (appelle une valeur chiffrée)
* pages totales : {{WD P|P1104}} (inutile de préciser une unité)
* isbn / isbn2 / isbn3 / isbn1 / isbn10 : {{WD P|P212)}} et {{WD P|P957}} (appelle un identifiant)<ref name="isbn erroné">Si l'isbn est erroné, il faut remplir le champ manuellement <code>|isbn erroné =</code>.</ref>
* oclc : {{WD P|P243}} (appelle un identifiant)
* bnf : {{WD P|P268}} (appelle un identifiant)
* lccn : {{WD P|P1144}} (appelle un identifiant)
* dnb : {{WD P|P1292}} (appelle un identifiant)
* doi : {{WD P|P356}} (appelle un identifiant)
* pmid : {{WD P|P698}} (appelle un identifiant)
* lire en ligne : {{WD P|P953}} (texte intégral disponible sur)]] (appelle une url)
{{boîte déroulante/fin}}

{{boîte déroulante/début|titre=pour un article (=Modèle:Article)}}
Voici les propriétés à ajouter sur l'élément Wikidata pour que les paramètres soient renseignés par le modèle. L'élément doit impérativement avoir [[:d:Property:P31|P31 (nature de l'élément)]] avec la valeur [[:d:Q191067|Q191067 (article)]].

Si la propriété indiquée appelle un élément, il faut que celui-ci existe sur Wikdiata (vous êtes potentiellement amené à le créer).
* langue : utiliser [[:d:Property:P407|P407 (langue de l'œuvre)]] (appelle un élément)
* prénom1 / nom1 / postnom1 / auteur1 / lien auteur1 / auteur institutionnel = remplir seulement [[:d:Property:P50|P50 (auteur)]]. Attention, si votre auteur n'est pas un auteur principal mais un collaborateur, vous devez utiliser [[:d:Property:P767|P767 (collaborateur)]] (appelle un élément)
* directeur1 = [[:d:Property:P98|P98]] (appelle un élément)
* responsabilité1 = fonctionne en utilisant des [[:d:Help:Qualifiers/fr|qualificatif]] sur les valeurs entrées dans [[:d:Property:P50|P50 (auteur)]] et [[:d:Property:P767|P767 (collaborateur)]]. Vous pouvez utiliser soit [[:d:Property:P518|P518 (s'applique à)]] avec les valeurs [[:d:Q670787|Q670787 (préface)]], [[:d:Q7234272|Q7234272 (postface)]], [[:d:Q11633|Q11633 (photographie)]] soit [[:d:Property:P794|P794 (comme)]] avec les valeurs [[:d:Q19839393|Q19839393 (préfacier)]] ou [[:d:Q33231|Q33231 (photographe)]]. '''dans l'état actuel de développement du modèle ce sont les seuls cas gérés'''.
* traducteur : [[:d:Property:P655|P655 (traducteur)]] (appelle un élément)
* photographe : voir l'explication au champ "responsabilité1"
* titre : [[:d:Property:P1476|P1476 (titre)]] (champ texte). Si la valeur n'est pas remplie, s'appuie sur le libellé en français.
* lieu : [[:d:Property:P291|P291 (lieu de publication)]] (appelle un élément)
* éditeur : [[:d:Property:P123|P123 (éditeur)]] (appelle un élément)
* lien éditeur : se fait automatiquement si l'éditeur a un article
* jour / mois / année / date : [[:d:Property:P577|P577 (date)]]
* isbn / isbn2 / isbn3 / isbn1 / isbn10 : [[:d:Property:P2012|P2012 (ISBN 13)]] et [[:d:Property:P957|P957 (ISBN 10)]] (appelle un identifiant)<ref name="isbn erroné"/>
* page(s) : {{WD P|P304}} (inutile de préciser une unité) attention c'est pages totales {{WD P|P1104}} pour ouvrage !
* oclc : [[:d:Property:P243|P243]] (appelle un identifiant)
* bnf : [[:d:Property:P268|P268]] (appelle un identifiant)
* lccn : [[:d:Property:P1144|P1144]] (appelle un identifiant)
* dnb : [[:d:Property:P1292|P1292]] (appelle un identifiant)
* doi : [[:d:Property:P356|P356]] (appelle un identifiant)
* pmid : [[:d:Property:P698|P698]] (appelle un identifiant)
* arxiv : [[:d:Property:P818|P818]] (appelle un identifiant)
* issn / issn1 / issn2 / issn3 : s'affiche automatiquement si [[:d:Property:P236|P236 (ISSN)]] est rempli dans l'élément du périodique.
* bibcode : s'affiche automatiquement si [[:d:1300|P1300 (bibcode)]] est rempli dans l'élément du périodique.
{{boîte déroulante/fin}}

{{boîte déroulante/début|titre=Liste des autres champs, non gérés de façon automatique depuis Wikidata}}
* et al. (4 auteurs mode {{m|sfn}} ) Noter que wikidata permet l'introduction par la chaîne libre [[:d:Property:P2093|author name string]] d'autant d'auteurs  non répertoriés dans wikidata  que l'on veut  pour un livre, ils sont affichés tel-que  et on peut mettre "al." au niveau de fin de liste que l'on veut<!--l'ancre ne marche pas au 3/4/2022-->.
* champ libre
* tome
* volume
* titre volume
* traduction titre
* nature ouvrage
* collection
* série
* numéro dans collection
* numéro
* titre numéro
* année première édition
* réimpression
* format livre
* isbn erroné
* math reviews
* zbl
* asin
* présentation en ligne
* écouter en ligne
* format électronique / format
* partie
* numéro chapitre
* titre chapitre
* passage
* pages
* référence
* référence simplifiée
* libellé
* extrait
* commentaire
* plume
{{boîte déroulante/fin}}

== Exemples ==
* <code><nowiki>{{Bibliographie|Q11927173|page= 122|plume=oui|libellé=i }}</nowiki></code>{{Bibliographie|Q11927173|page= 122|plume=oui|libellé=i }}
* <code><nowiki>{{Bibliographie|Q22137041|libellé=h }}</nowiki></code>{{Bibliographie|Q22137041|libellé=h }}
* <code><nowiki>{{Bibliographie|Q21470144|libellé=g }}</nowiki></code> {{Bibliographie|Q21470144|libellé=g }}
* <code><nowiki>{{Bibliographie|Q21192407|libellé=f }}</nowiki></code>{{Bibliographie|Q21192407|libellé=f }}
* <code><nowiki>{{Bibliographie|Q11927173|page=122|libellé=e }}</nowiki></code>{{Bibliographie|Q11927173|page=122|libellé=e }}
* <code><nowiki>{{Bibliographie|Q24074986|libellé=d }}</nowiki></code>{{Bibliographie|Q24074986|libellé=d }}
* <code><nowiki>{{Bibliographie|Q22240545|libellé=c }}</nowiki></code>{{Bibliographie|Q22240545|libellé=c }}
* <code><nowiki>{{Bibliographie|Q21004125|libellé=b }}</nowiki></code>{{Bibliographie|Q21004125|libellé=b }}
* <code><nowiki>{{Bibliographie|Q66103890|libellé=a }}</nowiki></code>{{Bibliographie|Q66103890|libellé=a }}
* <code><nowiki>{{Bibliographie|Q111165926|id=Marin1972}}</nowiki></code>{{Bibliographie|Q111165926|id=Marin1972}}

== Notes ==
{{Références}}
<references/>

== Templedata ==
<templatedata>
{
	"params": {
		"1": {
			"label": "Identifiant Wikidata",
            "description": "Qcode Wikidata",
			"example": "Q11927173",
			"required": true
		},
		"page": {
			"label": "Page",
			"description": "Numéro de la page",
			"example": "122"
		},
		"libellé": {
			"label": "Repère type Harvard de l'édition",
            "description": "Identifiant bibliographique intra article",
			"example": "Oteure 2022, vol.1"
        },
		"plume": {
			"label": "Ouvrage utilisé pour la rédaction de l'article",
            "description": "Ouvrage utilisé oui/non",
			"example": "oui"
		}
	},
	"description": "Le modèle a pour vocation d'être un équivalent de {{Ouvrage}} et {{Article}} généré à partir d'un élément Wikidata. En plus des paramètres indiqués ici, il est possible de l'utiliser avec tous les paramètres de celui de ces deux modèles qui correspond au type du document."
}
</templatedata>

<includeonly>
<!-- Catégories pour le modèle -->
[[Catégorie:Modèle pour bibliographie]]
</includeonly>