1장. 왜 블로그와 GitHub를 함께 써야 할까?

1-1. 이메일 첨부와 카페 자료실의 한계

많은 개발자들이 여전히 소스 코드를 이메일 첨부나 카페 자료실로 구독자에게 전달합니다. 처음에는 간편해 보이지만, 시간이 지날수록 몇 가지 문제가 드러납니다.

메일 용량 제한 때문에 큰 프로젝트는 잘려서 보내지 못합니다.
여러 번 수정하다 보면 어느 파일이 최신 버전인지 헷갈립니다.
카페·커뮤니티는 탈퇴하거나 글이 내려가면 링크가 사라질 수 있습니다.

특히 “예전 블로그 글에 올려 둔 첨부 파일이 사라졌어요”라는 문의가 반복된다면, 파일을 블로그 안에 직접 두는 방식에는 한계가 있다는 신호입니다.

스크린샷 예시: 메일 첨부 한계 화면

아래와 같은 화면을 스크린샷으로 캡처해서 넣어 두면 독자의 공감을 더 쉽게 얻을 수 있습니다.

메일 작성 화면에서 “첨부 파일 용량 초과” 에러가 떠 있는 장면
카페 자료실에서 “파일이 삭제되었거나 존재하지 않습니다” 메시지가 보이는 장면

실제 전자책에서는 다음과 같이 이미지를 삽입하면 됩니다.

<img src="images/mail-attachment-error.png" alt="이메일 첨부 용량 초과 에러 화면">

1-2. 블로그를 ‘배포 허브’로 쓰는 개념

블로그는 검색 유입, 구독자 관리, 설명 문서 제공에 최적화된 채널입니다. 반대로, 실제 파일 저장과 버전 관리는 전문 저장소가 훨씬 더 잘합니다.

이 책에서 다루는 전략은 간단합니다.

파일과 소스 코드는 GitHub 같은 저장소에 올려 두고,
블로그 글은 “무엇을, 왜, 어떻게 쓰는지”를 설명하는 안내 페이지로 쓴다.

이렇게 역할을 분리하면, 블로그 글 하나가 “설명 + 다운로드 센터” 역할을 동시에 수행하게 됩니다.

스크린샷 예시: 블로그 글과 GitHub 리포지토리 연결 구조

독자가 전체 구조를 한눈에 이해할 수 있도록, 다음과 같은 구성을 그림으로 보여줄 수 있습니다.

왼쪽: 블로그 글 화면(제목, 소개, 사용 방법, 다운로드 버튼)
오른쪽: GitHub 리포지토리 화면(파일 목록, Code 버튼, Download ZIP 위치)

전자책에서는 단순한 다이어그램이나 실제 캡처 이미지를 사용해 “블로그 → GitHub로 연결되는 흐름”을 시각적으로 보여 주세요.

1-3. GitHub를 파일 창고로 쓰는 이유

GitHub는 원래 개발자를 위한 코드 저장소이지만, 블로그 글을 쓰는 입장에서는 매우 강력한 “파일 공유 창고”로 활용할 수 있습니다.

Public 리포지토리는 누구나 링크만 있으면 접속 가능하다.
버전별 변경 이력이 자동으로 쌓인다.
“Download ZIP” 기능으로 전체 파일을 한 번에 내려받을 수 있다.

즉, 한 번 올려 두면 블로그 글에서는 링크만 붙여 주면 되고, 이후 버전을 올려도 동일한 글에서 계속 최신 파일을 안내할 수 있습니다.

실제 GitHub 다운로드 링크 HTML 예시

예를 들어, 아래와 같이 GitHub 리포지토리의 ZIP 다운로드 링크를 블로그 글이나 전자책 HTML에 버튼 형태로 삽입할 수 있습니다.

<a href="https://github.com/사용자명/저장소명/archive/refs/heads/main.zip"
   style="display:inline-block;padding:10px 18px;
          background:#1a73e8;color:#ffffff;
          text-decoration:none;border-radius:4px;
          font-weight:600;">
  예제 소스코드 다운로드 (.zip)
</a>

위 코드는 일반 텍스트 링크 대신, 독자가 직관적으로 눌러 볼 수 있는 “다운로드 버튼”을 만들어 주는 간단한 HTML 예시입니다.

스크린샷 예시: 다운로드 버튼이 포함된 블로그 글

이 부분에서는 실제 블로그 글에 위 HTML을 넣었을 때의 화면을 캡처해 보여 줍니다.

본문 설명 아래에 파란색 “예제 소스코드 다운로드 (.zip)” 버튼이 보이는 장면
마우스를 올렸을 때 커서가 손 모양으로 바뀌는 장면

전자책에서는 다음과 같은 형태로 이미지를 넣을 수 있습니다.

<img src="images/blog-download-button.png"
     alt="GitHub 예제 소스코드 다운로드 버튼이 포함된 블로그 글 화면">

1장 정리

이 1장에서 살펴본 것처럼, 블로그는 설명과 안내에, GitHub는 파일 저장과 버전 관리에 강점을 가진 도구입니다. 다음 장에서는 실제로 GitHub 리포지토리를 만들고, 블로그에서 쓸 수 있는 링크를 준비하는 과정을 단계별로 살펴보겠습니다.