правки

ru/syntax/media.md

@@ -56,17 +56,17 @@
 
 {% note info %}
 
-Поддерживаются следующие видеохостинги: Youtube, Vimeo, Vine, Prezi, Osf, Yandex, Vk, Rutube.
+Поддерживаются следующие видеохостинги: Youtube, Vimeo, Vine, Prezi, Osf, Yandex, VK, Rutube.
 
 {% endnote %}
 
-Для встаивания видео на страницу используйте разметку:
+Чтобы добавить на страницу видео, используйте разметку:
 
 ```markdown
 @[название_видеохостинга](id_видео_или_ссылка_на_него)
 ```
 
-**Пример реализации:**
+**Пример разметки:**
 
 ```markdown
 @[rutube](https://rutube.ru/play/embed/c25a0402e866c6fed5347be6d7dbf9ca/)
@@ -76,21 +76,23 @@
 
 @[rutube](https://rutube.ru/play/embed/c25a0402e866c6fed5347be6d7dbf9ca/)
 
-1. Замените `название_видеохостинга` на значение из списка, соответствующее вашему видеохостингу:
+Замените `название_видеохостинга` на значение из списка, соответствующее вашему видеохостингу:
 
-    - `youtube`;
-    - `vimeo`;
-    - `vine`;
-    - `prezi`;
-    - `osf`;
-    - `yandex`;
-    - `vk`;
-    - `rutube`.
+- `youtube`;
+- `vimeo`;
+- `vine`;
+- `prezi`;
+- `osf`;
+- `yandex`;
+- `vk`;
+- `rutube`.
 
-1. Получите ссылку на видео.
+Получите из атрибута `src` блока `iframe` ссылку на видео или воспользуйтесь инструкцией под катом.
 
-    1\. Откройте видео.
-    2\. Найдите код для публикации видео (его можно найти при экспорте, например, в разделе «Поделиться»).
+{% cut "Инструкция по получению ссылки на видео" %}
+
+1. Откройте видео на видеохостинге.
+1. Найдите код для публикации видео (его можно найти при экспорте, например, в разделе «Поделиться»).
 
     {% cut "Пример кода публикации" %}
 
@@ -100,15 +102,17 @@
 
     {% endcut %}
 
-    3\. Используйте ссылку из атрибута `src` в разметке.
+1. Используйте ссылку из атрибута `src` в разметке.
 
     ```html
     https://rutube.ru/play/embed/c25a0402e866c6fed5347be6d7dbf9ca/
     ```
 
+{% endcut %}
+
 {% note alert %}
 
-Если видео не показывается в окне проигрывателя из-за ошибки `ERR_BLOCKED_BY_CSP`, то внесите изменения в файл конфигурации `.yfm`, добавив видеохостинг в список разрешенных доменов.
+Если видео не отображается в окне проигрывателя из-за ошибки `ERR_BLOCKED_BY_CSP`, то внесите изменения в файл конфигурации `.yfm`, добавив видеохостинг в список разрешенных доменов.
 
 ```yaml
 resources:
@@ -117,6 +121,27 @@ resources:
         - "https://rutube.ru"
 ```
 
+{% cut "Пример конфига" %}
+
+```yaml
+allowHTML: true
+langs: ['en','ru']
+
+resources:
+  style:
+    - _assets/style/custom.css
+  csp:
+    - "frame-src":
+        - "https://rutube.ru"
+
+docs-viewer:
+  project-name: diplodoc
+  langs: ['en','ru']
+...
+```
+
+{% endcut %}
+
 {% endnote %}
 
 Ознакомиться с вариантами оформления и перечнем доступных видеохостингов можно на странице плагина [markdown-it-video](https://www.npmjs.com/package/markdown-it-video).