개발자 진입 가이드
이 문서는 T2Editor의 구조를 이해하고, 수정 및 확장을 시작하려는 개발자를 위한 입문서입니다.
- 코어 파일 우선 읽기:
editor.lib.php와js/core.js,config/t2_config.php를 먼저 분석하여 시스템의 초기화와 플러그인 로딩 메커니즘을 이해합니다. - 디렉터리 구조 파악: 각 디렉터리의 역할과 포함된 파일을 파악한 후, 수정하려는 부분이 어디에 위치하는지 확인합니다.
- 플러그인 구조 이해: 플러그인은 독립적인 모듈로 동작하므로, 각 플러그인의
*.js와*.css파일을 읽어 내부 메서드와 이벤트 흐름을 파악합니다. - 버전 관리: 수정 작업을 할 때는 Git과 같은 버전 관리 시스템을 사용하여 변경 이력을 기록하고, 안정적인 작업을 위해 브랜치를 활용하세요.
- 테스트: 개발 완료 후 다양한 환경에서 테스트를 수행하여 호환성과 성능을 검증합니다.
참고 자료
- 기능 설명 및 내부 구조: DSclub T2Editor 서비스 페이지
- AI 플러그인 관련 참고: SIR T2Editor 8.1.2 공지 및 후속 안내
권장 분석 관점
개발자는 T2Editor를 단순히 “에디터 한 덩어리”로 보지 말고, 서버 초기화 계층, 프런트 코어 계층, 플러그인 계층, 스타일 계층, 외부 서비스 계층으로 나눠 읽는 것이 좋습니다. 이 구분을 선명하게 잡아두면, 버그 수정이 필요한 상황에서도 수정 범위를 훨씬 빨리 좁힐 수 있습니다. 예를 들어 업로드 실패는 보통 설정·엔드포인트·권한의 문제이고, 툴바 버튼 오작동은 toolbar/core/plugin 세 축 중 어디에 연결이 끊겼는지 찾으면 됩니다.
문서 감사 결과에 따른 보완 포인트
초기 문서 세트에서는 구조 소개가 다소 짧고 중복 파일이 있어 읽기 흐름이 매끄럽지 않았습니다. 이번 감사에서는 08-developer-architecture-entry.md를 빠른 진입 문서로, 이 문서를 본격 구조 해설 문서로 역할 분리했습니다. 실무적으로는 이 문서를 다 읽은 뒤 코어 문서와 수정 대상 플러그인 문서를 바로 이어 읽는 흐름이 가장 효율적입니다.
참고 자료
- DSclub T2Editor 서비스 페이지: https://dsclub.kr/service/editor
- DSclub 개발 및 관리 가이드: https://dsclub.kr/code/1403
- SIR T2Editor 8.1.2 소개 글: https://sir.kr/boards/g5_plugin/15016