🔐로그인하면 문서 작성, 프로젝트 게시, ZIP 기반 버전 업로드, 브랜치 생성 기능을 사용할 수 있습니다. 로그인하러 가기
GNUBoard5 연동 가이드

리비전 비교

⎇ main ← 이력
비교 대상 선택
추가 0줄 삭제 0줄 변경 0줄 동일 67줄
r1 파일 가져오기: 05-gnuboard5-integration-guide.md
2026-04-17 14:54

그누보드5 연동 가이드

T2Editor는 그누보드5와 긴밀하게 연동될 수 있도록 설계되었습니다. 연동 절차와 고려사항은 다음과 같습니다:

  • 플러그인 폴더에 업로드: t2editor 폴더를 그누보드5의 /plugin 또는 /editor 디렉터리에 업로드합니다.
  • 보드 설정: 게시판 관리자 페이지에서 T2Editor를 기본 에디터로 선택합니다.
  • 스킨 및 테마: 기존 그누보드5 스킨과의 충돌을 피하기 위해 content.css를 적절한 위치에 포함시킵니다.
  • 권한 관리: 협업과 업로드 기능을 사용하기 위해 data와 collab 디렉터리에 707 권한을 부여합니다.
  • 버전 호환성: 그누보드5 5.5 이상에서 테스트 되었으며, 이전 버전에서는 호환성 문제가 발생할 수 있습니다.
  • 업데이트 주의: 그누보드5를 업데이트할 때 T2Editor의 파일이 덮어쓰여지지 않도록 백업을 유지하세요.

참고 자료

실제 연동에서 자주 놓치는 지점

그누보드5 연동에서 가장 많이 놓치는 부분은 본문 출력용 스타일 파일 포함, 업로드 디렉터리 권한, 게시판별 에디터 선택입니다. 설치만 끝내고 content.css를 출력 페이지에 반영하지 않으면 작성 화면은 멀쩡해 보여도 본문 보기 화면에서 미디어 블록이 깨질 수 있습니다. 또 관리자 페이지에서 전체 기본값만 바꾸고 개별 게시판 설정을 수정하지 않으면 특정 게시판에서는 여전히 기존 에디터가 유지될 수 있습니다.

스킨 충돌 대응법

그누보드5 스킨은 프로젝트마다 차이가 크므로, T2Editor가 출력하는 클래스와 기존 스킨 CSS가 충돌할 수 있습니다. 이때는 T2Editor 쪽 CSS를 무작정 수정하기보다 먼저 충돌하는 선택자를 찾아 스킨 쪽에서 범위를 제한하는 방식으로 해결하는 것이 좋습니다. 예를 들어 .view-content img처럼 지나치게 넓은 규칙이 있다면 T2Editor 미디어 블록을 별도로 제외해 주는 방식이 안전합니다.

버전 업데이트 시 점검 목록

그누보드5 자체 업데이트 후에는 에디터 호출 경로, 관리자 에디터 선택 값, 첨부파일 필터링 정책, view 스킨 CSS 포함 상태를 다시 검사해야 합니다. 에디터가 교체되거나 게시판 설정이 초기화되는 경우도 있으므로 업데이트 직후에는 최소한 한 개 테스트 게시판에서 작성·수정·삭제·첨부·보기 흐름을 다시 검수하는 것을 권장합니다.

참고 자료

r1 파일 가져오기: 05-gnuboard5-integration-guide.md
2026-04-17 14:54

그누보드5 연동 가이드

T2Editor는 그누보드5와 긴밀하게 연동될 수 있도록 설계되었습니다. 연동 절차와 고려사항은 다음과 같습니다:

  • 플러그인 폴더에 업로드: t2editor 폴더를 그누보드5의 /plugin 또는 /editor 디렉터리에 업로드합니다.
  • 보드 설정: 게시판 관리자 페이지에서 T2Editor를 기본 에디터로 선택합니다.
  • 스킨 및 테마: 기존 그누보드5 스킨과의 충돌을 피하기 위해 content.css를 적절한 위치에 포함시킵니다.
  • 권한 관리: 협업과 업로드 기능을 사용하기 위해 data와 collab 디렉터리에 707 권한을 부여합니다.
  • 버전 호환성: 그누보드5 5.5 이상에서 테스트 되었으며, 이전 버전에서는 호환성 문제가 발생할 수 있습니다.
  • 업데이트 주의: 그누보드5를 업데이트할 때 T2Editor의 파일이 덮어쓰여지지 않도록 백업을 유지하세요.

참고 자료

실제 연동에서 자주 놓치는 지점

그누보드5 연동에서 가장 많이 놓치는 부분은 본문 출력용 스타일 파일 포함, 업로드 디렉터리 권한, 게시판별 에디터 선택입니다. 설치만 끝내고 content.css를 출력 페이지에 반영하지 않으면 작성 화면은 멀쩡해 보여도 본문 보기 화면에서 미디어 블록이 깨질 수 있습니다. 또 관리자 페이지에서 전체 기본값만 바꾸고 개별 게시판 설정을 수정하지 않으면 특정 게시판에서는 여전히 기존 에디터가 유지될 수 있습니다.

스킨 충돌 대응법

그누보드5 스킨은 프로젝트마다 차이가 크므로, T2Editor가 출력하는 클래스와 기존 스킨 CSS가 충돌할 수 있습니다. 이때는 T2Editor 쪽 CSS를 무작정 수정하기보다 먼저 충돌하는 선택자를 찾아 스킨 쪽에서 범위를 제한하는 방식으로 해결하는 것이 좋습니다. 예를 들어 .view-content img처럼 지나치게 넓은 규칙이 있다면 T2Editor 미디어 블록을 별도로 제외해 주는 방식이 안전합니다.

버전 업데이트 시 점검 목록

그누보드5 자체 업데이트 후에는 에디터 호출 경로, 관리자 에디터 선택 값, 첨부파일 필터링 정책, view 스킨 CSS 포함 상태를 다시 검사해야 합니다. 에디터가 교체되거나 게시판 설정이 초기화되는 경우도 있으므로 업데이트 직후에는 최소한 한 개 테스트 게시판에서 작성·수정·삭제·첨부·보기 흐름을 다시 검수하는 것을 권장합니다.

참고 자료

라인 단위 비교
이전 새 버전
1 --- 1 ---
2 title: GNUBoard5 연동 가이드 2 title: GNUBoard5 연동 가이드
3 document_id: 05-gnuboard5-integration-guide 3 document_id: 05-gnuboard5-integration-guide
4 slug: 05-gnuboard5-integration-guide 4 slug: 05-gnuboard5-integration-guide
5 target_editor_version: 9.0.0 5 target_editor_version: 9.0.0
6 document_type: integration 6 document_type: integration
7 doc_type: integration 7 doc_type: integration
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: Integration 11 core_type: Integration
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: 06 22 reading_order: 06
23 summary: 그누보드5와 T2Editor를 연동하는 방법을 설명 문서 23 summary: 그누보드5와 T2Editor를 연동하는 방법을 설명 문서
24 description: 그누보드5와 T2Editor를 연동하는 방법을 설명 24 description: 그누보드5와 T2Editor를 연동하는 방법을 설명
25 tags: [GNUBoard5, integration, T2Editor] 25 tags: [GNUBoard5, integration, T2Editor]
26 version_tag: 9.0.0 26 version_tag: 9.0.0
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 ## 그누보드5 연동 가이드 35 ## 그누보드5 연동 가이드
36   36  
37 T2Editor는 그누보드5와 긴밀하게 연동될 수 있도록 설계되었습니다. 연동 절차와 고려사항은 다음과 같습니다: 37 T2Editor는 그누보드5와 긴밀하게 연동될 수 있도록 설계되었습니다. 연동 절차와 고려사항은 다음과 같습니다:
38 - **플러그인 폴더에 업로드**: `t2editor` 폴더를 그누보드5의 `/plugin` 또는 `/editor` 디렉터리에 업로드합니다. 38 - **플러그인 폴더에 업로드**: `t2editor` 폴더를 그누보드5의 `/plugin` 또는 `/editor` 디렉터리에 업로드합니다.
39 - **보드 설정**: 게시판 관리자 페이지에서 T2Editor를 기본 에디터로 선택합니다. 39 - **보드 설정**: 게시판 관리자 페이지에서 T2Editor를 기본 에디터로 선택합니다.
40 - **스킨 및 테마**: 기존 그누보드5 스킨과의 충돌을 피하기 위해 `content.css`를 적절한 위치에 포함시킵니다. 40 - **스킨 및 테마**: 기존 그누보드5 스킨과의 충돌을 피하기 위해 `content.css`를 적절한 위치에 포함시킵니다.
41 - **권한 관리**: 협업과 업로드 기능을 사용하기 위해 `data`와 `collab` 디렉터리에 707 권한을 부여합니다. 41 - **권한 관리**: 협업과 업로드 기능을 사용하기 위해 `data`와 `collab` 디렉터리에 707 권한을 부여합니다.
42 - **버전 호환성**: 그누보드5 5.5 이상에서 테스트 되었으며, 이전 버전에서는 호환성 문제가 발생할 수 있습니다. 42 - **버전 호환성**: 그누보드5 5.5 이상에서 테스트 되었으며, 이전 버전에서는 호환성 문제가 발생할 수 있습니다.
43 - **업데이트 주의**: 그누보드5를 업데이트할 때 T2Editor의 파일이 덮어쓰여지지 않도록 백업을 유지하세요. 43 - **업데이트 주의**: 그누보드5를 업데이트할 때 T2Editor의 파일이 덮어쓰여지지 않도록 백업을 유지하세요.
44   44  
45 ## 참고 자료 45 ## 참고 자료
46   46  
47 - 설치 및 권한 설정: [DSclub T2Editor 서비스 페이지 - 설치·오류 안내](https://dsclub.kr/service/editor) 47 - 설치 및 권한 설정: [DSclub T2Editor 서비스 페이지 - 설치·오류 안내](https://dsclub.kr/service/editor)
48 - 기능 설명: [SIR T2Editor 8.1.2 소개 글](https://sir.kr/boards/g5_plugin/15016) 48 - 기능 설명: [SIR T2Editor 8.1.2 소개 글](https://sir.kr/boards/g5_plugin/15016)
49   49  
50 ## 실제 연동에서 자주 놓치는 지점 50 ## 실제 연동에서 자주 놓치는 지점
51   51  
52 그누보드5 연동에서 가장 많이 놓치는 부분은 **본문 출력용 스타일 파일 포함**, **업로드 디렉터리 권한**, **게시판별 에디터 선택**입니다. 설치만 끝내고 `content.css`를 출력 페이지에 반영하지 않으면 작성 화면은 멀쩡해 보여도 본문 보기 화면에서 미디어 블록이 깨질 수 있습니다. 또 관리자 페이지에서 전체 기본값만 바꾸고 개별 게시판 설정을 수정하지 않으면 특정 게시판에서는 여전히 기존 에디터가 유지될 수 있습니다. 52 그누보드5 연동에서 가장 많이 놓치는 부분은 **본문 출력용 스타일 파일 포함**, **업로드 디렉터리 권한**, **게시판별 에디터 선택**입니다. 설치만 끝내고 `content.css`를 출력 페이지에 반영하지 않으면 작성 화면은 멀쩡해 보여도 본문 보기 화면에서 미디어 블록이 깨질 수 있습니다. 또 관리자 페이지에서 전체 기본값만 바꾸고 개별 게시판 설정을 수정하지 않으면 특정 게시판에서는 여전히 기존 에디터가 유지될 수 있습니다.
53   53  
54 ## 스킨 충돌 대응법 54 ## 스킨 충돌 대응법
55   55  
56 그누보드5 스킨은 프로젝트마다 차이가 크므로, T2Editor가 출력하는 클래스와 기존 스킨 CSS가 충돌할 수 있습니다. 이때는 T2Editor 쪽 CSS를 무작정 수정하기보다 먼저 충돌하는 선택자를 찾아 스킨 쪽에서 범위를 제한하는 방식으로 해결하는 것이 좋습니다. 예를 들어 `.view-content img`처럼 지나치게 넓은 규칙이 있다면 T2Editor 미디어 블록을 별도로 제외해 주는 방식이 안전합니다. 56 그누보드5 스킨은 프로젝트마다 차이가 크므로, T2Editor가 출력하는 클래스와 기존 스킨 CSS가 충돌할 수 있습니다. 이때는 T2Editor 쪽 CSS를 무작정 수정하기보다 먼저 충돌하는 선택자를 찾아 스킨 쪽에서 범위를 제한하는 방식으로 해결하는 것이 좋습니다. 예를 들어 `.view-content img`처럼 지나치게 넓은 규칙이 있다면 T2Editor 미디어 블록을 별도로 제외해 주는 방식이 안전합니다.
57   57  
58 ## 버전 업데이트 시 점검 목록 58 ## 버전 업데이트 시 점검 목록
59   59  
60 그누보드5 자체 업데이트 후에는 에디터 호출 경로, 관리자 에디터 선택 값, 첨부파일 필터링 정책, view 스킨 CSS 포함 상태를 다시 검사해야 합니다. 에디터가 교체되거나 게시판 설정이 초기화되는 경우도 있으므로 업데이트 직후에는 최소한 한 개 테스트 게시판에서 작성·수정·삭제·첨부·보기 흐름을 다시 검수하는 것을 권장합니다. 60 그누보드5 자체 업데이트 후에는 에디터 호출 경로, 관리자 에디터 선택 값, 첨부파일 필터링 정책, view 스킨 CSS 포함 상태를 다시 검사해야 합니다. 에디터가 교체되거나 게시판 설정이 초기화되는 경우도 있으므로 업데이트 직후에는 최소한 한 개 테스트 게시판에서 작성·수정·삭제·첨부·보기 흐름을 다시 검수하는 것을 권장합니다.
61   61  
62 ## 참고 자료 62 ## 참고 자료
63   63  
64 - DSclub T2Editor 서비스 페이지: https://dsclub.kr/service/editor 64 - DSclub T2Editor 서비스 페이지: https://dsclub.kr/service/editor
65 - DSclub 8.2.0 배포 페이지: https://dsclub.kr/zip/998 65 - DSclub 8.2.0 배포 페이지: https://dsclub.kr/zip/998
66 - SIR T2Editor 8.1.2 소개 글: https://sir.kr/boards/g5_plugin/15016 66 - SIR T2Editor 8.1.2 소개 글: https://sir.kr/boards/g5_plugin/15016
67   67  
T2WIKI · 기술 통합 위키 & 프로젝트 허브 · 나무위키 + Markdown 완벽 지원 · SQLite · PHP 8.2 · 소개 · 문법 안내