SpeakableSpecification
Тип schema.org ?
- Канонический URL: https://schema.org/SpeakableSpecification
- 👉 Проверить на наличие открытых проблем.
Содержание: Описание, Свойства которые можно использовать, Подходит для свойств, Ссылка на источник термина, Примеры использования.
Описание:
SpeakableSpecification указывает (обычно через xpath или cssSelector) разделы документа, которые выделены как особенно говоримые. Экземпляры этого типа, как ожидается, будут использоваться главным образом в качестве значений свойства говоримое.SpeakableSpecification — это тип данных, используемый в разметке Schema.org, который помогает определить определенные части текстового контента на веб-странице, которые могут быть озвучены голосовыми помощниками или системами синтеза речи. Этот тип разметки указывает, какие именно фрагменты текста являются "говорящими", то есть могут быть прочитаны вслух.
Основная цель SpeakableSpecification заключается в улучшении взаимодействия пользователей с голосовыми интерфейсами. Когда пользователи запрашивают информацию с помощью голосовых команд, системы могут извлекать и озвучивать только те части текста, которые помечены как speakable. Это позволяет сделать взаимодействие более естественным и удобным, так как пользователи получают именно ту информацию, которая им нужна, без лишних деталей.
Использование SpeakableSpecification обычно связано с определением селекторов, таких как xpath или cssSelector, которые указывают на конкретные элементы документа. Это позволяет точно указать, какие именно фрагменты текста следует озвучивать. В большинстве случаев SpeakableSpecification используется как значение для свойства speakable, что является частью более широкой схемы, направленной на оптимизацию контента для голосового поиска и взаимодействия.
Таким образом, SpeakableSpecification помогает улучшить доступность информации для пользователей, использующих голосовые технологии, и способствует более эффективному представлению контента в аудиоформате.
| Свойство | Ожидаемый тип | Описание |
|---|---|---|
| Свойство из SpeakableSpecification | ||
| cssSelector | CssSelectorType | CSS-селектор, например, для SpeakableSpecification или WebPageElement. В последнем случае несколько совпадений на странице могут составлять единый концептуальный "элемент веб-страницы". |
| xpath | XPathType | XPath, например, для SpeakableSpecification или WebPageElement. В последнем случае, несколько совпадений на странице могут составлять один концептуальный "элемент веб-страницы". |
| Свойство из Thing | ||
| additionalType | URL, Text | Дополнительный тип для элемента, обычно используемый для добавления более специфичных типов из внешних словарей в синтаксисе микроданных. Это отношение между чем-то и классом, к которому это что-то относится. Обычно значение является URI-идентифицированным классом RDF, и в этом случае соответствует использованию rdf:type в RDF. Текстовые значения могут использоваться экономно, в случаях, когда полезная информация может быть добавлена без наличия соответствующей схемы для ссылки. В случае текстовых значений, метка класса должна следовать руководству по стилю schema.org. |
| alternateName | Text | Псевдоним для элемента. |
| description | Text, TextObject | Описание предмета. |
| disambiguatingDescription | Text | Субсвойство описания. Краткое описание элемента, используемое для различения его от других, похожих элементов. Информация из других свойств (в частности, имени) может быть необходима для того, чтобы описание было полезным для различения. |
| identifier | PropertyValue, Text, URL | Свойство identifier представляет собой любой вид идентификатора для любого рода Thing, такого как ISBN, коды GTIN, UUID и т.д. Schema.org предоставляет специальные свойства для представления многих из них, как в виде текстовых строк, так и в виде ссылок URL (URI). См. фоновую информацию для получения дополнительных деталей. |
| image | ImageObject, URL | Изображение предмета. Это может быть URL или полностью описанный ImageObject. |
| mainEntityOfPage | CreativeWork, URL | Указывает на страницу (или другое творческое произведение), для которой этот объект является основным описываемым объектом. См. фоновую информацию для получения деталей. |
| name | Text | Название элемента. |
| potentialAction | Action | Указывает на потенциальное действие, которое описывает идеализированное действие, в котором этот объект будет играть роль 'объекта'. |
| sameAs | URL | URL страницы в Интернете, которая однозначно указывает на идентичность элемента. Например, URL страницы элемента в Википедии, запись в Викиданных или официальный сайт. |
| subjectOf | CreativeWork, Event | Творческое произведение или событие, связанное с этой вещью. |
| url | URL | URL предмета. |
Экземпляры SpeakableSpecification могут использоваться в качестве значения для следующих свойств.
| Свойство | Типы | Описание |
|---|---|---|
| speakable | WebPage, Article | Указывает на разделы веб-страницы, которые особенно 'говоримы' в том смысле, что они выделены как особенно подходящие для преобразования текста в речь. Другие разделы страницы также могут быть полезно произнесены в определенных обстоятельствах; свойство 'speakable' служит для указания частей, которые с наибольшей вероятностью будут полезны для речи. Свойство speakable может повторяться произвольное количество раз, с тремя видами возможных значений 'content-locator': 1.) id-value URL ссылки - использует id-value элемента на аннотируемой странице. Самое простое использование speakable имеет (возможно относительные) URL значения, ссылаясь на определенные разделы рассматриваемого документа. 2.) CSS селекторы - адресует содержимое на аннотированной странице, например, через атрибут класса. Используйте свойство cssSelector. 3.) XPaths - адресует содержимое через XPaths (предполагая XML представление содержимого). Используйте свойство xpath. Для более сложной разметки говоримых разделов, помимо простых ссылок ID, можно использовать либо CSS селекторы, либо выражения XPath для выделения разделов документа как говоримых. Для этого мы определяем вспомогательный тип, SpeakableSpecification, который определяется как возможное значение свойства speakable. |
Примеры
Пример 1
Пример заметки или HTML разметки.
An example of 'speakable' markup (JSON-LD only, initially).
Пример, закодированный в формате JSON-LD в теге <script> HTML.
{
"@context": "https://schema.org/",
"@type": "WebPage",
"name": "Jane Doe's homepage",
"speakable":
{
"@type": "SpeakableSpecification",
"cssSelector": ["headline", "summary"]
},
"url": "http://www.janedoe.com"
}
Структурированное представление примера JSON-LD.
- @context
- https://schema.org/
- @type
- WebPage
- name
- Jane Doe's homepage
- speakable
- @type
- SpeakableSpecification
- cssSelector
- 0
- headline
- 1
- summary
- url
- http://www.janedoe.com
Пример 2
Пример заметки или HTML разметки.
An example of speakable markup in Microdata in HTML head section.
Пример, закодированный в формате Microdata, встроенный в 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>
