Не совсем понятна формулировка. Базово -- это деплой с гитхаба с исполнением некоего локального скрипта? Как бы, с этим не видно никакой проблемы -- git co и все.
Видно проблема в следующем
\\joinrpg.readthedocs.org - вытягивает оттуда конфиг и .md файлы и компилит это в справку.
чем компилит?
\\Я сам все время утыкаюсь в то, что на винде все тулзы этой линии (Sphinx и миллион зависимостей)
а поподробнее? нужно еще и установить/настроить этот свинкс?
но тут непонятка какая-то. упомянутые там инструменты Сфинкс и Маркдаун нужны для сборки документации... но потом и править её лучше тоже в них...
гм
из того что понял ИМХО лучшее решение -- поднять виртуалку с Линуксом, под ним поставить тот Сфинкс как описано в гайде (проблем не должно быть, а если будут, то уже будет иметь смысл спрашивать), и оттуда же и заливать/редактиовать на гитхаб
я так понял суть проблемы -- поставить и настроить Сфинкс под Виндой? что в свою очередь сводится к вопросу инсталяции и разрешения траблов с -- pip? (судя по "винде все тулзы этой линии (Sphinx и миллион зависимостей) портированы чрезвычайно плохо.")
ИМХО подход с виртуалкой получается проще всего... если реально вылазят какие-то нереальные грабли на винде
Не нужен там постоянно работающий Сфинкс у пользователя. Сфинкс нужен чтобы проверить изначальные настройки и настроить визуальное оформление. После этого все настройки кладутся в тот же гитхаб что и документация и все это кормится RTD. Дальше можно настроить хук для гитхаба чтобы он дергал ручку у RTD и там вытягивалась новая версия и генерировался свежий html и обновлялись индексы Сфинкса.
Базово -- это деплой с гитхаба с исполнением некоего локального скрипта?
Как бы, с этим не видно никакой проблемы -- git co и все.
Видно проблема в следующем
\\joinrpg.readthedocs.org - вытягивает оттуда конфиг и .md файлы и компилит это в справку.
чем компилит?
\\Я сам все время утыкаюсь в то, что на винде все тулзы этой линии (Sphinx и миллион зависимостей)
а поподробнее?
нужно еще и установить/настроить этот свинкс?
а.
я так понял нужна помощь вот в этом -- https://docs.readthedocs.io/en/latest/install.html
не... не похоже
скорее вот (судя по желаемой ссылке) это -- https://docs.readthedocs.io/en/latest/getting_started.html
но тут непонятка какая-то.
упомянутые там инструменты Сфинкс и Маркдаун нужны для сборки документации...
но потом и править её лучше тоже в них...
гм
из того что понял
ИМХО лучшее решение -- поднять виртуалку с Линуксом,
под ним поставить тот Сфинкс как описано в гайде (проблем не должно быть, а если будут, то уже будет иметь смысл спрашивать),
и оттуда же и заливать/редактиовать на гитхаб
Reply
Reply
я так понял суть проблемы -- поставить и настроить Сфинкс под Виндой?
что в свою очередь сводится к вопросу инсталяции и разрешения траблов с -- pip?
(судя по "винде все тулзы этой линии (Sphinx и миллион зависимостей) портированы чрезвычайно плохо.")
ИМХО подход с виртуалкой получается проще всего... если реально вылазят какие-то нереальные грабли на винде
Reply
Reply
Reply
Leave a comment