Programowanje předłohi Diskusije Lua Testy Podstrony
Modul Hornjoserbsce English Deutsch

Modul: Dokumentacija

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
isAuthority
Wón je adresa serwera (tež IP) ressource, inkluziwnje porta?
  • 1haj
isDomain
Wón je mjenowany domain, inkluziwnje subdomainow?
  • 1haj
isHost
Wón je adresa serwera bjez porta (tež IP)?
  • 1haj
isIP
Wón je IP-adresa?
  • 4 jeli IPv4 (w normalnej notaciji)
  • 6 jeli IPv6
  • nic – hewak
isIPv4
Wón je IPv4-adresa w normalnej notaciji (z dypkami rozdźělena, decimalna)?
  • 1haj
isIPv6
Wón je IPv6-adresa?
  • 1haj
isMailAddress
Wón je adresa e-mejlki?
  • 1haj
isMailLink
Wón je wotkaz na e-mejlku (mailto:)?
  • 1haj
isProtocolDialog
Wón je URL / mjeno šemy, kotrež móže we Wikiju dialog započinać?
mailto, irc, ircs, ssh, telnet
  • 1haj
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.
  • 1haj
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.
  • 1haj
isSuspiciousURL
Wón je syntaktiski „podhladny“ URL, přećiwo kotrejž so by dyrbi warnować?
  • 1haj
isUnescapedURL
Wón je URL, při kotrejž hišće Wikisyntaksa [ | ] so dyrbi wotpadnyć?
  • 1haj
isWebURL
Wón je płaćiwa adresa za ressource (Protokol někajki)?
  • 1haj
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.

Přikłady (testowy bok)

Testowy bok ilustruje praktiske přikłady.

Powšitkowne pokiwy wo zawjazanju modulow

Zawjazanje so přeco w formaće stanje

{{#invoke: URLutil | Mjeno funkcije | hódnota1 | hódnota2 | mjenoX=hódnota … }}

Parametry so móžeja mjenowane abo njemjenowane kaž při předłohow być.

Jeli njeznaty rjad znamješkow přińdźe wot wonka (kaž parametry předłohow), so přeco z formu 1=hódnota dźěła.

Dalše informacije namakaš na Pomoc:Lua.

Z Wikipedije, swobodneje encyklopedije