Skip to content

Commit

Permalink
questions/qa-b-and-i-tags, update links to HTML
Browse files Browse the repository at this point in the history 
Fix #242.
  • Loading branch information
@xfq
xfq committed Mar 23, 2020
1 parent 16856df commit 6891fa7
Show file tree
Hide file tree
Showing 3 changed files with 15 additions and 15 deletions.
10 changes: 5 additions & 5 deletions questions/qa-b-and-i-tags-TEST.en.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -78,11 +78,11 @@ <h2 id="detail"><a href="#detail">Details</a></h2>

<section>
<h3 id="whatfor"><a href="#whatfor">What they're for</a></h3>
<p>The <a class="print" href=" https://www.w3.org/TR/html5/text-level-semantics.html#the-i-element ">HTML5 specification redefines</a> the intended use of these elements as follows.</p>
<blockquote class="print" cite="https://www.w3.org/TR/html5/text-level-semantics.html#the-i-element">
<p>The <a class="print" href=" https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-i-element ">HTML5 specification redefines</a> the intended use of these elements as follows.</p>
<blockquote class="print" cite="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-i-element">
<p><q>The <code class="kw" translate="no">i</code> element represents a span of text in an alternate voice or mood, or otherwise offset from the normal prose in a manner indicating a different quality of text, such as a taxonomic designation, a technical term, an idiomatic phrase from another language, transliteration, a thought, or a ship name in Western texts.</q></p>
</blockquote>
<blockquote class="print" cite="https://www.w3.org/TR/html5/text-level-semantics.html#the-b-element">
<blockquote class="print" cite="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-b-element">
<p><q>The <code class="kw" translate="no">b</code> element represents a span of text to which attention is being drawn for utilitarian purposes without conveying any extra importance and with no implication of an alternate voice or mood, such as key words in a document abstract, product names in a review, actionable words in interactive text-driven software, or an article lede.</q></p>
</blockquote>
</section>
Expand All @@ -107,7 +107,7 @@ <h3 id="issues"><a href="#issues">What issues are there?</a></h3>
<section>
<h3 id="recommendations"><a href="#recommendations">Recommended usage</a></h3>
<p>The HTML5 specification has the following recommendations with regards to the use of the <code class="kw" translate="no">i</code> element (highlighting added):</p>
<blockquote class="print" cite="https://www.w3.org/TR/html5/text-level-semantics.html#the-i-element">
<blockquote class="print" cite="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-i-element">
<p><q>Authors can
<mark>use the <code class="kw" translate="no">class</code> attribute</mark>
on the <code class="kw" translate="no">i</code> element to identify why the element is being used, so that if the style of a particular use (e.g. dream sequences as opposed to taxonomic terms) is to be changed at a later date, the author doesn't have to go through the entire document (or series of related documents) annotating each use.</q></p>
Expand All @@ -116,7 +116,7 @@ <h3 id="recommendations"><a href="#recommendations">Recommended usage</a></h3>
than the <code class="kw" translate="no">i</code> element, for instance the <code class="kw" translate="no">em</code> element for marking up stress emphasis, or the <code class="kw" translate="no">dfn</code> element to mark up the defining instance of a term.</q></p>
</blockquote>
<p>Similar wording appears in the description of the <code class="kw" translate="no">b</code> element, including the sentence: <q>The <code class="kw" translate="no">b</code> element should be used as a last resort when no other element is more appropriate.</q></p>
<p>In the HTML5 specification <a class="print" href="https://www.w3.org/TR/html5/text-level-semantics"><cite>4.5 Text-level semantics</cite></a> lists other elements that can be used to describe inline text semantically, such as <code class="kw" translate="no">dfn</code>, <code class="kw" translate="no">cite</code>, <code class="kw" translate="no">var</code>, <code class="kw" translate="no">samp</code>, <code class="kw" translate="no">kbd</code>, etc.</p>
<p>In the HTML5 specification <a class="print" href="https://html.spec.whatwg.org/multipage/text-level-semantics.html#text-level-semantics"><cite>4.5 Text-level semantics</cite></a> lists other elements that can be used to describe inline text semantically, such as <code class="kw" translate="no">dfn</code>, <code class="kw" translate="no">cite</code>, <code class="kw" translate="no">var</code>, <code class="kw" translate="no">samp</code>, <code class="kw" translate="no">kbd</code>, etc.</p>
<p>It may help to think of <code class="kw" translate="no">b</code> or <code class="kw" translate="no">i</code> elements as essentially a <code class="kw" translate="no">span</code> element with an automatic fallback styling. Just like a <code class="kw" translate="no">span</code> element, these elements usually benefit from class names if they are to be useful.</p>
</section>
</section>
Expand Down
10 changes: 5 additions & 5 deletions questions/qa-b-and-i-tags.de.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -78,14 +78,14 @@ <h2 id="detail"><a href="#detail">Details</a></h2>

<section>
<h3 id="whatfor"><a href="#whatfor">Wofür b und i zu verwenden sind</a></h3>
<p>Die <a class="print" href=" http://www.w3.org/TR/html5/text-level-semantics.html#the-i-element ">HTML5-Spezifikation definiert</a> die beabsichtigte Verwendung dieser Elemente folgendermaßen neu:</p>
<p>Die <a class="print" href="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-i-element">HTML5-Spezifikation definiert</a> die beabsichtigte Verwendung dieser Elemente folgendermaßen neu:</p>
<div class="sidenoteGroup">
<blockquote class="print" cite="http://www.w3.org/TR/html5/text-level-semantics.html#the-i-element">
<blockquote class="print" cite="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-i-element">
<p><q>Das <code class="kw" translate="no">i</code>-Element repräsentiert einen Textabschnitt in einer anderen Artikulierung oder Stimmung oder anderen Abweichung vom restlichen Text, die auf eine andersartige Qualität des Texts hindeutet; bspw. eine taxonomische Kennzeichnung, einen Fachbegriff, einen Begriff oder eine Redewendung aus einer anderen Sprache, eine Transliteration, einen Gedanken oder den Namen eines Schiffes in westlichen Texten.</q></p>
</blockquote>
<div class="sideinfonote"><p class="info">Anmerkung des Übersetzers: Im Englischen ist es üblich, Begriffe und Redewendungen aus einer anderen Sprache und Namen von Schiffen kursiv zu setzen.</p></div>
</div>
<blockquote class="print" cite="http://www.w3.org/TR/html5/text-level-semantics.html#the-b-element">
<blockquote class="print" cite="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-b-element">
<p><q>Das <code class="kw" translate="no">b</code>-Element repräsentiert einen Textabschnitt, dem aus praktischen Erwägungen Aufmerksamkeit zuteil wird, ohne dass ihm eine besondere Bedeutung oder eine andere Artikulierung oder Stimmung verliehen wird; bspw. ein Schlüsselwort in einer Zusammenfassung, einen Produktnamen in einer Bewertung, einen Begriff für eine Nutzeraktion in einer interaktiven textbasierten Software oder den ersten Absatz (Vorspann, Leitsatz) eines Artikels.</q></p>
</blockquote>
</section>
Expand All @@ -110,7 +110,7 @@ <h3 id="issues"><a href="#issues">Was gibt es zu beachten?</a></h3>
<section>
<h3 id="recommendations"><a href="#recommendations">Empfohlene Verwendung</a></h3>
<p>Die HTML5-Spezifikation gibt zur Verwendung von <code class="kw" translate="no">i</code>-Elementen folgende Empfehlung (Hervorhebung hinzugefügt):</p>
<blockquote class="print" cite="http://www.w3.org/TR/html5/text-level-semantics.html#the-i-element">
<blockquote class="print" cite="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-i-element">
<p><q>Seitenautoren können bei <code class="kw" translate="no">i</code>-Elementen
<mark><code class="kw" translate="no">class</code>-Attribute setzen</mark>
um zu verdeutlichen, warum das Element verwendet wurde. Wenn der Stil einer bestimmten Verwendung (z.B. eines Traums) später geändert werden soll, der Stil einer anderen Verwendung (z.B. einer taxonomischen Kennzeichnung) hingegen nicht, dann muss der Autor nicht das ganze Dokument (oder eine Reihe von Dokumenten) durchgehen und jede diese Verwendung erläutern.</q></p>
Expand All @@ -119,7 +119,7 @@ <h3 id="recommendations"><a href="#recommendations">Empfohlene Verwendung</a></h
als das <code class="kw" translate="no">i</code>-Element, z.B. das <code class="kw" translate="no">em</code>-Element, um starke Betonung auszudrücken, oder das <code class="kw" translate="no">dfn</code>-Element, um eine Definition eines Begriffes auszuzeichnen.</q></p>
</blockquote>
<p>Entsprechende Formulierungen finden sich auch in der Beschreibung des <code class="kw" translate="no">b</code>-Elements, wie der Satz: <q>Das <code class="kw" translate="no">b</code>-Element sollte als letzter Ausweg verwendet werden, wenn kein anderes Element passender ist.</q></p>
<p>In der HTML5-Spezifikation werden in Kapitel <a class="print" href="http://www.w3.org/TR/html5/text-level-semantics"><cite lang="en">4.5 Text-level semantics</cite></a> andere Elemente zur semantischen Beschreibung von Text aufgeführt: <code class="kw" translate="no">dfn</code>, <code class="kw" translate="no">cite</code>, <code class="kw" translate="no">var</code>, <code class="kw" translate="no">samp</code>, <code class="kw" translate="no">kbd</code> u.a.</p>
<p>In der HTML5-Spezifikation werden in Kapitel <a class="print" href="https://html.spec.whatwg.org/multipage/text-level-semantics.html#text-level-semantics"><cite lang="en">4.5 Text-level semantics</cite></a> andere Elemente zur semantischen Beschreibung von Text aufgeführt: <code class="kw" translate="no">dfn</code>, <code class="kw" translate="no">cite</code>, <code class="kw" translate="no">var</code>, <code class="kw" translate="no">samp</code>, <code class="kw" translate="no">kbd</code> u.a.</p>
<p>Man kann <code class="kw" translate="no">b</code>- und <code class="kw" translate="no">i</code>-Elemente im Wesentlichen als <code class="kw" translate="no">span</code>-Elemente mit automatischer Fallback-Darstellung ansehen. Ebenso wie <code class="kw" translate="no">span</code>-Elemente profitieren auch diese Elemente von Klassennamen, um Nutzen zu bringen.</p>
</section>
</section>
Expand Down
10 changes: 5 additions & 5 deletions questions/qa-b-and-i-tags.en.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -78,11 +78,11 @@ <h2 id="detail"><a href="#detail">Details</a></h2>

<section>
<h3 id="whatfor"><a href="#whatfor">What they're for</a></h3>
<p>The <a class="print" href=" https://www.w3.org/TR/html5/text-level-semantics.html#the-i-element ">HTML5 specification redefines</a> the intended use of these elements as follows.</p>
<blockquote class="print" cite="https://www.w3.org/TR/html5/text-level-semantics.html#the-i-element">
<p>The <a class="print" href="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-i-element">HTML5 specification redefines</a> the intended use of these elements as follows.</p>
<blockquote class="print" cite="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-i-element">
<p><q>The <code class="kw" translate="no">i</code> element represents a span of text in an alternate voice or mood, or otherwise offset from the normal prose in a manner indicating a different quality of text, such as a taxonomic designation, a technical term, an idiomatic phrase from another language, transliteration, a thought, or a ship name in Western texts.</q></p>
</blockquote>
<blockquote class="print" cite="https://www.w3.org/TR/html5/text-level-semantics.html#the-b-element">
<blockquote class="print" cite="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-b-element">
<p><q>The <code class="kw" translate="no">b</code> element represents a span of text to which attention is being drawn for utilitarian purposes without conveying any extra importance and with no implication of an alternate voice or mood, such as key words in a document abstract, product names in a review, actionable words in interactive text-driven software, or an article lede.</q></p>
</blockquote>
</section>
Expand All @@ -107,7 +107,7 @@ <h3 id="issues"><a href="#issues">What issues are there?</a></h3>
<section>
<h3 id="recommendations"><a href="#recommendations">Recommended usage</a></h3>
<p>The HTML5 specification has the following recommendations with regards to the use of the <code class="kw" translate="no">i</code> element (highlighting added):</p>
<blockquote class="print" cite="https://www.w3.org/TR/html5/text-level-semantics.html#the-i-element">
<blockquote class="print" cite="https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-i-element">
<p><q>Authors can
<mark>use the <code class="kw" translate="no">class</code> attribute</mark>
on the <code class="kw" translate="no">i</code> element to identify why the element is being used, so that if the style of a particular use (e.g. dream sequences as opposed to taxonomic terms) is to be changed at a later date, the author doesn't have to go through the entire document (or series of related documents) annotating each use.</q></p>
Expand All @@ -116,7 +116,7 @@ <h3 id="recommendations"><a href="#recommendations">Recommended usage</a></h3>
than the <code class="kw" translate="no">i</code> element, for instance the <code class="kw" translate="no">em</code> element for marking up stress emphasis, or the <code class="kw" translate="no">dfn</code> element to mark up the defining instance of a term.</q></p>
</blockquote>
<p>Similar wording appears in the description of the <code class="kw" translate="no">b</code> element, including the sentence: <q>The <code class="kw" translate="no">b</code> element should be used as a last resort when no other element is more appropriate.</q></p>
<p>In the HTML5 specification <a class="print" href="https://www.w3.org/TR/html5/text-level-semantics"><cite>4.5 Text-level semantics</cite></a> lists other elements that can be used to describe inline text semantically, such as <code class="kw" translate="no">dfn</code>, <code class="kw" translate="no">cite</code>, <code class="kw" translate="no">var</code>, <code class="kw" translate="no">samp</code>, <code class="kw" translate="no">kbd</code>, etc.</p>
<p>In the HTML5 specification <a class="print" href="https://html.spec.whatwg.org/multipage/text-level-semantics.html#text-level-semantics"><cite>4.5 Text-level semantics</cite></a> lists other elements that can be used to describe inline text semantically, such as <code class="kw" translate="no">dfn</code>, <code class="kw" translate="no">cite</code>, <code class="kw" translate="no">var</code>, <code class="kw" translate="no">samp</code>, <code class="kw" translate="no">kbd</code>, etc.</p>
<p>It may help to think of <code class="kw" translate="no">b</code> or <code class="kw" translate="no">i</code> elements as essentially a <code class="kw" translate="no">span</code> element with an automatic fallback styling. Just like a <code class="kw" translate="no">span</code> element, these elements usually benefit from class names if they are to be useful.</p>
</section>
</section>
Expand Down

0 comments on commit 6891fa7

Please sign in to comment.