Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Technical Portfolio
GitHub & GitVerse Pages

5. Публикация сайта

SQL Lab in JupyterLab

Data & BI Analyst

Abstract

Публикуем книгу Jupyter на GitHub Pages с помощью GitHub Actions.

Для этого необходимо включить GitHub Pages и установить в качестве источника GitHub Actions:

  1. Открыть репозиторий на сайте GitHub.

  2. В верхнем горизонтальном меню репозитория перейти во вкладку Settings.

  3. В левой боковой панели найти раздел Code and automation.

  4. Выбрать пункт Pages.

  5. В центре экрана найти блок Build and deployment.

  6. Внутри этого блока найти выпадающий список под заголовком Source.
    По умолчанию там обычно выбрано Deploy from a branch.


5.1. Создание файла автоматизации

Jupyter Book имеет под капотом команду, которая сама создает файл автоматизации GitHub Actions .github/workflows/deploy.yml для развертывания сайта на GitHub Pages:

# > Git Bash: (ds-book)
# > YOUR_USERNAME@COMPUTER MINGW64 /d/GitHub/Books/Learning-SQL (main)

# Создаем автодеплой на GitHub Pages
jupyter book init --gh-pages

# Отвечаем на вопросы утилиты (ветка: main, имя экшена: deploy.yml)
# ? What branch would you like to deploy from? --> main
# ? What would you like to call the action? --> deploy.yml

5.2. Отправка изменений на GitHub

Осталось добавить сгенерированный .github/workflows/deploy.yml в список отслеживаемых файлов, закоммитить и запушить на GitHub

# > Git Bash: (ds-book)
# > YOUR_USERNAME@COMPUTER MINGW64 /d/GitHub/Books/Learning-SQL (main)

git add .
git commit -m "chore: add github actions deploy workflow"
git push