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

Re: Formatting of html tags

From: Pearl Chen <pearlchen@google.com>
Date: Thu, 17 Jul 2014 14:36:33 -0400
Message-ID: <CAMzQgwA-4PUutc29gq-qXQZe1EvYEkxVhyyO4zCnE7FHehitGg@mail.gmail.com>
To: PhistucK <phistuck@gmail.com>
Cc: Julee Burdekin <julee@adobe.com>, "public-webplatform@w3.org" <public-webplatform@w3.org>
I will also add that I was trying to update "Step 5: Update existing
content" with some more examples but "Show Preview" actually cannot render
this line properly:

for inline terms use the <code>&lt;code&gt;</code> tag


It turns the rest of the page into an unclosed code block. Seems like other
html tags will causes issues too. I'll file a bug.

Pearl



On Thu, Jul 17, 2014 at 2:25 PM, Pearl Chen <pearlchen@google.com> wrote:

> Oh, I see why I missed that detail. The CSS style of <code> blocks set the
> font weight to bold. Thanks Julee.
>
> PhistucK, I think that if you're copying and pasting, there's lots of
> opportunities for formatting to get lost, including brackets, bold, and
> italics. Most of it seems out of our control.
>
>
>
>
> On Thu, Jul 17, 2014 at 2:07 PM, PhistucK <phistuck@gmail.com> wrote:
>
>> Just checking - did you read my concern regarding copying and pasting
>> text?
>>
>>
>> ☆*PhistucK*
>>
>>
>> On Thu, Jul 17, 2014 at 9:06 PM, Julee Burdekin <julee@adobe.com> wrote:
>>
>>>  Oh! Thanks, PhistucK! I prefer: Since this block element can only
>>> contains inline element, such as <code><span></code>
>>>
>>>  And looks like that’s what’s used in the code style guide.[1]
>>>
>>>  J
>>>
>>>  [1]
>>> http://docs.webplatform.org/wiki/WPD:Manual_Of_Style/Code_sample_best_practices
>>>
>>>  -------------------
>>> Julee Burdekin
>>> Content Strategist
>>> Adobe Web Platform
>>> @adobejulee
>>> julee@adobe.com
>>>
>>>   From: PhistucK <phistuck@gmail.com>
>>> Date: Thursday, July 17, 2014 at 10:55 AM
>>> To: julee <julee@adobe.com>
>>> Cc: Pearl Chen <pearlchen@google.com>, WebPlatform Public List <
>>> public-webplatform@w3.org>
>>> Subject: Re: Formatting of html tags
>>>
>>>   I think Pearl refers to situations such as (for example) "Since this
>>> is a block element can only contains inline element, such as <span>" and
>>> not necessarily code examples with syntax highlighting.
>>>
>>>
>>>  ☆*PhistucK*
>>>
>>>
>>> On Thu, Jul 17, 2014 at 8:52 PM, Julee Burdekin <julee@adobe.com> wrote:
>>>
>>>>  Hi, Pearl:
>>>>
>>>>  Thinking you’re talking about referring to content inline, and not
>>>> providing an example. You might want to review the guide on how to update
>>>> existing content[1] — there’s a syntax highlighting section. Also, refer to
>>>> the gotchas page for additional quirks of the system.[2]
>>>>
>>>>  HTH
>>>>
>>>>  J
>>>> [1]
>>>> http://docs.webplatform.org/wiki/WPD:Editors_Guide/step_5_update_existing_content
>>>>  [2] http://docs.webplatform.org/wiki/WPD:Style_Guide/Gotchas
>>>>  -------------------
>>>> Julee Burdekin
>>>> Content Strategist
>>>> Adobe Web Platform
>>>> @adobejulee
>>>> julee@adobe.com
>>>>
>>>>   From: Pearl Chen <pearlchen@google.com>
>>>> Date: Thursday, July 17, 2014 at 10:38 AM
>>>> To: WebPlatform Public List <public-webplatform@w3.org>
>>>> Subject: Formatting of html tags
>>>> Resent-From: WebPlatform Public List <public-webplatform@w3.org>
>>>> Resent-Date: Thursday, July 17, 2014 at 10:39 AM
>>>>
>>>>   I'm trying to figure out of there is a preferred way to display html
>>>> tags in text. I've seen it in various formats within the WPD docs, with and
>>>> without brackets, with and without bold:
>>>>
>>>>  - html element
>>>> - *html* element
>>>> - <html> element
>>>> - *<html>* element
>>>>
>>>>  My gut tells me to use "<html>", no bold unless there's an actual
>>>> emphasis needed.
>>>>
>>>>  Pearl
>>>>
>>>
>>>
>>
>
Received on Thursday, 17 July 2014 18:37:40 UTC

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