W3C home > Mailing lists > Public > www-i18n-comments@w3.org > March 2014

Re: Updated article: Declaring character encodings in HTML

From: Richard Ishida <ishida@w3.org>
Date: Mon, 24 Mar 2014 17:59:10 +0000
Message-ID: <5330726E.7080900@w3.org>
To: Gunnar Bittersmann <gunnar@bittersmann.de>
CC: www-i18n-comments@w3.org


On 19/03/2014 11:33, Gunnar Bittersmann wrote:
>
>> Latest versions attached.
>
> Latest comments: ;-)
>
> »»
> <h2 id="question"><a href="#question">Question</a></h2>
> ««
> »»
> <h2 id="answer"><a href="#answer">Answer</a></h2>
> ««
> »»
> <h2 id="detail"><a href="#detail">Details</a></h2>
> ««
> »»
> <h2 id="obscure"><a href="#obscure">Additional information</a></h2>
> ««
>
> Wouldn’t it be better to use the boilerplate for that, as before?

I'm torn: I find it easier to read the content while creating if I don't 
use the PHP, although I see the potential benefit for consistency (which 
is why I did that originally).  I've also been waiting to see whether 
those titles really work.  I'm going to leave as is for a little longer, 
at least.


>
> Not only would it make the original articles use the same headings, it
> would make localization easier and more consistent over various
> articles, especially when translated by different translators.
>
>
> There’s a bigger block of commented-out text in lines 202 to 236 that
> should be deleted from the HTML source.
>
> Hint: Use PHP comments <?php /* … */ ?> instead of HTML comments <!-- …
> --> for cases when you want to temporarily remove text from the article
> but keep it in the source file. Then the block won’t be in the generated
> HTML that will be served over the Web.

Fair point. Done.


>
> Minor things:
>
> »»
> <div class="sideinfonote">
> ««
>
> As in other places and in other articles, use the aside element (also in
> closing tag):
>
> <aside class="sideinfonote">

Done.

> »»
>      <p><b class="leadin">XHTML 1.x served as XML:</b> Use the <span
> class="kw">encoding</span> declaration
> ««
>
> Use <code class="kw">encoding</code>:
>
>      <p><b class="leadin">XHTML 1.x served as XML:</b> Use the <code
> class="kw">encoding</code> declaration

Done.

> »»
>    <p>HTML5 deprecated the use of the <code class="kw">charset</code>
> attribute on an <span class="kw">a</span> or <span
> class="kw">link</span> element, so you should avoid using it. It
> originated in the HTML&nbsp;4.01 specification for use with the <span
> class="kw">a</span>, <span class="kw">link</span> and <span
> class="kw">script</span> elements and was supposed to indicate the
> encoding of the document you are linking to. </p>
> ««
>
> Use code elements for all element type names:
>
>    <p>HTML5 deprecated the use of the <code class="kw">charset</code>
> attribute on an <code class="kw">a</code> or <code
> class="kw">link</code> element, so you should avoid using it. It
> originated in the HTML&nbsp;4.01 specification for use with the <code
> class="kw">a</code>, <code class="kw">link</code> and <code
> class="kw">script</code> elements and was supposed to indicate the
> encoding of the document you are linking to. </p>

Done.
RI
Received on Monday, 24 March 2014 17:59:39 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:20:17 UTC