이 문서는 초보자와 일반 웹마스터가 T2Editor를 신속하게 설치하고 사용할 수 있도록 돕습니다.
t2editor 폴더를 서버의 플러그인 또는 에디터 디렉터리에 업로드합니다.content.css를 스킨에 포함합니다.data와 collab 디렉터리 권한을 707로 설정합니다.이 과정을 완료하면 기본적인 사용 준비가 끝납니다. 추가 기능을 원한다면 플러그인 문서를 참고하여 필요한 플러그인을 활성화하세요.
초보자와 웹마스터는 설치만 끝났다고 바로 운영에 들어가지 말고, 최소한 다섯 가지를 확인하는 것이 좋습니다. 첫째, 작성 화면이 정상적으로 뜨는지. 둘째, 글 저장 후 보기 화면에서 스타일이 깨지지 않는지. 셋째, 이미지와 파일 업로드가 되는지. 넷째, 모바일 화면에서 툴바가 과도하게 깨지지 않는지. 다섯째, 협업이나 AI처럼 외부 의존 기능을 실제로 쓸 계획이 있는지입니다. 마지막 항목은 특히 중요합니다. 안 쓰는 기능이라면 초기에 비활성화해 두는 것이 관리 부담을 줄입니다.
content.css가 보기 페이지에 반영되었는지 확인data, collab 디렉터리 권한 확인이 문서는 초보자와 일반 웹마스터가 T2Editor를 신속하게 설치하고 사용할 수 있도록 돕습니다.
이 문서는 2026-09-28에 v10.5.1 기준으로 다시 썼습니다. 9.x 이하 계열은 EOL이며 업데이트 대상이 아닙니다.
| 쓰는 환경 | 올리는 위치 |
|---|---|
| 그누보드5 | g5/plugin/editor/t2editor/ |
| 라이믹스 2.1.x | rhymix/modules/editor/skins/t2editor/ |
| CMS 없이 직접 운영 | 웹 루트 또는 원하는 경로의 t2editor/ |
여기서 "CMS 종류"를 따로 고르는 설정은 없습니다. 폴더를 올리면 에디터가 그 자리의 파일 구조를 보고 스스로 판단합니다. 다만 한 단계라도 잘못 올리면 CMS 인식을 못 하고 화면이 이상해집니다.
admin/t2admin.key.txt 파일명을 admin/t2admin.key로 바꾸고 자체 비밀번호를 설정해야 합니다. 자세한 건 01-installation-guide.md 4절을 보십시오.content.css를 스킨에 포함합니다. 이 지시는 지금도 유효합니다 — 에디터가 본문에 스타일시트 링크를 자동 삽입하지만 CMS의 HTML 보안 필터가 지우기 때문에 스킨 쪽에서 직접 링크해 주는 편이 안전합니다. 이 단계를 빼면 작성 화면은 멀쩡한데 보기 화면만 밋밋해집니다.files, CMS 없이는 t2editor/data/. 최소 권장값은 707이고 777은 쓰지 마세요. 더 좁은 권한이어도 PHP 실제 쓰기 시험이 통과하면 그대로 둡니다. 협업용 폴더를 따로 만들지 마십시오 — 에디터가 t2editor_db/collab/에 알아서 만듭니다. 숫자를 보고 무작정 chmod하지 말고 에디터 하단 정보·진단 화면이 주는 실제 경로와 명령을 따르십시오.이 과정을 완료하면 기본적인 사용 준비가 끝납니다. 추가 기능을 원한다면 플러그인 문서를 참고하여 필요한 플러그인을 활성화하세요.
초보자와 웹마스터는 설치만 끝났다고 바로 운영에 들어가지 말고, 최소한 다섯 가지를 확인하는 것이 좋습니다. 첫째, 작성 화면이 정상적으로 뜨는지. 둘째, 글 저장 후 보기 화면에서 스타일이 깨지지 않는지. 셋째, 이미지와 파일 업로드가 되는지. 넷째, 모바일 화면에서 툴바가 과도하게 깨지지 않는지. 다섯째, 협업이나 AI처럼 외부 의존 기능을 실제로 쓸 계획이 있는지입니다. 마지막 항목은 특히 중요합니다. 안 쓰는 기능이라면 초기에 비활성화해 두는 것이 관리 부담을 줄입니다.
content.css가 보기 페이지에 반영되었는지 확인(작성 화면이 멀쩡해도 여기서 안 보이면 본문용 스타일시트가 빠진 것입니다)| 이전 | 새 버전 | ||
|---|---|---|---|
| 1 | --- | 1 | --- |
| 2 | title: 초보자/웹마스터 빠른 시작 | 2 | title: 초보자/웹마스터 빠른 시작 |
| 3 | document_id: 08-beginner-webmaster-quickstart | 3 | document_id: 08-beginner-webmaster-quickstart |
| 4 | slug: 08-beginner-webmaster-quickstart | 4 | slug: 08-beginner-webmaster-quickstart |
| 5 | target_editor_version: 9.0.0 | 5 | target_editor_version: 10.5.1 |
| 6 | document_type: guide | 6 | document_type: guide |
| 7 | doc_type: guide | 7 | doc_type: guide |
| 8 | target_readers: [초보자, 웹마스터, 개발자, AI agent] | 8 | target_readers: [초보자, 웹마스터, 개발자, AI agent] |
| 9 | importance: High | 9 | importance: High |
| 10 | dependency: Medium | 10 | dependency: Medium |
| 11 | core_type: Guide | 11 | core_type: Guide |
| 12 | stability: [Version-Bound] | 12 | stability: [Version-Bound] |
| 13 | stable_anchor: [] | 13 | stable_anchor: [] |
| 14 | version_bound: [] | 14 | version_bound: [] |
| 15 | related_docs: [] | 15 | related_docs: [] |
| 16 | related_files: [] | 16 | related_files: [] |
| 17 | related_functions: [] | 17 | related_functions: [] |
| 18 | related_classes_modules: [] | 18 | related_classes_modules: [] |
| 19 | related_features: [] | 19 | related_features: [] |
| 20 | related_ui: [] | 20 | related_ui: [] |
| 21 | change_risk: 수정 범위를 넓게 잡으면 관련 기능과 문서 흐름에 영향이 생길 수 있습니다. | 21 | change_risk: 수정 범위를 넓게 잡으면 관련 기능과 문서 흐름에 영향이 생길 수 있습니다. |
| 22 | reading_order: 09 | 22 | reading_order: 09 |
| 23 | summary: T2Editor를 처음 사용하는 초보자와 웹마스터를 위한 간단한 안내서 문서 | 23 | summary: T2Editor를 처음 사용하는 초보자와 웹마스터를 위한 간단한 안내서 문서 |
| 24 | description: T2Editor를 처음 사용하는 초보자와 웹마스터를 위한 간단한 안내서 | 24 | description: T2Editor를 처음 사용하는 초보자와 웹마스터를 위한 간단한 안내서 |
| 25 | tags: [quickstart, beginner, T2Editor] | 25 | tags: [quickstart, beginner, T2Editor, v10] |
| 26 | version_tag: 9.0.0 | 26 | version_tag: 10.5.1 |
| 27 | maintenance_difficulty: Medium | 27 | maintenance_difficulty: Medium |
| 28 | test_requirement: Medium | 28 | test_requirement: Medium |
| 29 | ai_agent_risk: Medium | 29 | ai_agent_risk: Medium |
| 30 | source_basis: [현재 코드 분석 기반, 웹 참고 자료 기반] | 30 | source_basis: [현재 코드 분석 기반, 공식 릴리즈 노트 기반, 공식 배포판 실물 기반] |
| 31 | beginner_section_included: true | 31 | beginner_section_included: true |
| 32 | webmaster_section_included: true | 32 | webmaster_section_included: true |
| 33 | developer_section_included: true | 33 | developer_section_included: true |
| 34 | --- | 34 | --- |
| 35 | ## 빠른 시작 가이드 | 35 | ## 빠른 시작 가이드 |
| 36 | 36 | ||
| 37 | 이 문서는 초보자와 일반 웹마스터가 T2Editor를 신속하게 설치하고 사용할 수 있도록 돕습니다. | 37 | 이 문서는 초보자와 일반 웹마스터가 T2Editor를 신속하게 설치하고 사용할 수 있도록 돕습니다. |
| 38 | 1. **다운로드**: 최신 버전을 다운로드하여 압축을 해제합니다. | 38 | 1. **다운로드**: 최신 버전을 다운로드하여 압축을 해제합니다. |
| 39 | 2. **업로드**: `t2editor` 폴더를 서버의 플러그인 또는 에디터 디렉터리에 업로드합니다. | 39 | |
| 40 | 3. **설정**: 관리자 페이지에서 기본 에디터로 T2Editor를 선택하고, `content.css`를 스킨에 포함합니다. | 40 | > 이 문서는 2026-09-28에 v10.5.1 기준으로 다시 썼습니다. 9.x 이하 계열은 EOL이며 업데이트 대상이 아닙니다. |
| 41 | 4. **권한 확인**: 업로드 및 협업 기능을 위해 `data`와 `collab` 디렉터리 권한을 707로 설정합니다. | 41 | 2. **업로드 — 올리는 위치가 CMS마다 다릅니다**: |
| 42 | | 쓰는 환경 | 올리는 위치 | | ||
| 43 | |---|---| | ||
| 44 | | 그누보드5 | `g5/plugin/editor/t2editor/` | | ||
| 45 | | 라이믹스 2.1.x | `rhymix/modules/editor/skins/t2editor/` | | ||
| 46 | | CMS 없이 직접 운영 | 웹 루트 또는 원하는 경로의 `t2editor/` | | ||
| 47 | |||
| 48 | 여기서 "CMS 종류"를 따로 고르는 설정은 없습니다. 폴더를 올리면 에디터가 그 자리의 파일 구조를 보고 스스로 판단합니다. 다만 **한 단계라도 잘못 올리면 CMS 인식을 못 하고 화면이 이상해집니다.** | ||
| 49 | 3. **에디터 선택**: 그누보드5는 관리자 → 환경설정 → 기본환경설정 → 에디터 선택에서 고릅니다. 게시판마다 다르게 쓰려면 게시판 관리 → 해당 게시판 → 에디터 사용에서 고릅니다. 라이믹스는 관리자 → 고급 설정 → 에디터 → 에디터 스킨에서 고릅니다. | ||
| 50 | 4. **최초 설치 안내 통과**: 글쓰기 화면을 열면 **T2Editor 최초 설치 안내**가 뜨고, 끝까지 통과하기 전까지 편집 기능이 잠깁니다. 안내가 하는 일은 ① 관리자 기능이 켜져 있는지 확인 ② 관리자 비밀번호 설정 여부 확인 ③ 파일을 저장할 폴더의 쓰기 권한 확인 ④ 서버가 필요한 기능을 지원하는지 확인입니다. **처음 설치할 때 놓친 설정을 자동으로 확인해주는 안내 화면**이므로 화면에 표시된 실패 항목을 그대로 해결하십시오. 그누보드5·라이믹스는 CMS 관리자 로그인으로 인증하지만, CMS 인증이 실패하는 환경에서는 `admin/t2admin.key.txt` 파일명을 `admin/t2admin.key`로 바꾸고 자체 비밀번호를 설정해야 합니다. 자세한 건 [[01-installation-guide.md]] 4절을 보십시오. | ||
| 51 | 5. **보기 화면 스타일 확인**: `content.css`를 스킨에 포함합니다. 이 지시는 지금도 유효합니다 — 에디터가 본문에 스타일시트 링크를 자동 삽입하지만 CMS의 HTML 보안 필터가 지우기 때문에 스킨 쪽에서 직접 링크해 주는 편이 안전합니다. 이 단계를 빼면 작성 화면은 멀쩡한데 보기 화면만 밋밋해집니다. | ||
| 52 | 6. **권한 확인**: 쓰기 권한이 필요한 곳은 CMS 환경에 따라 한 곳입니다 — 그누보드5는 CMS 데이터 폴더, 라이믹스는 `files`, CMS 없이는 `t2editor/data/`. 최소 권장값은 **707**이고 777은 쓰지 마세요. 더 좁은 권한이어도 PHP 실제 쓰기 시험이 통과하면 그대로 둡니다. **협업용 폴더를 따로 만들지 마십시오** — 에디터가 `t2editor_db/collab/`에 알아서 만듭니다. 숫자를 보고 무작정 chmod하지 말고 에디터 하단 **정보·진단 화면**이 주는 실제 경로와 명령을 따르십시오. | ||
| 42 | 5. **사용**: 게시판 글쓰기 페이지에서 T2Editor를 사용해 글을 작성하고 미디어를 추가합니다. | 53 | 5. **사용**: 게시판 글쓰기 페이지에서 T2Editor를 사용해 글을 작성하고 미디어를 추가합니다. |
| 43 | 54 | ||
| 44 | 이 과정을 완료하면 기본적인 사용 준비가 끝납니다. 추가 기능을 원한다면 플러그인 문서를 참고하여 필요한 플러그인을 활성화하세요. | 55 | 이 과정을 완료하면 기본적인 사용 준비가 끝납니다. 추가 기능을 원한다면 플러그인 문서를 참고하여 필요한 플러그인을 활성화하세요. |
| 45 | 56 | ||
| 46 | ## 참고 자료 | 57 | ## 참고 자료 |
| 47 | 58 | ||
| 48 | - 설치 방법: [DSclub T2Editor 서비스 페이지 - 설치·오류 안내](https://dsclub.kr/service/editor) | 59 | - 설치 방법: [DSclub T2Editor 서비스 페이지 - 설치·오류 안내](https://dsclub.kr/service/editor) |
| 49 | - 기능 소개: [DSclub T2Editor 서비스 페이지](https://dsclub.kr/service/editor) | 60 | - 기능 소개: [DSclub T2Editor 서비스 페이지](https://dsclub.kr/service/editor) |
| 50 | 61 | ||
| 51 | ## 처음 설치한 뒤 바로 확인할 것 | 62 | ## 처음 설치한 뒤 바로 확인할 것 |
| 52 | 63 | ||
| 53 | 초보자와 웹마스터는 설치만 끝났다고 바로 운영에 들어가지 말고, 최소한 다섯 가지를 확인하는 것이 좋습니다. 첫째, 작성 화면이 정상적으로 뜨는지. 둘째, 글 저장 후 보기 화면에서 스타일이 깨지지 않는지. 셋째, 이미지와 파일 업로드가 되는지. 넷째, 모바일 화면에서 툴바가 과도하게 깨지지 않는지. 다섯째, 협업이나 AI처럼 외부 의존 기능을 실제로 쓸 계획이 있는지입니다. 마지막 항목은 특히 중요합니다. 안 쓰는 기능이라면 초기에 비활성화해 두는 것이 관리 부담을 줄입니다. | 64 | 초보자와 웹마스터는 설치만 끝났다고 바로 운영에 들어가지 말고, 최소한 다섯 가지를 확인하는 것이 좋습니다. 첫째, 작성 화면이 정상적으로 뜨는지. 둘째, 글 저장 후 보기 화면에서 스타일이 깨지지 않는지. 셋째, 이미지와 파일 업로드가 되는지. 넷째, 모바일 화면에서 툴바가 과도하게 깨지지 않는지. 다섯째, 협업이나 AI처럼 외부 의존 기능을 실제로 쓸 계획이 있는지입니다. 마지막 항목은 특히 중요합니다. 안 쓰는 기능이라면 초기에 비활성화해 두는 것이 관리 부담을 줄입니다. |
| 54 | 65 | ||
| 55 | ## 운영 전 체크리스트 | 66 | ## 운영 전 체크리스트 |
| 56 | 67 | ||
| 57 | - 관리자 페이지에서 에디터 선택이 실제 게시판에도 반영되었는지 확인 | 68 | - 관리자 페이지에서 에디터 선택이 실제 게시판에도 반영되었는지 확인 |
| 58 | - `content.css`가 보기 페이지에 반영되었는지 확인 | 69 | - `content.css`가 보기 페이지에 반영되었는지 확인(작성 화면이 멀쩡해도 여기서 안 보이면 본문용 스타일시트가 빠진 것입니다) |
| 59 | - `data`, `collab` 디렉터리 권한 확인 | 70 | - 공용 데이터 폴더 쓰기 권한 확인(최소 권장 707. 협업 폴더는 만들지 않습니다) |
| 60 | - 보안상 허용하지 않을 확장자는 업로드 설정에서 제거 | 71 | - 보안상 허용하지 않을 확장자는 업로드 설정에서 제거 |
| 61 | - 외부 서비스 의존 기능(AI, 검색, ClipURL) 사용 여부 결정 | 72 | - 외부 서비스 의존 기능(AI, 검색, ClipURL) 사용 여부 결정 |
| 73 | - 관리자 페이지(확장 마켓·업데이트)에 접근 가능한지 확인 — CMS 관리자 로그인이 되지만, 안 되면 자체 비밀번호로 로그인해야 합니다(10.5.1) | ||
| 74 | - 확장 기능은 관리자 페이지의 **확장 마켓**에서 검색해 설치할 수 있습니다(10.4.0). 서버 ZIP을 FTP로 덮어쓰는 방식보다 안전하며, 설치 전 안전성 검사가 수행됩니다 | ||
| 62 | 75 | ||
| 63 | ## 참고 자료 | 76 | ## 참고 자료 |
| 64 | 77 | ||
| 65 | - DSclub T2Editor 서비스 페이지: https://dsclub.kr/service/editor | 78 | - DSclub T2Editor 서비스 페이지: https://dsclub.kr/service/editor |
| 66 | - SIR T2Editor 8.1.2 소개 글: https://sir.kr/boards/g5_plugin/15016 | 79 | - 현행 정보: https://dsclub.kr/service/editor |
| 80 | - 참고 이력(현재 기준으로는 쓰지 마십시오): SIR T2Editor 8.1.2 소개 글 https://sir.kr/boards/g5_plugin/15016 은 2026-03 판본 기준 자료입니다. | ||
| 81 | - 설치 절차 3경로와 최초 설정 게이트: [[01-installation-guide.md]] | ||
| 82 | - 그누보드5 연동 상세: [[05-gnuboard5-integration-guide.md]] | ||
| 67 | 83 | ||