# 🚀 MkDocs Material 블로그 배포 가이드

MkDocs Material 테마로 블로그를 운영할 때,  
로컬 환경에서 수정 후 GitHub Pages로 반영하는 전체 과정을 정리했습니다.

---

## 1️⃣ 가상환경 활성화

# (있다면) 가상환경 활성화

.venv\Scripts\Activate

##  2️⃣ Material 테마 최신 버전 설치/업데이트

pip install mkdocs-material --upgrade

## 3️⃣ 로컬에서 블로그 확인

mkdocs serve

👉 http://127.0.0.1:8000 접속해서 테마/수정사항 반영 확인

4️⃣ GitHub Pages 배포

mkdocs gh-deploy --force

5️⃣ 변경 사항 GitHub에 커밋 & 푸시

git add -A
git commit -am "blog edit commit"
git push origin main

필요 시 강제 푸시:

git push origin main --force

## ✅ 정리

가상환경 실행 → Activate

Material 업데이트 → pip install ...

로컬 테스트 → mkdocs serve

배포 실행 → mkdocs gh-deploy

GitHub 푸시 → git push origin main

### 이 순서대로 하면 MkDocs 블로그 수정 → 배포 → GitHub 반영까지 원활히 진행됩니다 🚀

config.js에서 blogTitle에 입력 후 커밋하면 반영

3. 좌측 깃허브 커밋 아이콘 마우스로 클릭 - 변경 내용 - 변경된 파일 선택 후 + 버튼 마우스 클릭 (변경 내용 스테이징)

4. 커밋 메시지 입력 후 커밋 및 푸시 버튼 마우스로 클릭

5.  적용 확인

* 참고 강의 : 

https://www.inflearn.com/course/3분만에-만드는-깃헙블로그

1. .com -> .dev로 url 주소 수정 후 Enter 키 입력하여 Github VSCODE TOOL 접속

. 키 눌러도 Github VSCODE TOOL 접속 가능

* 참고 강의 : 

https://www.inflearn.com/course/3분만에-만드는-깃헙블로그

1. 위니 블로그 링크 접속

https://blog.weniv.co.kr

2. 블로그 만들기 버튼 마우스로 클릭

3. Fork 버튼 마우스로 클릭

4. Create 버튼 마우스 클릭

5. 블로그 생성 화면

6. 블로그 생성 완료 화면

7.  Setting --> Pages 마우스로 클릭

8. Branch - main 마우스로 클릭

9. Save 버튼 마우스로 클릭

10. Github Page 저장 메시지 확인

11. 1~2분 뒤에 F5 키 눌러서 페이지 새로고침 후 링크 생성 확인 - 링크 접속 또는 Visit site 버튼 마우스로 클릭

12. 페이지 접속 여부 확인 - 블로그 생성 완료.

* 참고 강의 : 

https://www.inflearn.com/course/3분만에-만드는-깃헙블로그