office 문서들을 pdf 로 변환하고 여러 pdf 문서들을 하나로 병합하는 기능을 가졌습니다.
- Python 98.2%
- PowerShell 1%
- Batchfile 0.8%
Xehoon Han
19d03ac856
• 메인 학습 가이드 (docs/pyside6_learn_book.md) 추가 - 난이도별 학습 가이드 (초급/중급/고급) - 13개 세부 주제별 하위 문서 연결 - 실습 중심 학습 로드맵 제공 • 13개 상세 학습 문서 (docs/learning/*.md) 생성 - 기초: 기본 위젯, 레이아웃, 메인 윈도우 구조 - 고급: 드래그앤드롭, 커스텀 위젯, Signal/Slot - 스레딩: QThread, Worker 패턴 - UI/UX: 스타일링, 애니메이션, 진행률 표시 - 아키텍처: MVC 패턴, 관심사 분리 • 실제 프로젝트 코드와 연계한 실무 중심 내용 - 모든 예제가 PDF Helper 코드 기반 - 파일:라인번호 형식으로 정확한 코드 참조 - 실습 과제와 단계별 학습 가이드 포함 • 완전한 하이퍼링크 네비게이션 시스템 - 메인 → 세부 문서 → 메인으로 순환 링크 - 관련 주제 간 크로스 레퍼런스 - 고아 문서 없는 체계적 구조 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> |
||
|---|---|---|
| .claude | ||
| assets/icons | ||
| config | ||
| core | ||
| docs | ||
| installer | ||
| samples | ||
| scripts | ||
| tests | ||
| ui | ||
| .gitignore | ||
| .python-version | ||
| certificate_info.json | ||
| CLAUDE.md | ||
| deploy.bat | ||
| main.py | ||
| main.spec | ||
| pyproject.toml | ||
| README.md | ||
| sign_exe.ps1 | ||
| uv.lock | ||
PDF Helper
Office 파일을 PDF로 변환하고 병합하는 간소화된 GUI 도구
PDF Helper는 Excel과 PowerPoint 파일을 PDF로 변환하고 병합하는 Windows용 애플리케이션입니다. 설정 파일 없이 자동으로 변환 엔진을 감지하여 즉시 사용할 수 있습니다.
✨ 주요 기능
- 🎯 간소한 사용법: 파일 드래그 & 드롭 → 변환 버튼 클릭
- ⚡ 자동 엔진 감지: MS Office와 LibreOffice 자동 인식
- 📄 다중 파일 처리: Excel(.xlsx), PowerPoint(.pptx) 일괄 변환
- 🔗 PDF 병합: 변환된 파일들을 하나의 PDF로 자동 병합
- 🧹 자동 정리: 병합 후 중간 파일 자동 삭제
- 📂 폴더 열기: 변환 완료 후 결과 폴더 자동 표시
🚀 빠른 시작
필수 요구사항
- Windows 10/11
- 변환 엔진 (다음 중 하나):
- Microsoft Office (권장)
- LibreOffice (무료) - 다운로드
실행 방법
- PDF Helper 실행
- 파일 드래그: Excel/PowerPoint 파일을 창에 끌어다 놓기
- 변환 시작: "변환 및 병합" 버튼 클릭
- 완료: 지정된 출력 폴더에서 결과 확인
📖 상세 문서
- 설치 가이드 - 설치 및 환경 설정
- 사용자 매뉴얼 - 기본 사용법과 고급 기능
- 개발자 가이드 - 개발 환경 설정 및 기여 방법
- 코드 서명 가이드 - 사내 배포용 자체 서명 설정
- API 문서 - 핵심 모듈 API 레퍼런스
- 문제 해결 - 자주 묻는 질문과 해결법
- 아키텍처 - 프로젝트 구조와 설계 철학
PySide6 학습자를 위한 가이드
- PySide6 학습 가이드 - 이 프로젝트로 배우는 PySide6 완전 정복
개발 히스토리
프로젝트 전체 과정:
- 개발 워크플로우 - 전체 개발 과정과 5단계 계획
단계별 기술 문서 (Multi-backend 시스템):
- Phase 1 - 추상화 레이어 및 팩토리 패턴 구현
- Phase 2 - MS Office COM 백엔드 구현
- Phase 3 - 간소화된 엔진 선택 시스템
- Phase 4 - GUI 통합 및 상태 위젯
- Phase 5 - 간소화된 통합 테스트 및 최적화
상세 작업 계획서:
- Phase 1 작업 계획 - 비즈니스 로직 상세 구현 계획
- Phase 2 작업 계획 - MS Office COM 통합 작업 계획
🎯 주요 특징
간소화된 사용자 경험
- 설정 파일 없음 - 복잡한 설정 관리 불필요
- 자동 엔진 감지 - MS Office → LibreOffice 순서로 자동 선택
- 직관적 UI - 드래그 앤 드롭과 원클릭 변환
견고한 아키텍처
- GUI/비즈니스 로직 완전 분리
- 멀티 백엔드 지원 (MS Office COM + LibreOffice)
- 실시간 진행률 표시 및 상태 피드백
성능 최적화
- 평균 엔진 감지 시간: <0.2초
- 메모리 사용량: <200MB (초기) + <100MB (장시간 사용)
- 캐싱을 통한 2배 성능 향상
🔧 개발 환경
# 의존성 설치
uv sync
# 애플리케이션 실행
uv run main.py
# 테스트 실행
uv run pytest
# 빌드 (Windows)
python scripts/build_simplified.py
📋 개발 현황
- ✅ Phase 1: 기초 아키텍처 및 추상화 레이어
- ✅ Phase 2: MS Office COM 백엔드 구현
- ✅ Phase 3: 자동 엔진 선택 시스템
- ✅ Phase 4: GUI 통합 및 상태 위젯
- ✅ Phase 5: 완전 간소화 시스템 (현재 버전)
💬 지원
자주 묻는 질문:
- Q: "변환 엔진을 찾을 수 없습니다" → A: MS Office 또는 LibreOffice 설치 필요
- Q: 변환이 느림 → A: SSD 사용 권장, 파일 개수 10개 이하로 제한
- Q: 한글 파일명 문제 → A: 시스템 로케일을 한국어로 설정
더 자세한 내용은 문제 해결 가이드를 참조하세요.
🤝 기여
- 설정 파일 없이 구현
- GUI/비즈니스 로직 분리 원칙 준수
- 새 기능에 단위 테스트 필수
- 성능 벤치마크로 영향도 확인
자세한 내용은 개발자 가이드를 참조하세요.
PDF Helper - 설정 없는 간편함으로 PDF 변환을 더 쉽게!