Vikipedio:Lua/Moduloj/WLink/eo
Ŝablona programado | Diskutoj | Lua | Testoj | Subpaĝoj | ||||
---|---|---|---|---|---|---|---|---|
Modulo | Esperanto | English | Deutsch
|
Modulo: | Dokumentado |
WLink
– Modulo kun funkcioj por signoĉenoj rilate al Vikiaj ligiloj (Wikilink-format kaj URL-Format).
Funkcioj por ŝablonoj[redakti fonton]
Ĉiuj funkcioj havas ekzakte unu nenomitan parametron (kiu estas deviga). Tiu estas tolera al spacoj antaŭ aŭ post la enhavo. HTML-Entities estas en la endono eblaj kaj estas solvata en la rezulto. Kutime temas ĉe tio pri signoĉeno, en kiu krampigataj ligadoj estas atendataj; tiam la unua krampo estas pluprilaborata.
La redona valoro estas malplena signoĉeno („nenio“), se la parametra valoro ne plenumas la atendojn. Se rezulto ekzistas aŭ la pridemanda kondiĉo veras, rezultas almenaŭ unu signo. La rezulto nek komenciĝas nek finiĝas per spaco.
- ansiPercent
- Konvertas URL per ANSI-Encoding anstataŭ per UTF-8-Encoding.
- Por kelkaj serviloj kun softvara formato el la lasta jarcento bezonata.
- formatURL
- Formatas URL, ajnan retligilon aŭ simple domajnon.
- [http://example.org/about Homepage] rezultigas [http://example.org/about Homepage]
- http://example.org/about rezultigas [http://example.org/about example.org/about]
- example.org rezultasig [http://example.org/ example.org]
- Tekstaj aldonoj ekster ĉi tiuj formatoj estas transdonataj.
- getArticleBase
- Determinas la generan paĝotitolon, sen fragmento aŭ krampa esprimo de „Klammerlemma“.
- Uzas la aktualan paĝotitolon, se ne donita.
- getBaseTitle
- Determinas en subpaĝo la lastan segmenton de la paĝotitolo, sen fragmento.
- getExtension
- Determinas la „dosiernoma finaĵo“ de mediaj dosieroj.
- La rezulto estas montrata en minuskkleco sen komenca punkto.
- getFile
- Determinas la dosiernomon.
- La enigo povas esti krampata ligado aŭ nur dosiernomo. Ĝi estas nur valida, se ekzistas kaj permesata nomigo de la dosiernoma spaco kaj „finaĵo de dosiernomo“.
- La rezulto estas la titolo de la dosiero sen nomspaco.
- getFragment
- Determinas la originalan (ne dekoditan) fragmenton post
#
. - Neniu rezulto, se la fragmento estas malplena aŭ forestas.
- getLanguage
- Determinas la lingvan kodon de la projekto
- getNamespace
- Determinas la numeron de la nomspaco
- getPlain
- Elsolvas ĉiujn ligojn en la teksto kaj anstataŭas per la ligilaj titoloj.
- getProject
- Determinas la projektan nomon (nur ene de la Vikifarmo) en rekomendata mallonga formo
- getTarget
- Determinas la unuan ligilcelon (Vikia ligilo aŭ URL).
- getTargetPage
- Determinas la paĝarnomon al la unua ligilo (paĝonomo aŭ URL de la paĝo)
- Identa kun getTarget, se neniu fragmento.
- getTitle
- Determinas la unuan ligiltitolon (Vikia ligilo aŭ URL), aŭ alie la ligilcelo de Vikia ligilo.
- isBracketedLink
- Enthält das eine geklammerte Verlinkung?
- isBracketedURL
- Enthält das eine geklammerte URL?
- isCategorization
- Ĉu ĝi enhavas efikan kategoriigon?
- isExternalLink
- Ĉu ĝi enhavas URLon?
- isInterlanguage
- Ĉu ĝi enhavas Interlanguage?
- isInterwiki
- Ĉu ĝi enhavas intervikian ligilon ene de la Vikia farmo, enklude de Interlanguage?
- isMedia
- Ĉu ĝi enhavas median enplekton?
- isTitledLink
- Ĉu ĝi enhavas titolitan ligilon?
- isValidLink
- Ĉu ĝi enhavas ligilon?
- isWikilink
- Ĉu ĝi enhavas Vikian ligilon?
Ekzemploj (testopaĝo)[redakti fonton]
Testopaĝo ilustras praktikajn ekzemplojn.
Funkcioj por Lua-moduloj[redakti fonton]
Ĉiuj supre dokumentitaj funkcioj ankaŭ povas esti enplektataj per require()
en aliajn modulojn:
local lucky, WLink = pcall( require, "Modulo:WLink" )
if type( WLink ) == "table" then
WLink = WLink.WLink()
else
-- erarkazo; WLink enhavas erarmesaĝon
return "<span class='error'>" .. WLink .. "</span>"
end
Poste estas je dispono:
- WLink.ansiPercent()
- WLink.formatURL()
- WLink.getArticleBase()
- WLink.getBaseTitle()
- WLink.getExtension()
- WLink.getFile()
- WLink.getFragment()
false
, se forestas; sed "" se fragmento malplenas.- Neniu
#
je la komenco de la rezulto.
- WLink.getLanguage()
- WLink.getNamespace()
- WLink.getPlain()
- WLink.getProject()
- WLink.getTarget()
- WLink.getTargetPage()
- WLink.getTitle()
- WLink.isBracketedLink()
- WLink.isBracketedURL()
- WLink.isCategorization()
- WLink.isExternalLink()
- WLink.isInterlanguage()
- WLink.isInterwiki()
- WLink.isMedia()
- WLink.isTitledLink()
- WLink.isValidLink()
- WLink.isWeblink()
- WLink.isWikilink()
- WLink.wikilink()
- Liveras table kun la komponaĵoj de la Vikia ligilo, alie
false
. - Komponaĵoj povas esti, se donitaj:
lead
– Komenca duobla punkto vorhanden und erforderlich, setrue
project
– Projekta intervikio (normigita mallongigo)lang
– Konata lingva versio (minuskloj)ns
– Numero de la nomspacospace
– Norma nomo de la nomspacotitle
– Paĝartitolo kiel trovita; minimume malplena signoĉeno
- Liveras table kun la komponaĵoj de la Vikia ligilo, alie
En sukcesa kazo la WLink.get*() redonas signoĉenon, la WLink.is*() la valoron true
(kondiĉe ke ne alie donita); ĉe malsukceso ĉiufoje false
.
Uzado[redakti fonton]
Ĝenerala biblioteko; ne limigita.
Dependecoj[redakti fonton]
Vidu ankaŭ[redakti fonton]
- URLutil – ĝeneralaj funkcioj speciale por URL.
Deveno[redakti fonton]
- germana modulo "Modul:WLink" en la versio de la 22-a de junio 2015