La documentacion d'utilizacion d'aquel modul se pòt crear a Mòdul:Biblio/Article/ús

local Article = { }


local Commun = require( 'Module:Biblio/Comun' )
local References = require( 'Module:Biblio/Referéncias' )
local Outils = require( 'Module:Aisinas' )
local TableBuilder = require( 'Module:TableBuilder' )
local Langue = require( 'Module:Lenga' )


function Article.article( args )
	-- La table wiki va recevoir tout les petits bouts de texte, et sera concaténtée à la fin.
	-- Elle utilise la metat-table de TableBuilder, permettant d'utiliser les fonctions de la 
	-- librairy table comme des mèthodes. minsert permet d'insérer plusieurs élément en une 
	-- seule fois en, ignorant les paramètre nil.
	local wiki = TableBuilder.new()
	
	-- validArg renvoi le premier paramètre non vide, ou nil s'ils sont tous vides.
	-- Seul les noms des paramètres doivent être transmis à la fonction.
	local validArg = function ( ... ) return Commun.validTextArg( args, ... ) or false end
	
	-- table servant à la catégorisation
	args.categ = {}
	
	-- clarification paramètre nécessaire pour les COinS
	args['periodic'] = validArg( 'périodique', 'revue', 'journal', 'periodic', 'revista', 'jornal' )
	args.titre = validArg( 'titre', 'títol', 'title' )
	args.passage = validArg( 'pages', 'page', 'passage', 'paginas', 'pagina', 'passatge', 'p.', 'pp.' )
	args['format électronique'] = args.format
	args.format = false
	
	
	-- span initial (id) et libellé
	local spanInitial, spanFinal = Commun.spanInitial ( args, validArg )
	wiki.minsert( spanInitial,  Commun.libelle( args ) )
	
	-- indication de langue
	local indicLangue, codeLangue = Commun.indicationDeLangue ( args, validArg )
	if Outils.notEmpty( indicLangue ) then
		wiki.minsert( indicLangue, ' ' )
	end
	
	-- Liste des auteurs et de leur responsabilités (principale et secondaire)
	if validArg( 'nom1', 'nom', 'auteur1', 'auteur', 'auteurs', 'auteur institutionnel', 'autor1', 'autor', 'autors', 'autor institucional', 'last1', 'last', 'author1', 'author' ) then
		if validArg( 'autors' ) then
			wiki.minsert( args.auteurs )
		else
			 wiki.minsert( Commun.responsabilitePrincipale( args, validArg ) )
		end
		wiki.minsert( Commun.responsabiliteSecondaire( args, validArg ), ', ' )
		
		args.categ.auteur = validArg( 'auteur', 'auteurs', 'autor', 'autors', 'author1', 'author', 1, 2, 3, 4 )
		args.categ.coauteur = validArg( 'coauteurs', 'coauteur', 'coautors', 'coautor', 'coauthors' )
	end
	
	-- titre, sous-titre
	if args.titre then
		if codeLangue then
			local dir = Langue.directionLangue( codeLangue )
			if dir == 'rtl' then dir = '" dir="rtl'
			else dir = nil
			end
			wiki.minsert( '<span lang="', codeLangue, dir, '">')
		end
		
		local titre, sousTitre = args.titre, validArg( 'sostítol' )
		if sousTitre then
			titre = titre .. ' : ' .. sousTitre
		end
		titre = Commun.fusionTexteLien( titre, args['ligam títol'], args.categ )
		
		wiki.minsert( '« <cite style="font-style:normal;">', titre, '</cite> »', codeLangue and '</span>' )
	else
		args.categ.titre = true
		wiki.minsert( Outils.erreur( '[[Modèl:Article|{{Article}}]] : paramètre « <code>títol</code> » mancant' ) )
	end
	local traductionTitre = validArg( 'traduction titre', 'titre original', 'traduccion títol', 'títol original' )
	if traductionTitre and traductionTitre ~= args.titre then
		wiki.minsert( ' [« ', traductionTitre, ' »]' )
	end
	
	-- Nature du document et établissement (pour les thèses...)
	local nature = validArg( 'nature article', 'nature ouvrage', 'natura article', 'natura obratge' )
	if nature then
		wiki.minsert( ' (', nature, ')')
	end
	local etablissement = validArg( 'établissement', 'establiment' )
	if etablissement then
		wiki.minsert( ', ', etablissement )
	end
	
	-- périodique
	local periodique = validArg( 'périodique', 'periodic' )
	if periodique then
		-- on applique le code langue spécifique ou celui de l'article
		local languePeriodique = validArg( 'langue périodique', 'lenga periodica' )
		if languePeriodique then
			languePeriodique = Langue.codeLangue2( languePeriodique )
		end
		languePeriodique = languePeriodique or codeLangue
		if languePeriodique and languePeriodique ~= 'fr' then
			periodique = Langue.lang{ languePeriodique, periodique }
		end
		
		local periodiqueEtLien = Commun.fusionTexteLien( periodique, args['ligam periodic'], args.categ )
		if Langue.nonLatin( periodique ) then
			-- caractères non latin donc police droite
			wiki.minsert( ', ', periodiqueEtLien )
		else
			-- le titre et son lien éventuel son affichés en italique
			wiki.minsert( ', <i>', periodiqueEtLien, '</i>' )
		end
		
	else
		args.categ.periodique = true
		if args.categ.titre then
			wiki.minsert( ', ', Outils.erreur( 'paramètre « <code>periodic</code> » mancant' ) )
		else
			wiki.minsert( ', ', Outils.erreur( '[[Modèl:Article|{{Article}}]] : paramètre « <code>periodic</code> » mancant' ) )
		end
	end
	
	-- références : lieu, éditeur
	local lieu = validArg( 'lieu', 'lieu édition', 'luòc', 'luòc edicion', 'location' )
	if lieu then
		wiki.minsert( ', ', lieu )
	end
	local editeur = validArg( 'éditeur', 'editor', 'publisher' )
	if editeur then
		local lienEditeur = validArg( 'lien éditeur', 'ligam editor' )
		wiki.minsert( ', ', Commun.fusionTexteLien( editeur, lienEditeur, args.categ ) )
	end
	
	-- références : série, volume
	local serie = validArg( 'série', 'seria', 'serie' )
	if serie then
		if tonumber( serie ) then
			wiki.minsert( ', ', Outils.ordinal( serie, true ), ' seria' )
		else
			if string.match( serie, '<sup>e</sup>$') then
				wiki.minsert( ', ', serie, ' seria' )
			else
				wiki.minsert( ', seria ', serie )
			end
		end
	end
	local volume = validArg( 'volume', 'volum', 'vol' )
	if volume then
		wiki.minsert( ', ', Commun.vol, volume )
	end
	local tome = validArg( 'tome', 'tòme', 'tòm' )
	if tome then
		wiki.minsert( ', ', Commun.tome, tome )
	end
	local titreVolume = validArg( 'titre volume', 'titre vol', 'títol volum', 'títol vol' )
	if titreVolume then
		if codeLangue then
			wiki.minsert( ' ', Langue.lang{ codeLangue, '« ' .. titreVolume .. ' »' } )
		else
			wiki.minsert( ' « ', titreVolume, ' »' )
		end
	end
	
	-- références : n° du périodique et titre du n° et date de publication
	local numero = validArg( 'numéro', 'numèro', 'no', 'issue', 'eissida' )
	if numero then
		wiki.minsert( ', ', Commun.numero, numero )
	end
	local titreNumero = validArg( 'titre numéro', 'titre no', 'títol numèro', 'títol no' )
	if titreNumero then
		if codeLangue then
			wiki.minsert( ' ', Langue.lang{ codeLangue, '« ' .. titreNumero .. ' »'  } )
		else
			wiki.minsert( ' « ', titreNumero, ' »' )
		end
	end
	if validArg( 'année', 'date', 'annada', 'data', 'year' ) then
		args.mois = validArg( 'mois', 'saison', 'mes', 'sason' )
		wiki.minsert( ',&lrm; ', Commun.inscriptionDate( args ) )
		-- le &lrm est une marque de texte gauche à droite, utile si le texte qui précède est en droite à gauche (arabe, hébreux...)
	else
		args.categ.date = true
		if args.categ.titre or args.categ.periodique then
			wiki.minsert( ', ', Outils.erreur( 'paramètre « <code>annada</code> » o « <code>data</code> » mancant' ) )
		else
			wiki.minsert( ', ', Outils.erreur( '[[Modèl:Article|{{Article}}]] : paramètre « <code>annada</code> » o « <code>date</code> » mancant' ) )
		end
	end	
	
	-- format livre
	local format = validArg( 'format livre', 'format libre' )
	if format then
		wiki.minsert( ', ', format )
	end
	
	-- pages
	local page =  validArg( 'passage', 'pages', 'page', 'passatge', 'paginas', 'pagina', 'p.', 'pp.' )
	if page then
		if string.match ( page, '^[%dIVXL]' ) then
			wiki.minsert( ', ', Commun.page, page )
		else
			wiki.minsert( ', ', page )
		end
	end	
	local noArticle = validArg( 'numéro article', 'numèro article' )
	if noArticle then
		wiki.minsert( ', article ', Commun.numero, noArticle )
	end
	
	-- lien vers l'article en ligne (isbn, issn, pmid, doi, lire en ligne, résumé...)
	wiki.minsert( References.affichageLiensExternes( args, validArg, true, false ) )
	-- consulté le n'est plus affiché, voir [[Discussion_modèle:Ouvrage/Archive_5#.C3.89volution_documentation]]
	
	local patternPonct = '[,.;:!?]$'
	local ponctuation = wiki.concat():gsub( '%b<>', '' ):match( patternPonct )
	
	-- ajout des méthadonnées COinS (ContextObjects in Spans)
	wiki.minsert( Commun.COinS( args, validArg, 'article' ) )
	
	-- fin du span (id) et de la description de l'ouvrage
	wiki.minsert( spanFinal )
	
	-- citation et commentaire de cet ouvrage
	local citation = validArg( 'extrait', 'extrach', 'quote', 'citation', 'citacion' )
	if citation then
		wiki.minsert( ' :<blockquote>« ', citation, ' »</blockquote>' )
	end
	
	if validArg( 'plume', 'pluma' ) then
		local point
		if not citation and not ponctuation then
			point = '.'
		end
		wiki.minsert( point, Commun.plume )
	end
	
	wiki.minsert( Commun.commentaire( args ) )
	
	
	if mw.title.getCurrentTitle().namespace == 0 then
		wiki.minsert(
			args.categ.coauteur and '[[Categoria:Recension temporària pel modèle Article|coautor]]',
			args.categ.langue  and '[[Categoria:Pagina del modèl Article comportant una error|lenga]]',
			args.categ.titre and '[[Categoria:Pagina del modèl Article comportant una error|titol]]',
			args.categ.periodique and '[[Categoria:Pagina del modèl Article comportant una error|periodic]]',
			args.categ.date and '[[Categoria:Pagina del modèl Article comportant una error|data]]',
			args.categ.lienExterne and '[[Categoria:Pagina del modèl Article comportant una error|externe]]',
			args.categ.isbnInvalid and '[[Categoria:Obratge amb ISBN invalid]]',
			args.categ.issnInvalid and '[[Categoria:Pagina amb ISSN invalid]]'
		)
		if codeLangue then
			if Langue.directionLangue( codeLangue ) == 'rtl' then
				wiki.minsert( '[[Categoria:Recension temporària pel modèl Article|rtl]]' )
			end
		end
	end
	
	
	return wiki.concat()
end


return Article