From 445e1693002799b85bc6bde9e372a73023ec578d Mon Sep 17 00:00:00 2001 From: 1scnd_ <62334658+parinovK@users.noreply.github.com> Date: Fri, 13 Dec 2024 17:27:54 +0300 Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=BF=D0=BE=D0=BB=D0=BD=D0=B5?= =?UTF-8?q?=D0=BD=20=D1=80=D0=B0=D0=B7=D0=B4=D0=B5=D0=BB=20=D1=81=20=D0=B2?= =?UTF-8?q?=D0=B8=D0=B4=D0=B5=D0=BE=20(#75)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Дополнен раздел с видео Поддержаны новые сервисы * Новые фичи в видео Переписал раздел * Новая фича в разделе видео обновил структуру * правки * правки * правки * правки * правки * правки * правки * правки * правки * обновил * правки * правки * правки * правки структуры * правки * правки * обновлен * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки изменил порядок сервисов и добавил подраздел * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки в конфиг * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * структура * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки * правки --- .yfm | 5 +++ ru/syntax/media.md | 96 ++++++++++++++++++++++++++++++++++++++++++++-- 2 files changed, 98 insertions(+), 3 deletions(-) diff --git a/.yfm b/.yfm index 4a421345..dd53d77a 100644 --- a/.yfm +++ b/.yfm @@ -4,6 +4,11 @@ langs: ['en','ru'] resources: style: - _assets/style/custom.css + csp: + - "frame-src": + - "https://vk.com" + - "https://login.vk.com" + - "https://runtime.strm.yandex.ru" docs-viewer: project-name: diplodoc diff --git a/ru/syntax/media.md b/ru/syntax/media.md index ddda6342..74e82cb4 100644 --- a/ru/syntax/media.md +++ b/ru/syntax/media.md @@ -54,9 +54,99 @@ ## Видео {#video} -Чтобы добавить на страницу видео, используйте разметку: +{% note info %} + +Поддерживаемый список видеохостингов: Yandex, Rutube, VK, Youtube, Vimeo, Vine, Osf, Prezi. + +Если ваш видеохостинг не поддерживается, но у него есть кнопка экспорта видео, то воспользуйтесь разделом [Видео из другого видеохостинга](#unsupported-player). + +{% endnote %} + +### Видео из поддерживаемого видеохостинга {#supported-host} + +1. Чтобы добавить на страницу видео, используйте разметку: + + ```markdown + @[название_хостинга](id_видео_или_ссылка_на_него) + ``` + +1. Замените `название_хостинга` на название видеохостинга из списка: `yandex`, `rutube`, `vk`, `youtube`, `vimeo`, `vine`, `osf`, `prezi`. + +1. Откройте страницу с видео, которое нужно встроить в документацию. {#href-for-video} + +1. Найдите код для публикации видео (код можно найти при экспорте в теге `iframe`, например, в разделе «Поделиться»). + + ```html + + ``` + +1. Замените `id_видео_или_ссылка_на_него` на ссылку из атрибута `src`. + +**Пример разметки:** ```markdown -@[название_видеохостинга](id_видео_или_ссылка_на_него) +@[vk](https://vk.com/video_ext.php?oid=-207738372&id=456239060&hd=2&autoplay=1) +``` + +**Результат:** + +@[vk](https://vk.com/video_ext.php?oid=-207738372&id=456239060&hd=2&autoplay=1) + +{% note alert %} + +Если видео не отображается, и окно проигрывателя выдает ошибку `ERR_BLOCKED_BY_CSP`: + +1\. Откройте `.yfm` файл конфигурации. +2\. Добавьте видеохостинг в список разрешенных доменов. + +```yaml +resources: + csp: + - "frame-src": + - "ссылка_на_видеохостинг" ``` -Ознакомиться с вариантами оформления и перечнем доступных видеохостингов можно на странице плагина [markdown-it-video](https://www.npmjs.com/package/markdown-it-video). + +{% cut "Пример конфига" %} + +```yaml +allowHTML: true +langs: ['en','ru'] + +resources: + csp: + - "frame-src": + - "https://vk.com" + - "https://login.vk.com" + - "https://runtime.strm.yandex.ru" + +docs-viewer: + project-name: diplodoc + langs: ['en','ru'] +... +``` + +{% endcut %} + +{% endnote %} + +### Видео из другого видеохостинга {#unsupported-player} + +1. Чтобы добавить на страницу видео, используйте разметку: + + ``` + @[](id_видео_или_ссылка_на_него) + ``` + +1. Получите ссылку на [видео](#href-for-video). + +1. Замените `id_видео_или_ссылка_на_него` на полученную ссылку. + +**Пример разметки:** + +```markdown +@[](https://frontend.vh.yandex.ru/runtime/player/video/vplvic7jsotpobyc7o5b?autoplay=0&branding=0&from=documentation&mute=0&redirect_from=ugc) +``` + +**Результат:** + +@[](https://frontend.vh.yandex.ru/runtime/player/video/vplvic7jsotpobyc7o5b?autoplay=0&branding=0&from=documentation&mute=0&redirect_from=ugc) \ No newline at end of file