1년짜리 CS 독학 과정을 대학 강의처럼 기록하는 블로그예요. GitHub Pages(Jekyll)로 돌아가고, 따로 서버나 빌드 도구가 필요 없어요.
- 대시보드: 시즌 지도, 지금 할 과제 3개, 학생증(레벨, XP, 배지), 출석부
- 계획서: 시즌별 참고 강의와 교재, 과제 목록, 제출 여부
- 리포트: 과제마다 낸 리포트. "이 과제를 끝냈어요"를 체크하면 진도에 바로 반영돼요.
- 라이트/다크 모드 (시스템 설정을 따르고, 오른쪽 위 버튼으로 바꿀 수 있어요)
- GitHub에서 새 저장소를 만들어요.
- 이름을
내아이디.github.io로 하면 주소가https://내아이디.github.io가 돼요. (추천) - 다른 이름(예:
cs-study)으로 하면 주소가https://내아이디.github.io/cs-study가 되고,_config.yml의baseurl을"/cs-study"로 바꿔야 해요.
- 이름을
- 이 폴더를 저장소에 올려요.
.pages.yml처럼 점으로 시작하는 파일도 꼭 같이 올라가야 해서, 웹 업로드보다 git이 확실해요.cd cs-study-blog git init -b main git add . git commit -m "개강" git remote add origin https://github.com/내아이디/내아이디.github.io.git git push -u origin main
- 저장소의 Settings → Pages에서 Source를 Deploy from a branch, 브랜치를 **main / (root)**로 저장해요.
- 1~2분 뒤 주소로 들어가면 사이트가 떠요. 이후로는 푸시할 때마다 자동으로 다시 만들어져요.
_config.yml에서student(이름),course_start(개강일),weekly_hours(주당 공부 시간)를 내 것으로 바꿔요.
- 홈: 최근 글(공부 노트와 과제 리포트), 메인 프로젝트 카드, 사이드 프로젝트, 태그, 공부 잔디
- 프로젝트 (
/projects/, 하나씩은/project/?id=): 메인 프로젝트 하나와 사이드 프로젝트 여러 개. 프로젝트는_data/series.yml의 항목이고(= 시리즈), 가치관(values), 목표(goal), 상태(status: 진행 중, 잠시 쉼, 끝남), 할 일(todos)을 가져요. 노트의series가 프로젝트 id면 그 프로젝트의 글이에요. 메인은_data/settings.yml의main_project이고,cs는 CS 기본기 독학 과정이에요. 메인이 홈 카드와 GitHub 프로필 진도 카드에 크게 보여요. - 공부 노트 (
/notes/, 파일은_notes/): 과제와 상관없이 배운 것을 적는 기술 블로그 글. 시리즈(_data/series.yml)와 태그(_data/tags.yml)로 묶어요.?series=toby-spring,?tag=Spring처럼 걸러 볼 수 있어요. - CS 과정 (
/course/): 대시보드, 계획서, 리포트, 게임 규칙, 과정 소개 - 출석 체크 (홈의 '지금' 카드,
/checkins/출석부): 공부를 시작할 때 한 마디로 출석하고, 끝나면 마무리 한 마디와 함께 상황 종료. 기록은_data/checkins.yml에 쌓이고 공부 잔디에도 들어가요. - 로파이 플레이어 (모든 페이지 오른쪽 아래): 음원 파일 없이 브라우저에서 합성해요. 서울의 시간대와 날씨, 생활 시간표, 출석 상태에 따라 템포와 분위기(빗소리, 바람)가 바뀌고, 16마디마다 화음 진행과 피아노 음색이 바뀌어요. 페이지를 옮기면 아무 곳이나 한 번 누를 때 이어서 나와요. 플레이어의 '로파이/유튜브' 버튼으로
_config.yml의bgm_youtube영상을 유튜브 공식 플레이어로 틀 수도 있어요. 코드는assets/js/lofi.js. - 글쓰기 (주인만):
/write/note/는 공부 노트,/write/는 과제 리포트,/manage/는 시리즈와 태그 관리
머리말의 로그인으로 GitHub 로그인을 하면, 블로그 주인 계정에만 글쓰기 메뉴가 생겨요. /write/ 화면은 리포트 모양 그대로 칸을 채우는 방식이고, 제출하기를 누르면 1~2분 뒤 블로그에 올라가요. 쓰는 동안 이 브라우저에 임시 저장되고, 리포트 아래 이 리포트 고치기로 다시 고치거나 지울 수 있어요.
다른 GitHub 계정도 로그인은 되지만 글쓰기는 막혀 있어요. 권한 검사는 서버에서 해요.
처음 한 번 글쓰기 서버(Cloudflare Worker)를 띄워야 해요. 순서는 worker/README.md에 있어요. _config.yml의 api_base가 비어 있으면 로그인 버튼이 숨겨져요.
- https://app.pagescms.org 에 들어가 GitHub으로 로그인해요.
- 이 저장소를 고르면(처음엔 GitHub 앱 설치를 물어봐요) 왼쪽에 과제 리포트 메뉴가 생겨요.
- 새로 만들기 → 과제를 드롭다운에서 고르고, 학습 목표 / 백지 인출 결과 / 정리 / 못 떠올린 것 / 막힌 점 / 다음에 할 일을 채워요. 정리 칸은 서식 편집기라 굵게, 목록, 코드 블록, 이미지를 그대로 쓸 수 있어요.
- 저장하면 저장소에 커밋되고, 1~2분 뒤 사이트에 올라가요.
어떤 칸이 보일지는 .pages.yml에서 정해요.
저장소의 _posts 폴더에서 Add file → Create new file을 눌러 2026-11-20-S2-xxxxxx-1.md처럼 이름을 짓고, _drafts/report-template.md 내용을 붙여 넣어 채워요. 과제 id는 _data/quests.csv의 id 열에 있어요.
VS Code, Obsidian, Typora 등으로 _posts에 md 파일을 만들고 커밋, 푸시하면 돼요. 형식은 방법 C와 같아요.
대학 강의처럼 개강일부터 1주차, 2주차...로 나눠요. 메인, 보스, 복습 과제를 weekly_hours(주당 공부 시간)만큼씩 채워 나가고, 시즌은 항상 새 주차에서 시작해요. 사이드 과제는 주차에 넣지 않고 '선택 과제'로 따로 모아요.
- 대시보드의 N주차 강의에 이번 주 과제와 지난 주차에서 밀린 과제가 나와요.
- 계획서는 시즌 안에서 주차별로 묶여 있고, 이번 주가 노랗게 표시돼요.
- 학습 시트의 '주차' 열도 같은 계산이라, 시트에서 주당 공부 시간(E7)을 바꾸면
_config.yml의weekly_hours도 같이 바꿔 주세요.
리포트에서 "이 과제를 끝냈어요"를 체크하면 시트를 건드리지 않아도 진도가 올라가요. 시트에서만 체크한 과제도 반영하고 싶을 때만 아래처럼 해요.
- 학습 시트의 퀘스트 탭을 CSV로 내려받아요.
- 터미널에서:
python3 scripts/sync_quests.py ~/Downloads/퀘스트.csv git add _data/quests.csv .pages.yml && git commit -m "진도 반영" && git push
과제는 시트나 리포트 중 한쪽에서라도 완료면 완료로 잡혀요.
시트에서 과제 이름을 고치면 그 과제의 id가 바뀌어요. 이미 그 과제로 낸 리포트가 있다면 리포트의 quest 값도 새 id로 고쳐 주세요.
bundle install
bundle exec jekyll serve
# http://localhost:4000| 경로 | 내용 |
|---|---|
_config.yml |
이름, 개강일, 주당 공부 시간, 배포 주소 |
_data/quests.csv |
과제 목록 (시트에서 동기화) |
_data/seasons.yml |
시즌별 과목명, 참고 강의, 교재 |
_posts/ |
리포트 |
.pages.yml |
브라우저 편집기(Pages CMS) 설정 |
scripts/sync_quests.py |
시트 CSV → 과제 목록 동기화 |
write.html |
블로그 안 글쓰기 화면 (assets/js/write.js, 로그인은 assets/js/auth.js) |
worker/ |
로그인과 발행을 맡는 Cloudflare Worker (Jekyll 빌드에서는 빠져요) |
assets/lib/ |
미리보기용 marked(MIT), DOMPurify(Apache-2.0/MPL-2.0) |
assets/ |
스타일, 스크립트, 픽셀 폰트 |
픽셀 폰트는 이민서 님의 갈무리를 SIL Open Font License 1.1에 따라 함께 배포해요. 라이선스 전문은 assets/fonts/Galmuri-OFL.txt에 있어요.