Переиспользование контента

Вы можете вынести повторяющийся контент в отдельный файл и добавлять его в нужные места в документе с помощью конструкции {% include %}.

Переиспользование поможет сократить время на редактирование и поиск исходного текста: информация хранится только в одном месте, а изменения автоматически применяются ко всем файлам.

Порядок переиспользования

1. Создайте каталог для хранения повторяющегося контента. Например, _includes.

   Важно

   Файлы для переиспользования должны храниться в каталоге, имя которого начинается с символа _, иначе они будут удалены при сборке.

2. В каталоге _includes создайте отдельный md-файл с повторяющимся текстом.

3. В разделы документа, куда необходимо подставить текст, добавьте ссылку на файл в формате:

   {% include [Описание](../_includes/file.md) %}
   

   • [Описание] — описание файла. Информация для авторов документа, не влияет на сборку.
   • (_includes/file.md) — путь до файла.

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

   {% include notitle [Описание](../_includes/file.md) %}
   

При сборке документа текст файла будет добавлен в разделы на места инклюдов. Если в файле есть относительные ссылки, они будут перестроены.