Vikipedio:Lua/Moduloj/WLink/eo

El Vikipedio, la libera enciklopedio
Salti al navigilo Salti al serĉilo
Ŝ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, se true
    • project – Projekta intervikio (normigita mallongigo)
    • lang – Konata lingva versio (minuskloj)
    • ns – Numero de la nomspaco
    • space – Norma nomo de la nomspaco
    • title – Paĝartitolo kiel trovita; minimume malplena signoĉeno

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]