EommyDocs
개인 기술 문서 사이트 (https://eommydocs.com)
개요
| 항목 |
내용 |
| URL |
https://eommydocs.com / https://www.eommydocs.com |
| 엔진 |
MkDocs + Material 테마 |
| 배포 |
Cloudflare Pages (wrangler) |
| 도메인 |
Spaceship |
| 테마 |
베이지 + 갈색 |
사이트 구조
| 섹션 |
내용 |
문서 수 |
| 기초 |
CS, ML, DL, 통계, 인프라, MLOps, DE |
40+ |
| LLM/VLM |
기초, 아키텍처, 모델 카탈로그 |
50+ |
| Data |
Science, Analysis, 공공부문 |
80+ |
| 브리핑 |
주간 논문/기술 트렌드 |
주 1회 |
| 논문 |
주요 논문 정리 |
10+ |
| Projects |
실무/개인 프로젝트 |
15+ |
기술 스택
| 구성 |
도구 |
| SSG |
MkDocs (Python) |
| 테마 |
Material for MkDocs |
| 수식 |
MathJax |
| 코드 하이라이트 |
pymdownx.highlight |
| 다이어그램 |
수작업 SVG |
| 검색 |
MkDocs 내장 (한국어 지원) |
| CDN/배포 |
Cloudflare Pages |
배포 프로세스
# 빌드
python3 -m mkdocs build
# 배포
export CLOUDFLARE_API_TOKEN="..."
export CLOUDFLARE_ACCOUNT_ID="..."
wrangler pages deploy site --project-name eommydocs --commit-dirty=true
# iCloud 동기화
cp -r workspace/* ~/Library/Mobile\ Documents/com~apple~CloudDocs/02_Learning/eommydocs/
UI/UX 결정 사항
| 항목 |
결정 |
이유 |
| 탭바 |
제거 |
사이드바로 충분 |
| 검색 |
플로팅 버튼 |
탭바 없으면 기본 검색 UI 안 보임 |
| SVG |
수작업, 외부 파일 |
MkDocs가 인라인 SVG를 <p> 태그로 쪼갬 |
| 색상 |
흰 박스 + 테두리만 |
깔끔한 전문가 스타일 |
SVG 규칙
- 인라인 SVG 금지 (반드시 외부 파일로 분리)
- 저장 위치:
docs/assets/diagrams/ 또는 docs/카테고리/diagrams/
& 문자 → & 이스케이프 필수stroke 등 속성 중복 정의 금지- d2, mermaid 자동 생성 사용 금지
정기 업데이트
| 주기 |
작업 |
| 매일 10시 |
논문/기법 정리 1건 |
| 매주 수요일 14시 |
주간 문서 업데이트 10건 |
| 매주 월요일 9시 |
주간 브리핑 |
개발 이력
| 날짜 |
내용 |
| 2026-01 |
초기 구축 (MkDocs + Material, 기초 문서 작성) |
| 2026-02-03 |
기초, LLM, Data 섹션 대량 추가 |
| 2026-02-04 |
아키텍처, 분석 기법 추가 |
| 2026-02-04 |
UI 최종 결정 (탭바 제거, 플로팅 검색) |
| 2026-02-15 |
SVG 규칙 확립 |
| 2026-02 ~ 03 |
LLM/VLM, 아키텍처 섹션 확장, 주간 문서 업데이트 정기화 |
| 2026-03-05 |
Data Science/Analysis 대규모 확장 (30개 주제 추가) |
| 2026-03-12 |
주간 자동 업데이트 체계 구축 (OpenClaw cron 기반) |
| 2026-03-19 |
사이트 총 문서 수 200+ 달성 |
| 2026-03-25 |
공공부문 사례 추가, 주간 브리핑 안정화 |
| 2026-04-01 |
아키텍처 실무 가이드, DS 기법 확장 계속, Projects 문서 추가 |
최근 업데이트 (2026-03)
| 날짜 |
변경 사항 |
| 03-25 |
주간 문서 업데이트 (10개 신규/갱신) |
| 03-19 |
사이트 총 문서 수 200+ 달성 |
| 03-12 |
주간 자동 업데이트 체계 구축 (cron 기반) |
| 03-05 |
Data Science 섹션 대규모 확장 (30개 주제 추가) |
현황 (2026-03 기준)
| 항목 |
수치 |
| 총 문서 수 |
200+ |
| 주간 업데이트 |
매주 수요일 10개 문서 |
| 월간 신규 문서 |
약 40개 |
| 배포 |
Cloudflare Pages (자동) |
| 빌드 시간 |
약 15초 |
최종 업데이트: 2026-03-25