Voir la source de Initiation au Lua avec Scribunto/L'objet Title

{{Chapitre
  | idfaculté  = informatique
  | précédent  = [[../L'objet Frame/]]
  | suivant    = [[../L'objet URI/]]
  | page_liée  = Exercices/Sur l’objet Title
  | numéro     = 13
  | niveau     = 10
}}
Nous devons pas perdre de vue que le Lua a été implanté avec Scribunto afin de faciliter la gestion des pages se trouvant dans les différents projets de la fondation Wikimédia. Nous allons donc voir, dans ce chapitre, comment accéder à ces pages et plus précisément, comment accéder à divers renseignements concernant ces pages. Que ce soit le contenu des pages, le titre, ou d'autres renseignements, nous allons voir que nous disposons de toute une palette de fonctions utiles et pratiques qu’il nous faut bien maîtriser.
__TOC__
{{Clr}}
== L'objet Title  ==


== La librairie Title  ==

Dans ce paragraphe, nous allons étudier en détail les fonctions se trouvant dans la librairie Title.


==== mw.title.new ====

Cette commande est essentielle car c’est elle qui va créer un nouvel objet Title concernant la page passée en argument. Cette commande renvoie une table contenant tout ce qui est nécessaire pour obtenir des renseignements concernant la page rentrée en argument. Par exemple :

après :

<syntaxhighlight lang="lua">
local title1 = mw.title.new(page1)
local title2 = mw.title.new(page2)
</syntaxhighlight>

Les tables '''title1''' et '''title2''' contiendront tout ce qui est nécessaire pour obtenir des renseignements respectivement sur les pages dont les noms sont contenus dans les variables page1 et page2.

Comme exemple d'application, voir tous les exemples donnés ci-dessous car, sans cette commande, aucun accès aux pages n'est possible.


{{Attention|Nous devons aussi notez que cette commande est très vorace en temps d'exécution. En conséquence, il n’est pas autorisé de l’utiliser plus de 99 fois dans une même page. Voir : [[mw:Manual:$wgExpensiveParserFunctionLimit]]}}


{{Attention|Contrairement à ce que l’on pourrait croire à priori, si la page entrée en argument n'existe pas, un objet title est tout de même créé. C'est à l'intérieur de cet objet title que l’on aura des indications sur l'existence ou non de la page}}

==== mw.title.equals ====

{{...}}

==== mw.title.compare ====

{{...}}

==== mw.title.getCurrentTitle ====

Cette fonction crée un objet Title comme le ferait la fonction [[#mw.title.new|title.new]] mais concernant la page ou se trouve le module contenant la fonction. Si le module contenant cette fonction se trouve dans un modèle, la fonction retournera le titre de la page dans laquelle le modèle est placé.


Pour un exemple d'utilisation, voir le sous- paragraphe [[#title.text|title.text]] plus bas, dans cette page.


==== mw.title.makeTitle ====

Nous avons ici une troisième fonction qui créé un objet Title. Sa particularité est que le titre de la page, dont on veut créer l’objet Title, est fourni par morceaux à travers ses paramètres.

'''mw.title.makeTitle(Espace,titre,fragment, interwiki)'''

Pour le paramètre ''espace'', on rentrera le numéro ou le nom de l'espace où se trouve la page.

Pour la Wikiversité, nous donnons la correspondance entre le numéro d'espace et le nom d'espace dans le tableau suivant :
{{Encadre
  | couleur   = rouge
  | épaisseur = 3px
  | fond      = Bisque
  | contenu   =
* 0 : Espace principal.
* 1 : Discussion de l'espace principal.
* 2 : Espace utilisateur.
* 3 : Espace discussion utilisateur.
* 4 : Espace Wikiversité.
* 5 : Espace discussion Wikiversité.
* 6 : Espace fichier.
* 7 : Espace discussion fichier.
* 8 : Espace média wiki.
* 9 : Espace discussion média wiki.
* 10 : Espace modèle.
* 11 : Espace discussion modèle.
* 12 : Espace aide.
* 13 : Espace discussion aide.
* 14 : Espace catégorie.
* 15 : Espace discussion catégorie.
* 102 : Espace projet
* 103 : Espace discussion projet
* 104 : Espace recherche
* 105 : Espace discussion recherche
* 106 : Espace faculté
* 107 : Espace discussion faculté
* 108 : Espace département
* 109 : Espace discussion département
* 110 : Espace transwiki
* 111 : Espace discussion transwiki
* 828 : Espace module
* 829 : Espace discussion module
}}


Pour le paramètre ''titre'', on rentrera le titre de la page, sans préfixe.


Pour le paramètre ''fragment'', on rentrera le fragment. Qu’est ce qu'un fragment ? voir à le propos la page [[w:Identificateur de fragment|Identificateur de fragment]]


Pour le paramètre ''interwiki'', voir la page [[w:Interwiki|Interwiki]]


Les deux derniers paramètres ''fragment'' et ''interwiki'' sont facultatifs (ouf!)


{{Encart
  | couleur = olive
  | symbole = question
  | contenu =
'''Question : ''' Pourquoi s’embêter avec la fonction ''mw.title.makeTitle'' ? Pourquoi ne pas prendre la fonction ''mw.title.new'' et taper simplement en paramètre le nom de la page avec son préfixe ?

'''Réponse :''' Pour des besoins de programmation, les paramètres de la fonction ''mw.title.makeTitle'' peuvent être variables et sont fournis par d'autres fonctions ou des variables. En fait la fonction ''mw.title.makeTitle'' se trouvera dans un module placé dans un modèle qui sera placé dans un grand nombre de pages et l’objet Title que l’on voudra obtenir dépendra de la page où est placé le modèle.
}}


Nous donnons ci-dessous un exemple simple :

<syntaxhighlight lang="lua">
local p = {}

function p.creation(frame)
	local reponse = ""
	local title = mw.title.makeTitle(frame.args[1],frame.args[2])
	reponse = reponse.."<br>Le titre de la page dont on vient de créer l’objet Title est : "..title.prefixedText
	return reponse
end

return p
</syntaxhighlight>

(Voir [[#title.prefixedText|title.prefixedText]] que nous avons utilisé dans le programme)


'''<nowiki>{{#invoke:Title|creation|12|Maintenance à l'aide du Lua}}</nowiki>''' nous donne : {{#invoke:Title|creation|12|Maintenance à l'aide du Lua}}


== Objets en relation avec l’objet Title  ==

Tous les exemples de ce paragraphe se trouvent dans le [[Module:Title]]


Les objets que nous allons étudier dans ce paragraphe se trouvent dans l’objet '''Title'''. Nous commencerons donc par écrire une fonction '''p.visualisation''' permettant de les visualiser.


<syntaxhighlight lang="lua">
local p = {}

function p.visualisation(frame)
	title = mw.title.new(frame.args[1])
	reponse = ""
	for index, objet in pairs(title) do
		reponse = reponse.."<br />À la clé '''"..index.."''', on trouve un objet de type : "..type(objet)
	end
	return reponse
end

return p
</syntaxhighlight>


'''<nowiki>{{#invoke:Title|visualisation|{{PAGENAME}}}}</nowiki>''' nous donne : {{#invoke:Title|visualisation|{{PAGENAME}}}}


Nous voyons que nous avons un grand nombre d'objets à étudier, alors ne perdons pas de temps !


==== title.Redirect ====
{{...}}

'''title.Redirect''' indique si la page est une redirection.


Exemple :

<syntaxhighlight lang="lua">
local p = {}

function p.redirection(frame)
	local page = frame.args[1]
	local title = mw.title.new(page)
	if title.Redirect then
		return "<br />La page '''"..page.."''' est une redirection."
	else
		return "<br />La page '''"..page.."''' n’est pas une redirection."
	end
end

return p
</syntaxhighlight>

'''<nowiki>{{#invoke:Title|redirection|Bac à sable}}</nowiki>''' nous donne : {{#invoke:Title|redirection|Bac à sable}}


'''<nowiki>{{#invoke:Title|redirection|Aide:Maintenance à l'aide du Lua}}</nowiki>''' nous donne : {{#invoke:Title|redirection|Aide:Maintenance à l'aide du Lua}}


(Et l’on constate que cela ne marche pas ! un bon point pour celui qui trouvera pourquoi ! )


==== title.fullUrl ====

{{...}}


''title.fullUrl'' est de type ''function''. ''title.fullUrl(query, proto)'' Retourne l'URL complète de la page (avec optionnellement un "query", une chaîne ou une table). ''proto'' est optionnel et permet de préciser "http", "https", "relative" (par défaut), ou "canonical".


==== title.canonicalUrl ====

{{...}}


title.canonicalUrl est de type function. title.canonicalUrl(query) retourne l'URL canonique de la page (avec optionnellement un "query", une chaîne ou une table)


==== title.fragment ====

{{...}}


''title.fragment'' est de type ''string'' et donne le fragment (voir [[w:Identificateur de fragment]]).


==== title.subjectPageTitle ====

{{...}}


identique à mw.title.makeTitle( mw.site.namespaces[title.namespace].subject.id, title.text ).


==== title.isExternal ====

{{...}}


indique si la page a un interwiki


==== title.thePartialUrl ====

{{...}}


==== title.text ====

'''title.text''' contient le titre de la page concernée par l’objet Title. On imagine facilement qu’il serait absurde de créer un objet Title en utilisant la fonction [[#mw.title.new|mw.title.new]] pour avoir le titre d'une page car justement le titre de la page est fourni en argument à la fonction '''mw.title.new'''. L'objet Title sera donc, dans ce cas, logiquement fourni par la fonction [[#mw.title.getCurrentTitle|mw.title.getCurrentTitle]] ou par la fonction [[#mw.title.makeTitle|mw.title.makeTitle]].


Écrivons, par exemple, une fonction '''p.titre''' qui nous indique le titre de la page que nous sommes en train de lire !

<syntaxhighlight lang="lua">
local p = {}

function p.titre()
	local titr = mw.title.getCurrentTitle()
	return "Le titre de cette page est : "..titr.text
end

return p
</syntaxhighlight>

'''<nowiki>{{#invoke:Title|titre}}</nowiki>''' nous donne : {{#invoke:Title|titre}}


==== title.prefixedText ====

''title.prefixedText'' est de type ''string''. Cette variable contient le titre de la page avec l'espace de noms ainsi que l'interwiki.

Si l’on souhaite avoir en plus le fragment, on utilisera à la place [[#title.fullText|title.fullText]]

Donnons un exemple :

Le programme, ci-dessous, créé un objet Title et affiche le nom complet de la page concernée

<syntaxhighlight lang="lua">
local p = {}

function p.creation(frame)
	local reponse = ""
	local title = mw.title.makeTitle(frame.args[1],frame.args[2])
	reponse = reponse.."<br>Le titre de la page dont on vient de créer l’objet Title est : "..title.prefixedText
	return reponse
end

return p
</syntaxhighlight>


'''<nowiki>{{#invoke:Title|creation|Aide|Maintenance à l'aide du Lua}}</nowiki>''' nous donne : {{#invoke:Title|creation|Aide|Maintenance à l'aide du Lua}}


==== title.isTalkPage ====

indique si la page est une page de discussion

Exemple :

<syntaxhighlight lang="lua">
local p = {}

function p.discussion(frame)
	local page = frame.args[1]
	local title = mw.title.new(page)
	if title.isTalkPage then
		return "<br />La page '''"..page.."''' est une page de discussion."
	else
		return "<br />La page '''"..page.."''' n’est pas une page de discussion."
	end
end

return p
</syntaxhighlight>

'''<nowiki>{{#invoke:Title|discussion|Discussion:Initiation au Lua avec Scribunto}}</nowiki>''' nous donne : {{#invoke:Title|discussion|Discussion:Initiation au Lua avec Scribunto}}


'''<nowiki>{{#invoke:Title|discussion|Aide:Maintenance à l'aide du Lua}}</nowiki>''' nous donne : {{#invoke:Title|discussion|Aide:Maintenance à l'aide du Lua}}


==== title.exists ====

C'est un booléen qui nous indique si la page existe. Ceci peut paraître bizarre dans la mesure où l’on pourrait croire que, si une page n'existe pas, la fonction mw.title.new() devrait nous retourner ''nil''. C'est faux ! Si la page n'existe pas alors l’objet title est tout de même créé, mais le booleen title.exists sera à ''false''. Nous allons vérifier ce que l’on vient de dire en faisant un programme qui nous indique si, d'une part, l’objet title existe et si, d’autre part, la page associée à cet objet title existe.


<syntaxhighlight lang="lua">
local p = {}

function p.existe(frame)
	local reponse = ""
	local page = frame.args[1]
	local title = mw.title.new(page)
	if title then
		reponse = reponse.."L'objet title existe "
	else
		reponse = reponse.."L'objet title n'existe pas "
	end
	if title.exists then
		reponse = reponse.."et la page existe. "
	else
		reponse = reponse.."et la page n'existe pas. "
	end
	return reponse
end

return p
</syntaxhighlight>


'''<nowiki>{{#invoke:Title|existe|Bof}}</nowiki>''' nous donne : {{#invoke:Title|existe|Bof}}


'''<nowiki>{{#invoke:Title|existe|Aide:Maintenance à l'aide du Lua}}</nowiki>''' nous donne : {{#invoke:Title|existe|Aide:Maintenance à l'aide du Lua}}


==== title.talkPageTitle ====

Cette commande est identique à '''mw.title.makeTitle( mw.site.namespaces[title.namespace].talk.id, title.text )''', ou à '''nil''' si la page ne peut pas avoir de page de discussion.

Plus simplement, cette commande créé un objet title pour la page de discussion associée à la page dont on a créé un objet title appelé '''title'''

Par exemple si, sur la Wikiversité, on a créé un objet title pour une page de l'espace principal appelé '''title''', cette commande est identique a '''mw.title.makeTitle( 1 , title.text )'''. Car 1 est le numéro d'espace pour une page de discussion de l'espace principal.


==== title.inNamespace ====

{{...}}


''title.inNamespace'' est de type ''function''. ''title.inNamespace(ns)'' indique si la page est dans l'espace de noms indiqué. ''ns'' peut être toute clé trouvée dans ''mw.site.namespaces''.


==== title.isSubpageOf ====

{{...}}


''title.isSubpageOf'' est de type ''function''. ''title.isSubpageOf(title2)'' indique si la page est une sous-page de ''title2''.


==== title.canTalk ====

indique si la page peut avoir une page de discussion

Exemple :

<syntaxhighlight lang="lua">
local p = {}

function p.discute(frame)
	local page = frame.args[1]
	local title = mw.title.new(page)
	if title.canTalk then
		return "<br />La page '''"..page.."''' peut avoir une page de discussion."
	else
		return "<br />La page '''"..page.."''' ne peut pas avoir une page de discussion."
	end
end

return p
</syntaxhighlight>

'''<nowiki>{{#invoke:Title|discute|Spécial:Nouvelles pages}}</nowiki>''' nous donne : {{#invoke:Title|discute|Spécial:Nouvelles pages}}


'''<nowiki>{{#invoke:Title|discute|Aide:Maintenance à l'aide du Lua}}</nowiki>''' nous donne : {{#invoke:Title|discute|Aide:Maintenance à l'aide du Lua}}


==== title.getContent ====

Cette commande retourne le contenu de la page concernée par l’objet Title. Contrairement à ce que l’on pourrait penser ''a priori'', l'argument de cette commande est l’objet Title retourné par la commande mw.title.new et pas le nom de la page dont on extrait le contenu. Par exemple, on écrira :

<syntaxhighlight lang="lua">
local title = mw.title.new(page)
local texte = title.getContent(title)
</syntaxhighlight>

C'est-à-dire que l’on commence par créer un objet Title (ici la table title) et on passe cette table comme argument de la fonction '''title.getContent''' pour recueillir dans la variable '''texte''' le contenu de la page dont le titre était dans la variable '''page'''.

{{Encart
  | couleur = olive
  | symbole = question
  | contenu =
'''Question : '''Pourquoi n'existe-t-il pas une fonction qui permettrait d'obtenir directement le contenu d'une page en donnant le nom de cette page en argument ? Ce qui éviterait la création d'un objet Title et devrait permettre ainsi de gagner en temps d'exécution !

'''Réponse :''' <small>(Si vous avez la réponse à cette question, veuillez remplacer cette phrase entre parenthèse par celle-ci)</small>
}}


Donnons un exemple concret en écrivant une fonction '''p.mot''' qui permet de dire si un mot se trouve dans la page : [[Statique/Présentation de la leçon]].

<syntaxhighlight lang="lua">
local p = {}

function p.mot(frame)
	local mot = frame.args[1]
	local page = "Statique/Présentation de la leçon"
	local title = mw.title.new(page)
	local texte = title.getContent(title)
	local position = mw.ustring.find(texte,mot)
	if position then
		return "Le mot "..mot.." a été trouvé en position "..position
	else
		return "Le mot "..mot.." n'a pas été trouvé dans la page"
	end
end

return p
</syntaxhighlight>

'''<nowiki>{{#invoke:Title|mot|système}}</nowiki>''' nous donne : {{#invoke:Title|mot|système}}

'''<nowiki>{{#invoke:Title|mot|cacahuète}}</nowiki>''' nous donne : {{#invoke:Title|mot|cacahuète}}


==== title.hasSubjectNamespace ====

{{...}}

''hasSubjectNamespace'' est de type ''function''. ''hasSubjectNamespace(ns)'' indique si l'espace de noms sujet de la page est dans l'espace de noms indiqué. ns peut être toute clé trouvée dans ''mw.site.namespaces''


==== title.partialUrl ====

{{...}}


''title.partialUrl'' est de type ''function''. ''title.partialUrl(text)'' retourne ''text'' encodé comme une URL


==== title.isSubpage ====

Indique si la page est une sous-page.

Exemple :

<syntaxhighlight lang="lua">
local p = {}

function p.souspage(frame)
	local page = frame.args[1]
	local title = mw.title.new(page)
	if title.isSubpage then
		return "<br />La page '''"..page.."''' est une sous-page."
	else
		return "<br />La page '''"..page.."''' n’est pas une sous-page."
	end
end

return p
</syntaxhighlight>

'''<nowiki>{{#invoke:Title|souspage|Initiation au Lua avec Scribunto/L'objet Frame}}</nowiki>''' nous donne : {{#invoke:Title|souspage|Initiation au Lua avec Scribunto/L'objet Frame}}


'''<nowiki>{{#invoke:Title|souspage|Aide:Maintenance à l'aide du Lua}}</nowiki>''' nous donne : {{#invoke:Title|souspage|Aide:Maintenance à l'aide du Lua}}


==== title.isSpecialPage ====

Indique si la page est dans l'espace de noms "Spécial:"

Exemple :

<syntaxhighlight lang="lua">
local p = {}

function p.special(frame)
	local page = frame.args[1]
	local title = mw.title.new(page)
	if title.isSpecialPage then
		return "<br />La page '''"..page.."''' est une page spéciale."
	else
		return "<br />La page '''"..page.."''' n’est pas une page spéciale."
	end
end

return p
</syntaxhighlight>

'''<nowiki>{{#invoke:Title|special|Spécial:Nouvelles pages}}</nowiki>''' nous donne : {{#invoke:Title|special|Spécial:Nouvelles pages}}


'''<nowiki>{{#invoke:Title|special|Aide:Maintenance à l'aide du Lua}}</nowiki>''' nous donne : {{#invoke:Title|special|Aide:Maintenance à l'aide du Lua}}


==== title.basePageTitle ====

''title.basePageTitle'' est une fonction qui retourne un nouvel objet title. Si title est un objet title concernant une sous-page, alors ''title.basePageTitle'' retourne un objet title concernant la page ayant pour sous-page, la sous-page du premier objet title.

Plus précisément, si title est par exemple l’objet title de la page : ''Recherche:Les asticots/Introduction'', title.basePageTitle retournera un objet title associé à la page : ''Recherche:Les asticots''

Bien sur, si le premier objet title concerne une page qui n’est pas une sous-page, le deuxième objet title, créé par ''title.basePageTitle'', concernera la même page


Écrivons un petit programme pour mieux comprendre la syntaxe et voir l'effet sur différents types de pages :

<syntaxhighlight lang="lua">
local p = {}

function p.basepagetitle(frame)
	local reponse = ""
	local page = frame.args[1]
	local title = mw.title.new(page)
	local titlebase = title.basePageTitle
	reponse = reponse.."<br>Le premier objet title concerne la page : "..title.prefixedText
	reponse = reponse.."<br>Le deuxième objet title concerne la page : "..titlebase.prefixedText
	return reponse
end

return p
</syntaxhighlight>


'''<nowiki>{{#invoke:Title|basepagetitle|Bof/Niouf}}</nowiki>''' nous donne : {{#invoke:Title|basepagetitle|Bof/Niouf}} (bien que la page Bof/Niouf n'existe pas!)


'''<nowiki>{{#invoke:Title|basepagetitle|Aide:Maintenance à l'aide du Lua}}</nowiki>''' nous donne : {{#invoke:Title|basepagetitle|Aide:Maintenance à l'aide du Lua}}


'''<nowiki>{{#invoke:Title|basepagetitle|Recherche:Les fonds patrimoniaux des bibliothèques publiques/Parchemin et cuir}}</nowiki>''' nous donne : {{#invoke:Title|basepagetitle|Recherche:Les fonds patrimoniaux des bibliothèques publiques/Parchemin et cuir}}


Nous voyons aussi que ''title.basePageTitle'' est identique à ''mw.title.makeTitle(title.namespace,title.baseText)''


==== title.baseText ====

''title.baseText'' est un objet de type ''string''. Si l’on a affaire à une sous-page, ''title.baseText'' donne le titre de la page dont c’est la sous-page, sans préfixe d'espace. Sinon ''title.baseText'' a le même effet que [[#title.text|title.text]]. Nous voyons alors que ''title.baseText'' est l'équivalent de <nowiki>{{BASEPAGENAME}}</nowiki> dans la syntaxe wiki. Écrivons un petit programme pour voir comment se comporte ''title.baseText'' avec un choix de page donnée en argument :

<syntaxhighlight lang="lua">
local p = {}

function p.base(frame)
	local reponse = ""
	local page = frame.args[1]
	local title = mw.title.new(page)
	reponse = reponse.."Pour la page : '''"..page.."''', ''title.baseText'' nous donne : '''"..title.baseText.."'''."
	return reponse
end

return p
</syntaxhighlight>


'''<nowiki>{{#invoke:Title|base|Bof/Niouf}}</nowiki>''' nous donne : {{#invoke:Title|base|Bof/Niouf}} (bien que la page Bof/Niouf n'existe pas!)


'''<nowiki>{{#invoke:Title|base|Aide:Maintenance à l'aide du Lua}}</nowiki>''' nous donne : {{#invoke:Title|base|Aide:Maintenance à l'aide du Lua}}


'''<nowiki>{{#invoke:Title|base|Recherche:Les fonds patrimoniaux des bibliothèques publiques/Parchemin et cuir}}</nowiki>''' nous donne : {{#invoke:Title|base|Recherche:Les fonds patrimoniaux des bibliothèques publiques/Parchemin et cuir}}


==== title.nsText ====

{{...}}


''title.nsText'' est de type ''string'' et donne le nom de l'espace de noms de la page concernée.


==== title.isLocal ====

{{...}}

Indique si la page est locale au projet. Par exemple sur en: tous les Wikipédias sont considérés comme locaux mais pas les Wiktionnaires.

Exemple :

<syntaxhighlight lang="lua">
local p = {}

function p.locale(frame)
	local page = frame.args[1]
	local title = mw.title.new(page)
	if title.isLocal then
		return "<br />La page '''"..page.."''' est locale au projet."
	else
		return "<br />La page '''"..page.."''' n’est pas locale au projet."
	end
end

return p
</syntaxhighlight>

'''<nowiki>{{#invoke:Title|locale|Initiation au Lua avec Scribunto}}</nowiki>''' nous donne : {{#invoke:Title|locale|Initiation au Lua avec Scribunto}}


'''<nowiki>{{#invoke:Title|locale|en:wikt:amandantium}}</nowiki>''' nous donne : {{#invoke:Title|locale|en:wikt:amandantium}}


(ça n'a pas l'air de marcher, à revoir)


==== title.fullText ====

{{...}}


''title.fullText'' est de type ''string'' et donne le titre de la page, avec l'espace de nom, l'interwiki et le fragment.


==== title.subPageTitle ====

{{...}}


''title.subPageTitle'' est de type ''function''. ''subPageTitle(text)'' est identique à ''mw.title.makeTitle( title.namespace, title.text .. '/' .. text )''


==== title.inNamespaces ====

{{...}}


''title.inNamespaces'' est de type ''function''. ''title.inNamespaces(...)'' indique si la page est dans l'un des espaces de nom indiqués. Les espaces de noms peuvent être toute clé trouvée dans ''mw.site.namespaces''.


==== title.id ====

C'est un objet de type ''number'' qui nous donne l'identifiant de la page. Chaque page créée sur un Wiki a un identifiant. La première page créée a l'identifiant 1. La deuxième page créée a l'identifiant 2 et ainsi de suite. Si la page n'existe pas, ce nombre sera égal à 0. Nous allons vérifier ce que l’on vient de dire en faisant un programme qui nous indique si la page entrée en argument existe et quel est son identifiant.


<syntaxhighlight lang="lua">
local p = {}

function p.identifiant(frame)
	local reponse = ""
	local page = frame.args[1]
	local title = mw.title.new(page)
	if title.exists then
		reponse = reponse.."La page existe. "
	else
		reponse = reponse.."La page n'existe pas. "
	end
	reponse = reponse.."L'identifiant de la page est "..title.id
	return reponse
end

return p
</syntaxhighlight>


'''<nowiki>{{#invoke:Title|identifiant|Bof}}</nowiki>''' nous donne : {{#invoke:Title|identifiant|Bof}}


'''<nowiki>{{#invoke:Title|identifiant|Aide:Maintenance à l'aide du Lua}}</nowiki>''' nous donne : {{#invoke:Title|identifiant|Aide:Maintenance à l'aide du Lua}}


==== title.subpageText ====

''title.subpageText'' est un objet de type ''string''. Si l’on a affaire à une sous-page, ''title.subpageText'' donne le suffixe de la page. Sinon ''title.subpageText'' a le même effet que [[#title.text|title.text]]. Nous voyons alors que ''title.subpageText'' est l'équivalent de <nowiki>{{SUBPAGENAME}}</nowiki> dans la syntaxe wiki. Écrivons un petit programme pour voir comment se comporte ''title.subpageText'' avec un choix de page donnée en argument :

<syntaxhighlight lang="lua">
local p = {}

function p.subpage(frame)
	local reponse = ""
	local page = frame.args[1]
	local title = mw.title.new(page)
	reponse = reponse.."Pour la page : '''"..page.."''', ''title.subpageText'' nous donne : '''"..title.subpageText.."'''."
	return reponse
end

return p
</syntaxhighlight>


'''<nowiki>{{#invoke:Title|subpage|Bof/Niouf}}</nowiki>''' nous donne : {{#invoke:Title|subpage|Bof/Niouf}} (bien que la page Bof/Niouf n'existe pas!)


'''<nowiki>{{#invoke:Title|subpage|Aide:Maintenance à l'aide du Lua}}</nowiki>''' nous donne : {{#invoke:Title|subpage|Aide:Maintenance à l'aide du Lua}}


'''<nowiki>{{#invoke:Title|subpage|Recherche:Les fonds patrimoniaux des bibliothèques publiques/Parchemin et cuir}}</nowiki>''' nous donne : {{#invoke:Title|subpage|Recherche:Les fonds patrimoniaux des bibliothèques publiques/Parchemin et cuir}}


==== title.subjectNsText ====

{{...}}


''title.subjectNsText'' est de type ''string'' et donne le nom de l'espace de noms sujet de la page.


==== title.rootText ====

{{...}}


''title.rootText'' est de type ''string'' et donne le titre de la page de base sans préfixe si l’on se trouve dans une sous-page. Sinon est identique à ''title.text''.


indique si la page est une sous-page


==== title.isContentPage ====

Indique si la page est dans un espace de noms de contenu.

Exemple :

<syntaxhighlight lang="lua">
local p = {}

function p.contenu(frame)
	local page = frame.args[1]
	local title = mw.title.new(page)
	if title.isContentPage then
		return "<br />La page '''"..page.."''' est une page de contenu."
	else
		return "<br />La page '''"..page.."''' n’est pas une page de contenu."
	end
end

return p
</syntaxhighlight>

'''<nowiki>{{#invoke:Title|contenu|Initiation au Lua avec Scribunto}}</nowiki>''' nous donne : {{#invoke:Title|contenu|Initiation au Lua avec Scribunto}}


'''<nowiki>{{#invoke:Title|contenu|Bac à sable}}</nowiki>''' nous donne : {{#invoke:Title|contenu|Bac à sable}}


'''<nowiki>{{#invoke:Title|contenu|Recherche:Évolution prébiotique}}</nowiki>''' nous donne : {{#invoke:Title|contenu|Recherche:Évolution prébiotique}}


'''<nowiki>{{#invoke:Title|contenu|Faculté:Informatique}}</nowiki>''' nous donne : {{#invoke:Title|contenu|Faculté:Informatique}}


'''<nowiki>{{#invoke:Title|contenu|Aide:Maintenance à l'aide du Lua}}</nowiki>''' nous donne : {{#invoke:Title|contenu|Aide:Maintenance à l'aide du Lua}}


Il semblerait que seules les pages de l'espace principal, y compris les redirections, soient des pages de contenu.


==== title.cascadingProtection ====

{{...}}


==== title.rootPageTitle ====

{{...}}


identique à mw.title.makeTitle( title.namespace, title.rootText )


==== title.localUrl ====

{{...}}


''title.localUrl'' est de type ''function''. ''title.localUrl(query)'' retourne l'URL locale de la page (avec optionnellement un "query", une chaîne ou une table)


==== title.contentModel ====

{{...}}


Le type de contenu pour ce titre, sous forme de chaîne. Voir [[mw:Manual:ContentHandler]].


==== title.protectionLevels ====

{{...}}


==== title.interwiki ====

{{...}}


''title.interwiki'' est de type ''string'' et donne le préfixe interwiki. S'il n'y a pas de préfixe interwiki, la chaîne de caractère retournée est vide.


==== title.namespace ====

''title.namespace'' est de type ''number'' et permet d'obtenir le numéro d'espace dans lequel se trouve la page consernée.

<syntaxhighlight lang="lua">
local p = {}

function p.num_espace(frame)
	local page = frame.args[1]
	local title = mw.title.new(frame.args[1])
	return "<br />La page '''"..page.."''' se trouve dans l'espace de numéro : ".. title.namespace
end

return p
</syntaxhighlight>

'''<nowiki>{{#invoke:Title|num_espace|Aide:Maintenance à l'aide du Lua}}</nowiki>''' nous donne : {{#invoke:Title|num_espace|Aide:Maintenance à l'aide du Lua}}


{{Bas de page
  | idfaculté  = informatique
  | précédent  = [[../L'objet Frame/]]
  | suivant    = [[../L'objet URI/]]
}}

[[en:Lua/Title Library]]