빠른 시작 가이드
이 문서는 초보자와 일반 웹마스터가 T2Editor를 신속하게 설치하고 사용할 수 있도록 돕습니다.
- 다운로드: 최신 버전을 다운로드하여 압축을 해제합니다.
이 문서는 2026-09-28에 v10.5.1 기준으로 다시 썼습니다. 9.x 이하 계열은 EOL이며 업데이트 대상이 아닙니다.
- 업로드 — 올리는 위치가 CMS마다 다릅니다:
| 쓰는 환경 | 올리는 위치 |
|---|---|
| 그누보드5 | g5/plugin/editor/t2editor/ |
| 라이믹스 2.1.x | rhymix/modules/editor/skins/t2editor/ |
| CMS 없이 직접 운영 | 웹 루트 또는 원하는 경로의 t2editor/ |
여기서 "CMS 종류"를 따로 고르는 설정은 없습니다. 폴더를 올리면 에디터가 그 자리의 파일 구조를 보고 스스로 판단합니다. 다만 한 단계라도 잘못 올리면 CMS 인식을 못 하고 화면이 이상해집니다.
- 에디터 선택: 그누보드5는 관리자 → 환경설정 → 기본환경설정 → 에디터 선택에서 고릅니다. 게시판마다 다르게 쓰려면 게시판 관리 → 해당 게시판 → 에디터 사용에서 고릅니다. 라이믹스는 관리자 → 고급 설정 → 에디터 → 에디터 스킨에서 고릅니다.
- 최초 설치 안내 통과: 글쓰기 화면을 열면 T2Editor 최초 설치 안내가 뜨고, 끝까지 통과하기 전까지 편집 기능이 잠깁니다. 안내가 하는 일은 ① 관리자 기능이 켜져 있는지 확인 ② 관리자 비밀번호 설정 여부 확인 ③ 파일을 저장할 폴더의 쓰기 권한 확인 ④ 서버가 필요한 기능을 지원하는지 확인입니다. 처음 설치할 때 놓친 설정을 자동으로 확인해주는 안내 화면이므로 화면에 표시된 실패 항목을 그대로 해결하십시오. 그누보드5·라이믹스는 CMS 관리자 로그인으로 인증하지만, CMS 인증이 실패하는 환경에서는
admin/t2admin.key.txt파일명을admin/t2admin.key로 바꾸고 자체 비밀번호를 설정해야 합니다. 자세한 건 01-installation-guide.md 4절을 보십시오. - 보기 화면 스타일 확인:
content.css를 스킨에 포함합니다. 이 지시는 지금도 유효합니다 — 에디터가 본문에 스타일시트 링크를 자동 삽입하지만 CMS의 HTML 보안 필터가 지우기 때문에 스킨 쪽에서 직접 링크해 주는 편이 안전합니다. 이 단계를 빼면 작성 화면은 멀쩡한데 보기 화면만 밋밋해집니다. - 권한 확인: 쓰기 권한이 필요한 곳은 CMS 환경에 따라 한 곳입니다 — 그누보드5는 CMS 데이터 폴더, 라이믹스는
files, CMS 없이는t2editor/data/. 최소 권장값은 707이고 777은 쓰지 마세요. 더 좁은 권한이어도 PHP 실제 쓰기 시험이 통과하면 그대로 둡니다. 협업용 폴더를 따로 만들지 마십시오 — 에디터가t2editor_db/collab/에 알아서 만듭니다. 숫자를 보고 무작정 chmod하지 말고 에디터 하단 정보·진단 화면이 주는 실제 경로와 명령을 따르십시오. - 사용: 게시판 글쓰기 페이지에서 T2Editor를 사용해 글을 작성하고 미디어를 추가합니다.
이 과정을 완료하면 기본적인 사용 준비가 끝납니다. 추가 기능을 원한다면 플러그인 문서를 참고하여 필요한 플러그인을 활성화하세요.
참고 자료
처음 설치한 뒤 바로 확인할 것
초보자와 웹마스터는 설치만 끝났다고 바로 운영에 들어가지 말고, 최소한 다섯 가지를 확인하는 것이 좋습니다. 첫째, 작성 화면이 정상적으로 뜨는지. 둘째, 글 저장 후 보기 화면에서 스타일이 깨지지 않는지. 셋째, 이미지와 파일 업로드가 되는지. 넷째, 모바일 화면에서 툴바가 과도하게 깨지지 않는지. 다섯째, 협업이나 AI처럼 외부 의존 기능을 실제로 쓸 계획이 있는지입니다. 마지막 항목은 특히 중요합니다. 안 쓰는 기능이라면 초기에 비활성화해 두는 것이 관리 부담을 줄입니다.
운영 전 체크리스트
- 관리자 페이지에서 에디터 선택이 실제 게시판에도 반영되었는지 확인
content.css가 보기 페이지에 반영되었는지 확인(작성 화면이 멀쩡해도 여기서 안 보이면 본문용 스타일시트가 빠진 것입니다)- 공용 데이터 폴더 쓰기 권한 확인(최소 권장 707. 협업 폴더는 만들지 않습니다)
- 보안상 허용하지 않을 확장자는 업로드 설정에서 제거
- 외부 서비스 의존 기능(AI, 검색, ClipURL) 사용 여부 결정
- 관리자 페이지(확장 마켓·업데이트)에 접근 가능한지 확인 — CMS 관리자 로그인이 되지만, 안 되면 자체 비밀번호로 로그인해야 합니다(10.5.1)
- 확장 기능은 관리자 페이지의 확장 마켓에서 검색해 설치할 수 있습니다(10.4.0). 서버 ZIP을 FTP로 덮어쓰는 방식보다 안전하며, 설치 전 안전성 검사가 수행됩니다
참고 자료
- DSclub T2Editor 서비스 페이지: https://dsclub.kr/service/editor
- 현행 정보: https://dsclub.kr/service/editor
- 참고 이력(현재 기준으로는 쓰지 마십시오): SIR T2Editor 8.1.2 소개 글 https://sir.kr/boards/g5_plugin/15016 은 2026-03 판본 기준 자료입니다.
- 설치 절차 3경로와 최초 설정 게이트: 01-installation-guide.md
- 그누보드5 연동 상세: 05-gnuboard5-integration-guide.md