도큐사우루스

도큐사우루스 문서 사이트 만들기 - 4. GitHub Pages 배포 자동화

B로그지기 2024. 1. 3.

이제 도큐사우루스를 이용한 자신의 문서 사이트를 깃헙 페이지를 통한 배포로 무료로 평생 운영되는 사이트를 완성할 수 있다. 이제 완성된 정적 사이트 자료들을 서비스 운영 배포가 무료인 GitHub Pages 기술을 활용해서 아무런 비용없이 문서 사이트를 배포해서 온전한 나만의 문서 사이트를 운영해보자. 

 

도큐사우루스 설치 및 빌드와 관련된 기존 글들을 쭉 읽어보고 따라오기 바란다.

2024.01.02 - [디지털노마드] - 도큐사우루스 문서 사이트 만들기 - 1. 소개

2024.01.03 - [디지털노마드] - 도큐사우루스 문서 사이트 만들기 - 2. 설치 혹은 GitHub Fork로 복사

2024.01.03 - [디지털노마드] - 도큐사우루스 문서 사이트 만들기 - 3. GitHub Actions 빌드 및 브랜치 생성

2024.01.03 - [디지털노마드] - 도큐사우루스 문서 사이트 만들기 - 4. GitHub Pages 배포 자동화

2024.01.03 - [디지털노마드] - 도큐사우루스 문서 사이트 만들기 - 5. GitHub Pages 도메인 연동하기

2024.01.11 - [도큐사우루스] - 도큐사우루스 문서 사이트 만들기 - 6. 다국어 처리

 

그럼 이제 GitHub Pages를 활성화 해서 배포작업을 해보자.

GitHub Pages 기능 활성화

이제 gh-pages 브랜치로 배포된 이미지를 웹에 올려주는 GitHub Pages 기능을 활성화 시켜 보자.

해당 저장소에서 Settings 탭에 보면 원하는 브랜치를 선택할 수 있도록 되어 있다.

깃헙 페이지 세팅

당연히, 브랜치는

앞서 글에서 자동으로 만든 빌드 이미지 전용 브랜치인 gh-pages를 선택하면 된다.

그런다음 "Save" 버튼을 누르기만 하면 자동으로 주소가 생성되면서 웹서버 없이도 운영되는 사이트가 생성된다.

GitHub Pages 주소 생성

몇분 기다린뒤에 다시 "Settings" > "Pages" 로 방문해 보면 아래와 같이 주소가 정상적으로 맵핑되어 있음을 확인할 수 있다. 그럼 이제 자신만의 문서 사이트를 개시할 준비는 다 되었다.

깃헙 페이지 주소 생성

"Visit site" 누르면, 최종 결과물을 확인할 수 있다.

배포 결과

정상적으로 배포가 되었다면 아래와 같이 사이트를 볼 수 있다.

로컬에서 멀 실행하고 그런게 아니라 상시로 운영되는 온라인 문서 시스템을 구성할 수 있다는 뜻이다.

아래 사이트 주소는 여기

https://doc.jeylog.net

도큐사우루스 배포 완료

 

아래와 같이 마크다운을 활용해서 쉽게 문서 페이지를 만들거나, 계층 구조를 만들기만 하면 온라인에서 아래와 같이 문서 사이트처럼 보여지고, 특별하게도 블로그를 따로 구현할 필요없이 해당 기능도 아래와 같이 제공된다.

도큐사우루스 문서페이지 예제

 

지금까지 도큐사우루스를 이용하여 나만의 문서 사이트를 만들어 보았다. 이제 어떤 내용을 채워 넣어서 무료 문서 사이트를 운영하면 될 지 고민하면 된다. 공부를 많이 해야 겠네!

댓글