chore: edit theme overrides
Описание
Внесены изменения в содержимое папки overrides
и в файл docs/extra/style.css
.
Основная таблица стилей сайта документации — файл main.4b4a2bd9.min.css из темы Material для MkDocs. See: !335 (comment 67897)
Изменения содержимого папки overrides
:
- извлек .icons/icon-mono.svg из partials/~picodata-link.html
- переименовал partials/~picodata-link.html -> .custom/source-picodata.html
- переименовал partials/~icon.html -> .custom/icon.html
- добавил шаблон partials/source.html
- синхронизировал .custom/source-picodata.html с шаблоном partials/source.html
- отредактировал partials/header.html и partials/nav.html
Новые переопределения таблицы стилей Material для MkDocs:
- селектор
.md-source__repository {max-width: 100%}
— убирает обрезание текста кнопки GitLab в хедере - директива
@media screen and (max-width: 59.984375em)
— мобильная версия сайта:- селектор
.md-nav__source {background-color: var(--md-default-bg-color)}
— устанавливает белый фон для кнопок GitLab и Picodata в панели навигации
- селектор
Общие изменения в файле `docs/extra/style.css`
docs/extra/style.css
Общие изменения в файле - удалил селекторы:
-
.btn
и все дочерние объекты -
.header-site
и все дочерние объекты .md-content
.md-search
.md-search__form input
.md-sidebar
.md-sidebar--secondary
.md-tabs
.md-tabs__link--active
[data-md-toggle=search]:checked~.md-header .md-search__form
-
- удалил директивы:
@media(min-width: 540px)
@media(min-width: 992px)
@media(min-width: 1400px)
@media screen and (max-width: 76.1875em)
- уточнил определения селекторов:
-
h1, h2, h3, h4, h5, h6
->.md-typeset h1, h2, h3, h4, h5, h6
-
.md-header__title
->[dir=ltr] .md-header__title
-
.md-header[data-md-state="shadow"]
->.md-header--shadow
-
- вынес селектор
.md-search__input::placeholder
из директивы@media screen and (min-width: 60em)
- переместил селектор в директиву
@media screen and (max-width: 76.234375em)
:.md-nav--primary .md-nav__title[for=__drawer]
.md-icon__mobile
Частные изменения в файле `docs/extra/style.css`
docs/extra/style.css
Частные изменения в файле - псевдокласс
:root
:- удалил переменные:
-
--bg
— взамен этой переменной и цветаwhite
использовал переменную--md-default-bg-color
--btn-gray-bg
--btn-gray-border
--btn-gray-hover-bg
--btn-gray-hover-border
--btn-red-bg
--btn-red-border
--btn-red-hover-bg
--btn-red-hover-border
-
- переименовал переменную
--tiny-gray
->--gray
- переместил переменную
--md-default-fg-color--light
в группу:root,[data-md-color-scheme=default]
- удалил переменные:
- селекторы
h4, h5, h6
:- удалил свойство
font-weight: 600 !important
- удалил свойство
- селектор
.md-header--shadow
:- переместил свойство
transition
из селектора.md-header--shadow
- удалил свойство
background-color: white
- переместил свойство
- селектор
.md-search__form
:- удалил свойство
color: var(--black)
— переопределяется далее - удалил свойство
border-radius: 26px
— переопределяется далее - удалил свойство
border-radius: .1rem
— дублирует стандартное значение - удалил свойства
height: 1.8rem
— дублирует стандартное значение
- удалил свойство
See:
- https://squidfunk.github.io/mkdocs-material/customization/#setup-and-theme-structure
- https://github.com/squidfunk/mkdocs-material/tree/master/src/templates/assets/stylesheets
- https://docs.picodata.io/picodata/stable/assets/stylesheets/main.4b4a2bd9.min.css
- Close #186 (closed)
- Target branch:
main
- Changes should be cherry-picked to 24.1: YES
- Staging: https://docs.binary.picodata.io/picodata/branch-edit-theme-overrides/
- See !312 (merged)
Edited by Artur Sabirov