« Module:Biblio » : différence entre les versions

Une page de Wikipédia, l'encyclopédie libre.
Contenu supprimé Contenu ajouté
Zebulon84 (discuter | contributions)
COinS : corrections bugs
si References.affichageLiensExternes() retourne nil, empêche une erreur Lua ici car on ne peut pas concaténer nil ; j'ai regardé pour faire retourner une chaîne vide par affichageLiensExternes() quand il n'y a aucun lien, mais mieux vaut qu'il continue de retourner nil (le point important est de supporter les deux éventualités dans les codes appelants)
 
(23 versions intermédiaires par 6 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
-- Le module biblio centralise les différentes fonctions utiles pour les bibliographie et références.
local Biblio = {}


local Langue = require ( 'Module:Langue' )
local Biblio = { }
local Date = require ( 'Module:Date' )


require( 'strict' )
-- cette simple fonction permet de récupérer les arguement du modèle,
local Outils = require( 'Module:Outils' )
-- ou la table transmise à la fonction par une autre fonction d'un module

local function extractArgs ( frame )

-- return ( frame.getParent and frame:getParent().args ) or frame or { }
Biblio.ouvrage = function ( frame )
return frame.args or frame or { } -- renvoie les arguments transmis par invoke et non par le modèle, pour tester avant de créer les modèle.
local args = Outils.extractArgs( frame )
local Ouvrage = require( 'Module:Biblio/Ouvrage' )
return Ouvrage.ouvrage( args )
end
end


-- fonction abréviation, abréviation discrète
-- paramètres : 1 = abréviation, 2 = texte, 3 = langue, abrd = abréviation discrète
function Biblio.abr ( frame )
local args = extractArgs ( frame )
if args[2] == nil then
return args[1] or '' -- retoune l'abréviation ou au minimum une chaine vide s'il n'y a pas de texte
end


Biblio.chapitre = function ( frame )
local wikiText = { '<abbr' }
local args = Outils.extractArgs( frame )
if args.abrd then
local Ouvrage = require( 'Module:Biblio/Ouvrage' )
table.insert(wikiText, ' class="abbr"')
return Ouvrage.chapitre( args )
end
end
table.insert(wikiText, ' title="' .. args[2])
if args[3] then
table.insert(wikiText, '" lang="' .. args[3])
end
table.insert(wikiText, '">' .. args[1] .. '</abbr>')



return table.concat (wikiText)
Biblio.article = function ( frame )
local args = Outils.extractArgs( frame )
local Ouvrage = require( 'Module:Biblio/Article' )
return Ouvrage.article( args )
end
end


-- voir Modèle:ISBN
function Biblio.ISBN ( frame )
local args = extractArgs ( frame )
local liste = { }
local i = 1
local isbn = mw.text.trim ( args [1] or '' )
if isbn == '' then
liste = { 'ISBN&nbsp;inconnu[[Catégorie:ISBN nécessaire]]' }
else
local texteIsbn = 'ISBN ' .. isbn
repeat
local lien = '[[Spécial:Ouvrages de référence/' .. isbn
.. '|<span class="nowrap">' .. texteIsbn .. '</span>]]'
table.insert ( liste, lien )


Biblio.lienWeb = function( frame )
i = i + 1
local args = Outils.extractArgs( frame )
isbn = mw.text.trim ( args [i] or '' )
local Ouvrage = require( 'Module:Biblio/Lien web' )
texteIsbn = isbn
return Ouvrage.lienWeb( args )
until isbn == ''
end
return '<small>(' .. mw.text.listToText ( liste ) .. ')</small>'
end
end


Biblio.lienBrise = function( frame )
-- voir Modèle:ISSN
function Biblio.ISSN ( frame )
local args = Outils.extractArgs( frame )
local args = extractArgs ( frame )
local Ouvrage = require( 'Module:Biblio/Lien web' )
return Ouvrage.lienBrise( args )
local liste = { }
end
local i = 1
local issn = mw.text.trim ( args [1] or '' )
if issn == '' then
liste = { 'inconnu[[Catégorie:ISSN nécessaire]]' }
else
repeat
local lien = '<span class="plainlinks noarchive">[http://worldcat.org/issn/'
.. mw.uri.encode( issn ) .. '&lang=fr ' .. issn.. ']</span>'
table.insert ( liste, lien )



i = i + 1
Biblio.dictionnaire = function( frame )
issn = mw.text.trim ( args [i] or '' )
local args = Outils.extractArgs( frame )
texteIsbn = issn
local article = Outils.validTextArg( args, 'notice', 'article', 'titre chapitre' )
until issn == ''
local Ouvrage = require( 'Module:Biblio/Ouvrage' )
end
if article then
return '<small>([[International Standard Serial Number|ISSN]]&nbsp;' .. mw.text.listToText ( liste ) .. ')</small>'
args['titre chapitre'] = article
return Ouvrage.chapitre( args )
else
args.titre = args['titre ouvrage']
args['sous-titre'] = args['sous-titre ouvrage']
args.auteur1 = args['auteur ouvrage']
args.auteurs = args['auteurs ouvrage']
return Ouvrage.ouvrage( args )
end
end
end


-- catégorise une page en fonction du namespace
-- voir Modèle:Module biblio/span initial
function Biblio.spanInitial ( frame )
local function categorise(args)
local namespaceCategorisation = { [0] = true, [4] = true, [10] = true, [12] = true, [14] = true, [100] = true, [104] = true }
local args = extractArgs ( frame ) -- préparation pour appel par modèle ou direct.
local id = args.id or ''
local category = args[1]
local flag = args[2]
if string.len( id ) == 0 then
if type(category) == 'string'
id = mw.uri.anchorEncode ( args.id1 .. args.id2 .. args.id3 .. args.id4 .. args.id5 )
and flag
end
and namespaceCategorisation[ mw.title.getCurrentTitle().namespace ]
return '<span class="ouvrage" id="' .. id
then
return '[[Category:' .. category .. ']]'
end
return ''
end
end


Biblio.ISBN = function ( frame )
-- voir Modèle:Module biblio/libellé
function Biblio.libelle ( frame )
local args = Outils.extractArgs( frame )
if Outils.trim( args[1] ) then
local args = extractArgs ( frame )
local lib = args ['libellé'] or args [1] or ''
local newArgs = { isbn = args[1] }
local i = 2
if string.len( lib ) > 0 then
while args[i] do
lib = '<small>[' .. lib .. ']</small> '
newArgs[ 'isbn' .. i ] = args[i]
end
i = i + 1
return lib
end
return Biblio.identifiantsBiblio( newArgs )
else
return '<small>([[International Standard Book Number|ISBN]]&nbsp;inconnu)</small>' .. categorise{ 'ISBN nécessaire', true }
end
end
end


Biblio.rechercheIsbn = function( frame )
-- voir Modèle:Module biblio/indication de langue
local args = Outils.extractArgs( frame )
function Biblio.indicationDeLangue ( frame )
local References = require( 'Module:Biblio/Références' )
local args = extractArgs ( frame )
local newArgs = { isbn = args[1], sansLabel = true, categ = {} }
local codeLangue = Langue.codeLangue2 ( args.langue )
local isbn = References.isbn( newArgs ) or ''
if codeLangue ~= '' and codeLangue ~= 'fr' then
local categ = categorise{ 'Page avec ISBN invalide', newArgs.categ.isbnInvalid }
return Langue.indicationDeLangue { '', codeLangue }
return isbn .. categ
else
return ''
end
end
end



-- voir Modèle:Module biblio/responsabilité principale
function Biblio.responsabilitePrincipale ( frame )
Biblio.EAN = function ( frame )
local args = extractArgs ( frame )
local args = Outils.extractArgs( frame )
local nom = args ['nom1'] or ''
if Outils.trim( args[1] ) then
local newArgs = { ean = args[1], categ = {} }
local i = 2
if nom == '' then
while args[i] do
return ''
newArgs[ 'ean' .. i ] = args[i]
end
i = i + 1
end
local listeRresponsables = { } -- contiendra un élément pour chaque nom
return Biblio.identifiantsBiblio( newArgs )
local directeur = Biblio.abr { 'dir.', 'directeur de publication', abrd = true }
else
local responsable, prenom, lien , precision, resp
return '<small>([[EAN 13|EAN]]&nbsp;inconnu)</small>[[Catégorie:EAN nécessaire]]'
local i = 1
end
repeat -- boucle sur chaque nom, assemble toutes les caractéristique et ajoute l'ensemble à la liste.
prenom = args [ 'prénom' .. i ] or ''
if prenom ~= '' then prenom = prenom .. ' '
end
precision = args [ 'directeur' .. i ] or ''
resp = args [ 'responsabilité' .. i ] or ''
if precision == '' then
if resp ~= '' then
precision = ' (' .. resp .. ')'
end
else
if resp ~= '' then
precision = ' (' .. directeur .. ' et ' .. resp .. ')'
else
precision = ' (' .. directeur .. ')'
end
end
lien = args [ 'lien' .. i ] or ''
if lien ~= '' then
responsable = '[[' .. lien .. '|' .. prenom .. nom .. ']]' .. precision
else
responsable = prenom .. nom .. precision
end
table.insert ( listeRresponsables, responsable )
i = i + 1
nom = args [ 'nom' .. i ] or ''
until nom == ''
if args [ 'et al.' ] == 'oui' then
local et_al = " ''" .. Biblio.abr { "et al.", "et alii (et d’autres)", abrd = true } .. "''"
return table.concat ( listeRresponsables, ', ' ) .. et_al
else
return mw.text.listToText ( listeRresponsables )
end
end
end



-- voir Module biblio/responsabilité secondaire
function Biblio.responsabiliteSecondaire ( frame )
Biblio.ISSN = function ( frame )
local args = extractArgs ( frame )
local args = Outils.extractArgs( frame )
if Outils.trim( args[1] ) then
local traducteur = args.traducteur or ''
local preface = args [ 'préface' ] or ''
local newArgs = { issn = args[1], categ = {} }
local i = 2
local postface = args [ 'postface' ] or ''
while args[i] do
local illustrateur = args.illustrateur or ''
newArgs[ 'issn' .. i ] = args[i]
local photographe = args.photographe or ''
i = i + 1
local libre = args [ 'champ libre' ] or ''
end
local liste = { }
return Biblio.identifiantsBiblio( newArgs )
else
if traducteur ~= '' then
return '<small>([[International Standard Serial Number|ISSN]]&nbsp;inconnu)</small>' .. categorise{ 'ISSN nécessaire', true }
table.insert ( liste, Biblio.abr { 'trad.', 'traduction', abrd = true } .. '&nbsp;' .. traducteur )
end
end
if preface ~= '' then
table.insert ( liste, Biblio.abr { 'préf.', 'préface', abrd = true } .. '&nbsp;' .. preface )
end
if postface ~= '' then
table.insert ( liste, Biblio.abr { 'post.', 'postface', abrd = true } .. '&nbsp;' .. postface )
end
if illustrateur ~= '' then
table.insert ( liste, Biblio.abr { 'ill.', 'illustrations', abrd = true } .. '&nbsp;' .. illustrateur )
end
if photographe ~= '' then
table.insert ( liste, Biblio.abr { 'photogr.', 'photographies', abrd = true } .. '&nbsp;' .. photographe )
end
if libre ~= '' then
table.insert ( liste, libre )
end
local texte = table.concat ( liste , ', ')
if texte ~= '' then
return '(' .. texte .. ')'
else
return ''
end
end
end


Biblio.rechercheIssn = function( frame )
-- voir Modèle:Module biblio/description physique
local args = Outils.extractArgs( frame )
function Biblio.descriptionPhysique ( frame )
local References = require( 'Module:Biblio/Références' )
local args = extractArgs ( frame )
local newArgs = { issn = args[1], sansLabel = true, categ = {} }
local form = args.format or ''
local numeros = args [ 'nombre numéros' ] or ''
local issn = References.issn( newArgs ) or ''
local categ = categorise{ 'Page avec ISSN invalide', newArgs.categ.issnInvalid }
local volumes = args [ 'nombre volumes' ] or ''
return issn .. categ
local tomes = args [ 'nombre tomes' ] or ''
local pages = args [ 'nombre pages' ] or ''
local liste = { }
if form ~= '' then
table.insert ( liste, ', ' .. form )
end
if numeros ~= '' then
table.insert ( liste, ', ' .. numeros .. '&nbsp;numéros' )
end
if volumes ~= '' then
table.insert ( liste, ', ' .. volumes .. '&nbsp;' .. Biblio.abr { 'vol.', 'volumes', abrd = true } )
end
if tomes ~= '' then
table.insert ( liste, ', ' .. tomes .. '&nbsp;' .. Biblio.abr { 't.', 'tomes', abrd = true } )
end
if pages ~= '' then
table.insert ( liste, ', ' .. pages .. '&nbsp;' .. Biblio.abr { 'p.', 'pages', abrd = true } )
end
return table.concat ( liste )
end
end


Biblio.BNF = function ( frame )
-- voir Modèle:COinS bibliographique
local References = require( 'Module:Biblio/Références' )
function Biblio.COinS ( frame )
local args = extractArgs ( frame )
return References.bnf( Outils.extractArgs( frame )[1] )
local liste = { }
-- la fonction insert liste ajoute à la table 'liste' un couple 'nom Coins normalisé' - 'donnée'
-- Si istexte = true, le deuxième élément de tab est considéré comme du texte,
-- sinon comme le nom d'un paramètre.
local function insertList ( key, value, prefix )
prefix = prefix or ''
if value and value ~= '' then
table.insert ( liste, key .. '=' .. mw.uri.encode ( prefix .. value ) )
return true
end
end
-- norme du COinS
insertList ( 'ctx_ver', 'Z39.88-2004' )
-- genre, titre et sous-titre
local tabGenre = {
chapitre = { 'book', 'bookitem', 'rft.btitle', 'rft.atitle', 'titre section' },
article = { 'journal', 'article', 'rft.atitle', 'rft.jtitle', 'périodique' },
ouvrage = { 'book', 'book', 'rft.btitle', 'rft.atitle', 'titre section' },
}
local genre = tabGenre [ args.genre ]
if not genre then
return ''
end
insertList ( 'rft_val_fmt', genre [1], 'info:ofi/fmt:kev:mtx:' )
insertList ( 'rft.genre', genre [2] )
insertList ( genre [3], args.titre )
insertList ( genre [4], args [ genre [5] ] )
insertList ( 'rft.stitle', args ['sous-titre'] )
-- liste des auteur, noms - prénoms
if insertList ( 'rft.aulast', args.nom1 ) then
insertList ( 'rft.aufirst', args [ 'prénom1' ] )
end
insertList ( 'rft.au', args.auteur )
for i = 1, 10 do
local nom = args [ 'nom' .. i]
if nom == nil or nom == '' then
break
else
local prenom = args [ 'prénom' .. i] or ''
if prenom ~= '' then
prenom = ', ' .. prenom
end
insertList ( 'rft.au', nom .. prenom )
end
end
-- date
local datePub = Date.dateISO ( frame )
if datePub then
insertList ( 'rft.date', datePub )
else
insertList ( 'rft.date', args.date )
end
-- doonée phisique de la publication
insertList ( 'rft.volume', args.volume )
insertList ( 'rft.issue', args [ 'numéro' ] )
insertList ( 'rft.pages', args.pages )
insertList ( 'rft.spage', args [ 'page début' ] )
insertList ( 'rft.tpages', args [ 'pages totales' ] )
-- donnée sur l'éditeur
insertList ( 'rft.place', args.lieu )
insertList ( 'rft.pub', args [ 'éditeur' ] )
insertList ( 'rft.edition', args [ 'édition' ] )
-- références internationales
insertList ( 'rft.isbn', args.isbn )
insertList ( 'rft.issn', args.issn )
insertList ( 'rft_id', args.doi, 'info:doi/' )
insertList ( 'rft_id', args.pmid, 'info:pmid/' )
insertList ( 'rft_id', args.oclc, 'info:oclcnum/' )
insertList ( 'rft_id', args.url )
-- referer : page Wikipedia ou se trouve cette référence
insertList ( 'rfr_id', 'fr.wikipedia.org:' .. mw.title.getCurrentTitle().fullText, 'info:sid/' )
return '<span class="Z3988" title="' .. table.concat ( liste, '&' ) .. '">&thinsp;</span>'
end
end

Biblio.enLigne = function ( frame )
local args = Outils.extractArgs( frame )
local References = require( 'Module:Biblio/Références' )
return '<small>[' .. References.enLigne( args ) .. ']</small>'
end

Biblio.identifiantsBiblio = function( frame )
local args = Outils.extractArgs( frame )
args.categ = {}
local References = require( 'Module:Biblio/Références' )
return ( References.affichageLiensExternes( args, nil, true, true ) or '' )
.. categorise{ 'Page avec ISBN invalide', args.categ.isbnInvalid }
.. categorise{ 'Page avec ISSN invalide', args.categ.issnInvalid }
.. categorise{ 'Page avec EAN invalide', args.categ.eanInvalid }
end

return Biblio
return Biblio

Dernière version du 1 juin 2023 à 17:45

 Documentation[voir] [modifier] [historique] [purger]

Ce module sert de base aux fonctions bibliographiques. Lorsqu'elles sont appelées directement par un modèle (via #invoke), les paramètres passés à ce modèle sont automatiquement transmis au module, sauf si le modèle spécifie une autre valeur pour ce paramètre.

Utilisation

Fonctions exportables :

  • ouvrage(frame) – modèle {{Ouvrage}} ;
  • chapitre(frame) – modèle {{Chapitre}} ;
  • article(frame) – modèle {{Article}} ;
  • lienWeb(frame) – modèle {{Lien web}} ;
  • lienBrise(frame) – modèle {{Lien brisé}} ;
  • dictionnaire(frame) – appelle le modèle chapitre si un paramètre titre chapitre, article ou notice est non vide, sinon appelle le modèle ouvrage ;
  • ISBN(frame) – affiche en petit et entre parenthèses ISBN suivi d'autant de codes que de paramètres non nommés, avec lien à la page ad hoc ;
  • ISSN(frame) – affiche en petit et entre parenthèses ISSN suivi d'autant de codes que de paramètres non nommés, avec lien à la page ad hoc ;
  • enLigne() – similaire au modèle {{Lire en ligne}} (le texte par défaut est « en ligne »).

Modules externes et autres éléments dont ce module a besoin pour fonctionner :

Exemples

Utilisation de la fonction ouvrage dans un modèle pour afficher une référence :

  • {{#invoke:Biblio |ouvrage |auteur=Martine Michu |titre=Mes vacances à la mer}}
  • Martine Michu, Mes vacances à la mer

Une page utilisant ce modèle avec le paramètre « passage = 28 » affichera :

  • Martine Michu, Mes vacances à la mer, p. 28
-- Le module biblio centralise les différentes fonctions utiles pour les bibliographie et références.

local Biblio = {  }

require( 'strict' )
local Outils = require( 'Module:Outils' )


Biblio.ouvrage = function ( frame )
	local args = Outils.extractArgs( frame )
	local Ouvrage = require( 'Module:Biblio/Ouvrage' )
	return Ouvrage.ouvrage( args ) 
end


Biblio.chapitre = function ( frame )
	local args = Outils.extractArgs( frame )
	local Ouvrage = require( 'Module:Biblio/Ouvrage' )
	return Ouvrage.chapitre( args ) 
end


Biblio.article = function ( frame )
	local args = Outils.extractArgs( frame )
	local Ouvrage = require( 'Module:Biblio/Article' )
	return Ouvrage.article( args ) 
end


Biblio.lienWeb = function( frame )
	local args = Outils.extractArgs( frame )
	local Ouvrage = require( 'Module:Biblio/Lien web' )
	return Ouvrage.lienWeb( args ) 
end

Biblio.lienBrise = function( frame )
	local args = Outils.extractArgs( frame )
	local Ouvrage = require( 'Module:Biblio/Lien web' )
	return Ouvrage.lienBrise( args )
end


Biblio.dictionnaire = function( frame )
	local args = Outils.extractArgs( frame )
	local article = Outils.validTextArg( args, 'notice', 'article', 'titre chapitre' )
	local Ouvrage = require( 'Module:Biblio/Ouvrage' )
	if article then
		args['titre chapitre'] = article
		return Ouvrage.chapitre( args ) 
	else
		args.titre = args['titre ouvrage']
		args['sous-titre'] = args['sous-titre ouvrage']
		args.auteur1 = args['auteur ouvrage']
		args.auteurs = args['auteurs ouvrage']
		return Ouvrage.ouvrage( args )
	end
end

-- catégorise une page en fonction du namespace
local function categorise(args)
	local namespaceCategorisation = { [0] = true, [4] = true, [10] = true, [12] = true, [14] = true, [100] = true, [104] = true }
	local category = args[1]
	local flag = args[2]
	if type(category) == 'string'
		and flag 
		and namespaceCategorisation[ mw.title.getCurrentTitle().namespace ]
	then
		return '[[Category:' .. category .. ']]'
	end
	return ''
end

Biblio.ISBN = function ( frame )
	local args = Outils.extractArgs( frame )
	if Outils.trim( args[1] ) then
		local newArgs = { isbn = args[1] }
		local i = 2
		while args[i] do
			newArgs[ 'isbn' .. i ] = args[i]
			i = i + 1
		end
		return Biblio.identifiantsBiblio( newArgs )
	else 
		return '<small>([[International Standard Book Number|ISBN]]&nbsp;inconnu)</small>' .. categorise{ 'ISBN nécessaire', true }
	end
end

Biblio.rechercheIsbn = function( frame )
	local args = Outils.extractArgs( frame )
	local References = require( 'Module:Biblio/Références' )
	local newArgs = { isbn = args[1], sansLabel = true, categ = {} }
	local isbn = References.isbn( newArgs ) or ''
	local categ = categorise{ 'Page avec ISBN invalide', newArgs.categ.isbnInvalid }
	return isbn .. categ
end


Biblio.EAN = function ( frame )
	local args = Outils.extractArgs( frame )
	if Outils.trim( args[1] ) then
		local newArgs = { ean = args[1], categ = {} }
		local i = 2
		while args[i] do
			newArgs[ 'ean' .. i ] = args[i]
			i = i + 1
		end
		return Biblio.identifiantsBiblio( newArgs )
	else 
		return '<small>([[EAN 13|EAN]]&nbsp;inconnu)</small>[[Catégorie:EAN nécessaire]]'
	end
end


Biblio.ISSN = function ( frame )
	local args = Outils.extractArgs( frame )
	if Outils.trim( args[1] ) then
		local newArgs = { issn = args[1], categ = {} }
		local i = 2
		while args[i] do
			newArgs[ 'issn' .. i ] = args[i]
			i = i + 1
		end
		return Biblio.identifiantsBiblio( newArgs )
	else 
		return '<small>([[International Standard Serial Number|ISSN]]&nbsp;inconnu)</small>' .. categorise{ 'ISSN nécessaire', true }
	end
end

Biblio.rechercheIssn = function( frame )
	local args = Outils.extractArgs( frame )
	local References = require( 'Module:Biblio/Références' )
	local newArgs = { issn = args[1], sansLabel = true, categ = {} }
	local issn = References.issn( newArgs ) or ''
	local categ = categorise{ 'Page avec ISSN invalide', newArgs.categ.issnInvalid }
	return issn .. categ
end

Biblio.BNF = function ( frame )
	local References = require( 'Module:Biblio/Références' )
	return References.bnf( Outils.extractArgs( frame )[1] )
end

Biblio.enLigne = function ( frame )
	local args = Outils.extractArgs( frame )
	local References = require( 'Module:Biblio/Références' )
	return '<small>[' .. References.enLigne( args )  .. ']</small>'
end

Biblio.identifiantsBiblio = function( frame )
	local args = Outils.extractArgs( frame )
	args.categ = {}
	local References = require( 'Module:Biblio/Références' )
	return ( References.affichageLiensExternes( args, nil, true, true ) or '' )
		.. categorise{ 'Page avec ISBN invalide', args.categ.isbnInvalid }
		.. categorise{ 'Page avec ISSN invalide', args.categ.issnInvalid }
		.. categorise{ 'Page avec EAN invalide', args.categ.eanInvalid }
end

return Biblio