Programska opema MediaWiki, ki poganja Wikipedijo, dovoljuje za namen oblikovanja uporabo množice HTML 5elementov, označevalce (tag) in njihove atribute.[1] Vključite pa lahko večino HTML z uporabo ekvivalentnih wiki markup ali predlog; te v splošnem najraje uporabljamo v člankih, ker so običajno preprostejši za večino urejevalcev in bolj pregledni v oknu za urejanje; toda v nekaterih primerih se uporaba HTML priporoča. (Glej Pomoč:Wikibesedilo za wiki ekvivalente označevalcem HTML.) HTML je uporaben tudi izven člankov, na primer za oblikovanje znotraj tabel. Za pomoč pri uporabi Cascading Style Sheet v Wikipediji, glej Pomoč:Cascading Style Sheets.
Nekateri označevalci izgledajo kot HTML, ampak so v resnici MediaWiki označevalci za parser in razširitve. HTML v straneh lahko preverite skladnost s HTML5 z uporabo validacije. Nekatere elemente in atribute podpirajo MediaWiki in brskalniki, ampak so v HTML 5 zastarelin jih zato ne bi smeli več uporabljati.
Vodiči
Ta stran pomoči podaja samo pregled dovoljenih markup kod. Za nadaljnjo pomoč in podrobne specifikacije glejte:
HTML atributi zagotavljajo dodatne informacije o elementu in so vedno opredeljeni na začetku označevalca (tag). Oblikovani so kot par ime/vrednost, kot je name="value".
Globalni atributi se uporabljajo za vse označevalce. Atributi, ki niso navedeni tukaj, jih MediWiki ne dovoljuje[1]:
dir: smer besedila— "ltr" (od leve proti desni), "rtl" (od desne proti levi) ali "auto".
id: edinstven identifikator elementa.
lang: primarni jezik za vsebino elementa po BCP 47.
style: uporablja CSS slog vsebine elementa.
title: svetovalne informacije povezane z elementom.
HTML5 atributi mikropodatkov se uporabljajo za vse označevalce:[2]
Kateri koli atribut, ki se začne z data-
itemid
itemprop
itemref
itemscope
itemtype
Drugi označevalci, kot je <table>, podpirajo specifične atribute – ti so navedeni v ustreznem razdelku.
Uporaba
Izpis
To je <spanstyle="color:red;">rdeče</span> besedilo.
To je rdeče besedilo.
TMediaWiki Sanitizer.php izvede nekaj čiščenja nad atributi. Najboljša praksa je uporaba pravilne sintakse.
Opusti atribute, ki niso na beli listi za dani element.
Poškodovane ali neveljavne entitete pretvori v navadno besedilo.
Vse vrednosti atributov obda z dvojnimi narekovaji.
Atributi brez vrednosti dobijo ime kot je vrednost.
Podvojeni atributi so opuščeni.
Nevarni slogovni atributi so opuščeni.
Doda presledek, če atributi obstajajo.
Elementi
Ti HTML elementi so podprti s strani programske opreme MediaWiki. Ta razdelek podaja kratek pregled HTML elementa, zgled, ustrezno wikikodo in predloge.
Označevalci <h1>...</h1> do <h6>...</h6> so naslovi razdelkov s katerimi so povezani. <h1> se uporablja za naslov članka. Naslovi so oblikovani s pomočjo CSS in dodani v kazalo vsebine strani.
HyperText Markup Language
HyperText Markup Language
HyperText Markup Language
HyperText Markup Language
Označevalec <p>...</p> je najbolj uporaben v seznamih, za sezname elementov z več odstavki:
Uporaba
Izpis
*<p>To je odstavek.</p><p>To je še en odstavek iste postavke.</p>* To je druga postavka.
*
To je odstavek.
To je še en odstavek iste postavke.
To je druga postavka.
Opazite lahko, da zaključni označevalec </p> za MediaWiki namestitev, ki izpisuje HTML 5 (kot je Wikipedija), ni strogo potreben.
br
Označevalec <br> vriva prelome vrstic. Glej en:H:BR za druge 4 variante, ko programska oprema MediaWiki pretvori <br /> v HTML, ki ga berejo brskalniki.
Označevalec <!--...--> oblikuje zaprto besedilo skrito kot komentar.
Uporaba
Izpis
HyperText<!--Markup Language-->
HyperText
Bodite previdni glede presledkov okoli komentarjev. Če obdate komentar s praznimi vrsticami, bo rezultat prazen odstavek, ki bo zaznan kot dodatni dve prazni vrstici:
Uporaba
Izpis
Vrstica z vsebino 1
<!-- Komentar -->
Vrstica z vsebino 2
Vrstica z vsebino 1
Vrstica z vsebino 2
Oblikovanje
abbr
Označevalec <abbr>...</abbr> ustvari tooltip za pojasnitev kratic ali akronimov, ki se prikaže ob premiku miške nad besedilo.
Predloga: {{quote}}; podpira predoblikovane atribute in vire parametrov. Za druge specializirane predloge za citatne bloke, glejte Kategorija:Predloge za citate.
cite
Označevalec <cite>...</cite> vsebuje naslov dela. To je nova definicija v HTML5 — v prejšnji XML implementaciji se je <cite> uporabljal za to, da je vseboval citat ali sklic na druge vire. Ko je ta označevalec uporabljen, ne vpliva na videz besedila, ki ga obdaja.
Uporaba
Izpis
<cite>HyperText Markup Language</cite>
HyperText Markup Language
Označevalec <cite>...</cite> se na splošno ne uporablja direktno v člankih in je pogosto zlorabljen; glejte Wikipedija:HTML 5#cite za navodila za zamenjavo.
Označevalec <i>...</i> predstavlja besedilo, ki je drugače poudarjeno kot okoliška vsebina, ne da bi izražal kakršno koli extra poudarjanje ali pomembnost, in za katerega je običajna tipografska predstavitev ležeče besedilo.
Uporaba
Izpis
<i>HyperText Markup Language</i>
HyperText Markup Language
Wiki koda: Uporabite '' za odpiranje in zapiranje označbe ležečega besedila.
Uporaba
Izpis
''HyperText Markup Language''
HyperText Markup Language
ins
Označevalec <ins>...</ins> označuje obseg besedila, ki je bil dodan. Oblikovan je kot podčrtano besedilo. Uporablja se na pogovornih straneh za označevanje preoblikovanega besedila; glejte WP:REDACT.
Uporaba
Izpis
<ins>HyperText Markup Language</ins>
HyperText Markup Language
kbd
Označevalec <kbd>...</kbd> označuje uporabniški vnos, kot je tipkanje na tipkovnici ali glasovni ukaz.
Uporaba
Izpis
Pritisni <kbd>Enter</kbd>
Pritisni Enter
Predlogi:
{{kbd}} uporablja monospace stiliziranje in svetlo sivo ozadje, da se loči od kode (<code>) in izhoda (<samp> ali {{samp}}).
{{key press}} izpiše ilustrirane tipke in tipkovne kombinacije.
mark
Označevalec <mark>...</mark> izpiše del besedila v dokumentu, ki je označen ali poudarjen za namene sklicevanja, zaradi njegove pomembnosti v drugem kontekstu. Označeno besedilo je privzeto oblikovano z rumenim ozadjem.
Podpora: Ne podirajo ga Internet Explorer 8 in starejši.
pre
Označevalec <pre>...</pre> izpiše blok predoblikovanega besedila. V MediaWiki je <pre> pravzaprav označevalec parserja in ne HTMLja, vendar je funkcija enaka. Preprečuje tudi razčlenjevanje predlog.
Uporaba
Izpis
<pre>HyperText Markup Language</pre>
HyperText Markup Language
HTML entititete
Označevalec <pre> analizira HTML entitete. Če se želite temu izogniti, nadomestite & z & alinamesto tega uporabite <syntaxhighlight lang="text">.
Označevalec <ruby>...</ruby> označi posebno vrsto znakov ali simbolov, ki se uporabljajo v nekaterih pisavah in pisnih sistemih.
<rt>...</rt> označi komponento ruby besedilaz ruby anotacijo; ruby besedilo se izpiše v pomanjšani velikosti nad običajnimi znaki.
<rp>...</rp> se uporablja za zagotovitev vključitve oklepajev okoli komponente ruby besedilaa z anotacijo, z namenov da jo lahko izpišejo tisti, ki ne podpirajo ruby anotacij..
Brskalniki, ki ne podpirajo ruby znakov bodo izpisali to besedilo v normalni velikosti, vključeni v oklepaje za običajno vsebino.
Označevalec <s>...</s> se uporablja za označevanje vsebine, ki ni več veljavna ali relevantna in se izpiše kot prečrtano besedilo. Neustrezna je uporaba tega označevalca pri urejanju dokumentov; za označitev besedila, ki je bilo odstranjeno iz dokumenta, uporabite <del>.
<samp>...</samp> označuje vzorčni odlomek kode v programa. Zgledi vključujejo: izhod programa, skripte, ali Wikipedijine predloge; izpis statusov ali audio obvestil, ki jih uporablja aplikacija ali naprava; seznami datotečnega imenika in njihovi vzorci, kot so poti in imena datotek.
Uporaba
Izpis
<samp>HyperText Markup Language</samp>
HyperText Markup Language
Predloga: {{samp}} zagotovi način oblikovanja besedila, kjer so vsi znaki enake širine (monospace slog) in izpiše besedilo v temno sivi barvi, da se razlikuje od kode (<code>) in vhoda (<kbd> ali {{kbd}}).
{{small}} uporablja <span style="font-size:85%;">. {{small}} se priporoča namesto <small>, ker ima <small>...</small> semantični pomen za drobni tisk, medtem ko je {{small}} le stilističen.
strong
Označevalec <strong>...</strong> oblikuje besedilo, ki ima večjo pomembnost ali pa je poudarjeno; v večini brskalnikov se izpiše kot krepko. Običajno se ne uporablja v Wikipedijinih člankih, zaradi pravila nepristranskodti. Za uporabo tega elementa in druga poudarjanja glejte WP:KREPKO. Večina semantičnih poudarkov, vključno s citiranim materialom, naj se izpisuje s elementom <em>.
Označevalec <time>...</time> definira ali čas (24 hour clock) ali datum Gregorijanskega koledarja, z možnostjo časa in odmika od časovne cone.
Uporaba
Izpis
<time>10:00</time>
Atribut: datetime
Podpora: Ne podirajo ga Internet Explorer 8 in starejši.
u
Označevalec <u>...</u> se uporablja za označevanje besedila, da se razlikuje od okolice, ne da bi na to besedilo dajali poseben poudarek, običajno se beseli izpiše kot podčrtano.
<u> je bila v preteklosti pogosto uporabljena za označevanje povezav, vendar je bila ta praksa v HTML4 zastarela in se sedaj uporablja za ta namen slog CSS{text-decoration: underline}.[3] V HTML5 se je ta označevalec ponovno pojavil, toda pomen se mu je popolnoma spremenil: it now "represents a span of inline text which should be rendered in a way that indicates that it has a non-textual annotation".[3] This facility is intended for example to provide a red wavy line underline to flag spelling errors at input time but which are not to be embedded in any stored file (unlike an emphasis mark, which would be).
Uporaba
Izpis
<u>HyperText Markup Language</u>
HyperText Markup Language
Predloga: {{underline}} (ki zagotavlja priporočen slog CSS)
Označevalec <var>...</var> oblikuje besedilo v ležeč format z namenom razlikovati med spremenljivkami in drugim besedilom v matematičnih izrazih ali v programiranju.
Uporaba
Izpis
*<var>E</var>=<var>m</var>c<sup>2</sup> (c je konstanta in ne spremenljivka)
*<code><nowiki>{{</nowiki><var>ImePredloge</var>|<var>parameter</var>=<var>vrednost</var><nowiki>}}</nowiki></code>*If <var>A</var> then <var>B</var>
{{varserif}} oblikuje v italic serif z namenom drugačnega vizualnega označevanja
wbr
Označevalec <wbr> (word break opportunity) se uporablja za označevanje potencialnih mest, kjer je dovoljeno prelomiti dolge besede, če je to potrebno za pravilno prikazovanje besedila na različnih napravah ali zaslonskih velikostih.
Uporaba
Izpis
Zdaj je čas, da postanete mojstrski urejevalnik z učenjem HyperText Markup Language
Zdaj je čas, da postanete mojstrski urejevalnik z učenjem HyperText Markup Language
Zdaj je čas, da postanete mojstrski urejevalnik z učenjem Hyper<wbr>Text Markup Language
Zdaj je čas, da postanete mojstrski urejevalnik z učenjem HyperText Markup Language
Če se okno brskalnika zoži, se drugo besedilo prelomi med Hyper in Text.
Ne puščajte praznih vrstic med postavkami v seznamu, ker programska oprema MediaWik to interpretira kot začetek novega seznama.
dl, dt, dd
Označevalci <dl>...</dl>, <dt>...</dt> in <dd>...</dd> se uporabljajo za ustvarjanje seznama opisov (description list) z pojmom in opisom. Pojmi so izpisani krepko opisa pa so zamaknjeni. Vsak pojem mora vključevati enega ali več opisov.
Wiki koda: <dt> se ustvari z uporabo ;. Ta označevalec se običajno uporablja znotraj <dl>...</dl>. Označevalec <dd> se ustvari z uporabo : in se uporablja za podajanje dejanskega opisa ali definicije izraza, ki ga označuje <dl>. Za eno ali prvo vrednost, se lahko umesti : v isto vrstico za ;, kjer morajo sledeče vrednosti potem biti umeščene v svoje vrstice.
Označevalec <ol>...</ol> se uporablja za ustvarjanje oštevilčenega seznama elementov; <ul>...</ul> se uporablja za ustvarjanje neurejenega seznama, kjer so elementi naštevani brez določenega zaporedja; Vsak element v seznamu je označen z oznako <li>...</li>.
Uporaba
Izpis
<ol><li>Element 1</li><li>Element 2</li></ol>
Element 1
Element 2
<ul><li>Element 1</li><li>Element 2</li></ul>
Element 1
Element 2
Wiki koda: uporabite * za elemente v neurejenem seznamu in # za oštevilčene sezname.
Označevalci <thead>, <tfoot> in <tbody> niso podprti, ampak so avtomatično generirani, vendar se samodejno ustvarijo ob prikazu strani.
Zastareli/neželeni elementi
Ti elementi so zastareli in so iz HTML5 odstranjeni ali pa nezaželeni, toda brskalniki jeih še vedno podpirajo.[4] Ti označevalci so nadomeščeni z alternativnim označevalcem ali pa je njihovo funkcijo prevzela predloge s CSS. Za več podrobnosti o zastarelih HTML elementih in njihovih nadomestkih glejte Wikipedija:HTML5 § Zastareli elementi in atributi
Označevalec <rb>...</rb> (zastarelo) se uporablja v okviru označevalca <ruby> za označevanje glavnega besedila v kombinaciji z besedo, ki predstavlja njegovo razlago ali fonetično branje. Ta kombinacija se imenuje "ruby anotacija" in se pogosto uporablja v vzhodnoazijskih jezikih za označevanje izgovorjave, prevodov ali dodatnih pojasnil.
Označevalec <strike>...</strike> (zastarelo) se uporablja za označevanje prečrtanega besedila; namesto tega uporabite <s>.
tt
Označevalec <tt>...</tt> (zastarelo) se uporablja za oblikovanje besedila kjer je vsk znak besedila enako širok. Namesto tega uporabite <code>, <kbd> ali <samp>.
Ti elementi niso podprti, anpak imajo ekvivalent v wiki markup kodi. Če poskusite uporabiti katerikoli element, ki ni na belem seznamu Sanitizer.php, se bo kot rezulat tega izpisalo le neoblikovano besedilo.
Označevalec <a> se je uporabljal za ustvarjanje hiperpovezavs. Uporabite wiki kodo [[ ]] za notranje povezave in InterWikimedia povezave, ter [ ] za zunanje povezave.
Označevalec <input> se je uporabljal za ustvarjanje interaktivnih polj za vnos podatkov. The Razširitveni označevalec<inputbox> se je uporabljal za ustvarjanje besedilnega polja s potrditvenim gumbom.
HTML Tidy
HTML Tidy is an outdated HTML4 library that is slated for removal. Tidy parses the MediaWiki output and cleans it up to increase the likelihood that valid HTML4 is rendered. For example, with Tidy enabled, <br>, </br>, <br/>, <br.> all rendered as <br />. Tidy is not enabled for MediaWiki interface pages. Tidy was never perfect and has been known to introduce errors.
Izjeme
Nekatere strani v imenskiem prostoru MediaWiki, tipično to velja za kratka sporočila kot so gumbi label, se jim HTML ne razčlenjuje in analizira in označevalci bodo vidno izpostavljeni.
The MediaWiki software attempts to fix HTML errors, but it does not catch all of them. Where HTML is used, it is helpful to verify it with the W3C Markup Validation Service.