Modèle:Refbegin/Documentation

On peut utiliser {{refbegin}} et sa balise de clôture {{refend}} pour appliquer un style ou format bibliographique particulier, à des listes de références, de sources et / ou d'ouvrages cités, triés par ordre alphabétique du nom d'auteur ou de contributeur) qu'on aura utilisés dans un article de Wikipedia.

Ces listes bibliographiques ou de renvois sont parfois distribuées entre paragraphes distincts dans un article : on trouvera indifféremment les titres ==Références bibliographiques==, ==Ouvrages cités==, ==Bibliographie==, ==Pour en savoir plus==, ==Ouvrages imprimés==, etc.

La page Citez vos sources fournit plusieurs exemples de Conventions bibliographiques : {{ouvrage}}, {{article}} et {{Référence Harvard}}.

Les options de formatage fournies par le présent modèle sont :

Options/parameters du modèle refbegin

Option	Syntaxe à utiliser	Remarques
affichage par défaut	{{refbegin}}	ne nécessite aucun paramètre ; la casse par défaut est de 90% la casse standard.
liste multi-colonnes	{{refbegin|n}}	où n fixe le nombre de colonnes, ou la largeur de colonnes par rapport à la taille de fenêtre du navigateur.
liste indentée	{{refbegin|indent=yes}}	provoquera l'indentation automatique du texte de la référence si elle s'étale sur plus d'une ligne de la fenêtre du navigateur.

Chaque balise {{refbegin}}, qu'elle comporte ou non un paramètre, doit être refermée par une balise de clôture {{refend}} qui signale la fin de la zone formatée ; refend ne comporte aucun paramètre.

Par défaut, la taille de caractère est plus petite que celle du texte de l'article. On peut éventuellement combiner les options de découpage en colonnes et d’indentation (aux spécificités d'affichage des navigateurs près, décrites ci-après).

Syntaxe

Ce modèle n'est utilisé que pour les sections bibliographiques : il ne faut pas s'en servir pour créer des listes de texte, car les attributs de ces sections peuvent être fixés par des modèles spécifiques.

Voici la syntaxe complète avec tous les paramètres (optionnels) possibles :

==References==
{{refbegin |n |indent= }}
*liste d'entrées bibliographiques ou de renvois ..
...
{{refend}}

Emplacement dans le code d'une page

Il faut placer {{refbegin}} juste après le titre de la section bibliographique à laquelle le formatage doit s'appliquer. La balise fermante {{refend}} doit impérativement se trouver dans la même section, à la fin de la liste des références.

Chaque fois qu'on utilise une balise {{refbegin}}, il faut la refermer par une balise de clôture {{refend}}:

==References==
{{refbegin}}
*1re entrée bibliographique..
*2e entrée bibliographique..
...
*dernière entrée  bibliographique..
{{refend}}

Le formatage commence à l'endroit précis où l'on a inséré la balise {{refbegin}}, et il affecte tout le texte qui suit, jusqu'à occurrence du modèle {{refend}} (ou d'une balise </div>). L'absence de balise fermante {{refend}} peut s’accompagner d'effets indésirables dans les sections postérieures à la section 'Références', 'Bibliographie' etc., par ex. la section 'Voir également' qui se trouve d’habitude en fin d'article.

Option 1: comportement par défaut

L'utilisation du modèle par défaut (sans paramètre) produit un style où la taille de caractère des entrées bibliographiques est réduite. Cela permet un affichage plus compact de la bibliographie fournie, tout en rappelant le format que le modèle {{Références}} applique aux notes de bas de page.

Les {{Références}} formatent les notes de pied de page (c'est-à-dire tout texte du corps d'article se trouvant encadré de balises <ref>) créées automatiquement par l'extension cite.php, et appelées par {{reflist}}. Dans le cas d'articles utilisant le système par notes abrégées, les notes comportent typiquement une citation du genre <ref>Dupas 1992, p.123</ref> qui renvoie à une entrée bibliographique (la note peu comporter du texte ou une explication en plus).

La taille de caractère devrait apparaître réduite à 90% sur la plupart des navigateurs, mais avec Internet Explorer et sans doute quelques autres logiciels, elle peut conserver 100% des proportions. Pour fixer la taille de fonte, Reflist et Refbegin consultent leurs propres lignes de style CSS, codées dans MediaWiki:Common.css :

div.reflist,
div.refbegin {
    font-size: 90%;
}

Quand on utilise des notes de pied de page normales (c'est-à-dire qu'on ne crée pas de sections distinctes pour les notes de pied de page et les références bibliographiques, et que toutes les citations sont marquées par des balises <ref>), il suffit d'utiliser simplement le modèle {{Références}} :

==References==
{{Références}}

En revanche, si l'article comporte une liste bibliographique mais aucune note de bas de page (par ex. une bibliographie générale ou un système de citation entre crochets) il vaut mieux utiliser {{refbegin}} et {{refend}} ainsi :

==References==
{{refbegin}}
*référence courante 1
*référence courante 2
{{refend}}

Si l'on a prévu une section séparée pour les notes et pour la bibliographie (par ex. en utilisant les citations courtes du modèle {{Référence Harvard}}), on placera un modèle {{reflist}} pour la section des notes (juste avant la section bibliographie), et un modèle {{refbegin}} pour la section bibliographique :

==Notes==
{{Références}} <!--ce modèle crée automatiquement la liste numérotée des notes de pied de page -->

==Références==
{{refbegin}}
*entrée bibliographique / reference 1
*entrée bibliographique / reference 2
*etc.
{{refend}}

Option 2: section multi-colonnes

Si l'on passe au modèle un entier n comme premier paramètre, il affichera la bibliographie sur n colonnes ce qui peut être utile pour afficher une bibliographie abondante, et fait écho à l'option correspondante de {{Références}}. Par exemple, {{refbegin|2}} va afficher la liste sur deux colonnes. Lorsque ce paramètre est absent, l'affichage se fait sur une seule colonne. Il n'est ni usuel, ni commode, cela dit, d'afficher de la bibliographie sur plus de deux colonnes.

Si l'on passe comme premier paramètre un nombre suivi d'une unité (au format tex), par ex. 30em, le modèle interprète cette valeur comme la largeur minimum à donner aux colonnes, et il en déduira le nombre optimal de colonnes par ligne. Ainsi, un paramètre {{refbegin|30em}} peut convenir pour les citations courtes.

References

References

References

References

Aide pour certains navigateurs

« CSS3 multiple column layout », sur W33

Option 3: Alinéas

On peut insérer des alinéas dans les listes bibliographiques grâce au paramètre |indent=. Cette option peut s'avérer utile pour améliorer la lisibilité des listes bibliographiques, en particulier lorsque certaines entrées sont très longues, par ex. si elles débordent au-delà d'une ligne dans la fenêtre du navigateur. L’utilisation d'alinéas dans les listes facilite la reconnaissance de mots-clefs (souvent le nom d'un auteur) et les fait mieux ressortir d'une entrée à la suivante. Les alinéas font d'ailleurs partie intégrante de plusieurs systèmes bibliographiques standard, tels APA, MLA et Chicago.

Pour insérer un alinéa, insérez {{refbegin|indent=yes}}.

Exemples

a) Avec {{refbegin}} et l'option d'indentation |indent=yes :

==References==
{{refbegin|indent=yes}}
* {{ouvrage |auteur= Dakin, Karen|année= 1994|chap= El náhuatl en el yutoazteca sureño: algunas isoglosas gramaticales y fonológicas|titre= Investigaciones lingüísticas en Mesoamérica |collection= Estudios sobre Lenguas Americanas, no. 1|auteur2=Carolyn MacKay |auteur3=Verónica Vázquez|directeur2=Carolyn MacKay |directeur3=Verónica Vázquez |éditeur= Universidad Nacional Autónoma de México, Instituto de Investigaciones Filológicas, Seminario de Lenguas Indígenas|lieu= México D.F.|passage = 3–86 |isbn= 968-36-4055-9 |oclc= 34716589 |langue=es}}
* {{ouvrage |auteur1=Flores Farfán |auteur2=José Antonio |année= 2002|titre= The Use of Multimedia and the Arts in Language Revitalization, Maintenance, and Development: The Case of the Balsas Nahuas of Guerrero, Mexico |url= http://jan.ucc.nau.edu/~jar/ILAC/ILAC_24.pdf |format= [[Portable Document Format|PDF]] |collection= Proceedings of the Annual Conference on Stabilizing Indigenous Languages (7th, Toronto, Ontario, Canada, May 11–14, 2000) |titre volume= Indigenous Languages across the Community |auteur3=Barbara Jane Burnaby |auteur4= John Allan Reyhner|directeur3=Barbara Jane Burnaby |directeur4=John Allan Reyhner |lieu= Flagstaff, AZ |éditeur= Center for Excellence in Education, Northern Arizona University |passage = 225–236 |isbn= 0-9670554-2-3 |oclc= 95062129}}
* {{ouvrage |auteur= Rincón, Antonio del |publi= 1885 par les bons soins du Dr. Antonio Peñafiel | |année= 1595 |titre= Arte mexicana compuesta por el padre Antonio Del Rincón de la compañia de Jesus: Dirigido al illustrissimo y reverendissimo s. Don Diego Romano obispo de Tlaxcallan, y del consejo de su magestad, &c. En Mexico en casa de Pedro, Balli. 1595 |url= http://storage.lib.uchicago.edu/pres/2005/pres2005-033.pdf |format=facsimile PDF, Université de Chicago, Library digital collections|lieu= México D.F. |éditeur= Oficina tip. de la Secretaría de fomento |oclc= 162761360 |langue=es}}
* {{article |auteur= Voegelin, Charles F.|auteur2= Florence M. Voegelin |auteur3=Kenneth L. Hale |année= 1962 |titre= Typological and Comparative Grammar of Uto-Aztecan I: Phonology |périodique= Supplement to International Journal of American linguistics| volume= 28|numéro= 1 |collection= Indiana University publications in anthropology and linguistics, Memoir 17 |lieu= Baltimore MD |éditeur= Waverly Press |oclc= 55576894}}
{{refend}}

References

b) En combinant indentation et affichage multi-colonnes (ici, n = 2) {{refbegin|2|indent=yes}} (notez que l'option multi-colonnes ne fonctionne correctement qu'avec certains navigateurs):

==References==
{{refbegin|2|indent=yes}}
* {{ouvrage |auteur= Dakin, Karen|année= 1994|chap= El náhuatl en el yutoazteca sureño: algunas isoglosas gramaticales y fonológicas|titre= Investigaciones lingüísticas en Mesoamérica |collection= Estudios sobre Lenguas Americanas, no. 1|auteur2=Carolyn MacKay |auteur3=Verónica Vázquez|directeur2=Carolyn MacKay |directeur3=Verónica Vázquez |éditeur= Universidad Nacional Autónoma de México, Instituto de Investigaciones Filológicas, Seminario de Lenguas Indígenas|lieu= México D.F.|passage = 3–86 |isbn= 968-36-4055-9 |oclc= 34716589 |langue=es}}
* {{ouvrage |auteur1=Flores Farfán |auteur2=José Antonio |année= 2002|titre= The Use of Multimedia and the Arts in Language Revitalization, Maintenance, and Development: The Case of the Balsas Nahuas of Guerrero, Mexico |url= http://jan.ucc.nau.edu/~jar/ILAC/ILAC_24.pdf |format= [[Portable Document Format|PDF]] |collection= Proceedings of the Annual Conference on Stabilizing Indigenous Languages (7th, Toronto, Ontario, Canada, May 11–14, 2000) |titre volume= Indigenous Languages across the Community|auteur3=Barbara Jane Burnaby |auteur4= John Allan Reyhner|directeur3=Barbara Jane Burnaby |directeur4=John Allan Reyhner|lieu= Flagstaff, AZ |éditeur= Center for Excellence in Education, Northern Arizona University |passage = 225–236 |isbn= 0-9670554-2-3 |oclc= 95062129}}
* {{ouvrage |auteur= Rincón, Antonio del |publi= 1885 par les bons soins du Dr. Antonio Peñafiel | |année= 1595 |titre= Arte mexicana compuesta por el padre Antonio Del Rincón de la compañia de Jesus: Dirigido al illustrissimo y reverendissimo s. Don Diego Romano obispo de Tlaxcallan, y del consejo de su magestad, &c. En Mexico en casa de Pedro, Balli. 1595 |url= http://storage.lib.uchicago.edu/pres/2005/pres2005-033.pdf |format=facsimile PDF, Université de Chicago, Library digital collections|lieu= México D.F. |éditeur= Oficina tip. de la Secretaría de fomento |oclc= 162761360 |langue=es}}
* {{article |auteur= Voegelin, Charles F.|auteur2= Florence M. Voegelin |auteur3=Kenneth L. Hale |année= 1962 |titre= Typological and Comparative Grammar of Uto-Aztecan I: Phonology |périodique= Supplement to International Journal of American linguistics| volume= 28|numéro= 1 |collection= Indiana University publications in anthropology and linguistics, Memoir 17 |lieu= Baltimore MD |éditeur= Waverly Press |oclc= 55576894}}
{{refend}}

References

Voir également

• Wikipedia:Citez vos sources exemples de Conventions bibliographiques
• Aide:Insérer une référence
• {{references}} – numérotation automatique de notes et de citations