Ŝablono:URL

El Vikipedio, la libera enciklopedio
Dokumentado Dokumentado

Ĉi tiu ŝablono povas esti uzata por krei formatitan eksteran ligilon.

Noto: - ĉi tiu ŝablono estas por aperado de URLoj, kaj por aldoni mikroformatan meta-datumon.

Uzado

  • {{URL|1=url nomo|2=nedeviga ekrana teksto}}
    • La unua parametro estas analizata por vidi ĉu ĝi prenas la formon de kompleta URL. Se ĝi ne komenciĝas per konata URI-skemo kaj oblikvo ("http:/" aŭ "https:/" aŭ "ftp:/", eble aliaj estontece, redaktante ĝian kodon), "http://" prefikso estos aldonata al la specifita generita cela URL de la ligilo.
    • Se neniu montrata teksto estas specifita aŭ malplena, defaŭlta ekrana teksto konkludiĝos provante redukti la specifan URL sen ĝia agnoskita URI-skemo (sen la defaŭlta "/" pado de HTTP kaj FTP rimedoj), kaj la domajna nomo estos devigita minuskli (por pli mallonga kaj kanona montrado, sed ankaŭ por limigi la aperojn de facile konfuzeblaj signoj, ekzemple inter literoj kaj ciferoj). La resto de la URL (inkluzive de la resto de ĝia pado, la laŭvola konsulta ĉeno aŭ la specifita ankro) montriĝos senŝanĝa.
  • {{URL|2=montri tekston}}
    • La url aŭ domajna nomo estas nedeviga : se ĝi ne estas specifita en la unua parametro aŭ ĉi tiu parametro estas malplena, la montrata teksto fariĝas deviga, kaj montriĝos sen iu ajn ŝanĝo.
    • Se ambaŭ parametroj mankas aŭ estas malplenaj, defaŭlta mesaĝo referencantan ĝustan uzadon de ĉi tiu ŝablono estos generata (inkluzive ligilon al ĉi tiu paĝo), por helpi redaktantojn.
Averto:
  • Oni forte konsilas eksplicite numeri la parametrojn (precipe kiam la valoro de la URL estas nekonata, ekzemple kiam ĉi tiu ŝablono estas uzata en alia ŝablono specifanta la efikan URL kiel varia valoro), ĉar multaj URL enhavas egalan signon (en ilia demandoŝnuro). En tiu kazo, la dua parametro por la montrata teksto, se ĉeestas, 'devas' ankaŭ esti eksplicite numerita; alie ĝi superregos la valoron de la eksplicite numerita unua parametro.
  • Se vi specifas demandan ĉenon (komencante per "?", Ĝis la fino de la ĉeno aŭ ĝis la unua signo "#") aŭ ankron (komencante per '"#" ĝis la fino de la ĉeno) en la unua parametro tiam vi 'devas' specifi almenaŭ la defaŭltan padon "/" tuj post la domajna nomo; alie la rezulta ligilocelo estos neantaŭvidebla, ĉar la konsulta ĉeno kaj / aŭ la ankro eble neatendite konvertiĝos al ĉiuj minuskloj; estas forte rekomendite uzi plenajn kaj kanonajn URL-ojn en la unua parametro (sen dependi de la provizora detekto de mankanta URI-skemo aŭ pado). Ne zorgu, ĉi tiu defaŭlta "/" pado ne estos videbla en la defaŭlta ekrana teksto.

Ekzemploj

Kodo Rezulto
{{ URL }} {{URL|example.cz|nedeviga ekrana teksto}}
{{ URL | }} {{URL|example.cz|nedeviga ekrana teksto}}
{{ URL | EXAMPLE.com }} example.com
{{ URL | example.com }} example.com
{{ URL | www.example.com }} www.example.com
{{ URL | http://www.example.com }} www.example.com
{{ URL | https://www.example.com }} www.example.com
{{ URL | ftp://www.example.com }} www.example.com
{{ URL | ftp://ftp.example.com }} ftp.example.com
{{ URL | http://www.example.com/ }} www.example.com
{{ URL | http://www.example.com/path }} www.example.com/path
{{ URL | www.example.com/foo }} www.example.com/foo
{{ URL | http://www.example.com/foo | ligilo}} ligilo
{{ URL | www.example.com/foo | ligilo}} ligilo
{{ URL | http://www.example.com/path/ }} www.example.com/path/
{{ URL | www.example.com/foo/ }} www.example.com/foo/
{{ URL | 1=http://www.example.com/path?section=17 }} www.example.com/path?section=17
{{ URL | 1=www.example.com/foo?page=42 }} www.example.com/foo?page=42
{{ URL | http://www.example.com/foo/ | ligilo}} ligilo
{{ URL | www.example.com/foo/ | ligilo}} ligilo

Mikroformato

La ŝablono envolvas la montratan URL per class="url" tiel ke ĝi estas inkluzivita en iu ajn gepatra mikroformato kiu prenas URL-parametron - vidu our microformats project.

Vidu ankaŭ


Se vi havas demandon pri ĉi tiu ŝablono, tiam vi povas demandi en la ŝablonprojekta diskutejo. La Intervikiaj ligiloj estu metataj al Vikidatumoj. (Vidu Helpopaĝon pri tio.)