Microsoft Word에서 그림을 이동하는 방법
워드에서 그림을 드래그하여 이동하는 방법, 텍스트 줄 바꿈을 선택하는 방법, 단락에 그림을 함께 배치하거나 페이지에 고정하는 방법, 그리고 이동하지 않는 이미지를 해결하는 방법을 알아보세요.
ONLYOFFICE 데스크톱 편집기에서 플러그인 개발을 활성화하는 방법
ONLYOFFICE 데스크톱 에디터에는 "플러그인 개발 활성화" 스위치가 따로 문서화되어 있지 않습니다. 지원되는 워크플로는 플러그인 관리자를 통해 자체 플러그인을 설치하고, 로컬 플러그인 폴더에 배치한 다음, 필요에 따라 설치된 복사본을 작업 소스 폴더에 대한 심볼릭 링크로 덮어쓰는 것입니다. 오류를 검사하고 중단점을 사용하려면 문서화된 디버그 플래그를 사용하여 데스크톱 앱을 실행하십시오. 이 두 단계는 별개입니다. 디버그 모드는 개발자 도구를 제공하고, 플러그인을 설치하거나 링크하면 에디터에서 해당 플러그인을 사용할 수 있게 됩니다.
현재 ONLYOFFICE API 문서에는 동일한 데스크톱 워크플로가 설명되어 있으며, 실행 시 디버그 모드를 유지하는 플래그에 대한 내용도 포함되어 있습니다. 이러한 단계를 변경하는 새로운 개발 모드 토글에 대한 공식 공지는 찾지 못했습니다. 이 가이드는 2026년 10월 6일에 공개된 공식 지침을 따릅니다. 설치 유형에 따라 경로가 다를 수 있으므로 파일을 변경하기 전에 플랫폼에 맞는 경로를 확인하십시오.
플러그인 개발 워크플로를 선택하세요
| 접근하다 | ~에 가장 적합함 | 절충 |
|---|---|---|
.plugin플러그인 관리자에 아카이브를 설치하세요 | 최초 설치, 빠른 테스트 또는 간헐적인 변경 | 간단하고 지원도 되지만, 소스 코드를 변경할 때마다 아카이브를 다시 빌드하고 재설치해야 합니다. |
| 설치된 플러그인 폴더를 소스 폴더에 연결하세요. | 개발 과정에서 빈번한 수정이 이루어집니다. | 중복된 패키징을 제거하지만, 사용자별로 올바른 경로를 설정해야 하며 변경 사항을 적용하려면 앱을 다시 로드하거나 다시 열어야 합니다. |
| 디버그 플래그를 사용하여 실행하세요 | 콘솔 출력, 플러그인 프레임 또는 중단점을 검사합니다. | 개발자 도구를 활성화하지만, 플러그인을 설치하거나 신뢰할 수 없는 코드를 자동으로 로드하지는 않습니다. |
대부분의 개발자는 플러그인을 등록할 때 한 번만 아카이브를 사용하고, 이후에는 심볼릭 링크를 사용하여 반복적으로 관리하면 됩니다. 디버그 플래그는 코드 진단 시에만 추가하세요. 매 실행마다 개발자 도구가 필요한 경우가 아니라면, 디버그 플래그의 영구 사용 버전은 비활성화해 두는 것이 좋습니다.
플러그인 파일을 준비하세요
플러그인에 필요한 파일(예: `/plugins` 및 `/ config.jsonetc /plugins`)이 포함된 로컬 플러그인 디렉터리를 준비하세요 index.html. 구성 파일에는 유효한 플러그인 GUID가 있어야 하며, ONLYOFFICE 플러그인 스키마를 사용하여 플러그인의 시작 페이지와 자산을 가리켜야 합니다. 전체 스키마는 공식 샘플 플러그인 또는 API 문서를 참조하세요. GUID 형식이 잘못되었거나, 경로가 잘못되었거나, 구성이 유효하지 않으면 플러그인이 표시되지 않을 수 있습니다.
GUID는 config.json일반적으로 `<GID>` 형식을 갖습니다 asc.{YOUR-GUID}. 데스크톱 편집기는 GUID를 플러그인 폴더 이름으로 사용하지만 asc.접두사는 생략합니다. 소스 디렉터리, 아카이브 및 설치 경로에서 동일한 GUID를 유지하십시오. 내장 플러그인이나 다른 설치된 플러그인의 GUID를 재사용하지 마십시오.
플러그인을 처음 설치하세요
- 플러그인 파일과 하위 폴더를 ZIP 압축 파일로 만드세요. 파일 자체는 별도의 프로젝트 폴더 안에 있는 것이 아니라 압축 파일의 루트 폴더에 있어야 합니다.
- 압축 파일 확장자를 에서
.zip로 변경하세요.plugin. - ONLYOFFICE 데스크톱 편집기를 열고 플러그인 탭을 선택한 다음 플러그인 관리자를 클릭합니다 .
- '내 플러그인'을 열고 '플러그인 수동 설치'를 선택한 다음 파일을 선택
.plugin하고 확인하세요.
그러면 플러그인이 열려 있는 에디터와 이후에 여는 에디터의 플러그인 탭에 나타납니다. 수동 압축 방식은 인터넷 연결 없이도 작동합니다. 마켓플레이스 설치는 바로 사용할 수 있는 플러그인을 위한 것이며, 자체 개발 빌드를 로드하는 것을 대체하는 것이 아닙니다.
더 빠른 반복을 위해 심볼릭 링크를 사용하세요.
처음 설치 후, Desktop Editors는 설치 파일의 복사본을 sdkjs-plugins디렉터리에 저장합니다. 해당 복사본을 원본 폴더에 대한 심볼릭 링크로 교체하여 작업 파일을 직접 편집할 수 있도록 하십시오. 설치된 테스트 플러그인 폴더를 변경하기 전에 Desktop Editors를 종료하십시오. 원본 폴더의 백업을 만들거나 원본 폴더가 손상되지 않도록 한 후, 테스트 플러그인의 GUID와 일치하는 폴더만 삭제하십시오.
| 운영 체제 | 사용자 플러그인 디렉토리 |
|---|---|
| 윈도우 | %LOCALAPPDATA%\ONLYOFFICE\DesktopEditors\data\sdkjs-plugins\ |
| macOS | ~/Library/Application Support/asc.onlyoffice.ONLYOFFICE/data/sdkjs-plugins/ |
| 리눅스 | ~/.local/share/onlyoffice/desktopeditors/sdkjs-plugins/ |
디렉터리 내부에서 링크 이름은 asc.접두사 없이 중괄호로 묶인 GUID입니다. 예를 들어 구성 GUID가 인 경우 asc.{91EAC419-EF8B-440C-A960-B451C7DF3A37}폴더 또는 링크 이름은 입니다 {91EAC419-EF8B-440C-A960-B451C7DF3A37}.
윈도우
Windows 계정 또는 정책에 따라 관리자 권한으로 명령 프롬프트를 엽니다. 편집기를 닫고 설치된 test-plugin 폴더를 다른 위치로 옮긴 후 디렉터리 링크를 생성합니다.
mklink /D "%LOCALAPPDATA%\ONLYOFFICE\DesktopEditors\data\sdkjs-plugins\{YOUR-GUID}" "C:\path\to\your\plugin"두 자리 표시자를 GUID와 소스 디렉터리의 전체 경로로 바꾸십시오. 링크 대상은 이미 존재해서는 안 됩니다.
macOS
ln -s "/path/to/your/plugin" "$HOME/Library/Application Support/asc.onlyoffice.ONLYOFFICE/data/sdkjs-plugins/{YOUR-GUID}"리눅스
ln -s "/path/to/your/plugin" "$HOME/.local/share/onlyoffice/desktopeditors/sdkjs-plugins/{YOUR-GUID}"설치된 버전의 경로를 사용하십시오. 패키지 또는 샌드박스 빌드의 경우 사용자 데이터가 다른 위치에 저장될 수 있습니다. 소스 코드를 편집한 후에는 필요에 따라 문서를 다시 열거나 플러그인을 다시 로드하십시오. 심볼릭 링크를 사용하면 아카이브를 다시 빌드할 필요가 없지만, 편집기가 플러그인을 다시 로드할 때까지 변경 사항이 반영되지 않을 수 있습니다.
개발자 도구를 사용하여 데스크톱 편집기를 실행하세요.
플러그인을 디버깅하려면 Desktop Editors를 완전히 종료한 다음 다음 명령으로 다시 시작하세요 --ascdesktop-support-debug-info. 운영 체제에 맞는 명령어를 사용하십시오. 앱을 사용자 지정 위치에 설치한 경우 실행 파일 경로를 조정하십시오.
윈도우
명령 프롬프트에서 다음 명령어를 실행하세요:
"%ProgramFiles%\ONLYOFFICE\DesktopEditors\DesktopEditors" --ascdesktop-support-debug-info또는 바로가기의 대상 필드를 편집하여 실행 파일 경로 뒤에 공백과 플래그를 추가할 수 있습니다. 이렇게 하면 해당 바로가기를 통한 실행에 적용됩니다.
리눅스
"/opt/onlyoffice/desktopeditors/DesktopEditors" --ascdesktop-support-debug-infomacOS
"/Applications/ONLYOFFICE.app/Contents/MacOS/ONLYOFFICE" --ascdesktop-support-debug-info앱이 실행되면 문서 내부를 클릭하고 Enter 키를 누르 F1거나, 편집 가능한 도구 모음 필드를 마우스 오른쪽 버튼으로 클릭하고 '요소 검사'를 선택합니다 . 개발자 도구에서 플러그인의 iframe을 선택하여 자체 JavaScript 및 로그를 검사합니다. 에 전달된 코드는 callCommand'iframe'이라는 이름의 편집기 프레임에서 실행되므로 frameEditor오류 및 중단점이 플러그인 UI 코드와 다른 컨텍스트에 나타날 수 있습니다.
선택적 플래그를 --ascdesktop-support-debug-info-keep=1사용하면 디버그 모드가 프로그램 실행 시에도 계속 활성화됩니다. 지속적인 상태를 끄려면 `--debug-mode` 플래그를 사용하여 프로그램을 실행하고 --ascdesktop-support-debug-info-keep=0, 기본 상태로 되돌리려면 `--debug-mode` 플래그를 사용하십시오 --ascdesktop-support-debug-info-keep=default. 개발자 도구는 전용 테스트 머신에서는 편리하지만, 공유 워크스테이션에서 활성화된 상태로 유지하면 시스템이 복잡해지고 필요하지 않을 때도 검사 도구를 사용할 수 있게 됩니다.
개발 환경이 제대로 작동하는지 확인하십시오.
- 해당 플러그인은 플러그인 탭에서 설정된 이름으로 표시됩니다.
- 소스 코드를 변경한 후 문서를 다시 열거나 플러그인을 다시 로드하면 업데이트된 동작이 표시됩니다.
- 디버그 플래그를 사용하여 실행한 후, 개발자 도구는 '요소 검사'를 통해
F1또는 '요소 검사' 를 통해 열립니다. - 플러그인 iframe이 선택되면 플러그인 UI 코드의 로그가 표시되고, 문서 명령은 .에서 검사됩니다
frameEditor.
플러그인이 누락된 경우, 아카이브 루트에 해당 파일이 있는지, GUID가 유효한지, 그리고 폴더가 접두사 없이 GUID를 사용하고 있는지 확인하십시오 config.json. index.html링크 asc.가 소스 디렉터리를 가리키는지, 아니면 해당 파일이 포함된 상위 디렉터리를 가리키는지 확인하십시오. 플러그인이 표시되지만 이전 빌드처럼 작동하는 경우, 문서를 닫았다가 다시 열어 편집기가 연결된 파일을 다시 로드하도록 하십시오.
이 설정으로는 불가능한 것은 무엇일까요?
데스크톱 디버그 플래그는 플러그인 개발을 위한 전역 권한 스위치가 아닙니다. 아카이브를 설치하거나 지원되는 플러그인 디렉터리에 폴더를 배치하면 해당 플러그인을 사용할 수 있게 되며, 디버그 플래그를 통해 검사 도구를 사용할 수 있습니다. 마찬가지로 웹 편집기에서 URL을 사용하여 플러그인을 로드하는 방법은 데스크톱 편집기에는 자동으로 적용되지 않습니다. 위에서 설명한 데스크톱 전용 설치 및 디버깅 워크플로를 사용하십시오.
이 지침은 ONLYOFFICE 데스크톱 편집기용 플러그인에 관한 것입니다. DocSpace에서 플러그인을 활성화하는 방법, ONLYOFFICE Docs에서 서버 측 플러그인을 구성하는 방법 또는 마켓플레이스에 플러그인을 게시하는 방법은 설명하지 않습니다. 이러한 워크플로는 해당 제품의 공식 설명서를 참조하십시오.
공식 참고 자료
엑셀에 체크박스를 삽입하는 두 가지 간편한 방법
셀 내 도구를 사용하여 Excel에 확인란을 삽입하는 방법, 수식을 사용하여 선택된 항목 수를 계산하는 방법, 또는 이전 데스크톱 버전에서 연결된 폼 컨트롤을 추가하는 방법을 알아보세요.
엑셀에서 알파벳 자동 완성하는 방법: A부터 Z까지, 그리고 그 이상
Excel에서 채우기 핸들 함수, SEQUENCE 함수 또는 재사용 가능한 사용자 지정 목록을 사용하여 A부터 Z까지의 소문자 또는 Z를 초과하는 레이블을 생성할 수 있습니다.
엑셀에서 취소선을 긋는 방법: 단축키 및 단계별 방법
Windows, Mac 및 웹에서 Excel을 사용하여 셀에 취소선을 긋고, 셀의 일부 서식을 지정하고, 값을 삭제하지 않고 줄을 제거하는 방법을 알아보세요.
Microsoft Access란 무엇인가요? Microsoft Access의 데이터베이스 도구는 어떻게 작동하나요?
Microsoft Access는 관련 레코드를 저장하고, 쿼리를 작성하고, 데이터 입력 양식을 만들고, 보고서를 생성하는 데 사용할 수 있는 Windows 데이터베이스 응용 프로그램입니다. Access의 작동 방식과 적합한 사용 사례를 알아보세요.
Word 2010에서 눈금선 높이와 너비 변경하기
Word 2010에서 격자선 높이와 너비를 조정하고, 표시되는 선의 빈도를 변경하고, 기본 가로 및 세로 그리기 격자 간격을 설정하는 방법을 알아보세요.
Office Outlook 2010 가져오기 및 내보내기: PST 파일을 이용한 데이터 이동
Outlook 2010으로 PST 파일을 가져오거나 메일, 연락처, 일정 및 작업을 내보내는 방법을 알아보세요. 올바른 메뉴를 따라가면 폴더 누락이나 중복을 방지할 수 있습니다.
Nucleus Kernel을 사용하여 Outlook PST 암호 복구하기
Kernel에서 제공하는 최신 단계를 따라 잊어버린 Outlook PST 암호를 복구하세요. 여기에는 올바른 파일을 식별하는 방법, 백업을 만드는 방법, 도구의 한계를 확인하는 방법이 포함됩니다.
파워포인트 슬라이드에 웹페이지를 삽입하는 방법
LiveWeb 추가 기능을 사용하여 PowerPoint 슬라이드에 웹사이트를 배치하고, 크기와 새로 고침 동작을 설정하고, 발표 전에 호환성을 확인할 수 있습니다.
Access 2010 데이터베이스를 폼에서 열 수 있도록 하는 방법
Access 2010 데이터베이스 응용 프로그램을 데이터 입력 양식으로 바로 열도록 설정하고, 개체 목록을 숨기고, 메뉴를 제한하고, 공유하기 전에 설정을 확인합니다.