﻿---
title: "Справочник настроек: Blog List и списки тегов"
description: "Типы, стандарты и ограничения публичных настроек архива блога, тегов и общей пагинации."
url: "https://demo.anglefeint.com/ru/blog/config-blog-list/"
language: "ru"
author: "Anglefeint"
published: "2026-11-13T00:00:00.000Z"
updated: "2026-11-14T00:00:00.000Z"
---

# Справочник настроек: Blog List и списки тегов

**Примечание о версии:** Строгая проверка `blogPageSize` доступна с 0.36.1 и отсутствует в 0.36.0. В старых версиях также указывайте разумное положительное целое.

[Назад к общему справочнику](https://demo.anglefeint.com/ru/blog/config-reference/). Статья охватывает архив блога, каталог тегов, статьи тега и общую пагинацию. Код темы авторитетен; количество статей/цвета demo не стандарты.

Китайский блог — `/zh/blog/`, вторая страница `/zh/blog/2/`, теги `/zh/tags/`. Для отдельного тега используйте сгенерированную ссылку. Для других языков замените zh; режим адреса стандартной главной не удаляет эти языковые префиксы.

TypeScript объединяйте с существующим defineThemeConfig в `src/site.config.ts`. Изменяйте существующие theme/i18n/pagination, сохраняя остальное без повторных объектов.

## 1\. Сколько статей показывать на странице

### `theme.blogPageSize`

*   **Тип:** `number`.
*   **Стандарт темы:** `10`.
*   **Действие:** общий размер архива блога и списка каждого тега. Сначала текущий язык, затем pubDate от новых к старым.
*   **Состояние:** действует.
*   **Ограничения:** требуется положительное безопасное целое. 0, отрицательные и дробные значения, NaN, Infinity и числа вне безопасного диапазона явно отклоняются при разрешении конфигурации, без округления или сброса к стандарту. 0 не отключает пагинацию.
*   **Область:** не последние статьи главной, не размер Fragments; каталог тегов сам по этому полю не пагинируется.

```ts
theme: { blogPageSize: 12 },
```

Пустой блог всё равно создаёт первую страницу; при одной пагинация скрыта. После смены размера пересоберите и разместите. Старшие номера могут исчезнуть без автоматических перенаправлений.

Сортировка не по updatedDate, имени или просмотрам. draft/будущее не фильтруются, поля порядка нет. См. [статьи](https://demo.anglefeint.com/ru/blog/starter-guide-2-languages-and-routing/).

## 2\. Входы и страницы тегов

### `theme.tags.enabled`

*   **Тип:** `boolean`.
*   **Стандарт темы:** `true`.
*   **Действие:** входы, каталог, списки тегов, ссылки тегов карточек/статей.
*   **Состояние:** действует.
*   **Ограничения:** false не удаляет tags frontmatter, статьи или старые размещённые файлы. Не фильтрует общий блог по тегу. Быстрый вход блога требует настоящих тегов языка; включённый пустой каталог показывает подсказку.

```ts
theme: { tags: { enabled: false } },
```

Источник — массив `tags` frontmatter, реестра site.config нет. Крайние пробелы удаляются, пустые элементы отбрасываются, повторы одной статьи объединяются; Astro/astro различаются.

Каталог сортируется по количеству статей убыванием, затем по строке тега. Специальные символы, китайский, зарезервированные/длинные имена имеют стабильное кодирование: используйте ссылки страницы. Переименование меняет URL без сохранения старого.

Карточка показывает максимум два тега без настройки количества. Это не ограничение числа тегов статьи или регистрации всех действительных тегов каталогом.

## 3\. Окно номеров и быстрый переход

### `theme.pagination.windowSize`

*   **Тип:** `number`.
*   **Стандарт темы:** `7`.
*   **Действие:** выбор видимых номеров, границ и многоточий, не число статей.
*   **Состояние:** условно при более одной странице.
*   **Ограничения:** нормальные числа округляются вниз и ограничиваются 5–21. Это параметр стратегии окна, не гарантия точной суммы всех номеров/предыдущей/следующей/многоточий. Используйте конечное целое.

### `theme.pagination.showJumpThreshold`

*   **Тип:** `number`.
*   **Стандарт темы:** `12`.
*   **Действие:** форма при числе страниц строго больше порога и jump.enabled true.
*   **Состояние:** условно.
*   **Ограничения:** округление вниз и минимум 1. При 12 страницах стандартно скрыта, при 13 видна. Не порог статей, 0 не означает безусловный показ.

### `theme.pagination.jump.enabled`

*   **Тип:** `boolean`.
*   **Стандарт темы:** `true`.
*   **Действие:** разрешает форму перехода.
*   **Состояние и ограничения:** условно, нужен превышенный порог. false удаляет форму, не номера/ссылки. Интерактивному переходу нужен JavaScript, обычным ссылкам нет.

### `theme.pagination.jump.enterToGo`

*   **Тип:** `boolean`.
*   **Стандарт темы:** `true`.
*   **Действие:** Enter в поле перехода.
*   **Состояние и ограничения:** только при форме. false блокирует Enter, кнопка остаётся. Клиент удаляет нецифровые символы, ограничивает цель реальным диапазоном, не позволяет произвольный URL.

Общий пример:

```ts
theme: {
  pagination: {
    windowSize: 9,
    showJumpThreshold: 8,
    jump: { enabled: true, enterToGo: false },
  },
},
```

То же поведение у Fragments, но размер заметок задаётся его pageSize. Настройка не ограничена одним тегом.

## 4\. Стратегия вида пагинации

### `theme.pagination.style.enabled`

*   **Тип:** `boolean`.
*   **Стандарт темы:** `true`.
*   **Действие:** варианты контейнера/кнопок номеров.
*   **Состояние и ограничения:** условно; false использует базовый вариант 1, не удаляет пагинацию/статьи и не выключает Cyberpunk всей страницы. Не управляет случайным цветом карточек/Cards/List.

### `theme.pagination.style.mode`

*   **Тип:** `'random' | 'sequential' | 'fixed'`.
*   **Стандарт темы:** `'random'`.
*   **Действие:** выбор вариантов вида.
*   **Состояние и ограничения:** условно при style.enabled true. Три режима:

| Режим | Текущее поведение |
| --- | --- |
| random | Стабильный начальный вариант сборки; клиент заново случайно выбирает контейнер/кнопки, с повторами, не постоянной анимацией |
| sequential | Контейнер по номеру страницы, кнопки по своим индексам; цвета могут различаться, не смена по времени |
| fixed | Контейнер и кнопки используют один fixedVariant |

Без JavaScript остаётся начальный статический HTML-стиль, клиентская случайность не работает.

### `theme.pagination.style.variants`

*   **Тип:** `number`.
*   **Стандарт темы:** `9`.
*   **Действие:** количество выбираемых вариантов 1…N, не массив и не число глобальных тем.
*   **Состояние и ограничения:** условно, нормальные значения округляются вниз/ограничиваются 1–12. Но общие неоновые цвета определены только 1–9; 10–12 не три дополнительные полные палитры и могут наследовать базовый цвет. Рекомендуется 1–9, обычно стандартные 9. Это описание диапазона, не новая цветовая функция.

### `theme.pagination.style.fixedVariant`

*   **Тип:** `number`.
*   **Стандарт темы:** `1`.
*   **Действие:** номер fixed-варианта.
*   **Состояние и ограничения:** условно, округляется вниз и ограничивается 1…variants. Не фиксирует random/sequential. Полные неоновые цвета рекомендуются 1–9. Конечное целое.

Например, второй вариант:

```ts
theme: {
  pagination: {
    style: { enabled: true, mode: 'fixed', variants: 9, fixedVariant: 2 },
  },
},
```

Для базового вида объедините `theme: { pagination: { style: { enabled: false } } }`. Выберите один нужный пример, не копируйте оба подряд для взаимного перезаписывания.

## 5\. Заголовки, описания и пагинация

Префикс `i18n.locales.<locale>.messages.blog`, необязательные `string`, условны при соответствующей области. Стандарт — встроенные тексты/откат; ниже настоящие упрощённый китайский/английский, у других свои.

| Поле | Стандарт упрощённого китайского / английского | Действие и ограничения |
| --- | --- | --- |
| `title` | 博客 / Blog | Title первой страницы/скрытый заголовок секции, не заголовок статьи и не фиксированная кнопка переключения |
| `pageTitle` | 博客 - 第 / Blog - Page | Префикс title последующих страниц блога/тега; код добавляет номер, не обрабатывает custom-маркеры |
| `archiveDescription` | 关于 AI 时代开发、Web 工程与系统架构的文章。 / Essays on AI-era craft, web engineering, and system architecture. | Метаописание первой страницы/каталога тегов, не сниппеты карточек |
| `pageDescription` | 博客归档页 / Blog archive page | Префикс метаописания последующих страниц с номером/точкой; не то же место описания списка тега |

```ts
i18n: {
  locales: {
    ru: {
      messages: {
        blog: {
          title: 'Архив статей',
          pageTitle: 'Архив статей — страница',
          archiveDescription: 'Проекты, чтение и учебные заметки.',
          pageDescription: 'Страница архива статей',
        },
      },
    },
  },
},
```

Тот же префикс и тип string для пагинации:

| Поле | Стандарт упрощённого китайского / английского | Действие и ограничения |
| --- | --- | --- |
| `previous` | 上一页 / Previous | Видимый текст/доступное имя предыдущей, скрыта на первой |
| `next` | 下一页 / Next | Видимый текст/доступное имя следующей, скрыта на последней |
| `paginationAria` | 分页导航 / Pagination | Доступное имя nav, не крупный видимый заголовок |
| `jumpTo` | 跳转到页 / Jump to page | Текст рядом с вводом, только при условиях формы |
| `jumpInputLabel` | 页码 / Page number | Скрытый доступный label, не формат ввода |
| `jumpGo` | 跳转 / Go | Надпись submit, не целевой путь |

Общие для тегов и Fragments. В blog-пути пустые jumpTo/jumpInputLabel/jumpGo имеют дополнительный английский fallback, в tag-пути передаются напрямую. Не используйте пустоту для межстраничного скрытия; отключайте jump.enabled и сохраняйте понятные имена.

```ts
i18n: {
  locales: {
    ru: {
      messages: {
        blog: {
          previous: 'Предыдущая страница',
          next: 'Следующая страница',
          paginationAria: 'Пагинация статей',
          jumpTo: 'Перейти на страницу',
          jumpInputLabel: 'Номер страницы',
          jumpGo: 'Перейти',
        },
      },
    },
  },
},
```

## 6\. Каталог тегов и общие входы

Тот же `i18n.locales.<locale>.messages.blog`, необязательные string со стандартным откатом. Действуют при соответствующей области:

| Поле | Стандарт упрощённого китайского / английского | Действие и ограничения |
| --- | --- | --- |
| `tags` | 标签 / Tags | Вход/каталог/заголовок списка и доступность, не реальные теги или slug |
| `allPosts` | 全部文章 / All posts | Возврат ко всем статьям, также пояснение главной, не количество |
| `noTags` | 暂无标签 / No tags yet. | Пустой каталог тегов, не отсутствие статей |
| `taggedPosts` | 文章 / Posts | Пояснение числа статей тега/описание страницы, не ручной счётчик |

```ts
i18n: {
  locales: {
    ru: {
      messages: {
        blog: {
          tags: 'Просмотр по тегам',
          allPosts: 'Вернуться ко всем статьям',
          noTags: 'Пока нет тегов для просмотра.',
          taggedPosts: 'статей',
        },
      },
    },
  },
},
```

Очистка не отключает функции и может оставить пустые ссылки/описания. Для отключения — theme.tags.enabled, не false/пустота текста tags.

## 7\. Cards/List, обложки и границы

Текущее поведение, не новые поля:

*   Blog и список тега делят Cards/List. Без памяти стандарт cards; JavaScript переключает, localStorage с общим ключом сохраняет выбор между блогом, тегами и языками. Без хранилища переключение работает без гарантии памяти.
*   Нет site.config для начального вида, отключения переключателя, его текста, имён колонок или цветов. Переключатель/архивная полоса имеют встроенные таблицы языков компонентов, custom-язык без записи получает английский; messages.blog.title их не меняет.
*   Карточки показывают заголовок, дату, обложку и до двух тегов. Нет включения сниппета, числа приоритетных обложек или порядка updatedDate. Изменение метаописания списка не делает description сниппетом.
*   Первые две реальные обложки-кандидата eager/high, остальные lazy. Скрытие обложек List не гарантирует отсутствия скачивания. [Подготовка/объём изображений](https://demo.anglefeint.com/ru/blog/starter-guide-images/).
*   Языковой переход основного блога сохраняет номер при его наличии, иначе первая страница. Для тега ищет тот же текст тега: первая страница тега или каталог языка при отсутствии. Перевода тегов/синонимов нет.
*   Число статей главной/проход — в [главной](https://demo.anglefeint.com/ru/blog/config-home/). Навигация, поиск, подвал и комментарии здесь не переопределяются.

Отдельных совместимых полей списка не найдено. Не считайте blogView/showExcerpt/cardTheme поддерживаемыми. Произвольный ключ не включает ненастраиваемый вид.

## Как проверить изменения?

В dev проверьте первую/следующую страницы блога, каталог тегов и один список тега. Для быстрого перехода нужно достаточно страниц; различайте fixed/random. Метаописание проверяется в head, скрытые labels/доступные имена не определяются крупными надписями.

После размера списка или имени тега пересоберите и полностью разместите, убрав остатки старых страниц/тегов. Перед публикацией остановите dev, выполните npm run doctor, затем npm run preview. doctor содержит сборку, сразу повторять check/build не нужно. [Установка](https://demo.anglefeint.com/ru/blog/starter-guide-1-configure-your-site/) и [размещение](https://demo.anglefeint.com/ru/blog/starter-guide-deployment/).
