chore: edit theme overrides
All threads resolved!
All threads resolved!
Описание
Внесены изменения в содержимое папки 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
Merge request reports
Activity
assigned to @a.sabirov
mentioned in issue #186 (closed)
added 15 commits
-
c12a979e...642e9e6d - 10 commits from branch
main
- 62f08d05 - chore: create .custom and .icons in overrides
- 472d3e78 - header.html: delete unnecessary code
- 124a2c52 - chore: add overrides/partials/source.html
- edc929b6 - style.css: override .md-nav__source and .md-source__repository
- b44a583f - style.css: major edits
Toggle commit list-
c12a979e...642e9e6d - 10 commits from branch
requested review from @a.tolstoy
added 6 commits
-
95104b1b - 1 commit from branch
main
- 8285331a - chore: create .custom and .icons in overrides
- 67f6196e - header.html: delete unnecessary code
- 4681f836 - chore: add overrides/partials/source.html
- 8c223f98 - style.css: override .md-nav__source and .md-source__repository
- be0878d5 - style.css: major edits
Toggle commit list-
95104b1b - 1 commit from branch
- Resolved by Alexander Tolstoy
- Resolved by Artur Sabirov
- Resolved by Artur Sabirov
added 2 commits
added 9 commits
-
cc22db0c...095d2016 - 3 commits from branch
main
- 30aa0fd4 - chore: create .custom and .icons in overrides
- 684a0880 - header.html: delete unnecessary code
- e642fba9 - chore: add overrides/partials/source.html
- f5eb5b91 - style.css: override .md-nav__source and .md-source__repository
- dd694d26 - style.css: major edits
- 120a0932 - logo.svg: fix color
Toggle commit list-
cc22db0c...095d2016 - 3 commits from branch
Please register or sign in to reply