GitHub Pages 빠른 시작

GitHub Pages를 사용하여 일부 오픈 소스 프로젝트를 소개하거나, 블로그를 호스트하거나, 이력서를 공유할 수도 있습니다. 이 가이드는 다음 번 웹 사이트 만들기를 시작할 때 도움이 됩니다.

누가 이 기능을 사용할 수 있나요?

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

GitHub Pages은(는) 이제 GitHub Actions을(를) 사용하여 Jekyll 빌드를 실행합니다. 빌드의 원본으로 분기를 사용하는 경우 기본 제공 Jekyll 워크플로를 사용하려면 리포지토리에서 GitHub Actions을(를) 사용하도록 설정해야 합니다. 또는 GitHub Actions을(를) 사용할 수 없거나 사용하지 않도록 설정한 경우 원본 분기의 루트에 .nojekyll 파일을 추가하면 Jekyll 빌드 프로세스를 무시하고 콘텐츠를 직접 배포합니다. GitHub Actions 사용에 대한 자세한 내용은 "리포지토리에 대한 GitHub Actions 설정 관리"을 참조하세요.

이 문서의 내용

소개

GitHub Pages는 GitHub를 통해 호스트되고 게시되는 퍼블릭 웹 페이지입니다. 시작하고 실행하는 가장 빠른 방법은 Jekyll 테마 선택기를 사용하여 미리 만들어진 테마를 로드하는 것입니다. 그런 다음 GitHub Pages 콘텐츠 및 스타일을 수정할 수 있습니다.

이 가이드에서는 username.github.io에서 사용자 사이트를 만드는 작업을 안내합니다.

웹 사이트 만들기

  1. 임의 페이지의 오른쪽 위에 있는 을(를) 클릭한 다음, 신규 리포지토리를 클릭합니다.

    새 항목을 만드는 옵션을 보여 주는 GitHub 드롭다운 메뉴의 스크린샷. "새 리포지토리"라는 메뉴 항목이 진한 주황색 윤곽선으로 표시되어 있습니다.

  2. 리포지토리 이름으로 username.github.io를 입력합니다. username을 GitHub 사용자 이름으로 바꿉니다. 예를 들어 사용자 이름이 octocat이면 리포지토리 이름은 octocat.github.io입니다.

    리포지토리의 GitHub Pages 설정 스크린샷. 리포지토리 이름 필드에 "octocat.github.io" 텍스트가 포함되어 있으며 진한 주황색 윤곽선으로 표시되어 있습니다.

  3. 리포지토리 표시 여부를 선택합니다. 자세한 내용은 "리포지토리 정보"을(를) 참조하세요.

  4. 추가 정보를 사용하여 이 리포지토리 초기화를 선택합니다.

  5. Create repository(리포지토리 만들기)를 클릭합니다.

  6. 리포지토리 이름 아래에서 Settings(설정)를 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

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

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

  8. "빌드 및 배포"의 "원본"에서 분기에서 배포를 선택합니다.

  9. "빌드 및 배포"의 "분기"에서 분기 드롭다운 메뉴를 사용하여 게시 원본을 선택합니다.

    GitHub 리포지토리의 페이지 설정 스크린샷. "없음"이라는 레이블이 있는 게시 원본에 대한 분기를 선택하는 메뉴가 진한 주황색으로 표시되어 있습니다.

  10. 필요에 따라 리포지토리의 README.md 파일을 엽니다. README.md 파일에서 사이트의 콘텐츠를 작성하게 됩니다. 지금 파일을 편집하거나 기본 콘텐츠를 유지할 수 있습니다.

  11. username.github.io를 방문하여 새 웹 사이트를 봅니다. 참고: GitHub에 변경 내용을 푸시한 후 사이트 변경 내용이 게시되려면 최대 10분이 걸릴 수 있습니다.

제목 및 설명 변경

기본적으로 사이트의 제목은 username.github.io입니다. 리포지토리에서 _config.yml 파일을 편집하여 제목을 변경할 수 있습니다. 사이트에 대한 설명을 추가할 수도 있습니다.

  1. 리포지토리의 코드 탭을 클릭합니다.

  2. 파일 목록에서 _config.yml을 클릭하여 파일을 엽니다.

  3. 아이콘을 클릭하여 파일을 편집합니다.

  4. _config.yml 파일에는 사이트의 테마를 지정하는 줄이 이미 포함되어 있습니다. title: 뒤에 원하는 제목이 표시되는 새 줄을 추가합니다. description: 뒤에 원하는 설명이 표시되는 새 줄을 추가합니다. 예시:

    theme: jekyll-theme-minimal
title: Octocat's homepage
description: Bookmark this to keep an eye on my project updates!

  5. 파일 편집을 마쳤으면 변경 내용 커밋을 클릭합니다.

다음 단계

사이트에 페이지를 추가하는 방법에 대한 자세한 내용은 "Jekyll을 사용하여 GitHub Pages 사이트에 콘텐츠 추가"을(를) 참조하세요.

Jekyll을 사용하여 GitHub Pages 사이트를 설정하는 방법에 대한 자세한 내용은 “GitHub Pages 및 Jekyll 정보”을(를) 참조하세요.