Intro_

📘 Notion to GitHub 자동화 가이드

Notion 데이터베이스에 작성된 글을 매일 자동으로 GitHub 리포지토리에 백업하고, README.md에 목록을 업데이트해주는 도구입니다.

---

🚀 주요 기능

1. 자동 백업 (Daily): 매일 자정(한국 시간 00:05), 어제 작성한 글을 자동으로 가져옵니다.
2. 수동 전체 동기화 (Manual): 원할 때 언제든 모든 글을 다시 가져올 수 있습니다.
3. README 초기화 (Reset): 꼬였을 때 README를 싹 지우고 깔끔하게 다시 생성하는 기능이 있습니다.
4. 커밋 메시지 커스텀: 수동 실행 시 원하는 커밋 메시지를 적을 수 있습니다.

---

🛠 초기 설정 (Setup)

이 프로젝트를 사용하려면 Settings > Secrets and variables > Actions 메뉴에서 아래 환경 변수(Secrets)를 등록해야 합니다.

Secret 이름	설명	필수 여부	예시 값
NOTION_TOKEN	Notion API 통합 토큰	필수	secret_xxxx...
NOTION_DATABASE_ID	연동할 Notion 데이터베이스 ID	필수	32자리 숫자+영문
GIT_USER_NAME	커밋에 표시될 사용자 이름	선택	Gil Dong Hong
GIT_USER_EMAIL	커밋에 표시될 이메일 (잔디용)	선택	gildong@gmail.com

Tip:
🟩잔 디🟩
GIT_USER_NAME과 EMAIL을 등록하지 않으면 기본값(GitHub Action)으로 커밋됩니다. 본인의 깃허브 계정 이메일을 등록하면 잔디(Contribution)가 심어집니다.

---

💻 사용 방법 (Workflows)

이 프로젝트에는 두 가지 자동화 모드가 있습니다.

1. 매일 자동 업데이트 (Update Notion Log)

• 작동 방식: 별도의 조작 없이 매일 밤 00:05 (KST) 에 자동으로 실행됩니다.
• 기능: "어제" 작성된 글만 가져와서 리스트에 추가합니다.

2. 수동 동기화 및 초기화 (Manual Sync & Init)

원하는 시점에 전체 글을 가져오거나, README를 고치고 싶을 때 사용합니다.

실행 방법:

1. 상단 Actions 탭 클릭
2. 좌측 Manual Sync & Init 선택
3. 우측 Run workflow 버튼 클릭
4. 옵션 선택 후 실행

옵션 설명:

• README 초기화 체크박스:
  • ✅ 체크 시: 기존 README.md 내용을 모두 삭제하고 템플릿부터 다시 생성합니다. (중복 문제 해결용)
  • ⬜ 해제 시: 기존 파일에 내용을 덮어씌웁니다.
• 커밋 메시지 입력:
  • 원하는 커밋 메시지를 입력할 수 있습니다. (예: fix: 오타 수정, docs: 전체 동기화 완료)

---

📂 폴더 구조

작성된 글은 연/월 별로 자동 정리됩니다.

📦 TIL
 ┣ 📂 2025
 ┃ ┣ 📂 12
 ┃ ┃ ┗ 📜 2025-12-18_글제목.md
 ┣ 📂 2026
 ┃ ┣ 📂 01
 ┃ ┃ ┗ 📜 2026-01-21_글제목.md
 ...