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

Около 2 минКонфигКонфиг темыВнешний вид

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

Примечание

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

iconAssets Только root

  • Тип: FontIconAssets

    type Link = `//${string}` | `http://${string}` | `https://${string}`;
    
    export type FontIconAssets =
      | "iconfont"
      | "fontawesome"
      | "fontawesome-with-brand"
      | Link
      | Link[];
    
  • Обязательный: Нет

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

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

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

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

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

Заметка

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

themeColor Только root

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

fullscreen Только root

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

backToTop Только root

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

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

mobileBreakPoint Только root

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

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

Примечание

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

wideBreakPoint Только root

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

Window width switching wide screen view and desktop view in pixels

Примечание

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

pure Только root

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

Совет

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

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

print Root only

  • Type: boolean
  • Default: true

Whether display print icon in desktop mode.

iconPrefix Только root

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