설치 방법 안내서

1. 이 안내서는 누구를 위한 문서인가

• 대상 판본은 T2Editor 10.5.1 (2026-07-27) 입니다. 현재 공개된 판본입니다.
• v1 ~ v9 는 모두 지원이 끝난(EOL) 판본입니다. 이 문서에는 9.x 이하를 설치하기 위한 지시를 두지 않습니다.
• v11 은 별도 저장소에서 개발 중인 판본이며 아직 공개 배포되지 않았습니다. 이 문서는 v10 설치를 설명합니다.
• 배포본과 설치 계약의 기준이 v10.5.1 과 다른 v11 안내서를 보실 때는 7-3절을 먼저 확인하십시오. v11 의 방법 중 상당수가 10.x 에는 없습니다.

9.0.0 시대를 기준으로 적혀 있던 이전 안내서와 달리, 아래 4가지는 10.x 에서 바뀐 지점이며 설치와 곧바로 엮여 있습니다.

2. 설치 전에 확인할 것

2-1. PHP 버전

최소 PHP 7.4.0, 신규 운영 환경은 8.1 또는 8.2를 권장합니다.

• 7.4 미만이면 관리자 화면의 환경 점검에서 오류로 표시되고 설치가 진행되지 않습니다. 이 판정은 문서 설명이 아니라 코드가 강제합니다.
• 이 값이 바뀐 경위는 이렇습니다. 10.0.0 / 10.0.1 이 PHP "권장 사양"을 7.4 → 8.0 이상으로 올렸고, 10.1.0 이 "php7.4 호환 추가"로 되돌렸으며, 10.5.0 릴리즈 노트는 "PHP 7.4부터 8.4까지의 호환 범위를 유지"라고 명시합니다.
• 정리하면: 7.4 에서 동작합니다. 새 서버를 세팅한다면 8.1 또는 8.2로 시작하십시오. 7.4 를 유지하실 경우에도 문제가 없습니다.

2-2. PHP 확장

"설치가 안 된다"는 오해가 가장 많은 부분이라 분명히 적습니다. PHP 7.4 기본 상태(확장 없음)만으로도 설치와 글쓰기는 정상 동작합니다. 확장이 꼭 필요한 것은 관리자 쪽 기능입니다.

2-3. 쓰기 권한 (요약)

한 줄로: 공용 데이터 폴더 하나만 쓰기 가능하면 됩니다. 최소 권장값은 707 입니다. 자세한 내용은 5절에 있습니다.

2-4. 어디에 올려놓아야 하는가

• 폴더 이름은 바꾸지 마십시오. 두 CMS 모두 폴더 구조만 보고 스스로 판별합니다. 이름이 달라지면 CMS 로 인식되지 않아 CMS 관리자 연동·데이터 경로·업로드 경로가 전부 어긋납니다.
• "어느 CMS 모드로 설치할지"를 고르는 설정은 없습니다. 폴더를 잘못 놓으면 오류 없이 독립 환경처럼 동작해 보일 수 있습니다. 표의 경로를 정확히 확인하십시오.
• 워드프레스 연동용 어댑터가 배포판에 포함되어 있으나, 이 안내서는 스탠드얼론·그누보드5·라이믹스 세 경로만 다룹니다. 워드프레스의 설치 위치와 등록 절차는 [확인 필요] 입니다.

3. 설치 방법 — 3경로

3-1. 스탠드얼론 (CMS 없이 사용)

1. 현재 판본 배포판을 받아 압축을 풉니다.
2. t2editor 폴더 통째를 웹에서 도달 가능한 위치에 올립니다. 예: /var/www/html/t2editor/
3. 소유자를 웹 서버 실행 계정(예 www-data)으로 맞추고, 폴더는 755 · 파일은 644 로 두면 됩니다. 원본 폴더는 쓰기 가능하게 두지 마십시오.
4. 데이터는 t2editor/data/ 아래에 쌓입니다. 폴더가 없으면 에디터가 첫 요청 때 만듭니다.
5. 관리자 화면은 https://내도메인/t2editor/admin/index.php 입니다.
6. 글쓰기 화면에 붙이는 코드는 6-1절에 있습니다.

3-2. 그누보드5

1. <그누보드5 루트>/plugin/editor/t2editor/ 에 올립니다. 폴더 이름이 t2editor 여야 CMS 로 인식됩니다.
2. 데이터 위치는 CMS 를 따릅니다. 에디터가 자기 폴더 안에 쌓지 않습니다.

• 이미지·첨부파일: g5/data/editor/
• 관리자 설정·인증 정보·협업 데이터·업데이트 기록·서드파티 설치 정보: g5/data/t2editor_db/

1. 예전 버전의 g5/data/editor/t2editor_db/ 에 데이터가 남아 있으면 10.5.1 이 최초 실행 때 자동으로 새 위치로 옮깁니다. 옮겨진 설정 안에 남은 과거 경로도 함께 고쳐집니다.
2. 권한은 그누보드5의 디렉터리 권한 설정을 그대로 따릅니다. T2Editor 폴더만 따로 chmod 하지 마시고, CMS 관리자 → 환경설정 권한 화면에서 처리하는 편이 안전합니다. 그누보드5 가 이 디렉터리를 만들 때 쓰는 값도 그 CMS 설정에서 옵니다.
3. 관리자 화면에서 T2Editor 를 에디터로 선택합니다 → 6-2절.

3-3. 라이믹스

1. <라이믹스 루트>/modules/editor/skins/t2editor/ 에 올립니다. 폴더 이름이 t2editor 가 아니면 관리자 에디터 목록에 뜨지 않습니다.
2. 스킨 파일(skin.xml, config.blade.php, editor.html)이 배포판에 그대로 들어 있습니다. 기본 그대로 두십시오. 스킨 정보의 판본 표기도 10.5.1 기준으로 정리되어 있습니다.
3. 데이터 위치: 미디어 업로드는 라이믹스 파일 모듈(files/)을 씁니다. T2Editor 내부 데이터는 files/t2editor_db/ 아래에 놓입니다.
4. 동영상 iframe 허용 목록은 별도 애드온 설정 없이도 등록되도록 경로 계산이 정리되어 있습니다(10.5.1).
5. 관리자 화면에서 에디터 스킨으로 T2Editor 를 선택합니다 → 6-3절.

4. 첫 실행 — 「최초 설치 안내」를 끝까지 통과하십시오

이 단계를 건너뛰면 글쓰기 화면에서 편집이 되지 않습니다.

10.4.0 이 추가한 화면입니다. 필수 설정이 끝나지 않으면 편집 영역이 잠깁니다 — 툴바는 보이지만 편집 영역의 클릭·선택이 반응하지 않는 형태입니다. 안내가 떴다는 것은 문제가 있다는 뜻이 아니라, 아직 설치를 마치지 않았다는 뜻입니다. 이 안내는 15건의 사용자 문서 어디에도 없던 정보입니다.

4-1. 안내가 요구하는 것

스탠드얼론 — 4단계

1. admin/t2admin.key.txt 파일의 이름을 admin/t2admin.key 로 변경합니다. 이름을 바꾸는 것만으로 관리자 기능이 켜집니다.
2. t2editor/admin/index.php 로 들어가 관리자 비밀번호를 설정합니다.
3. 공용 데이터 폴더를 최소 권장 707 로 맞추고, 안내 화면이 보여 주는 실제 PHP 쓰기 시험이 통과하는지 확인합니다.
4. 안내를 끝까지 스크롤하고 확인 체크박스를 선택한 뒤 닫습니다. 확인 기록은 공용 데이터의 t2editor_db/first_run_state.php 에 저장되고, 그 다음부터 에디터를 쓸 수 있습니다.

그누보드5 · 라이믹스 — 3단계

1. CMS 관리자 로그인으로 T2Editor 관리자 기능을 사용합니다.
2. CMS 데이터 경로의 쓰기 권한과 실제 쓰기 시험을 확인합니다.
3. 안내를 끝까지 읽고 확인합니다.

• CMS 관리자 로그인이 정상 인식되지 않는 환경(빌더 환경, 서브폴더 설치 등)에서는 위 3단계 대신 4-1의 ①·②가 필요합니다. 안내 화면이 그 사실을 함께 알려 줍니다.
• 그 판단은 코드가 내립니다. CMS 인증 어댑터가 있는 환경(그누보드5·라이믹스)은 CMS 로그인을 우선하고, 독립 환경일 때만 자체 비밀번호를 필수로 요구합니다. 4-4절은 그 예외 경로입니다.

4-2. 서버 명령이 필요한 경우

안내 화면의 ③번 영역이 서버가 실제로 감지한 경로를 그대로 채워 줍니다. 그 경로와 명령을 복사해 그대로 쓰십시오.

• 리눅스 안내에는 첫 줄로 # T2Editor detected path: <경로> 가 붙습니다. 이 경로가 배포판을 실제로 놓은 위치와 같은지 확인하십시오. 다르다면 서버가 위치를 잘못 찾은 것이므로 그 상태에서 chmod 하지 마십시오.
• 이 화면은 PHP 파일 생성·쓰기·삭제 시험을 직접 돌립니다. 숫자를 보고 무작정 chmod 하지 않아도 됩니다.

4-3. 안내가 끝난 뒤에도 한 번 더 뜨는 것

admin/t2admin.key 로 이름을 바꾼 뒤 admin/t2admin.key.txt 를 지우지 않으면 "남아 있는 t2admin.key.txt 삭제" 안내가 한 번 더 뜹니다. 확인하면 다시 나오지 않습니다. 지워도 무방합니다.

4-4. 관리자 페이지에 들어가지 못할 때

에디터 하단 정보 및 진단 화면(에디터 아래의 버전 정보를 누르면 열립니다)을 보십시오. 이 화면의 버튼은 상태에 따라 세 가지입니다.

• 이 자체 로그인은 CMS 관리자 인증과 공존합니다. CMS 관리자 인증은 그대로 유지되고, 필요할 때만 자체 로그인을 씁니다(10.5.1).
• CMS 관리자 인증이 실패하는 환경에서도 이 방법으로 관리자 페이지에 접근할 수 있습니다.
• 업데이트·백업 복구·서드파티 설치 같은 중요한 작업에서는, 자체 로그인으로 들어와도 비밀번호를 한 번 더 묻습니다.

5. 권한 설정

5-1. 무엇에 쓰기 권한이 필요한가

공용 데이터 폴더 하나입니다. 그 안쪽의 나머지 폴더와 방어 파일은 에디터가 첫 요청 때 알아서 만듭니다.

5-2. 숫자는 최소 권장값일 뿐입니다

• 최소 권장값은 707 입니다. 777은 사용하지 마십시오. 필요 이상으로 넓고, 10.5.0 릴리즈 노트도 777을 권장하지 않는다고 명시했습니다.
• 안내 화면이 감지한 경로와 명령을 그대로 쓰십시오. 그 화면은 실제 쓰기 시험으로 통과 여부를 알려 줍니다.
• 쓰기 시험이 더 좁은 권한으로 통과하면 그 권한을 그대로 두십시오. 숫자만 보고 무작정 chmod 하지 않아도 됩니다.
• 참고로, 에디터가 폴더를 새로 만들 때 쓰는 값은 CMS 어댑터에서 옵니다(독립 환경 0755, 그누보드5 는 CMS 의 디렉터리 권한 설정값, 라이믹스 0755). 위의 707 은 그 값이 아니라 안내 화면이 사용자에게 권하는 최소 기준입니다. 둘은 다를 수 있습니다.

5-3. 직접 만들지 마십시오

• t2editor/collab/ 폴더를 새로 만들지 마십시오. 협업 데이터는 공용 데이터의 t2editor_db/collab/ 아래에 있고 에디터가 만듭니다.
• 예전 버전의 t2editor/collab/ 폴더가 남아 있으면 10.5.1 이 최초 실행 때 자동으로 새 위치로 옮깁니다. 새로 만든 폴더는 아무 효과가 없고 다음 갱신 때 다시 옮겨집니다.
• 그누보드5 의 g5/data/editor/t2editor_db/ 도 직접 옮기지 마십시오. 자동 이관됩니다.

5-4. 원본 폴더는 읽기 전용으로 두십시오

쓰기 권한은 공용 데이터 경로에만 부여하십시오. T2Editor 원본 코드와 plugin/, extend/, locales/ 전체를 쓰기 가능하게 만들면 갱신과 보안 측면에서 불리해집니다. 리눅스에서는 데이터 경로만 웹 서버 계정 소유로 바꾸거나 ACL 로 쓰기 권한을 주는 방식을 안내 화면이 제시합니다.

5-5. 웹 서버가 nginx 인 경우 (중요)

배포판은 내부 데이터 폴더에 .htaccess 를 함께 넣습니다. 그 내용은 디렉터리 목록 차단과 그 폴더 안의 PHP 실행 차단입니다. Apache 계열은 이 파일이 그대로 동작하지만, nginx 는 .htaccess 를 읽지 않습니다. nginx·LiteSpeed 로 운영하시면 서버 설정에서 직접 막아 주셔야 합니다.

nginx
location ^~ /t2editor/data/ { deny all; }

경로는 설치 자리에 맞게 바꾸십시오. 그누보드5 는 g5/data/t2editor_db/, 라이믹스는 files/t2editor_db/ 를 막으면 됩니다. 이 사실을 모른 채 운영하시면 관리자 인증 정보가 있는 내부 폴더가 웹에 노출될 수 있습니다. 자세한 내용은 74-security-guide.md 를 보십시오.

5-6. FTP 나 파일 관리기로 설정할 때

호스팅의 권한 설정 화면에서 공용 데이터 폴더만 707 로 설정하십시오. 그보다 넓게 열 필요는 없습니다. admin/t2admin.key 는 600 으로 두는 것을 안내 화면이 권합니다.

6. CMS 에디터로 등록하는 법

6-1. 스탠드얼론 — 페이지에 직접 넣기

php
<?php
require_once __DIR__ . '/t2editor/editor.lib.php';   // 배포판이 놓인 실제 경로
$old_content = $_POST['content'] ?? '';
?>
<form method="post" action="write.php"
      onsubmit="return _submitContent() && <?php echo chk_editor_js('content'); ?>">
  <?php echo editor_html('content', $old_content); ?>
  <script><?php echo get_editor_js('content'); ?></script>
  <button type="submit">저장</button>
</form>

• editor_html($id, $content) 가 숨겨진 입력 필드를 만듭니다. 폼 필드 이름이 곧 $id 이고, 실제로 저장되는 값은 그 이름으로 전달됩니다. 위 예에서는 $_POST['content'] 입니다.
• get_editor_js($id) 는 제출 직전에 본문을 그 입력 필드로 옮기는 스크립트(_submitContent)를 정의합니다. 폼 제출 전에 한 번 더 호출해야 합니다.
• chk_editor_js($id) 는 본문이 비어 있으면 저장을 막습니다.
• 보안 관련 주의 (10.5.1): 10.5.1 배포판에는 서버에서 본문을 거르는 진입점이 들어 있지 않습니다. CMS 를 쓴다면 CMS 가 그 역할을 합니다. CMS 없이 스탠드얼론으로 운영하실 경우 저장 지점에서 별도로 처리하셔야 합니다 → 74-security-guide.md.

6-2. 그누보드5

1. CMS 관리자로 로그인합니다.
2. 환경설정에서 에디터를 T2Editor 로 선택합니다. 게시판마다 다르게 쓰려면 게시판 관리에서 해당 게시판의 에디터를 지정합니다. 선택 화면의 위치 문구는 CMS 쪽 UI 이므로 [확인 필요] 입니다.
3. 그누보드5 에서는 CMS 관리자 로그인 상태를 그대로 T2Editor 관리자 인증에 씁니다. T2Editor 비밀번호를 따로 만들지 않아도 됩니다(10.5.0 변경).
4. 10.5.1 이전 판본을 쓰고 계셨다면 CMS 관리자로 로그인했는데도 T2Editor 가 "관리자 로그인이 필요합니다"만 보여 곤란한 경우가 있었습니다. 10.5.1 에서 수정되었으므로 10.5.1 로 갱신하십시오.

6-3. 라이믹스

1. CMS 관리자로 로그인합니다.
2. 고급 설정 → 에디터 → 에디터 스킨에서 T2Editor 를 선택합니다. 선택 화면의 위치 문구는 CMS 쪽 UI 이므로 [확인 필요] 입니다.
3. 모듈(게시판)마다 다르게 쓰려면 해당 모듈 설정에서 고릅니다.
4. 업로드는 라이믹스 파일 모듈을 통해 이뤄집니다. 첨부파일 목록·용량 계산·삭제가 CMS 쪽과 어긋나지 않으며, 파일이 T2Editor 별도 저장소에 쌓이지 않습니다.
5. 라이믹스 2.1.x 스킨 연동을 포함합니다(10.3.0).

6-4. 관리자 페이지 경로

• 스탠드얼론: t2editor/admin/index.php
• CMS 위: 에디터 하단 정보·진단 화면의 링크, 또는 t2editor/admin/index.php 직접
• 관리자 권한이 확인된 사용자에게만 관리자 경로가 노출됩니다. 일반 사용자에게는 관리자 경로 자체가 보이지 않습니다.

7. 게시 화면에서 본문 스타일 유지하기

7-1. 10.5.1 은 본문에 스타일 링크를 자동으로 넣습니다

글을 제출할 때 본문에 이미지·표·코드·그림 블록 중 하나가 들어 있고 아직 스타일 링크가 없다면, 에디터가 본문 끝에 다음을 자동으로 덧붙입니다.

html
<link href="(에디터 주소)/css/content.css" rel="stylesheet">

• 따라서 기본 상태에서는 스킨에 손댈 필요가 없습니다.
• 반복 편집·재발행해도 링크가 중복 쌓이지 않습니다.
• 이 파일은 배포판에 실제로 들어 있습니다(css/content.css).

7-2. 그래도 보기 화면 스타일이 밋밋할 때

CMS 의 HTML 보안 필터가 본문의 <link> 태그를 지우는 경우가 있습니다. CMS 가 남의 글에 외부 스타일시트를 심지 못하게 막는 것이 정상 동작이므로, 이건 편집기 문제가 아닙니다. 이때 빠져나가는 것은 글 본문 쪽 스타일입니다 — 표의 셀 여백이 0 으로 붙는 것이 대표적인 증상입니다.

이럴 때의 정답은 CMS 가 건드리지 않는 자리, 즉 보기 화면의 스킨·레이아웃 <head> 에 직접 링크하는 것입니다.

html
<link rel="stylesheet" href="/t2editor/css/content.css">

• 그누보드5 스킨이라면 스킨의 head 포함부(예: head.sub.php)에 넣습니다. 정확한 파일명은 스킨 구성에 따라 다르며 [확인 필요] 입니다.
• 링크를 두 군데에 넣어도 규칙이 같아 문제는 없습니다. 다만 한 곳에만 두십시오.
• 경로는 배포판을 올린 실제 경로로 바꾸십시오.
• 문제는 아니지만 알아두실 점: 이 방식이 11 절에서 설명하는 v11 방식으로 대체되는 것이 아닙니다. v11 에서 스킨에 손대지 않는 해법이 추가되었을 뿐입니다.

7-3. ⚠ 다음 방식은 10.5.1 에 존재하지 않습니다

아래는 11 계열에서 소개된 방법이며 10.5.1 에는 없습니다. 그대로 옮겨 적으시면 없는 파일을 찾게 되십니다.

• endpoints/ 디렉터리와 그 안의 설치 진단 화면
• ?bundle=content&scope=published&format=js 형태의 스타일 번들 엔드포인트
• T2Econtentstyleattach() / T2Econtentstyletag() 함수
• config/t2_content_styles.php, config/t2_sanitize.php

10.5.1 배포판 루트 파일은 아래 9개와 여러 디렉터리로 이루어져 있으며 위 항목은 하나도 없습니다.

config.blade.php  editor.core.php  editor.html  editor.lib.php
readme.txt         run.php          skin.xml     t2_css_min.php  t2_js_min.php

루트의 t2_css_min.php 는 ?f= 인자를 받는 단일 파일 축소기입니다. 번들을 묶어 주는 기능이 아닙니다.

8. 오류 대처

8-1. 글쓰기 화면은 열리는데 편집이 되지 않습니다

「최초 설치 안내」가 아직 끝나지 않은 상태입니다. 4절을 완료하십시오. 안내 화면이 이미 사라진 경우라면, 공용 데이터 폴더의 쓰기 권한이 사라진 것입니다 — 쓰기 권한이 회귀하면 안내가 다시 열립니다.

8-2. 「최초 설치 안내」가 계속 나타납니다

안내 화면의 항목 중 실패로 표시된 것이 남아 있습니다. 흔한 두 가지:

• 공용 데이터 폴더 쓰기 실패 → 5-2
• 그누보드5·라이믹스에서 CMS 관리자 로그인 미인식 → 10.5.1 로 갱신하거나 4-4의 자체 로그인 설정

8-3. 관리자 페이지가 열리지 않습니다

4-4를 확인하십시오. 공용 데이터 아래 t2admin-private/ 을 직접 만들지 마십시오. 에디터가 가장 좁은 권한으로 만들고 관리합니다.

8-4. 이미지가 업로드되지 않습니다

• 공용 데이터 폴더의 쓰기 권한 → 5절
• 기본 허용 크기는 50MB 입니다. 서버의 upload_max_filesize / post_max_size 가 이보다 작으면 에디터가 파일 자체를 거릅니다. 관리자 화면의 환경 정보에 실제 한도가 표시됩니다.
• fileinfo 확장을 활성화할 필요는 없습니다.

8-5. 이미지 업로드가 500 오류로 실패합니다 (예: "Image upload could not be completed on this server.")

10.5.0 에서 해결된 문제입니다. GIF 업로드에서 특히 발생하던 오류이며, 10.5.0 부터 GIF87a·GIF89a·투명 GIF·애니메이션 GIF·대문자 .GIF 를 지원하고 애니메이션과 투명도를 보존한 채 원본 그대로 저장합니다. 현재 판본이 10.5.0 미만이면 10.5.1 로 갱신하십시오.

8-6. 기존 글을 편집하면 화면이 비어 보입니다

오래된 글이나 외부에서 복사한 글에 깨진 문자가 들어 있어 본문을 화면에 넘기는 과정이 중단되던 문제이며 10.5.1 에서 수정되었습니다. 현재 판본에서도 동일하면 그 글의 문자 인코딩을 점검하십시오.

8-7. 관리자 화면이 계속 로딩되며 "서버의 PHP 확장과 파일 권한을 확인하고 있습니다"가 사라지지 않습니다

10.5.1 에서 해결된 문제입니다. 관리자 화면에 전달되는 일부 정보가 올바른 문자 형식으로 변환되지 않아 화면 스크립트가 중단되던 경우였습니다. 다른 메뉴도 함께 눌리지 않습니다. 현재 판본에서도 동일하면 서버 오류 로그에서 문자 인코딩 관련 오류를 확인하십시오.

8-8. 도구 모음 버튼이 눌리지 않거나 로딩 표시가 남습니다

10.5.0 에서 플러그인 로딩 실패 복구가 개선되었습니다. 갱신 후에도 남으면 관리자 페이지의 확장 목록에서 해당 플러그인을 한 번 다시 설치하십시오. 플러그인 하나가 실패해도 다른 플러그인과 본문은 계속 동작합니다.

8-9. 보기 화면에서 표·이미지 스타일이 밋밋합니다

7-2를 확인하십시오. 본문에 자동 삽입된 링크가 CMS 필터로 지워진 경우입니다.

8-10. 부적절한 이미지 필터(NSFW)가 동작하지 않습니다

• 9.0.0 계열에서 보고되던 이 문제는 10.4.0 에서 해결되었습니다. 필터가 필요한 파일을 배포판에 포함해 외부 서버에 의존하지 않게 되었고, 특정 설치 환경에서 필터가 아예 작동하지 않던 문제와 움직이는 GIF 검사 오류도 함께 고쳐졌습니다. 검사 방식은 관리자가 설정할 수 있습니다.
• 과거 판본으로 내려가지 마십시오. 아래로 내려가는 것은 문제를 해결하지 못합니다.
• 현재 판본에서 동작하지 않으면 관리자 페이지의 부적절한 이미지 필터 설정에서 검사 방식을 바꾸십시오.

8-11. 라이선스 관련 오류가 납니다

• 배포판에 license.txt / license.dat / license_en.txt / license_kr.txt 는 없습니다. 라이선스는 배포판 루트의 readme.txt 한 파일 안에 한국어와 영어로 함께 들어 있습니다(판본 표시 Version: 3.0.0).
• 확인할 것은 두 가지입니다. ① 배포판 루트에 readme.txt 가 존재하는가 ② 내용이 원본과 동일한가.
• 이상이 있으면 배포판을 다시 받아 t2editor 폴더를 덮어쓰십시오. 설정·업로드·내부 데이터는 data/ 아래에 있으므로 보존됩니다.
• readme.txt 를 직접 편집하거나 지운 채 재배포하면 라이전스 조항에 어긋납니다. 라이선스 본문은 07-license-guide.md 를 보십시오.
• 배포 ZIP 안에 별도 라이선스 파일이 함께 들어 있는지는 [확인 필요] 입니다. 위 지시는 ZIP 형태와 무관하게 안전합니다.

8-12. 툴바 아이콘이 글자로 보이거나 주소가 잘못 나옵니다

툴바에 아이콘 대신 dark_mode 같은 글자가 보인다면, 에디터가 감지한 자신이 있는 주소가 실제 접근 주소와 다르다는 뜻입니다. 서브폴더 설치·심볼릭 링크·리버스 프록시 뒤에서 흔히 발생합니다.

• 4-2절의 # T2Editor detected path: 경로가 배포판의 실제 위치와 같은지 확인하십시오.
• 확인이 필요하면 admin/t2admin.key 상태와 함께 관리자 화면의 환경 정보를 보십시오.
• 원인별로 체크할 항목은 71-error-handling-guide.md 에 정리되어 있습니다.

8-13. 아이콘·폰트가 제대로 표시되지 않습니다

css/, fonts/ 는 읽기 권한만 있으면 됩니다. 쓰기 권한을 줄 필요가 없습니다. 이전 안내서의 "권한을 664 이상으로"라는 지시는 근거가 없어 제외했습니다. FTP 로 업로드한 파일 권한이 지나치게 좁게 잡혔을 때만 조정하십시오.

8-14. 자동 업데이트·확장 마켓이 동작하지 않습니다

• 확장 마켓은 cURL 확장이 반드시 필요합니다(2-2). 자동 업데이트는 cURL 이 없어도 OpenSSL HTTPS 스트림 전송이 가능하면 동작합니다 — 관리자 환경 점검의 "외부 HTTPS 다운로드" 항목에서 어느 경로로 전송되는지 확인할 수 있습니다.
• ZIP 처리는 ZipArchive → 내장 zlib → 관리자 브라우저 폴백 순으로 대체 경로가 있습니다.
• 갱신은 기본적으로 원본을 건드리지 않고 별도 공간에 새 버전을 설치한 뒤 전환하는 방식을 쓰므로, 문제가 생겨도 이전 상태로 되돌릴 수 있습니다.

9. 다음 문서

• 00-overview-macro-guide.md — T2Editor 전체 구조
• 04-standalone-guide.md — 스탠드얼론 사용 상세
• 05-gnuboard5-integration-guide.md — 그누보드5 연동 상세
• 08-beginner-webmaster-quickstart.md — 5분 요약
• 06-version-compatibility-guide.md — 판본 호환성
• 07-license-guide.md — 라이선스 조항 전체
• 71-error-handling-guide.md — 오류 코드별 대응
• 72-version-issues-guide.md — 판본별 알려진 문제
• 75-upload-and-media-pipeline-guide.md — 업로드·미디어 처리
• 74-security-guide.md — 보안
• 70-dsclub-services-guide.md — 배포 및 문의처
• N-05-cms-adapter-and-data-paths.md — CMS 어댑터 4종과 데이터 경로 (라이믹스 경로 포함). 별도의 라이믹스 전용 설치 문서는 만들지 않았습니다 — 3-3절이 그 내용입니다.
• N-02-admin-console-guide.md — 통합 관리 페이지·자동 업데이트·확장 마켓·백업 (10.4.0 추가)

N-xx 번호 체계 메모 (2026-09-28 확정)

이 위키의 N- 번호는 2026-09-28에 등록부를 확정하면서 붙였습니다. 확정된 신규 문서는 4건입니다.

N-01 · N-04 · N-07은 비어 있습니다. 번호를 미리 예약하면 그 번호가 "예정된 문서가 있다"는 뜻으로 읽히고, 실제로 그런 문서가 생기지 않으면 독자가 찾다 포기합니다. 필요해지는 시점에 그때 번호를 쓰십시오. 이전 문안에서 [[N-02-admin-console-guide.md]]·[[N-05-cms-adapter-and-data-paths.md]]처럼 가리키던 링크는 이 등록부 기준으로 교정되었습니다(N-08 → N-02, 라이믹스 경로는 N-05에 포함).

참고 자료

• 배포 및 사용 안내: <https://dsclub.kr/service/editor> — 배포판 readme.txt 에 명시된 최신 판본·사용 안내 주소입니다.