Hjælp: tags

fra Wikipedia, den gratis encyklopædi
Spring til navigation Spring til søgning

Etiketter er et karakteristisk træk ved wiki -tekster . De er lånt fra markeringssprogene XML og HTML .

Denne hjælpeside giver et komplet overblik over, hvordan den kan bruges i Wiki -projekter. Resuméer kan findes under Hjælp: Tekstdesign .

En anden betydning af tags i wiki forklares under Redigering markering.

indeks

Lige til elementet:

Hjælp til de almindelige tags i wikitext kan næsten altid opnås ved at indtaste følgende i søgefeltet : h: name

syntaks

Syntaksen svarer til XML og HTML; der er minimale forskelle mellem de to sprog.

I det enkleste tilfælde har et mærke formen <name> - identifikatoren er efter åbningsvinkelbeslaget < . Det skal skrives med små bogstaver, men forstås også med store bogstaver. Lukkevinkelbeslaget > slutter dagen.

Der er grundlæggende flere sager:

  • Begyndelse og slutning:
    Et tekstafsnit er omsluttet af to tags, der har den samme identifikator. Den sidste dag starter med en skråstreg:
    <name> ……… </name>
    • Dette er beregnet til at tildele bestemte ejendomme til det lukkede område.
    • Hele enheden mellem begyndelse, slutning og indhold kaldes et element.
    • Elementer kan indlejres i hinanden; et indre element skal imidlertid derefter være fuldstændigt indeholdt i et ydre element.
  • unary tag som <references /> (single):
    • De har intet indhold; men kan have en kontrollerende effekt.
    • I tekster, der lejlighedsvis læses af mennesker (som det jævnligt er tilfældet med wikitekster), skrives et mellemrum foran skråstreget for bedre læsbarhed for at kunne skelne tagget pålideligt og uden fejl fra den binære variant, f.eks. B. med <references /> vs. </references> .
  • Tomt element (f.eks. <div></div> ).
    • For wiki -udvidelser kan dette altid erstattes af det kortere og hurtigere forståelige unary -tag , som det også findes i XML.
    • I HTML skelnes der stadig mellem tags, der aldrig kan indeholde indhold (tomrum) , [1] og dem, der i princippet kunne indeholde indhold, men som lige nu er tomme. I det første tilfælde skal der bruges et unary -mærke , i det andet tilfælde (tomt) må der ikke bruges nogen unary -tag . Dette kan føre til vanskeligheder, især med et tomt <div> . Siden sommeren 2016 er det ikke længere tilladt at [2] skrive tomme HTML-elementer af denne type med et "selvlukkende" unary-tag i kildeteksten; dette gælder specifikt ikke for MediaWiki -elementer og ikke for ugyldige -HTML.
  • Skabelonprogrammering :
    • Her kan tags i første omgang trækkes tilbage fra normal behandling ved hjælp af funktionen #tag:

Egenskaber

Følgende gælder også:

  • Attributtildelinger er mulige inden for tags. Dette gælder dog kun den første dag (åbning eller single).
  • De har attribut="Wert usw."
  • Attributværdier skal være anbragt i " ( ASCII tegn, Code 34 10) (muligt, men ikke almindeligt ville være apostroffer ' som ASCII-tegn, Code 39 10). Hvis attributten værdien kun består af et tal eller et enkelt ord, [ 3] dette ville også blive forstået uden en begrænser, hvis det er nødvendigt, men dette er meget tilbøjeligt til fejl.
  • Navnene på attributter skal skrives med små bogstaver.
  • Bortset fra navnet på tagget og attributtildelingerne må der ikke vises andet indhold i tagsene.
  • Linjeskift mellem attributtildelinger får lov til at gøre lange tags med mange attributter tydeligere; men ingen tomme linjer.
  • Tegnet < (samt > ) må ikke vises.
  • Attributter kan ikke gentages på en dag.
  • Attributformatet bruges ikke kun inden for tags, men også i for eksempel tabeller , hvor attributterne derefter indsættes i de genererede HTML -elementer.
  • Et par attributter er selvstændige ; de tildeles ingen værdi, og de udløser en effekt ved deres tilstedeværelse. Dette er dog meget sjældent i wikitext. [4]

Nogle almindelige standardattributter er

Om de er effektive i et specifikt individuelt tilfælde afhænger af dagen.

klasse

Klasserne er særligt vigtige for tildeling af CSS , da det er defineret projektdækkende i MediaWiki: Common.css og også kan aftales individuelt ( hjælp: CSS ).

Forsigtig: Hvis der er angivet flere klasser, skal de adskilles fra hinanden med mellemrum; ikke med komma:

class="wikitable float-right"

En projektdækket defineret klasse er error , ved hjælp af hvilken fejlmeddelelser (f.eks. Fra skabeloner ) kan findes på alle sider og formateres ensartet.

id

Dette kan bruges til at oprette fragmenter, som mærkerne kan linkes direkte til.

Der er regler for identifikatoren:

  • Identifikatorer skal starte med et bogstav og må ikke indeholde et # ; så de kan forbindes på en meningsfuld måde, heller ingen wikisyntaks som <>{|}[] .
  • For bedre læsbarhed bør de kun bestå af visse ASCII -tegn i alle situationer, nemlig:
    AZ az 0-9 . - / ( ) , ;
  • Identifikatorer må aldrig gentages på en side.
  • De skal være så korte som muligt og kortfattede med hensyn til indhold (slagord), og folk bør fortolke og skelne dem entydigt ("tale").

stil

Mens med class= CSS formatering er tildelt alle elementer på samme tid, med style= et enkelt element vises i en bestemt typografi. Dette gøres kun regelmæssigt i skabelonprogrammeringen og kan bruges i artikler som en undtagelse; se hjælp: CSS .

lang

Attributten lang= bruges lejlighedsvis i skabelonprogrammering. En sprogkode i henhold til ISO 639 osv. Skal angives syntaktisk som værdien; Passende wiki -udvidelser er også mulige.

Et menneskeligt sprog er tildelt elementet. lang="fr" betegner fransk, lang="de-AT" betegner østrigsk.

Dette kan bruges af skærmlæsere eller til at vælge særligt egnede skrifttyper [5] .

Brug af et XML -navneområde , xml:lang="it" , er ikke tilladt her eller andre steder.

Om muligt bruges opgaven ikke direkte i artikler, men mest via en skabelon: lang og andre .

til dig

Skrivningsretning (projektstandard: fra venstre mod højre); opgaven bruges ikke direkte i artikler, men via særlige skabeloner .

titel

Indholdet vises som et værktøjstip på alle synlige elementer; men normalt kun på stationære enheder og ikke på mobile enheder med berøringsskærm . Indholdet af attributten er simpel tekst uden markup ; et linjeskift kan foretages ved hjælp af &#10; blive genereret.

Ved at tildele en tom tegnstreng title="" kan værktøjstipet for omgivende områder undertrykkes.

Denne funktionalitet må kun tilbyde understøttende og ikke meningsfuld information, da den teknisk set ikke kan opfattes af enhver læser, og læsere ikke kan antage, at de lejlighedsvis kunne gøre yderligere tekst synlig på et upåagtet sted ved hjælp af musemarkøren. Dette er ikke særlig velegnet til aktuelle encyklopædiske artikletekster; For funktionssider og interaktive grafiske elementer kan læseren gøres opmærksom på mulighederne.

rolle

Tilgængelighed understøttes ved hjælp af role= og muligvis kombineret med aria-hidden= . Nogle af elementerne er identificeret som værende særligt vigtige for at navigere i det samme dokument eller for andre sider, der er nært beslægtede med hensyn til indhold; en anden del af elementerne ville være overflødige og forvirrende og bare irriterende for blinde, hvorfor de ikke er nævnt. Dette bruges ikke i kildekoden for encyklopædiske artikler.

Forældede attributter

Følgende attributter er ikke længere opdaterede og bør erstattes af opgaver i stil = eller en klassespecifikation som en del af revisioner:

align= bgcolor= border= clear= height= valign=

Dette fører også til en ensartet brug af CSS i stedet for forskellige historiske særlige forskrifter, der forvirrer i det lange løb. I de fleste tilfælde inkluderer den også width= . Se Hjælp: CSS .

Behandlingssekvens

  • Etiketter, der ikke er blevet opsnappet af wiki -behandlingen, og som er blevet behandlet af brugeren, forbliver i teksten. På nuværende tidspunkt kræver dette også optagelse i en positivliste; se Forbidden HTML .
  • De videregives således til outputdokumentet, og det skal bruge en gyldig HTML -syntaks.
  • Elementerne i wikisyntaksen (links, apostrofer osv.) Konverteres også til HTML, hvis det er nødvendigt.
  • Inden dette leveres til læseren, kører en RemexHTML -funktion (tidligere brugt: HTML Tidy [6] ) og forsøger at fortolke den resulterende blanding og formatere den som HTML, der er i overensstemmelse med standarderne.

Wiki -udvidelse

I den tysksprogede Wikipedia defineres ud over den grundlæggende wikisyntaks følgende tag-id'er, der kun er gyldige i wikier:

karsert

Dette element er kun beregnet til programmering af links til at indsætte tekstelementer i redigeringsfeltet. Det lukkede område konverteres til et link, der kalder wikibits -funktionen insertTags() . Sådanne links er ikke mulige med nogen anden wikisyntaks.

nuiki

Wiki -syntaksen har ingen effekt i det område, der er omsluttet af <nowiki> …… </nowiki> .

  • Alternativt kan entiteter også bruges, hvis kun få tegn skal maskeres. Dette er dog mindre læseligt i normal kildekode og ville være mere nyttigt til programmering af skabeloner .

Wiki -behandling afbrydes med <nowiki /> som unary tag ; dette bruges i kombinationer med wikilinks, hvis følgende ord ikke skal vises som en link titel: månelanding over [[Mond]]<nowiki />landung .

Enhederne &...; er ikke wikisyntaks, fungerer kun på karakterniveau og påvirkes ikke af nowiki . En gengivelse af kildekode, hvor enheder også forbliver synlige som specificeret, kan opnås med < syntaxhighlight lang="text"> .

Hvis nowiki skal gøre links og andre syntakselementer ineffektive, men for at evaluere variabler (og skabeloner ), kan den #tag: til skabelonprogrammering og intern dokumentation ved hjælp af funktionen #tag: ::

 {{#tag: nowiki | ... {{PAGENAME}} ...}}

Grundlæggende syntaks

Følgende indbyggede elementer fortolkes i hvert projekt:

bagestext inkluderer kun noinclude onlyiki onlyinclude

Derudover kan hvert projekt individuelt sammensætte valgfri softwarekomponenter, udvidelserne ("udvidelser"); se special: version .

HTML filosofi

De HTML -elementer, der er tilladt i vores Wikitext, bidrager til den viste tekst ved hjælp af to metoder:

  1. Inline -elementer - de påvirker skrifttypedesignet i en teksttekst ; Så dens farver, størrelse, skrifttype og mere.
  2. Bloker elementer - de arrangerer sidens layout . Hvert blokelement kan forestilles som et rektangulært stykke papir; på siden, arrangerer browseren derefter alle disse rektangler ved siden af ​​hinanden, sjældent inde i hinanden og ellers under hinanden.
  3. Kommentarer er tilladt, men har ingen effekt på det genererede HTML -dokument.

Inline elementer

  • Det universelle inline -element i HTML kaldes <span> .
    • Dette er kun nyttigt, hvis det også angives attributter .
  • Andre almindelige er f.eks. <small> <sub> <sup> <code>
  • Som regel forekommer inline -elementer i par , dvs. med et start- og sluttag, og forventer tekstindhold imellem.
  • <br /> er en undtagelse hertil, er en del af den <wbr /> tekst og også den sjældne <wbr /> .
  • Wiki -syntaksen styrer: '' og ''' for kursiv og fed skrift samt alle links.

Et blokelementaldrig optræde inden for et inlineelement; ikke engang slutningen på et afsnit.

  • <code> tillader heller ikke et linjeskift, da det kun er beregnet til enkelte ord eller korte grupper af ord.

Den enkle tekst, muligvis specielt formateret i sektioner med inline -elementer, "hældes" (typisk som kontinuerlig tekst ) i et blokelement .

Bloker elementer

  • Det universelle blokelement i HTML kaldes <div> . Det vil normalt have en attribut.
  • I HTML kræver blokelementer næsten altid et start- og sluttag; i hvert fald hvis det ønskes i wikitext.
  • Af wiki -softwareelementerne er blokelementer:
    • Alle afsnit (f.eks. Afsluttet med en tom linje).
    • Alle overskrifter .
    • Alle punkttegn og lister og hvert enkelt element i dem.
    • Alle tabeller , bordlinjer og individuelle bordceller .
    • Forformateret tekst med et mellemrum i begyndelsen af ​​linjen.
    • <pre> , hvorved et HTML -element med samme navn maskeres.

Blokelementer kan indeholde enkel tekst (muligvis formateret i sektioner med inline -elementer) samt andre blokelementer.

De kan centreres eller adresseres til layoutflow ; mindst elementet som helhed, siger hele tabellen.

Genereret HTML

Wiki -softwarens grundsyntaks genererer i sidste ende altid HTML -elementer, der indsættes i HTML -dokumentet.

  • De fleste af dem er blokelementer.
  • Inline -elementerne inkluderer '' og ''' for kursiv og fed skrift, inklusive alle links.
  • Billeder kan vises i begge roller; Som standard er de inline -elementer, men med parametre som f.eks. Et miniaturebillede bliver de til et blokelement.
  • <ref> er inline på det punkt, hvor slutnotemærket forekommer; selve detaljerne i <references> blokken er et kuglepunkt og derfor en del af en blok.
  • <syntaxhighlight> er som standard et blokelement, men har en inline parameter, der vender dette.
  • Hvad angår indlejrede sider (f.eks. Skabeloner), hvad der er resultatet af udvidelsen, gælder.

Nyttig HTML til artikler og sidetekster

Kun et lille antal elementer fra det generelle Hypertext Markup Language giver mening uden begrænsning på alle sider:

I den aktuelle artikeltekst er usædvanlige formateringskonstruktioner uforståelige og forstyrrende for de andre forfattere; her skal de være indlejret i generelt brugbare skabeloner med et beskrivende navn. Forfattere af generelle artikler bør ikke konfronteres med kryptisk syntaksfinding i den løbende tekst .

I tilfælde af tabeller og skematiske fremstillinger i artiklen kan brug af farver og specielle formater ud over standardelementerne være nødvendig og nyttig.

I fremmedsprogede tekstafsnit (især i asiatiske scripts) ville Ruby-notationen og anden scriptinformation også kunne tænkes med elementerne

bdi ruby ​​rb rp rt rtc

- dette vil også omfatte rbc , som i øjeblikket ikke understøttes af softwaren.

HTML -elementer, der er noteret på en positivliste, føres gennem wiki -softwaren i outputteksten. I tilfælde af ukendte elementer vises tagsne også og har ingen effekt; Det samme gælder for alle udtrykkeligt forbudte elementer. De fleste HTML -elementer kan bruges med det; dog er ikke alle HTML -elementer i wikitext ønskelige eller nyttige.

kommentar

  • En kommentar begynder med strengen <!-- og slutter med strengen --> (også på tværs af tomme linjer).
  • Kommentaren vises ikke på den viste side; den er heller ikke integreret som en kommentar på den genererede HTML -side.
  • Tekst mellem de to ydre strenge må hverken begynde med strengen > eller strengen -> eller indeholde strengen <!-- , --> eller --!> , Og skal heller ikke ende med strengen <!- .
    Mærker bør om muligt ikke inkluderes i teksten i en kommentar. Hvis dette er tilfældet, er det vigtigt at sikre, at mærkerne uden for kommentarerne fortsat danner selvstændige konstruktioner, dvs. hvert tomrumselement (element i form af et unært mærke ) med dets komplette starttag ubrudt, enten helt udenfor eller står helt inde i en kommentar, og for hinanden er både startmærket, der afgrænser det, og slutmærket, der afgrænser det, enten helt uden for eller helt inde i en kommentar.
  • Følgende er givet som kommentarer:
    • Tekniske noter til bots, scripts og forfattere, som f.eks
    • Tekniske noter til andre forfattere; f.eks. på formatskabeloner eller parameterværdier, integration af denne side med andre sider, opdatering af bots .
    • Små tip til andre forfattere om formatering; mulige forvekslinger eller små stave- og formateringsfejl i originalen tekniske detaljer om kilder og links eller andre faldgruber; Advarsel om uønsket oppustethed.
  • Generel indholdsrelateret information skal placeres på artiklens diskussionsside eller noteres i teksten, så den er synlig for alle læsere.

Se her for detaljer.

br

  • <br /> -elementet opretter et linjeskift i en tekstblok .
  • I slutningen af ​​tekstblokke er <br /> ineffektiv og derfor overflødig. Dette kan f.eks. Være: et afsnit , et punktopslag, tabelceller eller billedtekster. I begyndelsen af ​​en sådan blokering kan en pause også være ineffektiv.
  • <br /> -elementet har ingen gyldige attributter; især ikke clear= .
  • Følgende gælder for typografi:
    • Afbrydelse af læsestrømmen i artiklerne er uønsket. Enten starter du en ny tanke og laver et nyt afsnit (med en tom linje), eller du fortsætter tankegangen i samme linje.
    • Linjeskift er nyttige, når der er behov for en visuel struktur i et begrænset rum: bordceller og billedtekster; også indholdsstrukturen for et enkelt element på listen (element på listen) uden start af yderligere nummerering eller et ekstra element.
    • To på hinanden følgende linjeskift er normalt ikke nyttige; her er et afsnit, der skal laves.
  • <br /> kan placeres inden for en kildetekstlinje, en ny kildetekstlinje skal ikke startes. En linjeskift i kildeteksten gør det imidlertid lettere at holde overblikket for efterfølgende forfattere (undtagen i listeelementer: der afbryder hver linjeskift fortegnelsen / optællingen).
  • I HTML4 var stavemåden bare <BR> , forskellig fra <br /> XHTML -specifikationen, som blev vedtaget med lige rettigheder i den efterfølgende HTML5 -webstandard. Internt konverteres alle disse tags (HTML5 -kompatible) til <br> . Det er bydende nødvendigt, at det er et unarisk mærke ; <br></br> er derfor to linjeskift og ikke et tomt element .
  • <br /> tilføjes straks til slutningen af ​​linjen. Det tilhører denne linje samt afsnitstegn ¶, der somme tider vist i tekstbehandlingsprogrammer. Hvis det ønskes, kan dette efterfølges af et mellemrum, en ny linje med kildetekst eller den næste indholdslinje med det samme:
    I slutningen af ​​en linje
    er afsnitstegnet .

kode

Ved hjælp af <code> …… </code> områder i den kørende tekst i skrifttypemaskine . Bogstaver kan således klart skelnes; om i I l 1 | kan ikke forveksles. Dette er interessant for computerkode.

  • Wiki -syntaks erstattes inden for omfanget.
  • En ramme vises som standard ved hjælp af <code> ; elementet er kun beregnet til meget korte, dvs. enkeltlinjesøgeord eller tekstsekvenser. Et linjeskift er ikke nyttigt. Tekstpassager med flere linjer kan vises i skrivemaskinen ved hjælp af <tt> .
  • Hvis en hel tekstblok skal repræsenteres i artikler, anbefales det at < syntaxhighlight lang="text" > ved hjælp af < syntaxhighlight lang="text" > (eller mere specifikke formater).
    • Før dette var muligt, blev <code> til sådanne formål.
    • Den code Området er i øjeblikket vises på en hvid baggrund. Dette er normalt ikke mærkbart og vil sandsynligvis blive droppet en dag; går også tilbage til tidligere anvendelser.
    • Desværre betyder det, at linktekster ikke kan genkendes, hvis omfanget af linket og kodeblokken er det samme. Til dette og med en farvet baggrund skal du skifte til < tt > , eller <code> -koderne skal vedlægge det fulde link.
  • Hvis du vil undgå linjeskiftet i en kort kodesekvens, kan du skrive:
    <code style="white-space: nowrap"> …… </code>
    Længere sekvenser hører hjemme i en separat blok.
  • <code> er efterfølgeren til det forældede < tt > .

div

Med <div> er der defineret et element på tekstblokniveauet . En tekstblok begynder normalt på en ny linje; ellers er også tabelceller og billedtekster inkluderet.

Kun én brug kræves i artikler uden for skematiske fremstillinger:

  • <div style="clear: both;"></div>

Det betyder, at efter at billeder eller tabeller er blevet indarbejdet, strækker sidelayoutet sig igen over hele bredden; om nødvendigt indsættes et mellemrum op til bunden af ​​det forrige billede.

Det indsættes også af skabelonen {{ paragraph }} . [7]

Formularer, der ikke er tilladt og ikke forstås af alle browsere

  • <br style="clear: both;" />
    • br er ikke et tekstblokniveauelement, som det er nødvendigt for sidelayout.
  • <div style="clear: all;" />
    • Nøgleordet er both .
  • <div clear="all" />
    • clear er ikke et standardiseret attributnavn.
  • <div style="clear: both;" />
    • " Selvlukkende " indholdselementer er ikke længere tilladt for HTML siden sommeren 2016. [2]

Derudover right left og right stedet for both right forestilles som søgeord; dette er imidlertid irrelevant for udformningen af ​​normale wiki -sider (passende eksempel ).

I skabelonprogrammering bruges <div> elementer til at tildele klasser og stilarter til tekstblokke; dette kan også bruges til grafiske fremstillinger i artikler.

lille

  • Teksten er skrevet et trin mindre. Du bør lade det være i den normale tekst, kun i formelsættet ved hjælp af < math > yderligere reduktioner være nyttige.
  • Ofte er en mindre skrifttype typografisk slet ikke nyttig; den kunne lige så let skrives i normal skriftstørrelse og sættes i parentes i stedet.
  • Inden for områder, der allerede er nedskrevet, er en yderligere reduktion dels teknisk ineffektiv (fordi beregningen afhængigt af huden ikke er i forhold til miljøet), dels betyder det, at læsere med øjenproblemer ikke længere kan læse teksten eller slutte enheder kan ikke længere vise tegnene på en adskillelig måde. small bør ikke bruges inden for sub og sup , billedtekster, ref .

sub sup

Elementerne sub og sup påvirker subscript og superscript af den vedlagte tekst. Dette er skrevet mindre på samme tid. Der < small > bruges yderligere < small > ; den bør heller ikke indeholde nogen anden sub eller sup . I sådanne tilfælde ( formelsæt ) er der < math > .

Følgende gælder for typografi og tegnkodning:

  • Eksponenterne for kvadrat og kubik i enheder (f.eks. M² og m³) skrives ikke med sup , men med de enkelte tegn ² (pc -tastatur: AltGr + 2 ) og ³ (pc -tastatur: AltGr + 3 );ANSI 178 10 og 179 10 , også tilgængelig via inputhjælpen under redigeringsfeltet.
  • Alle andre eksponenter er skrevet med sup , selvom der er Unicode -definitioner for dem. Disse præsenteres dog ikke for alle læsere.
  • Hvis firkanter og andre eksponenter vises samtidigt i en tekstpassage, skal alle eksponenter formateres ensartet med sup , fordi den grafiske fremstilling normalt afviger noget.
  • I musikalsk notation er alle overskriftscifre ensartet skrevet med sup .
  • Abonnementerne skrives altid med sub , selvom der er nogle Unicode -værdier for dem. Disse præsenteres dog ikke for alle læsere.

Eksempel: T<sub>A</sub><sup>−1</sup> bliver T A −1 .

dd

HTML -elementet <tt> …… </tt> (forkortelse for teletype tekst ) forårsagede visning i skrifttypemaskine .

  • Effekten svarer dybest set til < code > .
    • Der er forskelle med hensyn til baggrundsfarve (gennemsigtig) og skriftstørrelse; også afhængig af kontekst og hud .
    • Selvom <tt> også tillader tekstpassager med flere linjer, er <code> som standard omgivet af en ramme og er kun beregnet til meget korte søgeord eller tekstsekvenser.

<tt> er (med HTML5) en forældet og langsigtet ikke længere understøttet notation i HTML. Men fordi det er meget let at skrive, findes dette stadig ofte i wikitexts. Hvis den ikke længere understøttes af browsere, kan dens effekt let opfattes af et MediaWiki -element med den samme syntaks.

Wikisource er eller blev <tt> …… </tt> brugt på en måde, der adskiller sig fra HTML -standarden for visning i Antiqua -skrifttyper.

HTML uden for artiklen

Yderligere elementer er mulige til skabelonprogrammering , til funktionssider især om tekniske spørgsmål og i diskussioner eller på brugersider:

De må kun bruges i artikeltekster i undtagelsestilfælde.

spændvidde

<span> er et universelt element til enhver tekstformatering. Alle andre formateringselementer på karakterniveau kan i princippet erstattes af span . I modsætning til < div > virker inline, dvs. inden for en tekstblok ( punkt ), særlig tildeler den class , id , og style attributter til et stykke tekst.

Som regel bruges de resulterende til tider komplicerede strukturer kun i skabelonprogrammeringen og på funktionelle sider til tekniske spørgsmål.

før

Med <pre> en blok med kodede oplysninger, dvs. i skrifttypemaskine og med linjeskiftet, der findes i kildeteksten.

  • Som en wikisyntaks bør linjer med et mellemrum som det første tegn på hver linje bruges på normale sider.
    • I modsætning hertil fortolkes det meste af wikisyntaksen ikke inden for <pre> …… </pre> ; så det er sådan set en kombination med < nowiki > .
  • Es ist eine Wiki-Erweiterung , die einem gleichbenannten HTML-Element überlagert ist.
  • Eine Alternative wäre < syntaxhighlight lang="…"> – ggf. mit lang="text" universell.

abbr acronym

Mit <abbr> (und <acronym> ) lassen sich Abkürzungen als solche kennzeichnen. Die semantisch feine Unterscheidung zwischen beiden Elementen hat sich kaum durchgesetzt.

  • In der HTML-Welt hat <acronym> keine Zukunft. Die Ausdifferenzierung (Abkürzung, Akronym, Apronym, Initialwort, Silbenkurzwort; expandiert, in Worten gesprochen oder buchstabiert [ Screenreader ]) soll zukünftig über anwenderspezifisches class= nur noch mittels <abbr> erfolgen. [8]

MediaWiki hat zurzeit acronym nicht auf der Positivliste .

Neben Verlinkungen und Bildern waren das in HTML.4 die einzigen grafischen Elemente, die einen Tooltip anzeigen, wenn man mit dem Mauszeiger darüber fährt; dies sollte die Erläuterung zur Abkürzung sein. Für modernere Browser kann auch das Universalattribut title= jedem sichtbaren Element zugeordnet werden; allerdings wissen Leser zunächst nicht, dass sie einen Tooltip erhalten würden, wenn sie den Mauszeiger dorthin bewegen.

In Artikeln wird dieses Element nicht verwendet; Wikilinks auf die Langform zu einer Abkürzung haben hinsichtlich des Tooltips den gleichen Effekt.

Beispiel
  • AI – erzeugt mit abbr-Tag: <abbr title="Amnesty International">AI</abbr>
  • AI – erzeugt mit Wikilinks: [[Amnesty International|AI]]

In der MW-Software gibt es die analoge class ="explain" und ermöglicht individuelle Erklärungen. Sie arbeitet mit der CSS -Deklaration cursor:help – diese ist ab CSS2 (1998) verfügbar, unterstreicht den Bereich üblicherweise mit einer gestrichelten Linie und zeigt meist ein Fragezeichen, wenn der Cursor dort steht.

Redaktionelle Markierungen

s strike

Mit diesen Tags wird der dazwischen liegende Text durchgestrichen.

Mit HTML5 (schon seit HTML4) ist <strike> nicht mehr standardkonform; <s> hat seine Semantik leicht gewandelt, was für Wiki-Anwendungen irrelevant ist.

del ins

Diese Elemente gehen über die reine Textformatierung hinaus; hier sollen auch Angaben zum Autor (Verlinkung) und Zeitpunkt gemacht werden und es soll eine optische Zuordnung (Farben) zu den einzelnen Veränderungsphasen oder Autoren sichtbar werden. <del> wird meist durchgestrichen dargestellt.

Das mag in einem Artikel zur Entstehung von Gedichten, Gesetzestexten usw. einmal sinnvoll sein, wäre ansonsten allenfalls bei der Erarbeitung Wiki-interner Texte einzusetzen.

mark

Die Kennzeichnung <mark> ( Textmarker -Funktion) ist eher gedacht zur dynamischen Einfügung in die fertige HTML-Seite, als dass es im Quelltext des Wikis dauerhaft vorhanden sein sollte (hierfür wäre < span > zu verwenden).

Mit <mark> kennzeichnet man in einem statischen Text vorübergehend den Bezug zu wechselnden Anmerkungen oder Belegen, oder man markiert das Vorkommen von aktuellen Suchbegriffen. Die konkrete Farbe wird dynamisch vom Browser so festgelegt, dass sie mit den im markierten Bereich vorhandenen Schrift- und Hintergrundfarben kontrastiert.

Die MediaWiki-Installation übersteuert allerdings im Moment dieses Verhalten und gibt explizit vor: Schwarze Schrift auf gelbem Hintergrund, weil älteren Browsern das neue HTML-5-Element unbekannt ist und wirkungslos bleiben würde.

Unerwünschtes HTML

Es sind über 110 verschiedene Element-Namen in HTML bekannt. Sie tragen teils kontextabhängige semantische Feinheiten, teils sind sie veraltet. Wiki-Autoren sollen sich damit nicht auseinandersetzen müssen.

Wikisyntax

Wo die Wikisyntax selbst Möglichkeiten bietet, sollen keine HTML-Elemente eingebracht werden.

Element Bedeutung Ersatz durch Wikisyntax
b strong Hervorhebung; Fettschrift Drei Apostrophzeichen '''
i em Hervorhebung; Kursivschrift Zwei Apostrophzeichen ''
p Absatz Leerzeile
<hr /> Trennlinie Vier Bindestriche ----
Im Artikel-Layout unerwünscht
ol ul li Aufzählung Stern * und Hashcode #
dl dt dd Definitionsliste Semikolon ; und Doppelpunkt :
h1 h2 h3 h4 h5 h6 Überschrift Gleichheitszeichen =
table td th tr thead caption tbody col colgroup tfoot Tabellensyntax Tabellensyntax

Gelegentlich werden temporär auf internen Funktionsseiten wie etwa Wartungslisten die Ergebnisse externer Software eingetragen, die laufend aktualisiert werden. Sie sind ggf. nicht in Wikisyntax, sondern mittels HTML formatiert, und dort ist das auch nicht zu beanstanden.

Formatierung

Diese Tags sollen in Artikeln und Projektseiten nicht verwendet werden. Nur im Rahmen der Vorlagenprogrammierung wird ggf. von den semantischen Eigenschaften der ersten drei Tags Gebrauch gemacht.

Element Bedeutung Ersatz
<blockquote> Blockzitat Vorlage {{ Zitat }} oder fremdsprachliche Varianten
<q> eingebettetes Zitat Vorlage {{ " }}
<cite> Titel eines Werks Kursivschrift
<u> Unterstreichung Kursivschrift
( Verwechslung mit Verlinkung ; Irritation der Leser)

Ungebräuchliches HTML

Gelegentlich wird noch gefunden oder thematisiert:

Element Bedeutung Ersatz
big Große Schrift style="font-size:larger;"
center Zentrierung class="centered"
class="center"
font Schrifteigenschaften style="…"
dfn , kbd , samp , var Software-Dokumentation <code>
nobr Kein Zeilenumbruch
(Nicht standardisiert)
style="white-space:nowrap;"
<wbr /> Worttrennung möglich (ohne Trennstrich )
(Seit HTML5 standardisiert)
Im Fließtext unerwünscht
&shy; (mit Trennstrich)
Im Fließtext unerwünscht

Es gibt noch etliche weitere Tags in HTML; diese waren aber bislang in Wikitexten nicht in Erscheinung getreten.

big

Dieses Element soll nicht verwendet werden.

  • Zeichen aus außereuropäischen Schriften sind in die entsprechenden Vorlagen der Kategorie:Vorlage:Fremdsprachenunterstützung einzubetten, die auch andere Eigenschaften projektweit geeignet zuordnen.
  • Für Überschriften ist Wikisyntax zu benutzen.
  • Zwischenüberschriften etwa in Infoboxen sind bei der Vorlagenprogrammierung über < span > zu realisieren.

Mit HTML5 ist <big> auch nicht mehr standardkonform.

center

Mittels <center> wurde ein Element innerhalb eines Blocks (horizontal) mittig ausgerichtet.

Es wird nicht gern gesehen, Artikel nach individuellem Geschmack umzugestalten; Bildlegenden usw. folgen einem einheitlichen Layout.

Wo wirklich erforderlich, kann mit dem Attribut class ="centered" ein ganzer Block zentriert werden; außerdem mit class="center" fast jedes Tag zur mittigen Ausrichtung seines Inhalts gebracht werden. Näheres siehe auf TG/Zentrieren .

Mit HTML5 (schon seit HTML4) ist <center> nicht mehr standardkonform; es sollte deshalb nicht mehr neu eingefügt und allmählich aus der Wikipedia entfernt werden. Es kann durch die genannten class ersetzt werden.

Bei Tabellen ist class ="center" der adäquate Ersatz für einzelne Felder oder die Tabelle insgesamt, in Fällen ohne Element steht, wenn erforderlich, die Vorlage: Center zur Verfügung.

font

Dieses Element spezifizierte Einzelheiten zur Schriftart, Schriftgröße oder andere Darstellungsformen. Das wird seit langem über das allgemeinere < span style =""> realisiert.

Mit HTML5 ist <font> nicht mehr standardkonform, war schon 1998 mit HTML4 obsolet und sollte unbedingt aus allen Wikiseiten entfernt werden.

Im Übrigen sind die Wiki-Seiten schlicht gehalten und verwenden nicht lauter verschiedene fein abgestufte Schriftgrößen. Für außereuropäische Schriften werden dem Browser Hinweise zu geeigneten Zeichensätzen über entsprechende Vorlagen gegeben.

HTML 2

dfn kbd samp var

In HTML 2 gemäß RFC 1866 von 1995 gab es noch kein CSS und keine style -Vereinbarungen. Deshalb musste jedes unterschiedliche Markup damals ein gesondertes Element erhalten.

Seinerzeit sah man als wesentliches Einsatzgebiet die Erstellung technisch-wissenschaftlicher Dokumente; insbesondere auch automatisch generierte Software-Dokumentation , die durch spezielle Tags unterstützt werden sollte. Aus diesem Kontext stammen die dfn kbd samp var – heute benutzt man dafür Klassen und CSS-Stile.

Als Darstellung für kbd und samp war Schreibmaschinenschrift vorgesehen; var und dfn werden meist kursiv dargestellt.

Für Tastatur-Eingaben einzelner Zeichen verwenden wir nicht direkt <kbd> , sondern {{ Taste }} ; bei allen anderen Anwendungen steht < code > oder < syntaxhighlight > zur Verfügung; selbst < tt > . Kursivschrift wird durch Apostrophe erreicht.

Das Element <samp> hat die semantische Bestimmung, den Output oder die Antwort von Computerprogrammen darzustellen. Zusammen mit <kbd> bildet es den Eingabe-Ausgabe-Dialog von textorientierten Konsolen der damaligen Zeit. Auf keinen Fall dürfen diese semantischen Elemente dazu missbraucht werden, Schreibmaschinenschrift zu generieren, nur weil das zufällig auch die gängige Darstellungsweise sei.

Andere Wikiprojekte

Nicht in der deutschsprachigen Wikipedia, aber in anderen Wikiprojekten könnte man zusätzlichen Wiki-Erweiterungen begegnen. Dazu gehören:

<languages />
Weist in mehrsprachigen Projekten auf der üblicherweise englischsprachigen Oberseite darauf hin, dass bestimmte Übersetzungen in Form von Unterseiten vorliegen.
<translate></translate>
Markiert in mehrsprachigen Projekten übersetzte Bereiche zu einer üblicherweise englischsprachigen Fassung.

Verbotenes HTML

Aus Sicherheitsgründen sind eine Reihe von HTML-Anweisungen ausschließlich über Wikisyntax möglich. Sie werden dabei auf böswillige Techniken überprüft. Es sind Verlinkungen und die Ausführung fremder Software. Wenn externe Ressourcen (Bilder, Multimedia, fremde Texte und Webseiten) direkt als Inhalte eingebunden würden, könnte es außerdem zu Urheberrechtsverletzungen kommen.

Alle direkten Verwendungen solcher Tags werden vom „Sanitizer“ auf dem Wiki-Server ausgefiltert. [9]

Betroffen sind („ blacklist “):

a applet area audio base body button canvas command embed form frame frameset head html iframe img input isindex layer link map meta object option param script select ( source ) style textarea title track video xml

Übrigens wird auch das URL -Format für Hintergrundbilder[10] im style -Attribut entfernt.

Die derzeitige Strategie ist, auch alle nicht explizit als geeignet bekannten HTML-Elemente auszufiltern. Alternativ würden im Wikitext vorgefundene unverstandene Elemente in den Ausgabetext durchgereicht, sofern sie nicht explizit verboten wären; durch die Vielzahl an Browser-Entwicklungen und neu definierter Tags ist das aber nicht mehr sicher genug.

Damit ist auch Pseudo-HTML wie <Scherz> unmittelbar möglich; zurzeit wird das < nur umgesetzt, wenn darauf ein erkanntes Tag von der Positivliste folgt. Das Escapen des < etwa als &lt; ist zurzeit nicht zwingend erforderlich; es kann aber auch nicht schaden, falls der Wikitext einmal anders interpretiert wird. Das schließende > braucht in diesen Fällen grundsätzlich nicht maskiert zu werden.

Nicht unterstützt

Zu den sicherheitstechnisch unschädlichen und prinzipiell vorstellbaren, aber zurzeit nicht gelisteten Elementen gehören:

acronym address fieldset label noscript rbc

Sie sind weltweit wegen unnötiger Verkomplizierung des Wikitexts unerwünscht. [11] Die Software ignoriert diese genau wie verbotene Elemente.

Anhang: Entities

 Hex- Zeichen Dez-  General-
&#x22; – " – &#34; – &quot;
&#x23; – # – &#35; – &num;
&#x26; – & – &#38; – &amp;
&#x27; – ' – &#39; – &apos;
&#x2A; – * – &#42; – &ast;
&#x3A; – : – &#58; – &colon;
&#x3B; – ; – &#59; – &semi;
&#x3C; – < – &#60; – &lt;
&#x3D; – = – &#61; – &equals;
&#x3E; – > – &#62; – &gt;
&#x5B; – [ – &#91; – &lsqb;
&#x5D; – ] – &#93; – &rsqb;
&#x7B; – { – &#123; – &lcub;
&#x7C; – | – &#124; – &vert;
&#x7D; – } – &#125; – &rcub;
&#x7E; – ~ – &#126; (TILDE)
&#xA7; – § – &#167; – &sect;
Unsichtbare (Whitespace):
&#xA0; –   – &#160; – &nbsp;
&#x20; – – &#32; (SPACE)
&#xAD; – – &#173; – &shy;
&#x2009; – – &#8201; –&thinsp;
&#x200A; – – &#8202; (HAIR SPACE)
&#x202f; – – &#8239; (NARROW NO-BREAK)

Keine HTML-Tags, aber thematisch verwandt sind Zeichen-Entitäten : &...;

Hier gilt für die deutschsprachige Wikipedia, insbesondere den Artikelnamensraum :

  • Das einzige regulär zu verwendende entity ist das geschützte Leerzeichen &nbsp; . Da es die Lesbarkeit des Quelltexts beeinträchtigt, sollte es nur eingesetzt werden, wenn der Nutzen überwiegt, wenn also die durch einen Zeilenwechsel verursachte Beeinträchtigung der Lesbarkeit des angezeigten Texts gravierend wäre. Grundregel ist, dass mindestens eines der verbundenen Textelemente sehr kurz sein muss, also nur wenige Zeichen lang. Werden die fest verbundenen Bestandteile zu lang, entsteht eine hässliche Lücke am rechten Rand.
    Beispiele für die sinnvolle Verwendung:
    • Zahlenangaben mit Einheitensymbol: 120&nbsp;kg
    • zusammengehörende Begriffe: Wilhelm&nbsp;I.
    • Abkürzungen: z.&nbsp;B.
Zwischen einer Ziffer und einem Prozentzeichen sowie innen in Guillemets «…» (französische Ausrichtung) setzt die Wiki-Software seit 2007 [12] automatisch ein geschütztes Leerzeichen.
Innerhalb eines unbetitelten Wikilinks kann das &nbsp; benutzt werden; es wird bei der Bildung der HTML-Verlinkung aufgelöst. [13]
Es ist eine technische Erweiterung in Arbeit, die in den Standardfällen falsche Zeilenumbrüche automatisch verhindern und händisch eingefügte geschützte Leerzeichen überflüssig machen soll.
  • Gelegentlich müssen Zeichen der Wikisyntax in bestimmten Texten oder Syntaxcodes unwirksam gemacht werden; so ist &#93; eine Umgehung, wenn in einer URL keine Klammer ] vorkommen kann und %5D wegen möglichem Unverständnis auf Seiten älterer Webserver nicht sicher funktioniert.
    • &amp; kann erforderlich werden, um ein Entity zu beschreiben.
    • Früher einmal gab es nicht standardisierte, praktisch Wiki-eigene Namen für Entitäten der Wikisyntax: &lsqb; &rsqb; &lcub; &rcub; für [ ] { } – dies wurde nicht mehr unterstützt.
    • Allgemein wird nur eine in HTML.4 (Stand 1998) gültige Definition in ein einzelnes Zeichen umgesetzt; ansonsten die Zeichenkette des Quelltextes angezeigt.
    • Der Name &apos; für den ASCII - Apostroph ' gehört zu XML/ XHTML und wird verstanden.
  • &shy; für einen bedingten Trennstrich ist im Allgemeinen unerwünscht; es verhindert Treffer bei Suchvorgängen und irritiert im Quelltext; nur wenige Autoren sind damit vertraut.
  • Alle anderen Verwendungen sind außerhalb von Vorlagenprogrammierung und dergleichen unerwünscht.
    • Gelegentlich hat man keine andere Möglichkeit, besondere Zeichen über die Tastatur einzugeben. Hier kann man im Bearbeitungsfeld das Zeichen über die Nummer eingeben; anschließend die Vorschau anzeigen, prüfen ob es das richtige Zeichen geworden ist, und durch C&P im Wikitext ersetzen. Bei exotischen Zeichen ist jedoch immer abzuwägen, ob es auch bei allen Anwendern dargestellt werden kann; oder ob alternativ ein gebräuchlicheres Zeichen verwendet werden könnte. Will man einen arabischen Namen zusätzlich in der Originalsprache nennen, ist es in Ordnung, wenn die Zeichen bei einigen Benutzern nicht dargestellt werden können; wer arabisch lesen kann, wird auch geeignete Zeichensätze installiert haben.
    • Einige Benutzer, Skripte und Bots ersetzen gelegentliche Restvorkommen automatisiert.

Benannte Entities werden von der MW-Software [9] automatisch in numerische (dezimale) Entities umgesetzt, so dass der entstehende HTML-Text völlig unabhängig von unzulänglichen Browsern ausgeliefert wird.

Weitere Informationen

Anmerkungen

  1. Einige Benutzer, die HTML5 nicht richtig verstanden haben, behaupten, bei <br /> würde es sich um ungültige oder veraltete Syntax in HTML5 handeln.
    • Das ist schlicht falsch.
    • Siehe HTML5, W3C Recommendation, 14 December 2017 , Abschnitt 8.1.2.1. Start tagsthen there may be a single U+002F SOLIDUS character (/) betreffend void -Elemente.
    Die Autorenschaft der deWP ist seit anderthalb Jahrzehnten an diese Syntax gewohnt und wendet die gleiche Logik auf <references /> an.
    • Mit oder ohne Schrägstrich ist jeweils eine von zwei in HTML gleichberechtigten gültigen Schreibweisen. Nirgendwo ist in HTML vorgeschrieben, dass nunmehr der Schrägstrich nicht mehr erlaubt, veraltet, inkompatibel oder sonstwas wäre, oder dass eine dieser beiden Notationen für HTML zu bevorzugen wäre.
    • Es gibt deshalb keinerlei Anlass, irgendetwas an der den Autoren vertrauten einheitlichen Notation für alle void -Elemente zu verändern.
  2. a b Entsprechende Seiten werden in Kategorie:Wikipedia:Seite mit problematischem HTML-Tag eingeordnet. Es ist zu erwarten, dass zuküftig weitere Restriktionen einen syntaktisch korrekten und damit eindeutigen Wikitext einfordern, namentlich das Schließen aller geöffneten Elemente und eine Warnung bei leeren HTML-Elementen, die weder Inhalte noch Attribute besitzen und deshalb sinnfrei sind.
  3. Bis etwa 2015 wurden nur englischsprachige Buchstaben a–z A–Z sowie Ziffern als Bestandteile eines Wortes erkannt
  4. <gallery showfilename> ist einer der wenigen Ausnahmefälle.
  5. Siehe etwa WP:CSS #lang und Hilfe:Schriftunterstützung .
  6. Dies konnte nicht mehr weiter benutzt werden; die Software HTML Tidy entstand 1998 unter anderen Bedingungen.
  7. Der Name der Vorlage {{ Absatz }} wurde sehr irreführend gewählt; tatsächlich müsste es heißen {{Seitenbreite}} oder {{Layout (volle Breite)}} oder ähnlich. Wobei {{vollbreit}} eher als inhaltlicher Kommentar missinterpretiert werden würde. Genaugenommen bedeutet es: „Textfluss zurücksetzen“ – was erst recht niemand versteht.
  8. phab:T2671 ( Bugzilla:671 #c37 )
  9. a b includes/parser/Sanitizer.php – dies übernimmt auch unerwünschtes CSS sowie die Umwandlung benannter Entities und die Entfernung von Kommentaren.
  10. Wenn man eine URL als background vereinbaren könnte, würde bei jedem Aufruf jeder entsprechenden Seite automatisch eine Anfrage an den externen Server ausgelöst werden, durch die diesem verraten würde, welche Benutzer mit welcher IP und welchem Browser und ggf. welchen Cookies der externen Domain wann welche Wiki-Seite lesen. Die Cookies können zur Zuordnung identischer Browserprofile unter wechselnden IP genutzt werden.
    In einem Wiki ist es eine bewusste Entscheidung des Lesers, ein externes Link anzuklicken; automatischer Serverkontakt erfolgt nur innerhalb der WMF oder durch selbst veranlasste Konfiguration.
    Aus dem gleichen Grund werden Bilder nur von Servern der WMF in der Seite dargestellt.
  11. phab:T2671 ( Bugzilla:671 ) , phab:T25932
  12. Projektneuheiten 2007
  13. Durch einen seit 2005 bestehenden Software-Fehler ( phab:T4700 ( Bugzilla:2700 ) ) geschieht das nicht innerhalb von Tag-Extensionen, also etwa durch < ref > eingeschlossen.