Протокол open graph
Що б перетворити вашу web-сторінку в графічні об'єкти, вам потрібно додати базові метадані до вашої сторінці. Ми опираємося на початковій версії протоколу RDFa це означає що ви будите розміщувати додаткові теги в
вашої web-сторінці. Чотири основні властивості для кожної сторінки:Як приклад нижче наводиться розмітка протоколу Open Graph для фільму "The Rock" на IMDB:
Наступні властивості є необов'язковими для будь-якого об'єкта і, як правило, рекомендується:
Наприклад (line-break виключно для демонстрації):
Властивість тега og: image має кілька додаткових структурованих властивостей:
Приклад структурованих властивостей для зображення:
Властивість тега og: video має ідентичні теги з og: image. Ось приклад:
Тег og: audio має тільки 3 доступних властивості (бо, звук не має ширини і висоти):
Якщо тег може мати кілька значень, просто поставте кілька таких тегів на вашій сторінці. Пріоритет тегам віддається з верху вниз, при виникненні конфліктів.
Пишіть структуровані властивості тегів після того, як ви оголосите батьківський тег. Коли один з батьківських елементів обробляється, його структуровані властивості виконуються послідовно.
На наведеному прикладі 3 зображення, відображатися вони будуть так: перше зображення має розмір 300x300 px, друге зображенням не має зазначених розмірів і третє зображенням має розмірі 1000 px у висоту.
Для того що б коректно відобразити об'єкт в графі, що необхідно дати йому тип. Це робиться за допомогою властивостей: og: type
Коли ми погоджуємося зі схемою типів, вони додаються до списку глобальних типів. Всі інші типи об'єктів визначаються як форма CURIEs
Глобальні типи згруповані по вертикалі. Кожен вертикальний тип має власний простір імен. Тип og: type значення імені завжди з префіксом простору імен, а потім період. Це для зменшення плутанини типів в просторах імен, в яких завжди є двокрапка.
- music: duration - integer> = 1 - Довжина пісні в секундах.
- music: album - music.album array - Назва альбому.
- music: album: disc - integer> = 1 - Номер альбому на диску.
- music: album: track - integer> = 1 - Номер треку в альбомі.
- music: musician - profile array - Виконавець пісні.
- music: song - music.song - Назва пісні в альбомі.
- music: song: disc - integer> = 1 - Теж саме що music: album: disc але в зворотному значенні.
- music: song: track - integer> = 1 - Теж саме що music: album: track але в зворотному значенні.
- music: musician - profile - Профайл музиканта, який створив цю пісню.
- music: release_date - datetime - Дату випуску альбому.
- music: song - Ідентично одному з music.album
- music: song: disc
- music: song: track
- music: creator - profile - Творець плейлиста.
- video: actor - Ідентично video.movie
- video: actor: role
- video: director
- video: writer
- video: duration
- video: release_date
- video: tag
- video: series - video.tv_show - До якої серії цей епізод належить.
Якщо це серіал або ТБ-шоу, метадані ідентичні video.movie.
Це глобально-певні об'єкти, які просто не вписуються в вертикальні об'єкти, але все ж широко використовуються в Інтернеті.
- book: author - profile array - Хто написав цю книгу.
- book: isbn - string - Міжнародний стандартний книжковий номер ISBN
- book: release_date - datetime - Дата випуску книги.
- book: tag - string array - Теги, пов'язані з цією книгою.
- profile: first_name - string - Ім'я користувача профайла.
- profile: last_name - string - Прізвище користувача профайла.
- profile: username - string - Нік.
- profile: gender - enum - Пол (чоловічий, жіночий).
Ніяких додаткових властивостей, відмінних від базових. Будь-яка НЕ розмічена web-сторінки повинна розглядатися як og: type web-сайт.
Наступні типи використовуються при визначенні атрибутів в протоколі Open Graph.