Github/Blog (6)
2025-09-11 08:06:07
반응형

# 🚀 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 반영까지 원활히 진행됩니다 🚀
반응형
2025-08-30 19:49:36
반응형

 

 

 

 

반응형
2025-08-30 19:15:27
반응형

 

반응형
2025-08-30 18:56:02
반응형

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

 

 

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

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

 

5.  적용 확인

* 참고 강의 : 

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

반응형
2025-08-30 18:53:04
반응형

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

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

 

 

 

 

 

* 참고 강의 : 

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

반응형
2025-08-30 18:31:09
반응형

1. 위니 블로그 링크 접속

https://blog.weniv.co.kr

 

매뉴얼 | 위니블로그

GitHub Pages를 이용하여 손쉽게 나만의 개발 블로그를 제작하세요.

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분만에-만드는-깃헙블로그

반응형