Sakura Editor 실무 가이드
Sakura Editor 플러그인 설치·설정·비활성화 방법
Sakura Editor 플러그인은 데스크톱 편집기에 기능을 추가하는 확장 방식입니다. 먼저 배포처와 지원 버전을 확인하고 sakura.ini 옆의 plugins 폴더에 압축을 푼 뒤 공통 설정에서 등록합니다. 이미 열려 있는 창이 아니라 새 편집기 창에서 변경이 적용되는 경우가 많습니다. 폴더 구조, 활성화, 제거, 문제 해결, 매크로와의 차이를 순서대로 설명합니다.
업데이트: 2026-10-14
핵심 순서: 배치하고, 등록하고, 새 창에서 확인하기
plugins 폴더에 ZIP을 넣는 것은 파일 배치 단계일 뿐입니다. sakura.ini가 있는 설정 폴더를 찾고 올바른 깊이로 플러그인을 풀어 공통 설정 > 플러그인에서 등록합니다. 플러그인을 활성화한 뒤 새 편집기 창을 열어 README에 적힌 기능을 테스트해야 설치 성공 여부를 판단할 수 있습니다.
| 목적 | 확인 위치 | 실무 확인 |
|---|---|---|
| 호환성 확인 | README, 릴리스 정보, 요구 사항 | Sakura Editor·Windows·플러그인 버전 비교 |
| 파일 배치 | sakura.ini 옆의 plugins | 정의 파일이 플러그인 폴더에 있는지 확인 |
| 등록·활성화 | 공통 설정 > 플러그인 | 등록 목록과 상태 확인 |
| 반영 확인 | 새로 연 편집기 창 | 메뉴·도구 모음·아웃라인 등 문서 기능 테스트 |
Sakura Editor 플러그인이란? 매크로와 무엇이 다른가
Sakura Editor 플러그인은 편집기에 추가로 읽히는 확장 모듈입니다. 공식 도움말은 메뉴 명령, 스마트 들여쓰기, 아웃라인 분석, 시작 시 실행 명령을 제공하는 플러그인을 설명합니다. 기능은 플러그인마다 다르므로 이름만 보고 같은 메뉴가 생긴다고 판단하지 말고 README와 정의 파일을 확인해야 합니다.
매크로는 반복 편집이나 외부 프로그램 실행을 스크립트로 자동화하는 방식입니다. 플러그인은 편집기 설정에서 관리하고 본체 기능과 연동할 수 있습니다. 짧은 변환과 반복 작업은 매크로가 적합하고, 메뉴·지원 기능·아웃라인에 통합되는 확장은 플러그인이 후보입니다. 플러그인을 설치해도 모든 매크로가 필요 없어지는 것은 아닙니다.
| 비교 | 플러그인 | 매크로·외부 명령 |
|---|---|---|
| 파일 | 설정 프로필의 plugins 아래 폴더 | 매크로 스크립트 또는 실행 파일 |
| 등록 | 공통 설정 > 플러그인 | 매크로 목록·키 할당·명령 설정 |
| 적합한 작업 | 편집기 명령과 지원 기능 통합 | 반복 편집과 외부 처리 |
| 되돌리기 | 비활성화·등록 해제·폴더 이동 | 등록 해제 또는 파일 복원 |
설치 전에 확인할 네 가지
현재 Sakura Editor 버전을 기록하고 플러그인의 지원 버전과 비교하세요. 공식 일반 도움말은 Sakura Editor 2.0.0.0 이상을 전제로 하지만 개별 플러그인에는 별도 조건이 있을 수 있습니다. 오래된 글에서 ZIP을 얻었다면 작성자, README, 날짜, DLL과 런타임 요구 사항을 확인하고 출처를 확인할 수 없는 실행 파일은 추가하지 마세요.
압축을 풀기 전에 설정 폴더를 확인하세요. sakura.ini 위치는 설치판, Portable판, 사용자별 설정에 따라 다를 수 있습니다. sakura.ini, 기존 plugins, 관련 매크로와 DLL을 별도 폴더에 백업하면 테스트 후 설정 차이를 비교하고 새 파일만 제거할 수 있습니다.
- 버전 기록Sakura Editor 버전, Windows 환경, README의 플러그인 요구 사항을 적습니다.
- 설정 폴더 확인실제 sakura.ini가 있는 폴더를 열고 다른 Portable 사본과 혼동하지 않습니다.
- 백업sakura.ini, 기존 플러그인, 매크로와 DLL을 별도 테스트 폴더에 복사합니다.
- 되돌리기 계획등록 해제, 폴더 이동, 백업 복원 순서를 미리 정합니다.
Sakura Editor 플러그인 설치 단계
공식 도움말의 기본 구조는 sakura.ini와 같은 위치에 plugins 폴더를 만들고 그 안에 플러그인 이름의 폴더를 두는 방식입니다. 압축을 두 번 풀면 plugins\plugin-name\plugin-name\plugin.def처럼 깊어질 수 있습니다. 정의 파일이 너무 깊으면 등록 창에서 플러그인을 찾지 못하므로 탐색기에서 실제 위치를 확인하세요.
파일을 배치해도 이미 열려 있는 창이 자동으로 바뀌지는 않습니다. 공통 설정 > 플러그인에서 로드를 활성화하고 새 플러그인 추가 또는 공식 도움말의 ZIP 설치 명령을 사용하세요. 목록에 이름·상태·읽기·폴더가 표시되면 README의 작성자와 버전을 비교하고 설정 창을 닫은 뒤 새 창에서 작은 파일로 시험합니다.
- ZIP 압축 풀기작성자의 안내에 따라 올바른 plugins 폴더 아래에 플러그인 폴더를 둡니다.
- 정의 파일 확인plugin.def 또는 README가 지정한 파일이 플러그인 폴더 바로 안에 있는지 확인합니다.
- 공통 설정 열기설정 > 공통 설정에서 플러그인 탭을 선택합니다.
- 플러그인 추가자동으로 보이지 않으면 새 플러그인 추가 또는 ZIP 설치를 사용합니다.
- 새 창 테스트새 편집기 창을 열고 README에 적힌 메뉴·도구·아웃라인 기능을 확인합니다.
# 폴더 구조 예시
sakura.ini
plugins\
plugin-name\
plugin.def
README.txt정의 파일 폴더를 활성 sakura.ini 옆의 plugins에 둡니다.
플러그인을 활성화하고 공통 설정에서 폴더를 추가합니다.
새 창에서 README에 적힌 기능을 확인합니다.
공통 설정에서 플러그인 관리·비활성화·삭제하기
공통 설정 > 플러그인에서는 플러그인 로드 활성화, 설정 폴더 열기, ZIP 설치, 새 플러그인 추가, 등록 목록 확인을 각각 수행합니다. 목록에는 추가, 업데이트, 중지, 실행, 삭제 같은 상태가 보일 수 있습니다. 폴더가 디스크에 있어도 현재 창이 아직 읽지 않았을 수 있으므로 상태와 읽기 열을 함께 확인하세요.
임시로 시험할 때는 파일을 옮기기 전에 플러그인을 비활성화하거나 등록을 해제하세요. 공식 도움말은 등록 해제가 파일 자체를 삭제하지 않으며, 이미 열린 창에서는 계속 로드될 수 있다고 설명합니다. 기존 창을 닫고 새 창에서 문제가 사라졌는지 확인한 후 폴더를 백업 위치로 옮깁니다.
| 동작·상태 | 의미 | 후속 확인 |
|---|---|---|
| 플러그인 로드 해제 | 등록된 플러그인을 읽지 않음 | 새 창에서 다시 테스트 |
| 중지·등록 삭제 | 선택한 플러그인 비활성화·등록 해제 | 기존 창 닫기 |
| 폴더 이동 | 파일을 검색하지 못하게 함 | README와 백업 보관 |
| 설정 열기 | 플러그인별 옵션 화면 열기 | 기존 값 기록 |
플러그인이 보이지 않거나 동작하지 않을 때
목록에 보이지 않으면 먼저 활성 sakura.ini 경로를 확인하세요. 다음으로 폴더 깊이, 정의 파일명, 이중 압축 해제, Windows 차단, 지원 버전을 확인합니다. 설정 폴더 명령으로 현재 사본이 실제 사용하는 경로를 열면 다른 Portable 프로필에 설치하는 실수를 줄일 수 있습니다.
목록에는 있지만 동작하지 않으면 README에서 의존 파일, 시작 조건, 메뉴 위치, 재시작 필요 여부를 확인하세요. 새 창에서 재현하고 플러그인 로드를 해제한 상태와 비교합니다. 작성자에게 문의할 때는 정확한 오류 문구, 플러그인 버전과 출처를 함께 남깁니다.
| 증상 | 먼저 볼 곳 | 다음 행동 |
|---|---|---|
| 목록에 없음 | sakura.ini, 폴더 깊이, plugin.def | 활성 설정 폴더에서 다시 압축 해제 |
| 등록됐지만 중지 | 버전, 의존성, 상태 | README 확인 후 새 창에서 다시 읽기 |
| 메뉴가 없음 | README와 도구 모음 설정 | 명령·지원 기능·아웃라인 연동 여부 확인 |
| 삭제 후에도 동작 | 이미 열려 있는 창 | 닫고 새 창에서 확인 |
| 편집기가 불안정 | 마지막으로 추가한 폴더 | 비활성화하고 분리한 뒤 다른 변경 진행 |
현재 sakura.ini 위치와 plugins 폴더 깊이를 확인합니다.
로드 상태, 등록 목록, 정의 파일을 확인합니다.
기존 창을 닫고 새 편집기 창에서 다시 시험합니다.
업데이트·공유·백업을 안전하게 진행하는 흐름
플러그인 업데이트는 단순한 파일 복사가 아니라 설정 변경으로 취급하세요. 작성자, URL, 확인일, 기존·새 버전, 변경 내용을 기록합니다. 가능하면 새 버전을 별도 테스트 폴더에 풀고 메뉴, 아웃라인, 일반 편집을 확인할 때까지 기존 폴더를 보관하세요. 유일한 정상 복사본을 덮어쓰면 되돌리기 어렵습니다.
여러 사람이 환경을 공유한다면 ZIP, README, 출처, 호환 버전, 필요한 설정, 비활성화 방법을 함께 보관하세요. 설정 내보내기와 차이 비교를 이용하면 플러그인 파일과 개인 설정을 분리할 수 있습니다. Windows 또는 조직 정책이 파일을 막는다면 경고를 우회하지 말고 관리자에게 문의하세요.
- 기록출처, 확인일, 플러그인 버전, 호환 Sakura Editor 버전을 남깁니다.
- 별도 테스트주 프로필을 덮어쓰지 말고 설정 폴더 복사본을 사용합니다.
- 차이 확인sakura.ini와 plugins를 비교해 메뉴·설정 변경을 확인합니다.
- 복구 절차 공유비활성화·등록 해제·이동·복원 순서를 문서화합니다.
범위와 한계: 공식 도움말을 최종 기준으로 사용하기
플러그인의 기능, 지원 OS, 설정과 라이선스는 작성자와 버전에 따라 달라집니다. 이 페이지는 Sakura Editor 공식 도움말의 일반적인 폴더와 관리 방식을 요약한 것이며 서드파티 플러그인의 안전성이나 향후 호환성을 보증하지 않습니다. 화면의 명칭이 다르면 설치한 버전의 도움말과 README를 우선하세요.
문제가 계속되면 플러그인을 비활성화한 상태에서 새 창으로 재현하고 동일한 설정 폴더인지 확인하세요. 원인을 모른 채 DLL이나 실행 파일을 추가하지 말고 공식 도움말, 작성자의 변경 이력, 조직 관리자에게 돌아가 확인하는 편이 안전합니다.
자주 묻는 질문
자주 묻는 질문
Sakura Editor 플러그인은 어디에 설치하나요?
공식 도움말은 사용하는 프로필의 sakura.ini 옆에 plugins 폴더를 만들고 플러그인별 폴더를 두는 방식입니다. 설정 폴더 명령으로 경로를 확인한 뒤 압축을 푸세요.
ZIP을 plugins에 복사하면 바로 사용할 수 있나요?
항상 그렇지는 않습니다. 올바른 폴더와 정의 파일을 확인하고 공통 설정 > 플러그인에서 로드와 등록을 진행한 뒤 새 창에서 테스트해야 합니다.
Sakura Editor 플러그인이 목록에 안 보이는 이유는 무엇인가요?
sakura.ini 경로, 폴더 깊이, plugin.def, 이중 압축 해제, Windows 차단과 지원 버전을 순서대로 확인하세요. 다른 Portable 사본의 설정 폴더를 사용했을 수도 있습니다.
Sakura Editor 플러그인을 비활성화하는 방법은?
공통 설정 > 플러그인에서 로드를 끄거나 플러그인을 중지·등록 해제합니다. 파일은 남을 수 있고 기존 창이 계속 로드할 수 있으므로 새 창에서 확인하세요.
플러그인 변경이 반영되지 않는 이유는 무엇인가요?
공식 도움말에 따르면 변경은 다음에 여는 새 창부터 적용되며 이미 열린 창에는 소급되지 않습니다. 기존 창을 닫고 다시 테스트하세요.
플러그인과 매크로 중 무엇을 사용해야 하나요?
반복 편집이나 외부 명령은 매크로, 메뉴·지원 기능·아웃라인 통합은 플러그인이 후보입니다. 항상 README와 버전 조건을 확인하세요.