---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://3y3.dev/ru/guides/includers.md
  - href: ru/guides/includers.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
updatedAt: '2026-04-03T14:31:21.000Z'
---
> **Documentation Index:** Fetch the complete configuration index at https://3y3.dev/ru/llms.txt

# Вставка произвольного контента (includers)

Можно включить в документацию произвольный контент через инклюдеры (от английского `includers`) — специальный механизм расширения документационного проекта на этапе сборки дополнительными файлами.

## Подключение {#config}

Инклюдеры подключаются в поле `includers` у пункта оглавления с параметром `include`:

```yaml
items:
  - name: <item-name>
    include:
      path: <path-where-to-include>
      includers:
        - name: <name-of-the-first-includer>
          <includer-parameter>: <includer-parameter-value>
        - name: <name-of-the-second-includer>
        - name: <name-of-the-third-includer>
      mode: link
```

1. Объект `include` должен иметь поле `path` с путем, **откуда** контент будет включен.

2. Параметр `mode` должен иметь значение `link` или быть пропущен, `link` является значением по умолчанию.

3. Параметр `includers` должен содержать список _includer-объектов_, которые будут вызваны последовательно в указанном порядке. 

4. Каждый _includer-объект_ должен содержать поле `name` с типом инклюдера:

    - `generic` — [вставка произвольных Markdown-файлов в структуру проекта](https://3y3.dev/ru/guides/generic.md);

    - `openapi` — [автогенерация статей на основе OpenAPI-спецификаций](https://3y3.dev/ru/guides/openapi.md);

    - `unarchive` — [распаковка tar-файла перед выполнением других инклюдеров](https://3y3.dev/ru/guides/unarchive.md).

5. У разных типов инклюдеров могут быть собственные параметры, которые указываются в _includer-объекте_.