New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add a Quotation type with supporting properties #247
Comments
This has been floating around forever. I have recently created a 'pending' schema to surface some of these ideas that have been stuck in review, so that they can be seen, implemented, reviewed without diving around inside the issue tracker. http://pending.webschemas.org/Quotation The old Wiki page linked above has some more potential properties that could be added. We also should add an example, especially showing how to include the main body of the quotation (via 'text' property). May also be relevant to schemaorg/schemaorg#1061 for fact-checking sites. |
There are two types of examples: quotes from fiction and quotes by real people. As an example, of both:
|
Updated http://pending.webschemas.org/Quotation with these examples. |
Does anyone want to argue for the inclusion of more properties? Or know where things got to in the Wikipedia/Wikidata world on this front? I found https://www.wikidata.org/wiki/Q19581108 in Wikidata but it seems incomplete. |
Note that Vicki's examples simply use isPartOf for the quotation coming from a creative work; earlier sketches used http://schema.org/isBasedOnUrl |
Structurally, I think this covers use cases in publishing without attempting to duplicate PROV-O or FRBR and friends. It would be a good idea to include examples of quotes from publications that are not intended to be credited to fictional characters. It is very common for a book or article to begin with an epigraph. Something like this:
|
Thanks, @TzviyaSiegman - are you also suggesting we should figure out a pattern to represent the case where a quote like this one appears within another work? Let's say a book chapter leads with this Great Gatsby quote, ... the example above captures the basics of the quote (who said it and where); but how should we tie that to the chapter itself? /cc @RichardWallis @dbs Ingredients include:
|
A http://schema.org/citation could be http://schema.org/isPartOf a http://bib.schema.org/Chapter http://schema.org/citation is more about a work that cites another in its text. Source is a better match I believe for defining who or where a quotation came from. However the current definition of http://schema.org/source is way wide of what is needed here. |
I have just posted a fix for schemaorg/schemaorg#950 so isBasedOn is now available. Queued at http://webschemas.org/isBasedOn (assuming nobody objects, which I would predict is a reasonable assumption) |
(Now I'm thinking isBasedOn was a poor name since property isn't boolean. Investigating whether we've used "is*" for non-booleans...) |
@danbri isPartOf |
Thanks @philbarker. I just looked at the data too :) We have lots of relational properties with names beginning with "is*", so this is ok.
(via ./scripts/rdfa2nt data/schema.rdfa | grep "Property" | grep '#type' | grep '/is' ) |
Guys, any idea when this will be published on schema.org? We are planing to implement it on www.quotetab.com. Is it possible to use it while it is in pending status and than once it is published to switch to real version? |
Can we please avoid using "Quotation" for this and use e.g. "quote"? Quotation is also used in the commercial world and me might want to extend schema.org lateron to support commercial quotations. martin hepp http://www.heppnetz.de
|
Business also uses "quote" extensively. I think we should go with "Quotation" and if we want to describe a price offered from a business, we should use something that sounds more clearly like that. |
I can't speak for technical usage in ecommerce formats but my native speaker intuition for general colloquial usage is that "quote" is very widely used in the business / cost estimation sense and that "quotation", while used in both ways, leans somewhat to the "something someone said" sense. |
My native speaker intuition concurs with @danbri |
FWIW Google Finance (e.g.) uses these locally-extended schema.org types and properties that include "quote" (none contain "quotation"): FinancialQuote |
ok, no more objections against "Quotation" for the liberal arts and "Quote" for the business worlds ;-) |
@mfhepp Thanks - I may quote you on that! |
@danbri I am looking forward to the quotation ;-) |
When doing so will you use single quotes or double quotes? |
This is available in pending, http://pending.schema.org/Quotation ... any feedback on it? Should we move it towards inclusion in the core? |
|
Hi, just saw this proposal; I was waiting for a schema.org for Quotations! I will implement it on our website PensieriParole as soon as it's released officially. @thadguidry |
Could http://pending.schema.org/contentReferenceTime be useful for Quotation? I have addressed @thadguidry 's points 1.) and 3.) with some minor edits. 2.) (spoken time) is partially addressed by noting that Event has recordedIn. As @ibobo mentions dateCreated, datePublished is relevant too. |
Also many quotations are not spoken, they appear in literary form only. So |
@Dataliberate the definition to date was very literary-minded, today's tweaks make it more applicable to quotations that don't have a canonical literary reference. |
@danbri re: 2. (spoken time) - I don't want to have to attach a quote to an Event. |
My preference would be to live with using dateCreated for the "date spoken" usecase, since not all quotes are from spoken speeches. For example, Donald Trump recently said:
He said this on Twitter via a textual post; he did not AFAIK speak those exact words. But if others here agree with @thadguidry on this I'm not going to argue strongly against dateSpoken, it might have its uses. The pending extension was designed to reduce friction for adding potentially-useful properties. Perhaps we can evolve Quotation into the core and have a dateSpoken sub-property of dateCreated and leave that in pending a little longer? Thoughts? |
@danbri I would like to see that dateSpoken sub-property to be in pending, sure. |
Any news about this? |
Noting that we should at least update to use isBasedOn instead of isBasedOnUrl |
|
Should the case of falsely accused quotations also be adressed? Something like "640K ought to be enough for anybody" or many sentences that Einstein never said? |
I'd like to ask how one would say that a quotation was "anonymous." Is there an IRI for an anonymous person? Or possibly just use a blank node for |
@tmciver You could use the creator property and fill in with Anonymous from wikidata? https://www.wikidata.org/wiki/Q4233718 Look at Example 2 - JSON-LD <script type="application/ld+json">
{
"@context": "http://schema.org/",
"@type": "Quotation",
"creator": {
"@type": "Person",
"name": "Anonymous",
"url": "https://www.wikidata.org/wiki/Q4233718"
},
"text": "The only thing we have to fear is death by chocolate cake!!!"
}
</script> I'd also suggest joining the Schema.org mailing list for these general questions instead of hijacking an issue :) but we're nice around here. :-) |
@thadguidry Thanks. I didn't know about the Anonymous wikidata link but I'm not surprised it exists. I've joined the mail list. One final question: why do you use |
This issue is being tagged as Stale due to inactivity. |
tagged for moving to brainstorming repo we should work through how this relates to Claim / ClaimReview |
See issue #7 for the context of the move from the main Schema.org issue tracker to this repository. |
Here's a microdata example from my site: <figure itemscope itemtype="https://schema.org/Quotation">
<blockquote>
<p>
I've said it before but let me say it again: fuzzing is really the top method to find problems in curl once we've fixed all flaws that the static analyzers we use have pointed out. The primary fuzzing for curl is done by OSS-Fuzz, that tirelessly keeps hammering on the most recent curl code.
</p>
</blockquote>
<figcaption itemprop="citation">
—
<span itemprop="creator" itemscope itemtype="https://schema.org/Person">
<a itemprop="url" href="https://daniel.haxx.se/">
<span itemprop="name">
<span itemprop="givenName">Daniel</span>
<span itemprop="familyName">Stenberg</span>
</span>
</a>
</span>,
<cite itemprop="isPartOf" itemscope itemtype="https://schema.org/BlogPosting">
<a itemprop="url" href="https://daniel.haxx.se/blog/2020/09/23/a-google-grant-for-libcurl-work/">
<span itemprop="name">A Google grant for libcurl work</span>
</a>
</cite>
</figcaption>
</figure> Rendered, it looks like this: — Daniel Stenberg , A Google grant for libcurl work Some issues:
|
I think I figured out quote attribution: <figure itemscope itemtype="https://schema.org/Quotation">
<blockquote>
<p>
There is only one honest measure of web performance:
<strong>the time from when you click a link to when you’ve finished skipping the last ad.</strong>
</p>
</blockquote>
<figcaption>
—
<span itemprop="citation" role="doc-credit">
<span itemprop="isPartOf" itemscope itemtype="https://schema.org/PresentationDigitalDocument">
<span itemprop="author" itemscope itemtype="https://schema.org/Person">
<a itemprop="url" href="https://idlewords.com/about.htm">
<span itemprop="name">
<span itemprop="givenName">Maciej</span>
<span itemprop="familyName">Cegłowski</span>
</span>
</a>
</span>,
<cite itemprop="name">
<a itemprop="url" href="https://idlewords.com/talks/website_obesity.htm">The Website Obesity Crisis
</a>
</cite>
</span>
</span>
</figcaption>
</figure> Rendered, it looks like this: — Maciej Cegłowski , The Website Obesity Crisis I left some extra whitespace in for readability. My live example seems to pass the validator; select "Quotation" in the rendered outline. This approach makes the quotation semantically represented as being a part of a larger work authored by a given individual. It combines nicely with microformats2 classes like |
I just implemented the Quotation schema.org markup on my quotes website on about 1.4 million quotes. Well, I implemented a first try but having troubles with marking up the author of the quotation. Some feedback, questions, and a request for help below. I only mean the feedback in the most respectful way - I am overall very impressed with the great work everyone has done here. -- The microdata format is what I chose as it seems most intuitive and to have the least payload (faster sites). -- I followed the directions in your getting started guide (https://schema.org/docs/gs.html) and it seemed fairly straightforward - the directions overall were well written, thank you all! -- However, the examples in microdata format were generally still to be done - so without examples, I am confused some and concerned about whether or not I have marked up my site correctly - can anyone please look at e.g. https://discoverquotes.com/nature/ and/or https://discoverquotes.com/nature/ and see if they are fully correctly done? They validate, but still I have questions, see below... -- that second example - I understand I should likely handle "unknown author" a different way. -- I tried the validator at https://validator.schema.org/ - and ultimately it was very helpful - I got confused about author being a prop not a type at one point - so the error message was "author not a schema.org type" - maybe add to validator an error with hint message saying - "Did you confuse type with property?" -- For the quote body (itemType text) I markup thus:
-- is the Quotation type in official use yet? -- Do folks know of other general quotations sites that have implemented it widely? -- Plus one that "Quotation" is better than "Quote" for "things people said." -- I love that you made allowances for fictional characters versus real people although I have not adjusted in my markup for that yet... I do have some fictional characters as "authors" for the moment. -- should I add something like a meta tag for version or anything in the header of my html files? I am wondering if I am missing something because some SEO tools I use indicate that I have no schema.org markup in my files even though I now do. -- Last, thanks all here for all your hard work! |
On Fri, Apr 29, 2022 at 12:42:40PM -0700, Dave Parizek wrote:
-- I tried the validator at [https://validator.schema.org/ ](https://validator.schema.org/ )- and ultimately it was very helpful - I got confused about author being a prop not a type at one point - so the error message was "author not a schema.org type" - maybe add to validator an error with hint message saying - "Did you confuse type with property?"
Author is lowercase, not uppercase; it is a property and not a type. Person and Organization are types, so they're upperacse.
-- For the quote body (itemType text) I markup thus:
<span itemprop="text" itemscope itemtype="https://schema.org/text" class="quote">
{{ quote.body|safe|linebreaks }}
</span>
in my code generator. The validator says no errors/warnings for the output of that - but I wonder - if the body has line feeds then hmtl "<p>" and possibly "<br>" tags get fed in by my generator. Will the existence of those html tags within the text itemscope be an issue? If so, how to handle markup of line breaks?
You could just switch from <span> to <blockquote> or <q>, and put a line-break after the <q> element. Make the <q> the text itemprop and the citation a "citation" or "author" itemprop. Example: see the quotations on https://seirdy.one/2020/11/23/website-best-practices.html, and the cited quotation examples from the WHATWG HTML Living Standard.
Unrelated: I found it really difficult to select the text below each quotation, as the existing markup makes it seem draggable instead of selectable.
|
@Seirdy Thank YOU!! I will dive into your suggestions. |
https://www.w3.org/wiki/WebSchemas/QuotationSchema
http://sdo-wip1.appspot.com/Quotation- test build currently offlineDraft schema (pretty basic)
The text was updated successfully, but these errors were encountered: