Справочник настроек: Blog List и списки тегов
Размер списка, теги, пагинация, тексты и границы Cards/List.
На этой странице
Примечание о версии: Строгая проверка blogPageSize доступна с 0.36.1 и отсутствует в 0.36.0. В старых версиях также указывайте разумное положительное целое.
Назад к общему справочнику. Статья охватывает архив блога, каталог тегов, статьи тега и общую пагинацию. Код темы авторитетен; количество статей/цвета 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; каталог тегов сам по этому полю не пагинируется.
theme: { blogPageSize: 12 },
Пустой блог всё равно создаёт первую страницу; при одной пагинация скрыта. После смены размера пересоберите и разместите. Старшие номера могут исчезнуть без автоматических перенаправлений.
Сортировка не по updatedDate, имени или просмотрам. draft/будущее не фильтруются, поля порядка нет. См. статьи.
2. Входы и страницы тегов
theme.tags.enabled
- Тип:
boolean. - Стандарт темы:
true. - Действие: входы, каталог, списки тегов, ссылки тегов карточек/статей.
- Состояние: действует.
- Ограничения: false не удаляет tags frontmatter, статьи или старые размещённые файлы. Не фильтрует общий блог по тегу. Быстрый вход блога требует настоящих тегов языка; включённый пустой каталог показывает подсказку.
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.
Общий пример:
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. Конечное целое.
Например, второй вариант:
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 | Префикс метаописания последующих страниц с номером/точкой; не то же место описания списка тега |
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 и сохраняйте понятные имена.
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 | Пояснение числа статей тега/описание страницы, не ручной счётчик |
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 не гарантирует отсутствия скачивания. Подготовка/объём изображений.
- Языковой переход основного блога сохраняет номер при его наличии, иначе первая страница. Для тега ищет тот же текст тега: первая страница тега или каталог языка при отсутствии. Перевода тегов/синонимов нет.
- Число статей главной/проход — в главной. Навигация, поиск, подвал и комментарии здесь не переопределяются.
Отдельных совместимых полей списка не найдено. Не считайте blogView/showExcerpt/cardTheme поддерживаемыми. Произвольный ключ не включает ненастраиваемый вид.
Как проверить изменения?
В dev проверьте первую/следующую страницы блога, каталог тегов и один список тега. Для быстрого перехода нужно достаточно страниц; различайте fixed/random. Метаописание проверяется в head, скрытые labels/доступные имена не определяются крупными надписями.
После размера списка или имени тега пересоберите и полностью разместите, убрав остатки старых страниц/тегов. Перед публикацией остановите dev, выполните npm run doctor, затем npm run preview. doctor содержит сборку, сразу повторять check/build не нужно. Установка и размещение.