Change docs theme #15
Conversation
| @@ -73,7 +73,7 @@ | |||
|
|
|||
| html_theme = 'basicstrap' | |||
| html_theme_options = { | |||
| 'sidebar_span': 1, | |||
| 'sidebar_span': 2, | |||
| } | |||
There was a problem hiding this comment.
Да надо тему менять, эта что-то не очень оказалась. И с сайдбаром эти заморочки, и отцентрировать её нельзя. Настроек добрых нет.
Насколько помню, брал её только потому что всякие сноски типа (!) Important у basicstrap на мой вкус не вырвиглазно выглядели, а у нас их много, у каждого метода API Note написан https://cybsi-cloud-sdk.readthedocs.io/en/latest/api.html#cybsi.cloud.auth.APIKeysAPI.filter.
Сноски называются Admonitions.
У Alabaster эти Admonitions оформлены совершенно никак, у read the docs сильно токсично.
Furo вроде прикольная, можно её попробовать. Book/Press тоже ничего.
https://sphinx-themes.readthedocs.io/en/latest/sample-sites/furo/kitchen-sink/admonitions/
В общем, выбирай :) https://sphinx-themes.readthedocs.io/en/latest/
Можно у cybsi-sdk и cybsi-cloud-sdk разные темы сделать, кмк, это прикольно будет, а то они сейчас слишком похожи друг на друга.
There was a problem hiding this comment.
Хотя хз, мб и 'sidebar_span': 2 норм фикс. Меня смущало, что лого половину экрана занимает, но мб и пофиг. Зато список слева не обрезается.
В общем, резолви или меняй что-то на свой вкус, мне любой вариант ок.
There was a problem hiding this comment.
А мне приглядывались темы, да, на book положил взгляд. Узнал что их несколько сегодня).
Хорошо, поиграюсь с этим.
There was a problem hiding this comment.
А если такую тему использовать? Это book. Давай пока её оставлю.
There was a problem hiding this comment.
Странно, что содержимое левого сайдбара повторяет содержимое правого, а в целом классно.
There was a problem hiding this comment.
"localtoc.html" в html_sidebars, наверное, просто лишний. Хз, какой каноничный набор у book в html_sidebars.
There was a problem hiding this comment.
А да, я отключал его. Забыл закомитить. В общем я убрал этот сайдбар справа
There was a problem hiding this comment.
Здесь выявилось, что readthedocs свою рекламу транслирует в документации. Но это внизу страницы на панели слева.
Попробовал убрать его, но пока безрезультатно
Может забить на эту рекламу, она вроде небольшая? Или вернуть лучше прошлую тему, там вроде нет шаблона в разметке страница, чтобы реклама встраивалась.
There was a problem hiding this comment.
У тебя adblock не установлен что ли? :) У меня рекламы нет.
А вообще пусть будет, почему нет, пусть readthedocs зарабатывают, доброе дело же делают, что хостят документацию.
There was a problem hiding this comment.
На самом деле стоит=)) Она иногда появляется иногда нет. Оставляю тогда эту тему)
perastov
force-pushed
the
fix-docs-sidebar
branch
4 times, most recently
from
4749c4a to
04c4686
Compare
perastov
force-pushed
the
fix-docs-sidebar
branch
2 times, most recently
from
008dde8 to
ae057f1
Compare
perastov
force-pushed
the
fix-docs-sidebar
branch
from
ae057f1 to
340360d
Compare
Откатил обратно размер сайд панели. Так как совсем сжало навигацию.
Сейчас вот так. Единственное лого стало старого размера.