Wikipedia:Lua/Modul/URLutil/hsb

Vorlagen- programmierung	Diskussionen	Lua						Test	Unterseiten
		Modul	Deutsch	English	Esperanto	Dolnoserbski	Hornjoserbsce		Modul:	WP:Lua

URLutil – Modul z funkcijemi za rjady znamješkow, kotrež so na internetowe adresy poćahnu (URL; IP-adresy – tež IPv4 a IPv6 – ale tež e-mejlka). Tež internacionalizěrowane adresy (IRI) su móžne.

Mamy za to zo je wužitk za Wikijowy projekt; tuž zmysłapołne adresy we wotewrjenym interneće. Sćěhowace specialne pady njejsu programowane, ale tež lědma relewantne:

• IPv4-adresa nic w normalnej notaciji (z dypkami rozdźělene, decimalne)
• URL z IPv6-Host (spinkowane; njekongruěruje derje z Wikijoweju syntaksu)
• Authority z username

Funkcije za předłohi

Wšě funkcije maja eksaktnje jedyn njemjenowany parameter (zmysłapołnje so dyrbi daty). Tutón je tolerantny přećiwo prózdnym znamješkam před abo po wobsahu.

Hódnota wróćenja je prózdna rjad znamješkow („nic“), jeli hódnota parametra njedospołni wotčakowanja. Jeli rezultat je wobstejacy abo prašenske wuměnjenje je prawne, rezultuje minimalnje jedne znamjo. Rezultat njezapočina abo so kónči z prózdnym znamješkom.

getAuthority

Ekstrahuje z ressource URL zaměranje serwera (rezultat pisany w małkich pismikach)

• nic – jeli njedowoleny

getHost

Ekstrahuje z ressource-URL domainom abo IP-adresu (rezultat pisany w małkich pismikach)

• nic – jeli njedowoleny

getPort

Ekstraruje z ressource-URL informaciju wo portu (rezultat ličba)

• nic – jeli wobstejacy

getScheme

Ekstrahuje z ressource-URL šemu (rezultat pisany w małkich pismikach; inkluziwnje dwójnych nakósnych smužkow)

• // – relatiwny protokol
• https:// – protokol
• nic – jeli spočatk URL njedowoleny

getTLD

Ekstrahuje z ressource-URL Top-Level-Domain (rezultat z małkimi pismikami pisany)

• ničo – jeli njedowoleny

getTop2domain

Ekstrahuje z ressource-URL najbóle hornjej wobaj niwowaj domaina (rezultat z małkimi pismikami pisany)

• ničo – jeli njedowoleny

getTop3domain

• ničo – jeli njedowoleny

isAuthority

Wón je adresa serwera (tež IP) ressource, inkluziwnje porta?

• 1 – haj

isDomain

Wón je mjenowany domain, inkluziwnje subdomainow?

• 1 – haj

isDomainExample

• 1 – haj

isHost

Wón je adresa serwera bjez porta (tež IP)?

• 1 – haj

isIP

Wón je IP-adresa?

• 4 jeli IPv4 (w normalnej notaciji)
• 6 jeli IPv6
• nic – hewak

isIPlocal

isIPv4

Wón je IPv4-adresa w normalnej notaciji (z dypkami rozdźělena, decimalna)?

• 1 – haj

isIPv6

Wón je IPv6-adresa?

• 1 – haj

isMailAddress

Wón je adresa e-mejlki?

• 1 – haj

isMailLink

Wón je wotkaz na e-mejlku (mailto:)?

• 1 – haj

isProtocolDialog

Wón je URL / mjeno šemy, kotrež móže we Wikiju dialog započinać?

mailto, irc, ircs, ssh, telnet

• 1 – haj

isProtocolWiki

Wón je URL / mjeno šemy, z kotrymž so móže referencěrować we Wikiju na ressource?

Relatiwny protokol ale tež ftp ftps git http https mms nntp sftp svn worldwind

Njepřate su tu: gopher, wais ale tež mailto, irc, ircs, ssh, telnet.

• 1 – haj

isResourceURL

Wón je URL, při kotrejž powšitkownje so móže přistup měć k ressource? To rěka: relatiwny protokol, http, https, ftp a nimo toho płaćiwy hósćinarski kompjuter (jendźelsce Host). Druhe URL by k předstajenju na projektowych a funkcijskich stronach, ale nic w encyklopediskim terenje.

• 1 – haj

isSuspiciousURL

Wón je syntaktiski „podhladny“ URL, přećiwo kotrejž so by dyrbi warnować?

• 1 – haj

isUnescapedURL

Wón je URL, při kotrejž hišće Wikisyntaksa [ | ] so dyrbi wotpadnyć?

• 1 – haj

isWebURL

Wón je płaćiwa adresa za ressource (Protokol někajki)?

• 1 – haj

wikiEscapeURL

K wikisyntaksej zawěšće [ | ] escapować.

• Identisce z parametrom, jeli žadne problematiske znamješka wustupuja.
• Narunanje wot [ | ] přez k webserwerej wěste HTML-Entities, jeli wobstejace. Pipe je w syntaksy předłoha nic chroble móžne.

failsafe

Die Failsafe-Schnittstelle erlaubt den damit ausgerüsteten Modulen in globaler Verteilung

• sicherzustellen, dass eine von einer Vorlage oder einem Modul benötigte Funktion in der lokalen Kopie eines Bibliotheksmoduls vorhanden ist, und ggf. auch in einer erforderlichen Mindestversion;
• die globale Aktualisierung und Verknüpfung von Modulen über Wikidata zu verwalten.

Die Failsafe-Schnittstelle liegt sowohl auf Ebene der Vorlagen wie auch in direktem Lua-Zugriff vor.

Die Funktionen sind im Einzelnen (nicht alle werden bereits überall in vollem Umfang unterstützt):

Parameter

Wert	Ergebnis	aktuell
nichts false	lokale Version	»2024-11-21«
Mindest­version	Mindestversionsbezeichnung Datum im ISO-Format Es wird verglichen, ob das aktuelle Modul diese Version oder später erfüllt. leer, falls Mindestversion nicht erfüllt	2001-01-01 → »2024-11-21« 2099-01-01 → »«
wikidata	Versionsbezeichnung der globalen Mutter (d:Q10859193) Versionsbezeichnung auf Wikidata lokal, falls dort keine gefunden	»2024-10-29«
item	ID des Wikidata-Items leer, falls nicht definiert	»Q10859193«
~	Übereinstimmung der lokalen mit der auf Wikidata registrierten Versionsbezeichnung leer, falls aktuell Versionsbezeichnung auf Wikidata, falls ungleich	»2024-10-29«
@	Ist die aktuelle (Modul-)Seite richtig mit Wikidata verknüpft? leer, falls mit dem richtigen Item verknüpft Item-ID, falls nicht
Der Rückgabewert ist in der Vorlagenprogrammierung leer und per Lua false; andernfalls die angegebene Zeichenkette.

Přikłady (testowy bok)

Testowy bok ilustruje praktiske přikłady.

Funkcije za Lua-module

Wšě horjeka dokumentowane funkcije so tež móžeja zawjazować z require() do druhich modulow:

local lucky, URLutil = pcall( require, "Module:URLutil" )
if type( URLutil ) == "table" then
    URLutil = URLutil.URLutil()
else
    -- zmylkowu pad; URLutil wobsahuje powěsć zmylka
    return "<span class='error'>" .. URLutil .. "</span>"
end

Po tym su k dispoziciji:

• URLutil.getAuthority()
• URLutil.getHost()
• URLutil.getPort()
  numeriska hódnota, abo false
• URLutil.getScheme()
• URLutil.getTLD()
• URLutil.getTop2domain()
• URLutil.getTop3domain()
• URLutil.isAuthority()
• URLutil.isDomain()
• URLutil.isDomainExample()
• URLutil.isHost()
• URLutil.isIP()
  numeriski 4, 6, abo false
• URLutil.isIPlocal()
• URLutil.isIPv4()
• URLutil.isIPv6()
• URLutil.isMailAddress()
• URLutil.isMailLink()
• URLutil.isProtocolDialog
• URLutil.isProtocolWiki()
• URLutil.isResourceURL()
• URLutil.isSuspiciousURL()
• URLutil.isUnescapedURL()
• URLutil.isWebURL()
• URLutil.wikiEscapeURL()
• URLutil.failsafe()

W padźe wuspěcha URLutil.get*() wróći rjad znamješkow, URLutil.is*() hódnotu true (jeli nic hewak daty); při njewuspěchu kóždy raz false.

Wužiće

Powšykna biblioteka; njewobmjezowana.

Wotwisnosć

Žadna.