W3C home > Mailing lists > Public > public-vocabs@w3.org > March 2014

Re: Marking up quotes that relate to known Freebase topics/people

From: Matthias Tylkowski <matthias@binarypark.org>
Date: Thu, 06 Mar 2014 11:14:10 +0100
Message-ID: <53184A72.7000402@binarypark.org>
To: Quotations Book <quotationsbook@gmail.com>
CC: public-vocabs@w3.org
Hello Amit,
I put my comments in your HTML example below. I hope they are helpful.

Regards
Matthias Tylkowski

Am 06.03.2014 01:53, schrieb Quotations Book:
> Hi Matthias,
>
> Thanks for your note. In terms of an actual example, this is what I 
> have right now - after factoring in the aspects you pointed out below. 
> Is there anything missing/wrong from this example of a single quote, 
> containing tag and author?
>
> ===============
>
> <div itemscope="" itemtype="http://schema.org/Quotation" 
> class="quote-wrap">

Currently there is no Quotation type defined in Schema.org. Using the 
Extension Mechanism <http://schema.org/docs/extension.html> you may use 
"http://schema.org/CreativeWork/Quotation" to define you own type.

>      <div class="quote">
> <div data-quote="5596" class="quote_text" style="cursor:auto;">
> <dt>
> <div itemprop="description">Seek not to change the world, but choose 
> to change your mind about the world.</div>
> </dt>
> </div>
>

<dt> <http://www.w3.org/TR/html-markup/dt.html#dt> and <dd> 
<http://www.w3.org/TR/html-markup/dd.html#dd> elements should be placed 
inside a <dl> <http://www.w3.org/TR/html-markup/dl.html#dl> element. The 
browser can interpret it, but it is not correct HTML. I would use 
<blockquote> <http://html5doctor.com/cite-and-blockquote-reloaded/> 
instead of the *<dt>*. This element itself has already a semantical 
meaning of what you show there. You may drop the *<dd> *completely as it 
does not have any meaning.

>      <ul class="quote-author">
> <li>
> <dd>
>                 <span itemprop="author" itemscope="" 
> itemtype="http://schema.org/Person" 
> itemid="http://quotationsbook.com/quotes/author/1/all/">
>                <a itemprop="name" 
> href="http://quotationsbook.com/quotes/author/1/all/" 
> data-toggle="tooltip" title="Quotes by A Course In Miracles" 
> data-placement="bottom">A Course In Miracles</a>
>                 <link itemprop="url" 
> content="http://www.freebase.com//m/02vp3k">

The *<link>* element does not have a *content* attribute. Either use:
<*meta* itemprop="*sameAs*" content="http://www.freebase.com//m/02vp3k">
or:
<link itemprop="*sameAs*"*href*="http://www.freebase.com//m/02vp3k">

<link> is propably better as the elements meaning itself is related to 
URLs. Also I would use "*sameAs*" instead of "url" because you are 
talking about the *same thing* which is also located on freebase.

>                  </span>
>                 </dd>
> </li>
> <li><em>on</em></li>
> <li>
> <span itemprop="about" itemscope="" itemtype="http://schema.org/Thing" 
> itemid="http://quotationsbook.com/quotes/tag/change/all/">
> <a href="http://quotationsbook.com/quotes/tag/change/all/" 
> title="Quotes about change" itemprop="name">change</a>
> <link itemprop="url" 
> content="http://www.freebase.com/linkwouldgohere"></span></li>
>         </ul>
>       </div>
> </div>
>
> ===============
>
> Warm wishes
> Amit Kothari
> http://quotationsbook.com
>
> On Thursday, 27 February 2014 at 06:21, Matthias Tylkowski wrote:
>
>> Hello Amit,
>> I think you are doing it correctly with using about there. If you 
>> have a freebase Url you may use it directly without wrapping it in a 
>> http://schema.org/Thing "container". If you keep the structure with 
>> using http://schema.org/Thing, I recomment to use the schema:url 
>> property instead of schema:sameAs, you may also fill in the 
>> schema:name of the http://schema.org/Thing you are talking about.
>>
>> Otherwise you can use anything that is derived from 
>> http://schema.org/Thing in the schema:about property. So when the 
>> quote is from a book you can use http://schema.org/Book instead of 
>> the most general case http://schema.org/Thing.
>>
>> Regards
>> Matthias Tylkowski
>> Technischer Leiter
>> Binarypark UG (haftungsbeschränkt)
>> Erich-Weinert-Str. 1
>> 03046 Cottbus
>> Tel +49 (0)355 692931
>> Fax +49 (0)355 694171
>> info@binarypark.org  <mailto:info@binarypark.org>
>> http://binarypark.org   
>> Am 26.02.2014 13:51, schrieb Quotations Book:
>>> Hi all,
>>>
>>> I’ve implemented quotations markup some time ago, but I have various 
>>> problems.
>>>
>>> We’ve invested hundreds of man hours per week tracking precise 
>>> sources for quotes, which look like this:
>>> http://quotationsbook.com/quote/652309/
>>> (see the text in bold under the quote).
>>>
>>> Is there some specific markup to add “source”? Source can be quite 
>>> variable e.g. a book, a speech, something spoken in the media in a 
>>> known public appearance, etc. Please note the ambiguity possible 
>>> i.e. it could be said in response to something by someone in a 
>>> certain context so this isn’t a straight entity match.
>>>
>>> There is a problem with items appearing empty within the structured 
>>> data markup testing tool:
>>> https://dl.dropboxusercontent.com/u/14563542/Screen%20Shot%202014-02-26%20at%2009.46.38.png
>>> for all URL’s for example:
>>> http://quotationsbook.com/quote/194/
>>> Does my markup need amendment?
>>>
>>> We are currently working on matching our quotes with Google Books if 
>>> we can, showing books in context of where the quote appears.
>>>
>>> Another problem I had was author markup - I have added markup 
>>> pointing to our Google Plus entity 
>>> <https://plus.google.com/+Quotationsbook/>, but Webmaster Central 
>>> doesn’t show this up, nor do search results. Is there an authorship 
>>> markup error on all my pages? The structured data testing tool 
>>> doesn’t show a problem, yet on this view, there is no authorship stated:
>>> https://www.google.com/webmasters/tools/labs-author-stats-1
>>> (the above question is more Google-specific, for which I apologise). 
>>> I suppose the difference between author and publisher here needs 
>>> clarification.
>>>
>>> Warm wishes
>>> Amit Kothari
>>> Chief Potato
>>> http://quotationsbook.com
>>>
>>> On Wednesday, 15 January 2014 at 17:29, Thad Guidry wrote:
>>>
>>>>
>>>>
>>>>
>>>> On Wed, Jan 15, 2014 at 7:47 AM, Stéphane Corlosquet 
>>>> <scorlosquet@gmail.com <mailto:scorlosquet@gmail.com>> wrote:
>>>>
>>>>
>>>>
>>>>
>>>>     On Thu, Dec 5, 2013 at 7:59 PM, Shawn Simister
>>>>     <simister@google.com <mailto:simister@google.com>> wrote:
>>>>
>>>>         Hey Amit,
>>>>
>>>>         Thanks for putting in the hard work to align your content
>>>>         with Freebase. Fo what you're trying to accomplish you
>>>>         would use your own identifiers for the item IDs and then
>>>>         use the sameAs <http://schema.org/sameAs> property to align
>>>>         them with Freebase. Here's how I would mark up a quotation
>>>>         (once the type is part of schema.org <http://schema.org>)
>>>>         using Microdata:
>>>>
>>>>         <div itemscope itemtype="http://schema.org/Quotation">
>>>>         <p itemprop="description">Never let formal education get in
>>>>         the way of your learning.</p>
>>>>         <span itemprop="author" itemscope
>>>>         itemtype="http://schema.org/Person"
>>>>         itemid="http://quotationsbook.com/quotes/author/7349/">
>>>>         <a itemprop="name"
>>>>         href="http://quotationsbook.com/quotes/author/7349/">Mark
>>>>         Twain</a>
>>>>
>>>>
>>>>     Beware that the itemprop in an 'a' element will take on the
>>>>     href attribute as the property value. If you want to annotate
>>>>     the name of the person/author, you should use a span instead of
>>>>     'a', or if you really want a link, add a span inside the a
>>>>     element, like this:
>>>>     <a
>>>>     href="http://quotationsbook.com/quotes/author/7349/"><span itemprop="name">Mark
>>>>     Twain</span></a>
>>>>
>>>>     Steph.
>>>>
>>>>
>>>> I would use that link... "Things NOT Strings" is the right way for 
>>>> Linked Data efforts.  And then author key 7349, will thus be useful 
>>>> for someone else linking back to it !
>>>> -- 
>>>> -Thad
>>>> +ThadGuidry <https://www.google.com/+ThadGuidry>
>>>> Thad on LinkedIn <http://www.linkedin.com/in/thadguidry/>
>>>
>>
>
Received on Thursday, 6 March 2014 10:14:49 UTC

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