Open Graph

Open Graph определяет, как экспортированный документ выглядит при отправке ссылки в мессенджерах, соцсетях, внутренних порталах и других системах предпросмотра ссылок.

На что влияет Open Graph

Когда кто-то отправляет ссылку на экспортированную страницу, многие платформы пытаются собрать карточку предпросмотра по метатегам из блока HTML head.

В One File Docs эти значения берутся из настроек Open Graph документа во время экспорта и записываются в итоговый файл.

  • og:title задает заголовок карточки
  • og:description задает текст карточки
  • og:image задает изображение карточки
  • og:image:alt задает альтернативный текст для изображения
  • og:type экспортируется как article
  • og:locale экспортируется из языка документа

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

Как заполнять поля

Используйте короткий и однозначный заголовок, который соответствует конкретному документу, а не названию всей системы, продукта или отдела.

Описание должно быть сфокусировано на практической пользе страницы: что читатель узнает, сделает или найдет после открытия.

Для изображения указывайте полный публичный URL, включая https://. Относительные пути и локальные файлы во внешних preview crawler работают ненадежно.

Добавляйте alt-текст, если изображение несет важный смысл, подписи, метрики или фрагменты интерфейса, которые стоит описать для доступности.

Как эти значения используются при экспорте

Поля Open Graph вставляются в сгенерированный однофайловый HTML. Они не меняют видимое содержимое страницы, но меняют то, что внешние сервисы видят до открытия страницы.

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

Поскольку автогенерация изображения отключена, картинку для предпросмотра нужно подготовить отдельно и заранее разместить по стабильному URL.

Практические рекомендации

  • готовьте отдельное изображение предпросмотра для важных документов и релизов, а не одну общую картинку для всего
  • избегайте перегруженных текстом изображений, которые плохо читаются в маленьких карточках
  • синхронизируйте заголовок и описание с текущей экспортированной версией
  • после публикации проверяйте ссылку в тех платформах, которые важны вашей команде
  • если предпросмотр обновляется не сразу, учитывайте, что многие сервисы кэшируют данные Open Graph на некоторое время