Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.

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

GitHub Pages 사이트에 기본 게시 원본을 사용하는 경우 사이트가 자동으로 게시됩니다. 다른 분기 또는 폴더에서 사이트를 게시하도록 선택할 수도 있습니다.

이 기능을 사용할 수 있는 사용자

People with admin or maintainer permissions for a repository can configure a publishing source for a GitHub Pages site.

GitHub Pages는 GitHub Free 및 조직에 대한 GitHub Free가 있는 퍼블릭 리포지토리와 GitHub Pro, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server가 있는 퍼블릭 및 프라이빗 리포지토리에서 사용할 수 있습니다.

게시 원본 정보

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

경고: 사이트 관리자가 퍼블릭 페이지를 사용하도록 설정한 경우 사이트의 리포지토리가 프라이빗이거나 내부인 경우에도 GitHub Pages 사이트를 인터넷에서 공개적으로 사용할 수 있습니다. 사이트의 리포지토리에 중요한 데이터가 있는 경우 게시하기 전에 데이터를 제거할 수 있습니다. 자세한 내용은 "엔터프라이즈에 대한 GitHub 페이지 구성" 및 "AUTOTITLE"을 참조하세요.

분기에서 게시

  1. 게시 원본으로 사용할 분기가 리포지토리에 이미 있는지 확인합니다.

  2. GitHub Enterprise Server에서 사이트의 리포지토리로 이동합니다. 1. 리포지토리 이름 아래에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

    탭을 보여 주는 리포지토리 헤더의 스크린샷. "설정" 탭은 진한 주황색 윤곽선으로 강조 표시됩니다.

  3. 사이드바의 "코드 및 자동화" 섹션에서 페이지를 클릭합니다.

  4. "GitHub Pages"에서 분기 드롭다운 메뉴를 사용하고 게시 원본을 선택합니다. GitHub 리포지토리의 페이지 설정 스크린샷 "없음"이라는 레이블이 지정된 게시 원본에 대한 분기를 선택하는 메뉴가 진한 주황색으로 표시됩니다.

  5. 필요에 따라 폴더 드롭다운 메뉴를 사용하여 게시 원본에 대한 폴더를 선택합니다. GitHub 리포지토리의 페이지 설정 스크린샷 "/(root)"라는 레이블이 지정된 게시 원본의 폴더를 선택하는 메뉴가 진한 주황색으로 표시됩니다.

  6. 저장을 클릭합니다.

분기에서 게시 문제 해결

참고: 사이트에서 자동으로 게시하지 않은 경우 관리자 권한과 확인된 메일 주소를 가진 사람이 게시 원본으로 푸시되었는지 확인합니다.

분기의 docs 폴더를 게시 원본으로 선택하고 나중에 리포지토리의 해당 분기에서 /docs 폴더를 제거한 경우 사이트가 빌드되지 않으며 누락된 /docs 폴더에 대한 페이지 빌드 오류 메시지가 표시됩니다. 자세한 내용은 "GitHub 페이지 사이트에 대한 Jekyll 빌드 오류 문제 해결"을 참조하세요.