Как собрать документы в одной ветке и автоматически скопировать build / html в ветку gh-pages

Question

Github хранит веб-сайты проекта в отдельной ветке (gh-pages) репозитория проекта. У нас есть основной пакет sphinx, который создает наши документы и мы хотим автоматически зафиксировать сгенерированные документы в ветке gh-pages.

Конфигурация Sphinx и источник не могут быть в самой ветви gh-pages, потому что эта ветвь содержит только html. Если мастер не выполнил версию html, то это будет видно (используйте .git ignore, как показано здесь Как я могу зафиксировать конкретный каталог в отличной от рабочей ветке в git? ). Что будет, если это версия.

Я хочу напечатать make publish и заставить его создавать документы (у нас это уже есть как цель make), а затем применить эти изменения к ветви gh-pages (фактически)).

Проблема в том, что gh-pages фактически является содержимым doc / build / html, поэтому стандартное слияние может не сработать.

сохранение изменений, изменение веток и применение результатов в конфликтах, и, похоже, нет способа указать стратегию слияния --ours.

Объединение поддеревьев и такие методы, по-видимому, предназначены для объединения внешних репозиториев, а не вещей в одном репо.

Answer 1

Я нашел эти шаги очень полезны для публикации в другой ветке, такой как gh-pages.Есть несколько других скриптов, которые вы можете найти в Google, но этот, кажется, написан более четко.

Обычно выполняются следующие шаги: - добавьте ваш текущий outdir в .gitignore - клонируйте весь репозиторий в outdir, чтобы инициировать .git там, очистите его и сделайте ветку gh-pages - сделайте сборку, котораявы нажимаете из outdir.

Вы можете следовать коду, который использует две отдельные папки для master и gh-pages здесь , комментарии на русском языке, но команды довольно понятны.

Answer 2

вы можете создать ветку, которая будет пустой и в которой вы сможете фиксировать только свои HTML. просто следуйте инструкциям на страницах github для "Project Pages" из здесь .