speakable

Свойство schema.org ?

Канонический URL: https://schema.org/speakable
👉 Проверить на наличие открытых проблем.

Содержание: Описание, Какие должны быть типы, В каких типах используется, Ссылка на источник термина, Примеры использования.

Описание:

Указывает на разделы веб-страницы, которые особенно 'говоримы' в том смысле, что они выделены как особенно подходящие для преобразования текста в речь. Другие разделы страницы также могут быть полезно произнесены в определенных обстоятельствах; свойство '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.

Свойство speakable в Schema.org предназначено для указания тех частей веб-страницы, которые особенно подходят для преобразования текста в речь. Это свойство помогает выделить контент, который может быть полезен для пользователей, использующих технологии синтеза речи, такие как голосовые помощники или программы для чтения текста.

Использование speakable позволяет разработчикам веб-страниц более точно настраивать, какие именно фрагменты контента должны быть произнесены, когда страница обрабатывается с помощью текстово-речевых систем. Это может быть особенно важно для улучшения доступности контента и повышения удобства использования для людей с ограниченными возможностями.

Свойство speakable может быть применено несколько раз на одной странице, что дает возможность указать разные части контента. Оно поддерживает три типа значений, которые помогают указать местоположение контента:

id-value - это ссылки на элементы страницы, которые имеют уникальный идентификатор. Это самый простой способ указать, какие части страницы следует произнести.
CSS Selectors - этот метод позволяет обращаться к контенту на странице через классы или другие селекторы CSS, что дает возможность более гибко выбирать части текста.
XPaths - этот способ позволяет указывать местоположение контента с помощью выражений XPath, что может быть полезно при работе с XML-структурой документа.

Для более сложной разметки секций, которые должны быть произнесены, можно использовать CSS селекторы или выражения XPath. Для этого в Schema.org предусмотрен специальный тип под названием SpeakableSpecification, который может быть использован в качестве значения свойства speakable.

Таким образом, speakable является важным инструментом для оптимизации контента веб-страниц под нужды пользователей, использующих голосовые технологии, и способствует улучшению доступности информации в интернете.

Ожидается, что значения будут одного из этих типов

Используется в этих типах

Источник

https://github.com/schemaorg/schemaorg/issues/1389

Примеры

Пример 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

Пример заметки или 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>

Пример 3

Пример заметки или 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": [ "#myhead1", "#thesummary"],
  "url": "http://www.janedoe.com"
}

Структурированное представление примера JSON-LD.

@context

https://schema.org/

@type

WebPage

name

Jane Doe's homepage

speakable