W3C home > Mailing lists > Public > public-webplatform@w3.org > July 2014

Re: Formatting of html tags

From: Pearl Chen <pearlchen@google.com>
Date: Fri, 18 Jul 2014 12:18:06 -0400
Message-ID: <CAMzQgwBD7hagtJkxjVb6XNoVM2AKpkdjYhE3d+kN1mtU4iJg4Q@mail.gmail.com>
To: Renoir Boulanger <renoir@w3.org>, "public-webplatform@w3.org" <public-webplatform@w3.org>
Regarding copy and paste of the angled brackets, I would want the brackets
copied too, especially if the inline code represented something more than
just the tag name. Example:

Display: "An element can be styled using using the *style* attribute
(e.g. *<div
style="padding: 1em;"></div>*) or via CSS selectors."

Wiki input:  "An element can be styled using using the <code>style</code>
attribute (e.g. <code>&lt;div style="padding: 1em;"&gt;&lt;/div&lt;</code>)
or via CSS selectors."

A blanket statement saying that all inline code should be wrapped in
<code></code> seems sufficient to me.

A contributor really shouldn't have to think so hard, or know so many rules
about their writing situation, in order to contribute.





On Fri, Jul 18, 2014 at 12:00 PM, Pearl Chen <pearlchen@google.com> wrote:

> I've never used <tt> before and when I looked it up, MDN says
> <https://developer.mozilla.org/en-US/docs/Web/HTML/Element/tt> <tt> is
> obsolete and shouldn't be used anymore.
>
> For most developers and content writers, <code> would be more apparent,
> imo.
>
>
>
>
>
>
> On Fri, Jul 18, 2014 at 11:51 AM, Renoir Boulanger <renoir@w3.org> wrote:
>
>> hi all,
>>
>> Personally, what I do is one of three things:
>>
>>
>> 1. Inline mention
>>
>> When I have to use a tag name in full, I use <tt>&lt;tag-name&gt;</tt>.
>> Not pretty, but not too long to write.
>>
>>
>> 2. In page code sample
>>
>> I use the <syntaxHighlight> extension which takes care of hilighting [0]
>>
>> <syntaxHighlight lang="html5">
>>   <!DOCTYPE html>
>>   ...
>> <syntaxHighlight>
>>
>> The syntaxHighlight escapes for us the tags, supports html and all that
>> jazz.
>>
>> And, it works pretty well [1]
>>
>>
>> 3. Create a code sample in Dabblet
>>
>> see code.webplatform.org
>>
>>
>>   [0]:
>>
>> http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi#Supported_languages
>>   [1]:
>>
>> http://docs.webplatform.org/w/index.php?title=Beginners/html&action=formedit
>>
>> --
>> Regards,
>>
>> Renoir Boulanger  |  Developer operations engineer
>> W3C  |  Web Platform Project
>>
>> http://w3.org/people/#renoirbhttps://renoirboulanger.com/  ✪
>>  @renoirb
>> ~
>>
>>
>>
>
Received on Friday, 18 July 2014 16:19:14 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:21:02 UTC