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

Re: Formatting of html tags

From: PhistucK <phistuck@gmail.com>
Date: Fri, 18 Jul 2014 19:23:22 +0300
Message-ID: <CABc02_+4kWw3Vy5wW5h5FL3fM0hLVWnTc81KSRnP4ZBhoAZRng@mail.gmail.com>
To: Pearl Chen <pearlchen@google.com>
Cc: Renoir Boulanger <renoir@w3.org>, "public-webplatform@w3.org" <public-webplatform@w3.org>
Your example is unrelated...
My suggestion was only referring to the element name mention situation.
Inline code is unrelated here and of course should have actual angle
brackets.


☆*PhistucK*


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

> 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:24:29 UTC

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