GithHub Pages의 사용자/조직 페이지와 프로젝트 페이지의 차이점 요약 @ 2018년 10월

소개

GitHub Pages 들은 적이 있었지만 처음부터 직접 만든 적이없는 사람
2018 년 10 월 현재 요약

비교적 오래된 기사가 많았기 때문에, 다시 지금의 정보를 정리해 보았습니다.

요약

GitHub Pages에는 크게 나누어 2종류가 있다(사용자/조직 or 프로젝트)

각각 할 수 있는 것이 미묘하게 다르다

빠르고 쉽게 만들고 즐겁게 운영한다면 프로젝트 유형으로 만들면 편하게

조직이라고 하면 핀 때 어려울지도 모릅니다만
GitHub의 organization입니다.

거친 비교표

먼저 목록에서보고 나서 개별적으로 팔로우합니다.



사용자/조직
프로젝트


리포지토리 이름
<username or org> .github.io
어떤 것도 가능

공개 브랜치
마스터만
master/master docs 디렉토리/gh-pages

생성되는 URL
https://<username or org> .github.io
https://<username or org> .github.io/<projectname>
맞춤 도메인
사용 가능
사용 가능

리포지토리 이름

▼사용자/조직의 경우
형식을 따라 리포지토리 이름이어야 합니다.

이 형식을 따르는 이름의 경우 GitHub Pages로 게시하면
페이지 공개 설정도 자동으로 들어갑니다.

▼프로젝트의 경우
좋아하는 리포지토리 이름으로 괜찮습니다.

공개할 브랜치

▼사용자/조직의 경우
마스터 전용입니다. master의 바로 아래를 공개하게 됩니다.
HUGO등으로 특정의 디렉토리에 토해내는 계라면, master의 바로 아래에 여러가지 전개될 필요가 있어, 그다지 재미있지 않습니다...

▼프로젝트의 경우
리포지토리에 파일이 등록되면 세 가지 옵션 중에서 선택할 수 있습니다.

master (이것은 사용자/조직의 경우와 동일)

master의 docs 디렉토리 (master 브랜치의 특정의 디렉토리만 공개할 수 있다)

gh-pages (master 브랜치가 아닌 다른 브랜치로 공개 내용을 관리하고 싶을 때)

HUGO와 같은 정적 파일의 generator와 결합하면,
특정 디렉토리를 공개 할 수있는 것이 루트 디렉토리에 파일이 넘치지 않아 편리합니다.

생성되는 URL

▼사용자/조직의 경우
다음과 같은 느낌입니다. 포트폴리오 등, 개인에 포커스를 맞추면 이 URL이 좋다고 생각한다.https://<username or org>.github.io
▼프로젝트의 경우
다음과 같은 느낌입니다. 특정 리포지토리에 대한 설명과 같은 형식이 좋을 것 같습니다.https://<username or org>.github.io/<projectname>

맞춤 도메인

이것은 두 경우 모두 설정할 수있는 것 같습니다.

복잡한 요약

개인의 포트폴리오 정도를 간단하게 작성·운용한다면 프로젝트 페이지에서
master 브랜치의 docs 디렉토리 공개 설정이 좋다고 생각합니다.

URL은 프로젝트 이름이 들어가는 만큼 길어지는 것이 미묘하지만,
HUGO등과 합했을 때도, 루트 디렉토리에 직접 전개하는 것은 피하고 싶다.

참고