<!-- Generated from ru/llms-txt-astro/index.html. The canonical document is the HTML page. -->

- [ Главная ](/ru/) 
/
- [ Как создать ](/ru/how-to-create/) 
/
- Руководство по Astro            
# `llms.txt` с Astro

Два подхода: положить файл в public/ для мгновенного развёртывания или динамически генерировать его из коллекций контента с помощью конечной точки TypeScript.

Последнее обновление: 29 октября 2026 г.

На этой странице

- [ Подход 1: статический файл в public/ ](#approach-1)
- [ Подход 2, конечная точка TypeScript с getCollection() ](#approach-2)
- [ Добавление llms-full.txt ](#llms-full)
- [ Сайты на Starlight: starlight-llms-txt ](#starlight)
- [ Проверьте после сборки ](#verify)
- [ Какой подход выбрать ](#which)               
Пример

Этот сайт работает на Astro

Сам llmtxt.info создан с помощью Astro на Cloudflare Pages. Приведённые ниже подходы — именно
те, которые мы используем для публикации собственного  /llms.txt .

## Подход 1. Статический файл в `public/`

Самый простой вариант. Создайте обычный текстовый файл по адресу `public/llms.txt` в корне
проекта. Astro копирует весь `public/` каталог без изменений в `dist/` во время
`astro build`, поэтому файл доступен по адресу
`/llms.txt` с нулевой конфигурацией.
static approach, public/llms.txt    Копировать     

```
# Place the file at: public/llms.txt
# Astro copies everything in public/ to the output directory as-is.
# Result: served at https://yoursite.com/llms.txt, no code changes needed.

# After deploy, verify:
curl -I https://yoursite.com/llms.txt
# Expected: HTTP/2 200 | Content-Type: text/plain
```

**Когда использовать:** если ваш контент меняется нечасто, вам не нужны накладные расходы
во время сборки или вы обслуживаете файл вручную. Одинаково работает на Cloudflare Pages, Vercel,
Netlify и любом другом хостинге Astro.

## Подход 2, конечная точка TypeScript с `getCollection()`

Astro соответствует двойному расширению `.txt.ts` и рассматривает
`src/pages/llms.txt.ts` в качестве эндпоинта API, отвечающего по адресу
`/llms.txt`. В режиме SSG (по умолчанию) Astro предварительно генерирует его в
статический `dist/llms.txt` во время сборки, без затрат на выполнение.
src/pages/llms.txt.ts    Копировать     

```
// src/pages/llms.txt.ts
// Astro treats src/pages/foo.ext.ts as a route for /foo.ext
// In SSG mode (default), it pre-renders to dist/llms.txt at build time.

import type { APIRoute } from 'astro';
import { getCollection } from 'astro:content';

export const GET: APIRoute = async () => {
// Replace 'docs' with your actual content collection name
const docs = await getCollection('docs');

const lines = [
'# My Site',
'',
'> One-sentence description of what this site is about.',
'',
'## Documentation',
'',
...docs
.filter((d) => !d.data.draft)
.sort((a, b) => (a.data.order ?? 999) - (b.data.order ?? 999))
.map((d) => `- [${d.data.title}](https://yoursite.com/${d.id}/): ${d.data.summary ?? ''}`.trimEnd()),
'',
'## Optional',
'',
'- [Changelog](https://yoursite.com/changelog/): version history.',
];

return new Response(lines.join('\n'), {
headers: { 'Content-Type': 'text/plain; charset=utf-8' },
});
};

```

Конечная точка предполагает наличие коллекции `docs`. Начиная с Astro 6 все коллекции
контента должны использовать Content Layer API: коллекции, создаваемые во время сборки,
объявляются в
`src/content.config.ts` (а не в `src/content/config.ts`) вместе с
загрузчиком, например:
src/content.config.ts    Копировать     

```
// src/content.config.ts
// Build-time collections are defined here, each with a loader (Content Layer API).
import { defineCollection } from 'astro:content';
import { glob } from 'astro/loaders';
import { z } from 'astro/zod';

const docs = defineCollection({
loader: glob({ base: './src/content/docs', pattern: '**/*.{md,mdx}' }),
schema: z.object({
title: z.string(),
summary: z.string().optional(),
order: z.number().optional(),
draft: z.boolean().optional(),
}),
});

export const collections = { docs };

```

Основные моменты:

- Заменить `'docs'` с фактическим названием коллекции из `src/content.config.ts`. 
- У записей больше нет свойства `slug`: для построения URL используйте
`entry.id`. Идентификаторы, создаваемые встроенным загрузчиком `glob()`,
преобразуются в slug. 
- Отфильтруйте черновики перед построением карты: `!d.data.draft`. 
- Каждая строка-аннотация (`: short note`) необязателен, но настоятельно
рекомендуется: он даёт большим языковым моделям контекст о каждой странице, не заставляя их
получать её. 
- Всегда устанавливайте `Content-Type: text/plain; charset=utf-8` в ответе.     
Предупреждение

Режим вывода SSR

Если вы используете  output: 'server'  в  astro.config.mjs ,
конечная точка выполняется при каждом запросе. Для развёртываний с высокой посещаемостью
добавьте
export const prerender = true;  в верхней части файла, чтобы принудительно включить статический
пререндеринг даже в серверном режиме.

## Добавление `llms-full.txt`

[llms-full.txt](/ru/llms-full-txt/) сопутствующий файл встраивает полное содержимое каждой
страницы, что удобно для RAG-конвейеров и клиентов LLM, которым нужен весь корпус сразу. Создайте
параллельную конечную точку:
src/pages/llms-full.txt.ts    Копировать     

```
// src/pages/llms-full.txt.ts
// Generates the full-content companion file.
// Each entry gets its full Markdown body inlined, useful for RAG pipelines.

import type { APIRoute } from 'astro';
import { getCollection } from 'astro:content';

export const GET: APIRoute = async () => {
const docs = await getCollection('docs');
const sections: string[] = [];

for (const doc of docs.filter((d) => !d.data.draft)) {
sections.push(
`# ${doc.data.title}`,
'',
`URL: https://yoursite.com/${doc.id}/`,
'',
doc.body ?? '', // raw, uncompiled Markdown/MDX body (undefined if retainBody is false)
'',
'---',
'',
);
}

return new Response(sections.join('\n'), {
headers: { 'Content-Type': 'text/plain; charset=utf-8' },
});
};

```

`doc.body` содержит исходное, нескомпилированное тело записи Markdown или MDX, поэтому
в выводе нет HTML-тегов. Оно равно `undefined`, если параметр загрузчика
`retainBody` установлен в `false`, отсюда и запасное значение в виде
пустой строки.

## Сайты на Starlight: `starlight-llms-txt`

Для документации, созданной на Starlight, плагин сообщества [starlight-llms-txt](https://delucis.github.io/starlight-llms-txt/) генерирует `llms.txt`, `llms-full.txt` и `llms-small.txt` из содержимого
сайта. Он поддерживается в личном репозитории GitHub Криса Свитинбэнка (`delucis`), а
не в организации `withastro`. Версия 0.12.0 (опубликована 15 сентября 2026 г.)
объявляет peer-зависимости `astro ^7.0.0` и `@astrojs/starlight >=0.41.0`. Обязателен URL `site`:
astro.config.mjs, Starlight plugin    Копировать     

```
// astro.config.mjs
import starlight from '@astrojs/starlight';
import { defineConfig } from 'astro/config';
import starlightLlmsTxt from 'starlight-llms-txt';

export default defineConfig({
site: 'https://example.com/', // required by the plugin
integrations: [
starlight({
title: 'My Docs',
plugins: [starlightLlmsTxt()],
}),
],
});

```

## Проверка после сборки
verify    Копировать     

```
# Build the project
npx astro build

# Check static output (works for both approaches in SSG mode)
cat dist/llms.txt

# Or start preview server and curl:
npx astro preview &
curl http://localhost:4321/llms.txt
curl http://localhost:4321/llms-full.txt
```

После развёртывания вставьте действующий URL в [валидатор](/ru/validator/)
для проверки соответствия спецификации: ровно один H1, корректный синтаксис ссылок (`- [title](https://...)`), все URL абсолютны, пустых разделов нет.

## Какой подход выбрать

- **Статический `public/llms.txt`**, лучше всего для сайтов, которые
обновляются нечасто. Нулевые накладные расходы, TypeScript не требуется, работает везде. 
- **Конечная точка TypeScript `src/pages/llms.txt.ts`**, лучше всего
подходящий сайтам документации с большим числом автоматически создаваемых страниц. Файл
автоматически синхронизируется при каждой сборке без ручного редактирования.   
&rarr; [Полное руководство по созданию](/ru/how-to-create/) &middot;
[Руководство по Next.js](/ru/llms-txt-nextjs/) &middot;
[Руководство по WordPress](/ru/llms-txt-wordpress/)

## Источники

- [ llmstxt.org, предложение сообщества ](https://llmstxt.org/)
- [ Astro: коллекции контента ](https://docs.astro.build/en/guides/content-collections/)
- [ Astro, справочник API коллекций контента ](https://docs.astro.build/en/reference/modules/astro-content/)
- [ Astro, переход на v6 ](https://docs.astro.build/en/guides/upgrade-to/v6/)
- [ Astro, конечные точки ](https://docs.astro.build/en/guides/endpoints/)
- [ Документация starlight-llms-txt ](https://delucis.github.io/starlight-llms-txt/)
- [ Исходный код starlight-llms-txt (delucis/starlight-llms-txt) ](https://github.com/delucis/starlight-llms-txt)
