Примеры сайтов GitHub Pages можно посмотреть в коллекции примеров GitHub Pages.
Чтобы приступить к работе, см. раздел Создание сайта GitHub Pages.
Владельцы организации могут отключить публикацию сайтов GitHub Pages из репозиториев организации.
Дополнительные сведения см. в разделе Управление публикацией сайтов GitHub Pages для организации.
Типы сайтов GitHub Pages Существует три типа сайтов GitHub Pages: сайт проекта, сайт пользователя и сайт организации.
Сайты проектов подключаются к определенным проектам, размещенным в GitHub Enterprise Server, таким как библиотека JavaScript или коллекция рецептов.
Сайты пользователей и организаций подключены к определенной учетной записи в экземпляр GitHub Enterprise Server. Чтобы опубликовать сайт пользователя, необходимо создать репозиторий, принадлежащий вашей личной учетной записи с именем <username>.<hostname>
. Чтобы опубликовать сайт организации, необходимо создать репозиторий, принадлежащий организации с именем <organization>.<hostname>
.
Исходные файлы для сайта проекта хранятся в том же репозитории, что и проект.
Для каждой учетной записи в GitHub Enterprise Server можно создать только один сайт пользователя или организации. Сайты проектов, принадлежащие учетной записи организации или личной учетной записи, не ограничены.
URL-адрес, по которому доступен сайт, зависит от того, включена ли изоляция поддомена для экземпляр GitHub Enterprise Server. Тип сайта
Изоляция поддомена включена
Изоляция поддомена отключена | Пользователь | План |
---|---|---|
Сайт проекта, принадлежащий личной учетной записи | http(s)://pages.<hostname>/<username> | http(s)://<hostname>/pages/<username> |
Сайт проекта, принадлежащий учетной записи организации | http(s)://pages.<hostname>/<organization> | http(s)://<hostname>/pages/<organization> |
Дополнительные сведения см. в разделе Включение изоляции поддомена или обратитесь к администратору сайта. | http(s)://pages.<hostname>/<username>/<repository>/ | http(s)://<hostname>/pages/<username>/<repository>/ |
http(s)://pages.<hostname>/<orgname>/<repository>/ | http(s)://<hostname>/pages/<orgname>/<repository>/ |
Источники публикации для сайтов GitHub Pages
Предупреждение. Если администратор сайта включил "Общедоступные страницы", сайты GitHub Pages по умолчанию находятся в открытом доступе, даже если репозиторий для сайта является частным или внутренним. Если в репозитории вашего сайта есть конфиденциальные данные, удалите их перед публикацией. Дополнительные сведения см. в разделах Настройка GitHub Pages для предприятия и Сведения о репозиториях.
Ваш сайт GitHub Pages будет публиковаться при каждой отправке изменений в определенную ветвь. Можно указать, какую ветвь и папку следует использовать в качестве источника публикации. Исходной ветвью может стать любая ветвь репозитория, а исходной папкой может быть либо корень репозитория (/
), либо папка /docs
в исходной ветви. После отправки изменений в исходную ветвь изменения в исходной папке будут опубликованы на вашем сайте GitHub Pages.
Дополнительные сведения см. в разделе Настройка источника публикации для сайта GitHub Pages.
Генераторы статических сайтов GitHub Pages публикует все статические файлы, которые вы отправляете в свой репозиторий.
Вы можете создать собственные статические файлы или использовать генератор статических сайтов для создания сайта.
Вы также можете настроить собственный процесс сборки локально или на другом сервере. Мы рекомендуем использовать Jekyll, генератор статических сайтов со встроенной поддержкой GitHub Pages и упрощенным процессом сборки.
Дополнительные сведения см. в разделе Сведения о GitHub Pages и Jekyll.
GitHub Pages будет использовать Jekyll для создания сайта по умолчанию. Если вы хотите использовать другой генератор статических сайтов, отключите процесс сборки Jekyll, создав пустой файл с именем .nojekyll
в корне вашего источника публикации, а затем следуйте инструкциям вашего генератора статических сайтов, чтобы создать сайт локально.
GitHub Pages не поддерживает серверные языки, такие как PHP, Ruby или Python.
Ограничения на использование GitHub Pages
Не предусмотрено и не разрешается использование GitHub Pages в качестве бесплатной службы веб-размещения для запуска бизнеса в Интернете, сайта электронной коммерции и любого другого веб-сайта, в первую очередь направленного либо на коммерческие транзакции, либо на предоставление коммерческого программного обеспечения как услуги (SaaS).
Сайты GitHub Pages не должны использоваться для конфиденциальных транзакций, таких как отправка паролей или номеров кредитных карт.
Кроме того, использование GitHub Pages регулируется условиями предоставления услуг GitHub, включающими ограничения на схемы быстрого обогащения, материалы непристойного сексуального характера, а также материалы или действия, содержащие насилие или угрозы. Ограничения использования
На сайты GitHub Pages распространяются следующие ограничения использования.
Для исходных репозиториев GitHub Pages рекомендуется использовать ограничение в 1 ГБ.
Размер опубликованного сайта GitHub Pages не может превышать 1 ГБ.
Типы MIME в GitHub Pages
Тип MIME — это заголовок, который сервер отправляет в браузер, предоставляя сведения о характере и формате файлов, запрошенных браузером.
GitHub Pages поддерживает более 750 типов MIME в тысячах расширений файлов.
Список поддерживаемых типов MIME создается из проекта mime-db. Хотя вы не можете указывать специальные типы MIME на уровне файла или репозитория, вы можете добавлять или изменять типы MIME для использования в GitHub Pages. Дополнительные сведения см. в правилах по предложению улучшений в mime-db.
Дополнительные материалы GitHub Pages в GitHub Skills
"Репозитории"
GitHub Pages on GitHub Skills - "
Репозитории "