Vorlage:Strong/Doku
Dies ist eine nachgeordnete Seite der Dokumentation von Vorlage:Strong. Sie enthält Informationen zur Verwendung, Kategorisierung und zu anderem Inhalt, der nicht Bestandteil der originalen Vorlage-Seite ist. |
Funktion
[Bearbeiten]Diese Vorlage bietet die Möglichkeit, Textpassagen besonders stark zu betonen und diese Information für externe Programme (Vorlesefunktion, Robots usw.) verfügbar zu machen.Dabei wird aucf das [X]HTML's-Tag <strong>...</strong>
zurückgegriffen welches für die starke Betonung (englisch: strong emphasis) von Text zuständig ist. Das gängige Wiki-Markup zu Fettschreibung ist für diesen Zweck ungeeignet. Solch starke Hervorhebungen werden in grafischen Browsern in der Regel in einer fetten (bold) Schriftart dargestellt, können aber mit Style Sheets, Anwendungen und Text-to-Speech-Screenreadern auf anpassbare Weise geparst und verarbeitet werden. Es handelt sich um semantisches Markup, d. h. Markup, das Bedeutung oder Kontext vermittelt, nicht nur visuelles Aussehen. Einfache Fettschreibung ist rein typografisch und semantisch bedeutungslos. Sie wird am häufigsten für Titel von Veröffentlichungen (Bücher, Filme, Alben usw.), Fremdwörter und -sätze) und andere Fälle verwendet, in denen stilistische Konventionen Fettschrift verlangen, diese aber keine Betonung vermittelt.
Verwendung
[Bearbeiten]{{strong|stark hervorzuhebender Text}}
oder, wenn der hervorzuhebende Text ein Gleichheitszeichen enthält:
{{strong|1=stark hervorzuhebender Text}}
Diese werden beide folgendermaßen ausgegeben:
- stark hervorzuhebender Text
Diese Vorlage setzt absichtlich und ausdrücklich das <strong>...</strong>
(starke Hervorhenbung) [X]HTML-Tag um den als ersten Parameter angegebenen Text. Am sichersten ist es, immer die Syntax |1=
zu verwenden.
Optionale Parameter
[Bearbeiten]Erweiterte HTML-Werte können über die Vorlage an den HTML-Code übergeben werden:
|class=
fügt einen Klassennamen (oder mehrere Klassennamen, getrennt durch Leerzeichen); fügtclass="classname[s]"
im HTML-Code ein|title=
nimmt Text, der nicht in irgendeiner Weise gekennzeichnet werden kann, und zeigt ihn als Pop-up-Tooltip (in den meisten Browsern) an, wenn der Mauszeiger über den Bereich bewegt wird
Anwendungsfälle
[Bearbeiten]Diese Vorlage dient dazu, in wichtiges Wort oder einen wichtigen Satz in einer Passage auf eine Weise zu stark zu betonen, und die (im Gegensatz zur einfachen Fettschreibung) semantisch korrektes MArkup erzeugt.. Mit dieser Technik hebt sich der hervorgehobene Text in den meisten, wenn nicht sogar in allen visuellen Browsern und einigen Text-to-Speech-Screenreadern (die in der Regel die rein typografische Fettschreibung ignorieren) vom übrigen Text ab, ohne die Lesbarkeit stark zu beeinträchtigen. Außerdem kann sie von User-Agents und anderer Software als eindeutiger Hinweis auf eine Betonung und nicht nur auf einen typografischen Fettdruckeffekt um des Aussehens willen interpretiert werden. Es sollte daher in Artikeln nur sparsam verwendet werden, um etwas zu betonen (z. B. um eine starke stimmliche Betonung darzustellen). Beispiele:
- In der Einleitung eines Artikels werden der Titel des Artikels und seine Synonyme sollten mit
{{strong}}
hervorgehoben werden. Beispiel: "Osttimor (offiziell Timor-Leste) ist der jüngste Staat Südostasiens.". - Nach der Einleitung can kannes benutzt werden, um wirklich entscheidende Stichworte hervorzuheben.
- Außerhalb von Artikeln sollte es in Diskussionen und Abstimmungen benutzt werden, um Zustimmung oder Ablehnung zu signalisieren.
Keine Anwendungsfälle
[Bearbeiten]Da {{strong}}
ausschließlich der semantischen (sinnvollen) Hervorhebung dient, sollte es nicht für Layout, typografische Konventionen und dergleichen verwendet werden. In diesen verschiedenen Fällen sollte fett '''...'''
(das im Browser oder einem anderen User-Agent zu <b>...</b>
aufgelöst wird) stattdessen verwendet werden. Es sollte auch nicht verwendet werden, wenn der Text, auf den es angewendet wird, bereits aus einem anderen Grund fett gedruckt ist (z. B. als Teil einer Überschrift); in solchen Fällen sollte stattdessen {{em}}
verwendet werden. Vermeide die Verwendung von {{strong}}
in nicht zitierten Sätzen, die mit einem Ausrufezeichen enden. Außerdem ist es in der Regel übertrieben, es bei Begriffen zu verwenden, die bereits mit einem Wikilink versehen sind, da die Linkauszeichnung selbst als eine Form der Hervorhebung fungiert.
Siehe auch
[Bearbeiten]Projektseiten
[Bearbeiten]- Fett- und Kursivdruck – Anwendung des Fett- und Kursivdrucks in Artikeln – eine Anleitung.
Hilfeseiten
[Bearbeiten]- Textgestaltung – Eine Anleitung, wie man Teile von Artikeln mit Mitteln der Wikisoftware und ihres Markups formatiert.
Vorlagen
[Bearbeiten]Die semantischen Vorlagen dienen der Kennzeichnung von Text. Der Text wird in spezielle HTML-Tags eingebettet, die die Bedeutung des Inhalts kennzeichnen. Browser, Robots und Werkzeuge für Barrierefreiheit können entsprechend darauf reagieren. Folgende semantische Vorlagen können in Wikivoyage-Artikeln eingesetzt werden:
- {{em}} – Die Vorlage kennzeichnet Text, der besonders betont werden soll. Browser stellen ihn im Regelfall kursiv dar.
- {{strong}} – Dient der starken Hervorhebung von Wörtern und Passagen. Die Darstellung erfolgt standardmäßig in Fettschrift.
In Artikeln außerhalb des Haupt- und Nachrichtennamensraums (Diskusssionen, Projekt- und Hilfeseiten) können weitere Vorlagen Anwendung finden:
- {{strongbad}} – Wie
{{strong}}
aber rot wie in dem Beispiel: „Benutze{{strongbad}}
niemals in Artikeln.“ - {{stronggood}} – Wie
{{strongbad}}
aber grün wie in dem Beispiel: „Benutze{{stronggood}}
nur außerhalb des Artikelnamensraums.“ - {{var}} – Zusammen mit {{varserif}} dient die Vorlage der Kennzeichnung und Visualisierung von Variablen bzw. Platzhaltern in Dokumentationen und Hilfetexten.
Die folgenden Vorlagen stellen lediglich eine Formatierungshilfe dar, erzeugen aber keine speziellen [X]HTML-Tags, um Inhalte maschinenlesbar eine Bedeutung zu geben.
- {{wikivar}} – Stellt Text als Magisches Wort dar und erleichtert damit die Dokumentation und Erstellung von Hilfeseiten. Beispiele:
{{PAGENAME}}
,{{DEFAULTSORT:Lastname, Firstname}}
. - {{para}} – Dient der Ausgabe von Vorlagenparametern (
|title=
) oder Parametern mit Werten (|year=2008
). - {{tlx}} and related – For displaying entire templates (with or without parameters and values) as code.
- {{tag}} – For using HTML elements ("tags") in prose (e.g. "When coding HTML
<img>...</img>
tags, always include …"). - {{code}} – For computer source code (e.g. "always include the
alt=
parameter"). (Note: to nest other templates like{{var}}
inside, use<code>...</code>
instead of{{code}}
.) - {{syntaxhighlight}} or {{sxhl}} – Wrapper for
<syntaxhighlight>...</syntaxhighlight>
, but will wrap overflowing text. - {{pre}} – For larger blocks of source code and other pre-formatted text.
- {{pre2}}, a template with similar functionality but induces optional line wrap and optional scroll bars.
- {{bq}} – For indented blocks of content, such as block quotations, examples, poems, etc.
- {{kbd}} – For indicating user input.
- {{key press}} – For indicating the input of specific keystrokes, e.g. ⎈ CtrlX.
- {{samp}} – For example output.
<syntaxhighlight>