Žórłowy tekst za Wikipedija:Lua/Module/URLutil/hsb sej wobhladać

{{LuaModuleDoc}}
<onlyinclude>'''<code>URLutil</code>''' – Modul z funkcijemi za rjady znamješkow, kotrež so  na internetowe adresy poćahnu ([[Uniform Resource Locator|URL]]; IP-adresy –&nbsp;tež [[IPv4]] a [[IPv6]]&nbsp;– ale tež e-mejlka). Tež internacionalizěrowane adresy ([[Internationalized Resource Identifier|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''
<noinclude>__TOC__</noinclude>
== {{Anchor|Předłoha}} 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 {{Anchor|getAuthority}}
: Ekstrahuje z ressource URL zaměranje serwera (rezultat pisany w małkich pismikach)
:* ''nic'' – jeli njedowoleny
; getHost {{Anchor|getHost}}
: Ekstrahuje z ressource-URL domainom abo IP-adresu (rezultat pisany w małkich pismikach)
:* ''nic'' – jeli njedowoleny
; getPort {{Anchor|getPort}}
: Ekstraruje z ressource-URL informaciju wo portu (rezultat ličba)
:* ''nic'' – jeli wobstejacy
; getScheme {{Anchor|getScheme}}
: Ekstrahuje z ressource-URL šemu (rezultat pisany w małkich pismikach; inkluziwnje dwójnych nakósnych smužkow)
:* <code>//</code> – relatiwny protokol
:* <code>https://</code> – protokol
:* ''nic'' – jeli spočatk URL njedowoleny
; getTLD {{Anchor|getTLD}}
: Ekstrahuje z ressource-URL ''[[Top-Level-Domain]]'' (rezultat z małkimi pismikami pisany)
:* ''ničo'' – jeli njedowoleny
; getTop2domain {{Anchor|getTop2domain}}
: Ekstrahuje z ressource-URL najbóle hornjej wobaj niwowaj domaina (rezultat z małkimi pismikami pisany)
:* ''ničo'' – jeli njedowoleny
; isAuthority {{Anchor|isAuthority}}
: Wón je adresa serwera (tež IP) ressource, inkluziwnje porta?
:* <code>1</code> – ''haj''
; isDomain {{Anchor|isDomain}}
: Wón je mjenowany domain, inkluziwnje subdomainow?
:* <code>1</code> – ''haj''
; isHost {{Anchor|isHost}}
: Wón je adresa serwera bjez porta (tež IP)?
:* <code>1</code> – ''haj''
; isIP {{Anchor|isIP}}
: Wón je IP-adresa?
:* <code>4</code> ''jeli [[IPv4]]'' (w normalnej notaciji)
:* <code>6</code> ''jeli [[IPv6]]''
:* ''nic'' – hewak
; isIPv4 {{Anchor|isIPv4}}
: Wón je [[IPv4]]-adresa w normalnej notaciji (z dypkami rozdźělena, decimalna)?
:* <code>1</code> – ''haj''
; isIPv6 {{Anchor|isIPv6}}
: Wón je [[IPv6]]-adresa?
:* <code>1</code> – ''haj''
; isMailAddress {{Anchor|isMailAddress}}
: Wón je adresa e-mejlki?
:* <code>1</code> – ''haj''
; isMailLink {{Anchor|isMailLink}}
: Wón je wotkaz na e-mejlku (<nowiki>mailto:</nowiki>)?
:* <code>1</code> – ''haj''
; isProtocolDialog {{Anchor|isProtocolDialog}}
: Wón je URL / mjeno šemy, kotrež móže we Wikiju dialog započinać?
: <code>mailto, irc, ircs, ssh, telnet</code>
:* <code>1</code> – ''haj''
; isProtocolWiki {{Anchor|isProtocolWiki}}
: Wón je URL / mjeno šemy, z kotrymž so móže referencěrować we Wikiju na ressource?
: Relatiwny protokol ale tež <code>ftp ftps git http https mms nntp sftp svn worldwind</code>
: Njepřate su tu: gopher, wais ale tež mailto, irc, ircs, ssh, telnet.
:* <code>1</code> – ''haj''
; isResourceURL {{Anchor|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.
:* <code>1</code> – ''haj''
; isSuspiciousURL {{Anchor|isSuspiciousURL}}
: Wón je syntaktiski „podhladny“ URL, přećiwo kotrejž so by dyrbi warnować?
:* <code>1</code> – ''haj''
; isUnescapedURL {{Anchor|isUnescapedURL}}
: Wón je URL, při kotrejž hišće Wikisyntaksa <code>[ | ]</code> so dyrbi wotpadnyć?
:* <code>1</code> – ''haj''
; isWebURL
: Wón je płaćiwa adresa za ressource (Protokol někajki)?
:* <code>1</code> – ''haj''
; wikiEscapeURL {{Anchor|wikiEscapeURL}}
: K wikisyntaksej zawěšće <code>[ | ]</code> escapować.
:* Identisce z parametrom, jeli žadne problematiske znamješka wustupuja.
:* Narunanje wot <code>[ | ]</code> přez k webserwerej wěste HTML-Entities, jeli wobstejace. Pipe je w syntaksy předłoha nic chroble móžne.

===  Přikłady (testowy bok) ===
[[:de:Wikipedia:Lua/Modul/URLutil/test|Testowy bok]] ilustruje praktiske přikłady.</onlyinclude>

== {{Anchor|Lua}} Funkcije za Lua-module ==

Wšě horjeka dokumentowane funkcije so tež móžeja zawjazować z <code>require()</code> do druhich modulow:
<syntaxhighlight lang="lua">
local lucky, URLutil = pcall( require, "Modul:URLutil" )
if type( URLutil ) == "table" then
    URLutil = URLutil.URLutil()
else
    -- zmylkowu pad; URLutil wobsahuje powěsć zmylka
    return "<span class='error'>" .. URLutil .. "</span>"
end
</syntaxhighlight>
Po tym su k dispoziciji:
* URLutil.getAuthority()
* URLutil.getHost()
* URLutil.getPort()<br />numeriska hódnota, abo <code>false</code>
* URLutil.getScheme()
* URLutil.getTLD()
* URLutil.getTop2domain()
* URLutil.isAuthority()
* URLutil.isDomain()
* URLutil.isHost()
* URLutil.isIP()<br />numeriski 4, 6, abo <code>false</code>
* URLutil.isIPv4()
* URLutil.isIPv6()
* URLutil.isMailAddress()
* URLutil.isMailLink()
* URLutil.isProtocolDialog
* URLutil.isProtocolWiki()
* URLutil.isResourceURL()
* URLutil.isSuspiciousURL()
* URLutil.isUnescapedURL()
* URLutil.isWebURL()
* URLutil.wikiEscapeURL()
W padźe wuspěcha ''URLutil.get*()'' wróći rjad znamješkow, ''URLutil.is*()'' hódnotu <code>true</code> (jeli nic hewak daty); při njewuspěchu kóždy raz <code>false</code>.

== Wužiće ==
Powšykna biblioteka; njewobmjezowana.

== Wotwisnosć ==
Žadna.

== Hlej tež ==
* [[:de:Hilfe:Lua/Links#mw.uri|mw: '''Uri library''']] – druhe funkcionalnosće na powšitkownym URI; ale specielnje za Wikijowe URL pomocne.

<!-- == Interne Funktionen == -->
== Model ==
* [[:de:Vorlage:URLutil]] - wot 15. junija 2013, kotryž so je ze swojeje strony zdźěla z  [[:en:Special:Permalink/542839577?title=Module:IPAddress|en:Module:IPAddress]] nastał – 1. měrca 2013
* Unit tests: [[:en:Module:IPAddress/tests]]