GitHub Pages 정보

GitHub Pages 정보

GitHub Pages는 GitHub AE의 리포지토리에서 HTML, CSS 및 JavaScript 파일을 직접 가져와서 필요에 따라 빌드 프로세스를 통해 파일을 실행하고 웹 사이트를 게시하는 정적 사이트 호스팅 서비스입니다. GitHub Pages 사이트의 예는 GitHub Pages 예제 컬렉션에서 확인할 수 있습니다.

시작하려면 "GitHub Pages 사이트 만들기"을 참조하세요.

GitHub Pages 사이트 유형

GitHub Pages 사이트에는 프로젝트, 사용자 및 조직, 이렇게 세 가지 유형이 있습니다. 프로젝트 사이트는 JavaScript 라이브러리 또는 레시피 컬렉션과 같이 GitHub AE에서 호스트되는 특정 프로젝트에 연결됩니다. 사용자 및 organization 사이트는 GitHub AE의 특정 계정에 연결됩니다.

사용자 사이트를 게시하려면 <username>.<hostname>이라는 개인 계정이 소유한 리포지토리를 만들어야 합니다. 조직 사이트를 게시하려면 <organization>.<hostname>이라는 조직이 소유한 리포지토리를 만들어야 합니다. 사용자 및 조직 사이트는 http(s)://pages.<hostname>/<username> 또는 http(s)://pages.<hostname>/<organization>에서 사용할 수 있습니다.

프로젝트 사이트의 원본 파일은 프로젝트와 동일한 리포지토리에 저장됩니다. 프로젝트 사이트는 http(s)://pages.<hostname>/<username>/<repository>/ 또는 http(s)://pages.<hostname>/<organization>/<repository>/에서 사용할 수 있습니다.

GitHub AE에서 각 계정에 대해 하나의 사용자 또는 조직 사이트만 만들 수 있습니다. 조직 또는 개인 계정이 소유하든 관계 없이 프로젝트 사이트는 무제한입니다.

GitHub Pages 사이트에 대한 원본 게시

GitHub Pages 사이트는 변경 내용이 특정 분기로 푸시될 때마다 게시됩니다. 게시 원본으로 사용할 분기 및 폴더를 지정할 수 있습니다. 원본 분기는 리포지토리의 모든 분기일 수 있으며 원본 폴더는 원본 분기에 있는 리포지토리(/)의 루트이거나 원본 분기의 /docs 폴더일 수 있습니다. 변경 내용이 원본 분기로 푸시될 때마다 원본 폴더의 변경 내용이 GitHub Pages 사이트에 게시됩니다.

자세한 내용은 "GitHub Pages 사이트에 대한 게시 원본 구성"을 참조하세요.

정적 사이트 생성기

GitHub Pages는 리포지토리에 푸시하는 정적 파일을 게시합니다. 사용자 고유의 정적 파일을 만들거나 정적 사이트 생성기를 사용하여 자동으로 사이트를 빌드할 수 있습니다. 로컬 또는 다른 서버에서 사용자 고유의 빌드 프로세스를 사용자 지정할 수도 있습니다.

GitHub Pages 및 간소화된 빌드 프로세스를 기본적으로 지원하는 정적 사이트 생성기인 Jekyll을 사용하는 것이 좋습니다. 자세한 내용은 "GitHub Pages 및 Jekyll 정보"을 참조하세요.

GitHub Pages는 기본적으로 Jekyll을 사용하여 사이트를 빌드합니다. Jekyll 이외의 정적 사이트 생성기를 사용하려면 게시 원본의 루트에서 .nojekyll하는 빈 파일을 만들어 Jekyll 빌드 프로세스를 사용하지 않도록 설정한 다음 정적 사이트 생성기의 지침에 따라 사이트를 로컬로 빌드합니다.

GitHub Pages에서는 PHP, Ruby 또는 Python과 같은 서버 쪽 언어를 지원하지 않습니다.

GitHub Pages의 사용 제한

GitHub Pages는 온라인 비즈니스, 전자 상거래 사이트 또는 상업적 거래를 촉진하거나 SaaS(Software as a Service)를 제공하는 데 주로 사용되는 다른 웹 사이트를 실행하기 위한 무료 웹 호스팅 서비스로 사용할 수 없습니다. GitHub Pages 사이트는 암호 또는 신용 카드 번호 전송과 같은 중요한 트랜잭션에 사용하면 안 됩니다.

또한 GitHub Pages의 사용에는 풍부한 구성표, 외설적인 콘텐츠, 폭력적이거나 위협적인 콘텐츠 또는 활동에 대한 제한을 포함하여 GitHub 서비스 약관이 적용됩니다.

사용 제한

GitHub Pages 사이트에는 다음과 같은 사용 제한이 적용됩니다.

• GitHub Pages 원본 리포지토리의 권장 제한은 1GB입니다. 을 참조하세요.
• 게시된 GitHub Pages 사이트는 1GB 이하일 수 있습니다.
• GitHub Pages 배포는 10분 이상 걸리는 경우 시간 초과됩니다.

GitHub Pages의 MIME 형식

MIME 형식은 서버가 브라우저로 보내는 헤더로, 브라우저에서 요청한 파일의 특성 및 형식에 대한 정보를 제공합니다. GitHub Pages는 수천 개의 파일 확장명 중 750개 이상의 MIME 형식을 지원합니다. 지원되는 MIME 형식 목록은 mime-db 프로젝트에서 생성됩니다.

파일별 또는 리포지토리별로 사용자 지정 MIME 형식을 지정할 수는 없지만 GitHub Pages에서 사용할 MIME 형식을 추가하거나 수정할 수 있습니다. 자세한 내용은 mime-db 기여 지침.

추가 참고 자료

• GitHub Skills의 GitHub Pages
• "리포지토리"