Ta stran jetehnično navodilo. Opisuje proces ali postopke nekaterih vidikov norm in prakse v Wikipediji. To nipravilo ali smernica Wikipedije in lahko odraža različne ravnisoglasja inpreverjanja.

Bližnjici H:HTML WP:HTML

Programska opemaMediaWiki, ki poganja Wikipedijo, dovoljuje za namen oblikovanja uporabo množiceHTML 5elementov, označevalce (tag) in njihoveatribute.^[1] Vključite pa lahko večino HTML z uporabo ekvivalentnihwiki markup alipredlog; 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. (GlejPomoč: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, glejPomoč:Cascading Style Sheets.

Nekateri označevalci izgledajo kot HTML, ampak so v resnici MediaWikioznačevalci za parser in razširitve. HTML v straneh lahko preverite skladnost s HTML5 z uporabovalidacije. Nekatere elemente in atribute podpirajo MediaWiki in brskalniki, ampak so vHTML 5 zastarelin jih zato ne bi smeli več uporabljati.

Ta stran pomoči podaja samo pregled dovoljenih markup kod. Za nadaljnjo pomoč in podrobne specifikacije glejte:

• HTML5 Introduction na developer.mozilla.org
• HTML5 Introduction na w3schools.com

HTML atributi zagotavljajo dodatne informacije o elementu in so vedno opredeljeni na začetku označevalca (tag). Oblikovani so kot par ime/vrednost, kot jename="value".

Globalni atributi se uporabljajo za vse označevalce. Atributi, ki niso navedeni tukaj, jih MediWiki ne dovoljuje^[1]:

• class: ena ali več klasifikacij, katerim element pripada. GlejWikipedija:Katalog CSS razredov.
• 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 poBCP 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 zdata-
• itemid
• itemprop
• itemref
• itemscope
• itemtype

Drugi označevalci, kot je<table>, podpirajo specifične atribute – ti so navedeni v ustreznem razdelku.

To je<spanstyle="color:red;">rdeče</span> besedilo.

TMediaWikiSanitizer.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.

TiHTML 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 sooblikovani s pomočjo CSS in dodani vkazalo vsebine strani.

<h1>Glava 1</h1><h2>Glava 2</h2><h3>Glava 3</h3><h4>Glava 4</h4><h5>Glava 5</h5><h6>Glava 6</h6>

Wiki koda: obdajte besedilo z ustreznim številom enačajev. Naslovi, oblikovani z wikikodo, dodajo povezavo [uredi].

= Glava 1 === Glava 2 ===== Glava 3 ======= Glava 4 ========= Glava 5 =========== Glava 6 ======

Predloge:{{fake heading}} za uporabo v dokumentaciji

Označevalec<p>...</p> umesti vsebino v ločen odstavek.

<p>HyperText Markup Language</p><p>HyperText Markup Language</p>

Wiki koda: Odstavek loči z eno prazno vrstico.

HyperText Markup LanguageHyperText Markup Language

Označevalec<p>...</p> je najbolj uporaben v seznamih, za sezname elementov z več odstavki:

*<p>To je odstavek.</p><p>To je še en odstavek iste postavke.</p>* 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.

Označevalec<br> vriva prelome vrstic. Glejen:H:BR za druge 4 variante, ko programska opremaMediaWiki pretvori<br /> v HTML, ki ga berejo brskalniki.

HyperText<br>Markup Language

Predloge:

• {{break}} doda več prelomov vrstic.
• {{crlf2}} doda pravi "carriage return" in "line feed".
• {{clear}} dodaja prelom s slogom za čiščenje plavajočih elementov.
• {{plainlist}} ustvari neoznačen seznam.

Označevalec<hr> ali<hr /> predstavlja "paragraph-level thematic break" in se prikaže kot horizontalna črta.

<hr />

Wiki koda: uporaba----

----

Predloga:{{hr}}

Označevalec<!--...--> oblikuje zaprto besedilo skrito kot komentar.

HyperText<!--Markup Language-->

Bodite previdni glede presledkov okoli komentarjev. Če obdate komentar s praznimi vrsticami, bo rezultat prazen odstavek, ki bo zaznan kot dodatni dve prazni vrstici:

Vrstica z vsebino 1<!-- Komentar -->Vrstica z vsebino 2

Označevalec<abbr>...</abbr> ustvaritooltip za pojasnitev kratic ali akronimov, ki se prikaže ob premiku miške nad besedilo.

<abbr title="HyperText Markup Language">HTML</abbr>

Predloga:{{abbr}}

Označevalec<b>...</b> slogovno oblikuje besedilo, da se razlikuje od drugega besedila (krepko) brez izražene dodatne pomembnosti.

<b>HyperText Markup Language</b>

Wiki koda: Uporabite''' za odpiranje in zapiranje označbe krepkega besedila.

'''HyperText Markup Language'''

Označevalec<bdi>...</bdi> izolira vsebino od nastavitev smeri okoliškega besedila.

اليمين إلى اليسارod leve proti desni

اليمين إلى اليسار<bdi>od leve proti desni</bdi>

Podpirata: Firefox, Chrome

Označevalec<bdo>...</bdo> določa smer besedila.

Attributes and values:

• dir – določa smer besedila
  • ltr
  • rtl

<bdo dir="rtl">HyperText Markup Language</bdo>

Označevalec<blockquote>...</blockquote> besedilo predstavi zamaknjenem bloku.

<blockquote>HyperText Markup Language</blockquote>

Predloga:{{quote}}; podpira predoblikovane atribute in vire parametrov. Za druge specializirane predloge za citatne bloke, glejteKategorija:Predloge za citate.

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.

<cite>HyperText Markup Language</cite>

Označevalec<cite>...</cite> se na splošno ne uporablja direktno v člankih in je pogosto zlorabljen; glejteWikipedija:HTML 5#cite za navodila za zamenjavo.

<code>...</code> oblikuje odsek računalniške kode. Oblikovan je zCSS prekomediawiki.skinning/elements.less kot pisava|monospace s sivim ozadjem in robom.

<code>HyperText Markup Language</code>

Predloga:{{code}} uporablja<syntaxhighlight>. Glejte razdelek "Glej tudi" na strani predloge za dodatne predloge za označevanje kode.

Glejte§ samp in§ kbd na tej strani za semantično označevanje izhoda in vhoda.

Označevalec<data>...</data> oblikuje strojno berljivo različico vsebine.

<data value="978-0764502149">HTML for Dummies</data>

Atributi:value

Označevalec<del>...</del> oblikuje izbrisano besedilo.

<del>HyperText Markup Language</del>

Označevalec<dfn>...</dfn> se uporablja za označevanje definicije izraza.

<dfn>Definicija</dfn>

Predloge:{{dfn}}

Označevalec<em>...</em> predstavlja del besedila s semantičnim poudarkom). V večini brskalnikov se izpiše ležeče.

<em>HyperText Markup Language</em>

Predloga:{{em}}

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.

<i>HyperText Markup Language</i>

Wiki koda: Uporabite'' za odpiranje in zapiranje označbe ležečega besedila.

''HyperText Markup Language''

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; glejteWP:REDACT.

<ins>HyperText Markup Language</ins>

Označevalec<kbd>...</kbd> označuje uporabniški vnos, kot je tipkanje na tipkovnici ali glasovni ukaz.

Pritisni <kbd>Enter</kbd>

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.

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.

<mark>HyperText Markup Language</mark>

<mark>HyperText Markup Language</mark>

Podpora: Ne podirajo ga Internet Explorer 8 in starejši.

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.

<pre>HyperText Markup Language</pre>

HyperText Markup Language

Označevalec<pre> analizira HTML entitete. Če se želite temu izogniti, nadomestite& z& alinamesto tega uporabite<syntaxhighlight lang="text">.

<pre>&amp;</pre>

&

<pre>&lt;</pre>

<

<pre>&amp;amp;</pre>

&

<pre>&amp;lt;</pre>

<

Predloga:

• {{pre}} objame besedilo, ki prekorači stran.

Označevalec<q>...</q> se uporablja za označevanje kratkih navedkov. Zaenkrat se ta označevalec v Wikipediji uporablja zelo malo.

<q>HyperText Markup Language</q>

Namesto tega raje uporabljajte "", {{quote}} ali <blockquote>.

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.

<ruby>東<rp>(</rp><rt>とう</rt><rp>)</rp>京<rp>(</rp><rt>きょう</rt><rp>)</rp></ruby>

Predloge:

• {{ruby}}
• {{ruby-ja}} za japonščino
• {{Ruby-zh-p}} za kitajski pinjin
• {{Ruby-zh-b}} za kitajski bopomofo

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>.

<s>HyperText Markup Language</s>

Predloga:{{strikethrough}}

<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.

<samp>HyperText Markup Language</samp>

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}}).

Označevalec<small>...</small> oblikuje pomanjšano besedilo.

<small>HyperText Markup Language</small>

Predloga:

• {{small}} uporablja<span>.{{small}} se priporoča namesto<small>, ker ima<small>...</small> semantični pomen zadrobni tisk, medtem ko je{{small}} le stilističen.

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 pravilanepristranskodti. Za uporabo tega elementa in druga poudarjanja glejteWP:KREPKO. Večina semantičnih poudarkov, vključno s citiranim materialom, naj se izpisuje s elementom<em>.

<strong>HyperText Markup Language</strong>

Predloga:{{strong}}

Označevalec<sub>...</sub> oblikuje besedilo v podpisano besedilo.

HyperText <sub>Markup Language</sub>

Predloge:

Označevalec<sup>...</sup> oblikuje besedilo v nadpisano besedilo.

HyperText <sup>Markup Language</sup>

Predloge:

• {{sub}} (_podpisano besedilo)
• {{subsub}} (_{podpisano podpisano} besedilo)
• {{ssub}} (_{podpisano, small} besedilo)
• {{sup}} (^superscript besedilo)
• {{su}} (^nadpisano
  _podpisano besedilo)
• {{sup sub}} (text^sup
  _sub)
• {{e}} (1,23×10⁴)

Označevalec<time>...</time> definira ali čas (24 hour clock) ali datum Gregorijanskega koledarja, z možnostjo časa in odmika od časovne cone.

<time>10:00</time>

Atribut:datetime

Podpora: Ne podirajo ga Internet Explorer 8 in starejši.

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 slogCSS{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).

<u>HyperText Markup Language</u>

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.

*<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>

Predloge:

• {{var}}
• {{varserif}} oblikuje v italic serif z namenom drugačnega vizualnega označevanja

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.

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

Če se okno brskalnika zoži, se drugo besedilo prelomi medHyper inText.

Ne puščajte praznih vrstic med postavkami v seznamu, ker programska oprema MediaWik to interpretira kot začetek novega seznama.

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 pojemmora vključevati enega ali več opisov.

<dl><dt>Pojem</dt><dd>Definicija 1</dd><dd>Definicija 2</dd></dl>

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.

; Pojem: Definicija 1: Definicija 2

Predloga:{{defn}}

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>.

<ol><li>Element 1</li><li>Element 2</li></ol>

<ul><li>Element 1</li><li>Element 2</li></ul>

Wiki koda: uporabite* za elemente v neurejenem seznamu in# za oštevilčene sezname.

# Element 1# Element 2

* Postavka 1* Postavka 2

Predloge: za variante, glejteKategorija:Predloge za oblikovanje seznamov.

Označevalec<div>...</div> se uporablja za ustvarjanje kontejnerja oz. bloka, ki se uporablja za združevanje in ločevanje drugih elementov.

HyperText <div>Markup</div> Language

Označevalec<span>...</span> se uporablja za ustvarjanje kontejnerja vsebine, ki se izpiše kot medvrstični element.

HyperText <span>Markup</span> Language

Označevalec<table>...</table> definira tabelo.

• <tr>...</tr> definira vrstico v tabeli.
• <td>...</td> definira podatkovno celico z vsebino, ki lahko vključuje besedilo, povezave, slike, sezname, druge tabele. itd.

<tableborder=1><tr><td>podatek</td><td>podatek</td></tr></table>

Atributi:

• <table>:

  Dovoljeno toda ne priporočljivo:border="" inborder="1"

  Dovoljeno toda zastarelo:border (z neprazno vrednostjo različno od "1"),align,bgcolor,cellpadding,cellspacing,frame,rules,summary,width^[4]

• <td>:colspan,headers,rowspan

  Dovoljeno toda zastarelo:abbr,align,axis,bgcolor,scope,height,nowrap,valign,width^[4]

Označevalec<th>...</th> definira glavo tabele; slog je centrirano in krepko.

<tableborder="1"><tr><th>Glava</th><th>Glava</th></tr><tr><td>podatek</td><td>podatek</td></tr></table>

Atributi:

• <th>:colspan,headers,rowspan,scope

  Dovoljeno toda zastarelo:abbr,align,axis,bgcolor,height,nowrap,valign,width^[4]

Označevalec<caption>...</caption> dodaja napis v tabelo.

<tableborder=1><caption>Napis</caption><tr><td>podatek</td><td>podatek</td></tr></table>

Atributi:

• <caption>:

  Dovoljeno toda zastarelo:align^[4]

Označevalci<thead>,<tfoot> in<tbody> niso podprti, ampak so avtomatično generirani, vendar se samodejno ustvarijo ob prikazu strani.

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 glejteWikipedija:HTML5 § Zastareli elementi in atributi

Označevalec<center>...</center> (zastarelo) se uporablja za sredinsko poravnavo besedilnih elementov.

Predloga:{{center}} uporablja CSS.

Označevalec<font>...</font> (zastarelo) za določanje atributov besedila, kot so barva, velikost, nabor pisave in slog besedila.

Predloga:{{font}} uporablja CSS.

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.

ZA nadomestitev glejte:Pomoč:HTML v wikibesedilu#rp, rt, ruby

Označevalec<strike>...</strike> (zastarelo) se uporablja za označevanje prečrtanega besedila; namesto tega uporabite<s>.

Označevalec<tt>...</tt> (zastarelo) se uporablja za oblikovanje besedila kjer je vsk znak besedila enako širok. Namesto tega uporabite<code>,<kbd> ali<samp>.

Predloga:{{mono}} uporablja CSS.

Ti elementi niso podprti, anpak imajo ekvivalent v wiki markup kodi. Če poskusite uporabiti katerikoli element, ki ni na belem seznamuSanitizer.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 inInterWikimedia 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 is an outdated HTML4 library that isslated 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 forMediaWiki interface pages. Tidy was never perfect and has been known to introduce errors.

Nekatere strani vimenskiem 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.

User and sitewideCSS andJavaScript pages are interpreted as if inside a<pre> block. GlejtePomoč:Uporabniški slog.

Glavni članek:Help:Markup validation.

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 theW3C Markup Validation Service.

Za strojno generiran seznam, glejSpecial:Version#mw-version-parser-extensiontags. Vsebuje lahko označevalce, ki niso navedeni tukaj.

Označevalci za parser

<gallery>,<includeonly>,<noinclude>,<nowiki>,<onlyinclude>,<pre>

Označevalci za razširitve

<categorytree>,<ce>,<chem>,<charinsert>,<graph>,<hiero>,<imagemap>,<indicator>,<inputbox>,<math>,<math chem>,<poem>,<ref>,<references>,<score>,<section>,<syntaxhighlight> (alias<source>),<templatedata>,<timeline>

• Pomoč:Wiki markup
• Wikipedija:HTML5

• HTML 4.01 specification:elements |attributes
• HTML 5.2 specification:elements |attributes

• Tehnična navodila za Wikipedijo
• Priročnik za urejevalce

• Strani v Wikipediji z nepravilnimi predlogami za zaščito