Skip to content

Генерация llms.txt

Docusite автоматически генерирует файлы llms.txt и llms-full.txt — стандарт для LLM-дружественной документации. Это позволяет AI-ассистентам и LLM эффективно потреблять вашу документацию.

Базовое использование

По умолчанию генерация включена (llms: true):

ts
import { defineConfig } from 'docusite'

export default defineConfig({
  llms: true,
})

При этом:

  • Создаётся /llms.txt — краткий индекс документации
  • Создаётся /llms-full.txt — полная документация в текстовом виде
  • В навигацию добавляется ссылка «LLM, AI docs 🤖»

Отключение

ts
import { defineConfig } from 'docusite'

export default defineConfig({
  llms: false,
})

Расширенная настройка

ts
import { defineConfig } from 'docusite'

export default defineConfig({
  llms: {
    llmsTxt: true,           // генерировать llms.txt (по умолчанию: true)
    llmsFullTxt: true,       // генерировать llms-full.txt (по умолчанию: true)
    ignoreFiles: ['**/drafts/**'],  // глоб-шаблоны для исключения файлов
    ignoreFrontmatter: true, // убирать frontmatter из вывода (по умолчанию: true)
    description: 'Документация My Project',  // описание для llms.txt
  },
})

Поля DocusiteLlmsOptions

ПолеТипПо умолчаниюОписание
llmsTxtboolean?trueГенерировать llms.txt
llmsFullTxtboolean?trueГенерировать llms-full.txt
ignoreFilesstring[]?Глоб-шаблоны файлов для исключения
ignoreFrontmatterboolean?trueУдалять frontmatter из вывода
descriptionstring?Описание проекта для llms.txt

Как это работает

В режиме разработки

Docusite внедряет кастомный Vite-плагин, который перехватывает запросы к /llms.txt и /llms-full.txt и генерирует содержимое на лету — рекурсивно сканируя директорию docs/ на наличие .md-файлов.

В продакшене

Используется плагин vitepress-plugin-llms, который генерирует файлы на этапе сборки.