diff --git a/ydb/docs/ru/core/contributor/documentation/_assets/presentation-reference.png b/ydb/docs/ru/core/contributor/documentation/_assets/presentation-reference.png new file mode 100644 index 000000000000..711faf2f7550 Binary files /dev/null and b/ydb/docs/ru/core/contributor/documentation/_assets/presentation-reference.png differ diff --git a/ydb/docs/ru/core/contributor/documentation/_assets/tags-to-video.png b/ydb/docs/ru/core/contributor/documentation/_assets/tags-to-video.png new file mode 100644 index 000000000000..2661434ce9b2 Binary files /dev/null and b/ydb/docs/ru/core/contributor/documentation/_assets/tags-to-video.png differ diff --git a/ydb/docs/ru/core/contributor/documentation/guide-to-public-material.md b/ydb/docs/ru/core/contributor/documentation/guide-to-public-material.md new file mode 100644 index 000000000000..c148b581056e --- /dev/null +++ b/ydb/docs/ru/core/contributor/documentation/guide-to-public-material.md @@ -0,0 +1,72 @@ +# Добавление медиа в публичные материалы + +Эта статья посвящена размещению медиа на [странице «Публичные материалы»](../../public-materials/videos/) + +## Видео + +### Название + +Первым шагом при публикации видеоматериалов является выбор заголовка. Как правило, это заголовок второго уровня, а название полностью идентично названию видео с той площадки, откуда пришла ссылка первоисточника. + +### Тег + +У каждого видео должен быть свой тег, отражающий категорию и краткое содержание. Все виды тегов расписаны в папке репозитория `/public-materials/_includes/tags.md` и на [странице](../../public-materials/videos.md). Тег ставится следующим после названия. + +![](../../contributor/documentation/_assets/tags-to-video.png) + +### Краткое описание + +Следующий шаг - небольшое описание в один абзац, отражающее лишь самые основные моменты видео. Необязательно отсматривать видео полностью самостоятельно, можно воспользоваться функцией саммаризации видео с помощью [ИИ](https://300.ya.ru/), однако помните, что ИИ могут совершать ошибки и лучше перепроверять саммари самостоятельно. + +### Целевая аудитория + +Обязательно следующий абзац должен быть про целевую аудиторию публикуемого видео. Учитывайте их конкретную роль ([разработчики приложений](../../dev/index.md), [DevOps-инженеры](../../dev/index.md), [инженеры по безопасности](../../security/index.md) и т.д.), а если вы не можете сориентироваться самостоятельно, спросите у автора доклада. В случае, если автор недоступен, можно снова спросить совета у ИИ. Тот, скорее всего, не ошибется. + +### Прикрепление ссылок + +Ссылки на видео оформляются по стандартным md-правилам. `@[название_ресурса](ссылка)`. Например: + +- `@[youtube](https://youtu.be/Dy0VtzQatag?)` +- `@[rutube](6840af8411a8be4e7da9f82cb4a25103)` + +- `@[](https://runtime.strm.yandex.ru/player/episode/vplekzpruxb4htfcgqwm?autoplay=0&mute=1&color=white&rel=0)` + +- `@[vk](https://vk.com/video_ext.php?oid=-34475478&id=456239479&hd=2&autoplay=1)` + +Для получения ссылки с Youtube достаточно нажать **копировать URL видео**, и использовать полученную ссылку. + +С Rutube после получения ссылки видео в формате `https://rutube.ru/video/6840af8411a8be4e7da9f82cb4a25103/?r=plwd` достаточно оставить только часть с ID видео, как было показано в примере выше. + +С Yandex достаточно скопировать ссылку на видео, а название хостинга в квадратных скобках указывать необязательно. + +При работе со ссылками VK-видео необходимо учитывать, что воспроизводимый формат превью получается только при формате ссылки вида `https://vk.com/video_ext.php?oid=-84793390&id=456239888&hd=2&autoplay=0` +Тогда как при копировании ссылки на видео вк, формат будет выглядеть так: +`https://vkvideo.ru/video-84793390_456239888`. + +В данном случае необходимо первую числовую комбинацию до нижнего слеша вставить в поле `oid=`, а вторую комбинацию - в поле `id=`. + +{% note info %} + +При наличии видео на нескольких ресурсах, оформлять ссылки с этих ресурсов необходимо с помощью табов `{% list tabs %}` + +{% endnote %} + +### Добавление слайдов + +К некоторым видеоматериалам (например, к докладам с конференций) необходимо прикладывать слайды презентаций, помещённые после ссылки на видео во вкладку **Слайды**. + +Для корректного отображения презентацию необходимо загружать в виде ссылки `https://presentations.ydb.tech/2025/ru/infra_source_craft/presentation.pdf`. + +Для этого нужно: + +* Загрузить презентацию в pdf - формате в [репозиторий](https://github.com/ydb-platform/ydb-presentations). + +* Извлечь ссылку на слайды: + +![](../../contributor/documentation/_assets/presentation-reference.png) + +Получится ссылка `2025/ru/infra_source_craft/presentation.pdf`. + +* Добавить в начало этой ссылки `https://presentations.ydb.tech/`. + + diff --git a/ydb/docs/ru/core/contributor/documentation/index.md b/ydb/docs/ru/core/contributor/documentation/index.md index f395769e3fe5..9aa6e0241e05 100644 --- a/ydb/docs/ru/core/contributor/documentation/index.md +++ b/ydb/docs/ru/core/contributor/documentation/index.md @@ -17,4 +17,5 @@ - [{#T}](structure.md) - [{#T}](genres.md) - [Документация GitHub](https://docs.github.com/en) -- [Документация Git](https://git-scm.com/doc) \ No newline at end of file +- [Документация Git](https://git-scm.com/doc) +- [{#T}](guide-to-public-material.md) \ No newline at end of file diff --git a/ydb/docs/ru/core/contributor/documentation/toc_p.yaml b/ydb/docs/ru/core/contributor/documentation/toc_p.yaml index 0f44dbe00b5c..693c0aeeddc8 100644 --- a/ydb/docs/ru/core/contributor/documentation/toc_p.yaml +++ b/ydb/docs/ru/core/contributor/documentation/toc_p.yaml @@ -7,3 +7,5 @@ items: href: structure.md - name: Жанры href: genres.md +- name: Добавление медиа в публичные материалы + href: guide-to-public-material.md