Skip to main content

GitHub Pages 사이트 만들기

새 리포지토리 또는 기존 리포지토리에서 GitHub Pages 사이트를 만들 수 있습니다.

GitHub Pages는 GitHub Free 및 조직에 대한 GitHub Free가 있는 퍼블릭 리포지토리와 GitHub Pro, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server가 있는 퍼블릭 및 프라이빗 리포지토리에서 사용할 수 있습니다. 자세한 내용은 “GitHub 제품”을 참조하세요.

참고: 조직 소유자는 조직 소유의 리포지토리에서 GitHub Pages 사이트의 게시를 제한할 수 있습니다. 자세한 내용은 “GitHub Pages 사이트의 게시 관리”를 참조하세요.

사이트에 대한 리포지토리 만들기

리포지토리를 만들거나 사이트에 대한 기존 리포지토리를 선택할 수 있습니다.

리포지토리의 모든 파일이 사이트와 관련 있는 건 아닌 리포지토리에 대한 GitHub Pages 사이트를 만들려면 사이트에 대한 게시 원본을 구성할 수 있습니다. 예를 들어 전용 분기 및 폴더를 사용하여 사이트 원본 파일을 보유하거나 사용자 지정 GitHub Actions 워크플로를 사용하여 사이트 원본 파일을 빌드하고 배포할 수 있습니다.

리포지토리를 소유하는 계정이 조직에 대해 GitHub Free 또는 GitHub Free을 사용하는 경우 리포지토리는 공용이어야 합니다.

기존 리포지토리에서 사이트를 만들려면 "사이트 만들기" 섹션으로 건너뜁니다.

  1. 페이지의 오른쪽 위 모서리에서 드롭다운 메뉴를 사용하고 새 리포지토리를 선택합니다. 새 리포지토리를 만드는 옵션이 포함된 드롭다운 1. 소유자 드롭다운 메뉴를 사용하여 리포지토리를 소유할 계정을 선택합니다. 소유자 드롭다운 메뉴 1. 리포지토리의 이름과 설명(선택 사항)을 입력합니다. 사용자 또는 조직 사이트를 만드는 경우 리포지토리 이름은 <user>.github.io 또는 <organization>.github.io이어야 합니다. 사용자 또는 조직 이름에 대문자가 포함된 경우 소문자로 입력해야 합니다. 자세한 내용은 “GitHub Pages 정보”를 참조하세요. 리포지토리 만들기 필드 1. 리포지토리 표시 여부를 선택합니다. 자세한 내용은 “리포지토리 정보”를 참조하세요. 리포지토리 표시 여부를 선택하는 라디오 단추 1. 추가 정보를 사용하여 이 리포지토리 초기화를 선택합니다. README 확인란을 사용하여 이 리포지토리 초기화 1. 리포지토리 만들기를 클릭합니다. 리포지토리를 만드는 단추

사이트 만들기

사이트를 만들려면 GitHub에 사이트에 대한 리포지토리가 있어야 합니다. 기존 리포지토리에서 사이트를 만들지 않는 경우 “사이트에 대한 리포지토리 만들기”를 참조하세요.

경고: 사이트의 리포지토리가 프라이빗인 경우에도 GitHub Pages 사이트는 인터넷에서 공개적으로 사용할 수 있습니다. 사이트의 리포지토리에 중요한 데이터가 있는 경우 게시하기 전에 데이터를 제거할 수 있습니다. 자세한 내용은 “리포지토리 정보”를 참조하세요.

  1. GitHub에서 사이트의 리포지토리로 이동합니다. 1. 사용할 게시 원본을 결정합니다. 자세한 내용은 "GitHub Pages 사이트에 대한 게시 원본 구성"을(를) 참조하세요.

  2. 사이트에 대한 항목 파일을 만듭니다. GitHub Pages은(는) 사이트에 대한 항목 파일로 index.html, index.md, 또는README.md 파일을 찾습니다.

    게시 원본이 분기 및 폴더인 경우 항목 파일은 원본 분기의 원본 폴더 최상위 수준에 있어야 합니다. 예를 들어 게시 원본이 main 분기의 /docs 폴더인 경우, 항목 파일은 main이라는 분기의 /docs 폴더에 있어야 합니다.

    게시 원본이 GitHub Actions 워크플로인 경우 배포하는 아티팩트에 아티팩트 최상위 수준에 있는 항목 파일이 포함되어야 합니다. 항목 파일을 리포지토리에 추가하는 대신 워크플로가 실행되면 GitHub Actions 워크플로에서 항목 파일을 생성하도록 선택할 수 있습니다. 1. 게시 원본을 구성합니다. 자세한 내용은 “GitHub Pages 사이트에 대한 게시 원본 구성”을 참조하세요. 1. 리포지토리 이름 아래에서 설정을 클릭합니다. 리포지토리 설정 단추

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

  4. 게시된 사이트를 보려면 "GitHub Pages"에서 방문 사이트를 클릭합니다. 게시된 사이트의 URL 옆에 있는 "사이트 방문" 단추 스크린샷

    참고: GitHub에 변경 내용을 푸시한 후 사이트 변경 내용이 게시되려면 최대 10분이 걸릴 수 있습니다. 한 시간 후 브라우저에 GitHub Pages 사이트 변경 내용이 반영되지 않으면 “GitHub Pages 사이트에 대한 Jekyll 빌드 오류 정보”를 참조하세요.

  5. GitHub Pages 사이트는 GitHub Actions 워크플로를 사용해 빌드 및 배포됩니다. 자세한 내용은 “워크플로 실행 기록 보기”를 참조하세요.

    참고: GitHub Actions 실행은 퍼블릭 리포지토리에 대해 무료입니다. 사용 요금은 매월 무료 사용 가능 시간(분)을 초과하는 프라이빗 및 내부 리포지토리에 적용됩니다. 자세한 내용은 “사용량 제한, 청구 및 관리”를 참조하세요.

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

다음 단계

더 많은 새 파일을 만들어 사이트에 페이지를 더 추가할 수 있습니다. 각 파일은 게시 원본과 동일한 디렉터리 구조로 사이트에서 사용할 수 있습니다. 예를 들어 프로젝트 사이트의 게시 원본이 gh-pages 분기이고 gh-pages 분기에 /about/contact-us.md라는 새 파일을 만드는 경우 파일은 https://<user>.github.io/<repository>/about/contact-us.html에서 사용할 수 있습니다.

테마를 추가하여 사이트의 모습과 느낌을 사용자 지정할 수도 있습니다. 자세한 내용은 “Jekyll을 사용하여 GitHub Pages 사이트에 테마 추가”를 참조하세요.

사이트를 더욱 사용자 지정하려면 GitHub Pages에 대한 기본 제공 지원이 포함된 정적 사이트 생성기인 Jekyll을 사용할 수 있습니다. 자세한 내용은 “GitHub Pages 및 Jekyll 정보”를 참조하세요.

추가 참고 자료