---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://3y3.dev/ru/style/css-js.md
  - href: ru/style/css-js.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
updatedAt: '2025-11-20T11:13:39.000Z'
---
> **Documentation Index:** Fetch the complete configuration index at https://3y3.dev/ru/llms.txt

# Подключение CSS и JavaScript

{% note warning %}

Свободное подключение JavaScript-файлов разрешено только в статических сборках.

{% endnote %}

CSS-стили и JavaScript-файлы позволяют адаптировать оформление и добавить интерактивность для документации — от тонкой настройки отдельных элементов до создания уникального визуального стиля и поведения.

Чтобы подключить свой стиль или скрипт к проекту:

1. В корне проекта создайте файл со стилем или скриптом, например:  
   - для css: `_assets/style/custom.css`  
   - для js: `_assets/script/custom.js`
2. Добавьте в соответствующий файл CSS- или JavaScript-код.
3. В конфигурационный файл `.yfm` добавьте нужный блок:
    ```yaml
    resources:
      style:
        - _assets/style/custom.css
      script:
        - _assets/script/custom.js
    ```
4. Соберите проект с флагом `--allow-custom-resources`.

Пример использования стилей см. в [репозитории Diplodoc](https://github.com/diplodoc-platform/docs).