Руководство по микроразметке Speakable
Узнайте как выделить особенно 'говорящие' разделы веб-страниц.
speakable - Свойство Schema.org
Описание: Указывает разделы веб-страницы, которые особенно 'говорящие' в смысле их выделения для конвертации в речь. Другие разделы страницы также могут быть полезно озвучены в определенных ситуациях; свойство 'speakable' служит для указания частей, наиболее вероятно подходящих для речи.
Свойство speakable может повторяться произвольное число раз, с тремя возможными значениями 'content-locator':
1.) id-value URL-ссылки - использует значения id-value элемента на странице для аннотирования. Простое использование speakable имеет (возможно относительные) URL-значения, ссылается на определенные разделы обсуждаемых документов.
2.) Селекторы CSS - обращается к содержимому на аннотированной странице, например, через атрибут 'class'. Используйте свойство cssSelector.
3.) XPaths - обращается к содержимому через XPaths (предполагается XML-представление содержимого). Используйте свойство xpath.
Для более сложной разметки 'говорящих' разделов вне простых ссылок ID, рекомендуется использовать селекторы CSS или выражения XPath для выбора одного или нескольких разделов документа в качестве 'говорящих'. Для этого определен тип поддержки, SpeakableSpecification, который является возможным значением свойства speakable.
Свойство speakable может повторяться произвольное число раз, с тремя возможными значениями 'content-locator':
1.) id-value URL-ссылки - использует значения id-value элемента на странице для аннотирования. Простое использование speakable имеет (возможно относительные) URL-значения, ссылается на определенные разделы обсуждаемых документов.
2.) Селекторы CSS - обращается к содержимому на аннотированной странице, например, через атрибут 'class'. Используйте свойство cssSelector.
3.) XPaths - обращается к содержимому через XPaths (предполагается XML-представление содержимого). Используйте свойство xpath.
Для более сложной разметки 'говорящих' разделов вне простых ссылок ID, рекомендуется использовать селекторы CSS или выражения XPath для выбора одного или нескольких разделов документа в качестве 'говорящих'. Для этого определен тип поддержки, SpeakableSpecification, который является возможным значением свойства speakable.
Индицирует разделы веб-страницы, которые особенно 'говорящие' в смысле их выделения для конвертации в речь. Другие разделы страницы также могут быть полезно озвучены в определенных ситуациях; свойство 'speakable' служит для указания частей, наиболее вероятно подходящих для речи. Свойство speakable может повторяться произвольное число раз, с тремя возможными значениями 'content-locator':
1.) id-value URL-ссылки - использует значения id-value элемента на странице для аннотирования. Простое использование speakable имеет (возможно относительные) URL-значения, ссылается на определенные разделы обсуждаемых документов.
2.) Селекторы CSS - обращается к содержимому на аннотированной странице, например, через атрибут 'class'. Используйте свойство cssSelector.
3.) XPaths - обращается к содержимому через XPaths (предполагается XML-представление содержимого). Используйте свойство xpath.
Для более сложной разметки 'говорящих' разделов вне простых ссылок ID, рекомендуется использовать селекторы CSS или выражения XPath для выбора одного или нескольких разделов документа в качестве 'говорящих'. Для этого определен тип поддержки, SpeakableSpecification, который является возможным значением свойства speakable.
1.) id-value URL-ссылки - использует значения id-value элемента на странице для аннотирования. Простое использование speakable имеет (возможно относительные) URL-значения, ссылается на определенные разделы обсуждаемых документов.
2.) Селекторы CSS - обращается к содержимому на аннотированной странице, например, через атрибут 'class'. Используйте свойство cssSelector.
3.) XPaths - обращается к содержимому через XPaths (предполагается XML-представление содержимого). Используйте свойство xpath.
Для более сложной разметки 'говорящих' разделов вне простых ссылок ID, рекомендуется использовать селекторы CSS или выражения XPath для выбора одного или нескольких разделов документа в качестве 'говорящих'. Для этого определен тип поддержки, SpeakableSpecification, который является возможным значением свойства speakable.
Values expected to be one of these types
Source
https://github.com/schemaorg/schemaorg/issues/1389
Examples
Example 1
Copied
Example notes or example HTML without markup.
An example of 'speakable' markup (JSON-LD only, initially).
Example encoded as JSON-LD in a HTML script tag.
{
"@context": "https://schema.org/",
"@type": "WebPage",
"name": "Jane Doe's homepage",
"speakable":
{
"@type": "SpeakableSpecification",
"cssSelector": ["headline", "summary"]
},
"url": "http://www.janedoe.com"
}
Structured representation of the JSON-LD example.
Example 2
Copied
Example notes or example HTML without markup.
An example of speakable markup in Microdata in HTML head section.
Example encoded as Microdata embedded in HTML.
<!DOCTYPE html> <html> <head rel="home" href="/" itemid="" itemscope itemtype="https://schema.org/SpeakableSpecification"> <title>Example showing complex structures in HTML head</title> <meta itemprop="cssSelector" content=".title" /> <meta itemprop="xpath" content="/html/body/h3" /> </head> <body> <h1 class="title">Complex Microdata in HTML head</h1> <p>...</p> </body> </html>
Example 3
Copied
Example notes or example HTML without markup.
An example of 'speakable' markup (JSON-LD only, initially).
Example encoded as JSON-LD in a HTML script tag.
{
"@context": "https://schema.org/",
"@type": "WebPage",
"name": "Jane Doe's homepage",
"speakable": [ "#myhead1", "#thesummary"],
"url": "http://www.janedoe.com"
}
Structured representation of the JSON-LD example.