Опции внешнего вида темы

Следующие параметры управляют внешним видом темы. В большинстве случаев на них не нужно обращать внимание, они предусмотрены лишь для небольшого количества пользователей с потребностями.

Примечание

Эти параметры действительны только при установке непосредственно под параметрами темы, установка их на каждом языке не влияет.

iconAssets Только root

• Тип: FontIconAssets

  type Link =
    | `/${string}`
    | `//${string}`
    | `http://${string}`
    | `https://${string}`;
  
  type BuiltInFontIcon =
    | "iconify"
    | "iconfont"
    | "fontawesome"
    | "fontawesome-with-brands";
  
  type FontIconAssets = BuiltInFontIcon | Link | (BuiltInFontIcon | Link)[];
  

• Обязательный: Нет

• Детали: Интерфейс → Иконка

Поддерживается ссылка на ресурс иконки шрифта, ключевые слова 'iconfont' и 'fontawesome'.

darkmode Включено по умолчанию Только root

• Тип: "switch" | "toggle" | "auto" | "enable" | "disable"
• По умолчанию: "switch"
• Детали: Интерфейс → Темный режим

Варианты поддержки темного режима:

• "switch": переключение между темным, светлым и авто
• "toggle": переключение между светлым и темным режимами
• "auto": автоматически решать, применять ли темный режим на основе цветовой схемы пользовательского устройства или текущего времени
• "enable": только темный режим
• "disable": отключить темный режим

Заметка

Если вам не нужна эта функция, установите darkmode: "disable", чтобы отключить ее.

themeColor Только root

• Тип: Record<string, string> | false
• По умолчанию: false
• Детали: Интерфейс → Цвет темы

Конфигурация цвета темы.

fullscreen Только root

• Тип: boolean
• По умолчанию: false
• Детали: Интерфейс → Кнопка «Полноэкранный режим»

Показывать ли кнопку «полноэкранный режим».

backToTop Только root

• Тип: boolean | number
• По умолчанию: true
• Детали: Интерфейс → Кнопка «Наверх»

Показывать ли кнопку «Вернуться к началу».

Расстояние срабатывания по умолчанию составляет 300 пикселей, которое можно изменить, указав число. Заполнение false отключает кнопку «Наверх».

mobileBreakPoint Только root

• Тип: number
• По умолчанию: 719

Ширина окна при переключении мобильного представления и представления рабочего стола в пикселях

Примечание

Вы должны оставить для этой опции то же значение, что и для $tablet в .vuepress/config.scss

pcBreakPoint Только root

• Тип: number
• По умолчанию: 1440

Ширина окна при переключении широкоэкранного режима и режима рабочего стола в пикселях

Примечание

Вы должны оставить для этой опции то же значение, что и для $pc в .vuepress/config.scss

pure Только root

• Тип: boolean
• По умолчанию: false
• Детали: Интерфейс → Чистый режим

Включить ли чистый режим.

Совет

Включение этого отключит некоторые причудливые стили.

Полезно, когда вы хотите предоставить «Сайт с чистой документацией».

print Только root

• Тип: boolean
• По умолчанию: true

Отображать ли значок печати в режиме рабочего стола.

iconPrefix Только root

• Тип: string
• По умолчанию: Выводится из iconAssets
• Детали: Интерфейс → Иконка

Префикс значка FontClass， обычно он может быть автоматически установлен темой.