Merge pull request #227 from bloodmike/update/pdf-extra-links

add pdf generation info

Author: bloodmike

ru/guides/generate-pdf.md

@@ -8,7 +8,9 @@ PDF-документ состоит из трех частей:
 
 1. **Титульные страницы** {#start-pages}
 
-    Чтобы сформировать титульные страницы, настройте блок `startPages` в `toc.yaml`:
+    Отображаются в начале документации и не нумеруются.
+    
+    Титульные страницы указываются в блоке `startPages` в `toc.yaml`:
 
     ```yaml
     pdf:
@@ -24,7 +26,7 @@ PDF-документ состоит из трех частей:
 
     {% endnote %}
 
-    Чтобы проверить верстку в браузере, используйте флаг `--pdf-debug`. Он создаст HTML-версии страниц из `startPages`.
+    При сборке документации титульные страницы не трансформируются в файлы. Для проверки их верстки в браузере, используйте при сборке флаг `--pdf-debug`: он создаст HTML-версии страниц из `startPages`.
 
 1. **Оглавление**
 
@@ -41,7 +43,7 @@ PDF-документ состоит из трех частей:
     - перекрестные ссылки;
     - изображения и другие медиа-файлы.
 
-    Каждая следующая статья PDF-документа начинается с новой страницы.
+    Каждая следующая статья PDF-документа начинается с новой страницы. Статьи в PDF располагаются в том же порядке, что и в оглавлении.
 
 ## Сборка { #build }
 
@@ -67,7 +69,8 @@ PDF-документ состоит из трех частей:
     ```
 
     - `-i .` — путь к папке с исходниками (в примере — текущая папка);
-    - `-o ./docs-output` — путь к папке для результатов сборки.
+    - `-o ./docs-output` — путь к папке для результатов сборки;
+    - `--pdf` — флаг, включающий подготовку данных для генерации PDF; если поддержка PDF включена в `.yfm`, флаг передавать не требуется.
 
 1. Запустите генератор PDF:
 
@@ -77,7 +80,7 @@ PDF-документ состоит из трех частей:
 
 {% note info %}
 
-Для каждого файла `toc.yaml` Diplodoc создает отдельный `single-page.pdf`. Статьи в PDF располагаются в том же порядке, что и в оглавлении.
+Для каждого файла `toc.yaml` Diplodoc создает отдельный `single-page.pdf`. 
 
 {% endnote %}
 

ru/settings.md

@@ -240,7 +240,7 @@ extensions:
 
 ### Секция `pdf` {#pdf}
 
-Для генерации pdf-версии документации необходимо использовать сервис `@diplodoc/pdf-generator` [согласно инструкции](https://github.com/diplodoc-platform/pdf-generator). Секция содержит параметры предобработки данных для работы сервиса.
+Содержит параметры предобработки данных для [генерации pdf-версии](guides/generate-pdf.md) документации.
 
 #|
 || **Название** | **Описание** | **Тип и значение по умолчанию** ||