ONLYOFFICE 데스크톱 편집기에서 플러그인 개발을 활성화하는 방법
ONLYOFFICE 데스크톱 편집기에서 플러그인 개발을 설정하려면 로컬 .plugin 아카이브를 설치하고, 소스 폴더를 연결하고, 개발자 도구를 활성화한 다음 변경 사항을 테스트하십시오.
Collabora Online에서 여러 언어의 맞춤법을 검사하려면 서버와 문서 텍스트 양쪽 모두 설정에 동의해야 합니다. 서버는 필요한 사전을 제공하고 허용해야 하며, 문서 텍스트는 실제로 사용하는 언어로 태그되어 있어야 합니다. 빨간색 밑줄 기능만 활성화하는 것으로는 Collabora가 여러 언어가 혼합된 문서에서 모든 언어를 정확하게 식별할 수 없습니다.
예시: 노스사이드 문해력 네트워크(Northside Literacy Network)가 영어 지침과 스페인어 가족 자료를 같은 Writer 파일에 담아 자원봉사자 안내서를 작성한다고 가정해 보겠습니다. 이는 단계를 설명하기 위한 가상의 예시이며, 실제 조직이나 검증된 Collabora 배포 사례를 나타내는 것은 아닙니다. 목표는 영어 텍스트는 영어 사전으로, 스페인어 텍스트는 스페인어 사전으로 검토하면서, 인명과 전문 용어는 쉽게 검토할 수 있도록 하는 것입니다.
Collabora Online은 서버에서 편집 엔진을 실행합니다. 따라서 작성자의 노트북에 사전을 설치한다고 해서 온라인 편집기에도 자동으로 추가되는 것은 아닙니다. Collabora 서버에 해당 언어 지원 사전이 필요하며, 서버 구성에서 해당 언어를 지원하도록 설정되어 있어야 합니다. 관리자가 이 설정을 변경해야 할 수도 있습니다. 일반적으로 문서 편집기는 브라우저에서 서버 전체에 적용되는 언어 리소스를 설치할 수 없습니다.
사용자 인터페이스 언어는 문서의 교정 언어와 별개입니다. 예를 들어 메뉴를 스페인어로 변경한다고 해서 파일의 스페인어 단락에 자동으로 태그가 지정되거나 서버에 스페인어 맞춤법 검사 사전이 있다는 것이 보장되는 것은 아닙니다.
서버를 변경하기 전에 관리자에게 사용 중인 Collabora 배포 방식(CODE 컨테이너, 패키지에서 설치한 Collabora Online, 관리형 호스팅 서비스 또는 다른 플랫폼에서 제공하는 오피스 통합)을 확인하십시오. 구성의 위치와 저장 방식이 다를 수 있습니다. 호스팅 서비스의 경우 사용자가 직접 구성을 편집하는 대신 공급자가 사전 기능을 활성화하도록 요청해야 할 수 있습니다.
실제 사용되는 언어와 지역별 변형을 간략하게 목록으로 작성하세요. 노스사이드의 가상 안내서에서는 미국 영어와 스페인어가 해당될 수 있습니다. 문서에 캐나다 프랑스어나 브라질 포르투갈어가 필요한 경우, 모든 지역 사전이 호환된다고 가정하지 말고 가능한 경우 해당 변형을 사용하세요. Collabora의 언어 코드 목록은 서버 구성 세부 정보입니다. 실행 중인 배포판에 표시되는 코드는 와 같은 형식을 사용할 수 있으며 en_US, 문서 인터페이스에는 사람이 읽을 수 있는 언어 이름이 표시될 수 있습니다.
사용자가 실제로 사용하는 언어로만 목록을 제한하세요. Collabora의 설정은 allowed_languages쓰기 지원 도구에서 지원하는 언어 목록을 보여주며, 너무 많은 언어를 허용하면 시작 성능에 영향을 미칠 수 있다고 경고합니다.
자체 관리 설치 환경에서는 각 언어에 대한 Collabora/LibreOffice 언어 사전 패키지가 설치되어 있는지 확인하십시오. 패키지 이름은 배포판 및 Collabora 에디션에 따라 다를 수 있으므로 Ubuntu, Debian 또는 RPM 패키지 이름을 무작정 복사하지 말고 운영 체제에 맞는 패키지 설치 지침을 확인하십시오. 해당 언어에 해당하는 사전 모듈이 설치되지 않은 경우 메뉴에 해당 언어의 맞춤법 검사 기능이 표시되지 않을 수 있습니다.
공식 CODE Docker 이미지를 실행하는 경우, 사전 선택에 대한 현재 컨테이너 구성 지침을 따르십시오. 애플리케이션 자체 환경에 로케일을 추가하거나 호스트에 사전을 설치하는 것이 실행 중인 컨테이너를 자동으로 업데이트한다고 가정하지 마십시오. 컨테이너 배포 정의에 관련 설정을 유지하여 컨테이너를 다시 생성하거나 이미지를 업데이트할 때 해당 설정이 자동으로 제거되지 않도록 하십시오.
패키지 기반 배포의 경우 관리자는 설치에서 지원하는 언어 코드를 사용하여 allowed_languages설정을 업데이트해야 할 수 있습니다. 해당 값의 간략한 예시는 다음과 같습니다.coolwsd.xml
<allowed_languages>en_US es_ES</allowed_languages>
이 코드 조각은 예시 목록일 뿐이며, 완전한 구성 파일이 아니므로 파일의 기존 속성이나 배포별 설정을 대체해서는 안 됩니다. CODE 컨테이너의 경우, 해당 이미지 버전에 맞는 Docker 구성 방법을 통해 언어 선택을 적용하십시오. 배포 관리자가 재시작 시 삭제할 임시 컨테이너 파일은 편집하지 마십시오.
사전과 허용 목록이 업데이트되면 해당 설치에 대한 서비스 절차를 사용하여 Collabora를 다시 시작하거나 재배포하십시오. 시작 오류가 있는지 서버 로그 또는 공급자 상태 보기를 확인하십시오. 다시 시작이 성공적으로 완료되면 인프라 점검만 완료된 것이므로, 다음으로 대상 언어가 편집기의 언어 목록에 나타나는지, 각 언어의 샘플 단어가 적절하게 선택되는지 확인하십시오.
Collabora Online Writer에서 문서를 엽니다. 교정할 영어 또는 스페인어 텍스트를 선택한 다음, 도구 메뉴에서 언어 명령을 사용합니다. Collabora Writer 인터페이스는 선택한 텍스트, 단락 또는 문서 전체에 대한 언어 옵션을 제공합니다. 정확한 메뉴 문구와 위치는 Collabora 버전과 탭 인터페이스 또는 기존 인터페이스 사용 여부에 따라 다를 수 있습니다. Northside의 예시에서는 영어 안내문을 선택하고 영어로 지정한 다음, 스페인어 가족 지원 자료 단락을 선택하고 스페인어로 지정합니다.
재사용할 텍스트의 경우, 각 단락을 직접 반복적으로 서식 지정하는 것보다 단락 스타일을 사용하는 것이 유지 관리가 더 쉽습니다. 제목이나 본문 스타일을 사용하여 의도한 문구를 지정할 수 있으므로, 해당 스타일을 사용하는 이후 단락에도 동일한 서식이 적용됩니다. 먼저 기존 문서를 검토하여 텍스트가 단락 스타일의 서식을 상속받거나 특정 단어에 더 구체적인 서식을 지정할 수 있는지 확인하십시오.
파일이 실제로 다국어인 경우 "문서 전체"를 선택하지 마십시오. 이 옵션을 선택하면 기존 콘텐츠 전체의 언어가 변경되어 스페인어 부분이 영어로 선택되거나 그 반대의 경우가 발생할 수 있습니다. 마찬가지로 기본 문서 언어를 설정하는 것은 텍스트에 두 번째 언어를 지정하는 것을 대체할 수 없습니다.
자동 맞춤법 검사가 꺼져 있으면 도구 > 맞춤법 검사를 켜세요 . 그러면 현재 문서 언어에 사용 가능한 사전이 있는 경우 입력하는 동안 맞춤법이 틀린 단어가 표시됩니다. 수동으로 검사하려면 도구 > 맞춤법 검사를 선택하거나 , 배포 환경에 따라 검토 탭을 사용하거나, 브라우저와 플랫폼에서 바로 가기 키인 F7 키를 누르세요.
맞춤법 검사 대화 상자에서 단어를 발견하면 제안을 수락하기 전에 해당 문단에 할당된 언어를 확인하십시오. 인명, 조직명, 지명, 약어 또는 외래어는 사전에서 잘못된 것으로 표시되더라도 올바를 수 있습니다. 배포 환경에서 허용하는 경우, 자주 사용하는 용어를 적절한 사용자 사전에 추가하십시오. 밑줄을 지우기 위해 변경 사항을 수락하지 마십시오.
첫 번째 검사에서는 실제 문서를 편집하는 대신 짧은 테스트 사본을 사용하세요. 노스사이드의 가상 안내서에서 영어 부분과 스페인어 부분에 각각 의도적으로 철자를 틀린 일반 단어를 하나씩 넣고, 각각에 올바르게 철자를 쓴 단어도 하나씩 포함시키세요. 각 단락에 언어를 지정하고 자동 맞춤법 검사를 활성화한 다음 수동 맞춤법 검사를 실행하세요. 예상 결과는 해당 사전을 사용하여 철자가 틀린 단어는 식별되지만 올바르게 철자를 쓴 단어는 오류로 표시되지 않는 것입니다. 검사 후 테스트 오류를 제거하세요.
언어 메뉴에서 특정 언어가 누락되었거나 유용한 제안이 표시되지 않는 경우, 문제는 서버 측에 있을 가능성이 높습니다. 예를 들어 사전이 설치되지 않았거나, 해당 로케일이 허용되지 않았거나, 새 구성이 적용되지 않았거나, 편집자가 관리자가 변경한 Collabora 인스턴스와 다른 인스턴스에 연결되어 있을 수 있습니다. 언어는 표시되지만 섹션의 모든 단어에 플래그가 지정되는 경우, 서버 패키지를 변경하기 전에 해당 단락에 할당된 언어와 단락 스타일을 확인하십시오.
저장된 문서를 닫았다가 다시 열어보세요. 언어 서식은 문서 내용에 적용되는 반면, 맞춤법 검사 밑줄은 로컬 보기 기본 설정일 수 있습니다. 언어 지정이 올바른 단락에 그대로 유지되는지, 그리고 다른 권한 있는 편집자가 동일한 교정 동작을 보는지 확인하세요.
관리형 Nextcloud, ownCloud 또는 기타 호스팅 통합 환경에서는 플랫폼 팀이나 서비스 제공업체가 Collabora 서버 구성을 관리할 수 있습니다. 관리자에게 필요한 언어 코드, Collabora 버전 또는 배포 유형(알고 있는 경우), 그리고 누락된 언어에 대한 설명을 제공하십시오. 사전이 설치되어 있고 해당 언어가 허용되어 있는지 확인해 달라고 요청하십시오. 기본 문서 언어만 변경해 달라는 요청으로는 문제가 해결되지 않을 수 있습니다.
LanguageTool과 같은 외부 문법 검사 서비스를 활성화한 경우, 내장된 맞춤법 검사 사전과는 별개의 기능으로 간주하십시오. Collabora는 원격 문법 검사 기능을 구성 가능한 서비스로 제공하며, 구성에 따라 문서 텍스트가 해당 서비스로 전송될 수 있습니다. 원격 검사 기능을 활성화하기 전에 조직의 개인정보 보호 및 데이터 처리 요구 사항을 검토하십시오. 여러 로컬 사전 언어를 지정하는 데 원격 검사 기능이 반드시 필요한 것은 아닙니다.
메뉴 레이블과 배포 메커니즘은 릴리스 및 통합에 따라 변경될 수 있습니다. 사용 중인 Collabora Online 버전과 컨테이너 또는 패키지에 대한 자세한 내용은 설명서를 참조하십시오. 유용한 주요 참조 자료로는 Collabora의 문서 언어 선택 가이드 , 언어 옵션 참조 및 맞춤법 검사 대화 상자 참조가 있습니다 . 서버 구성에 대해서는 Collabora Online SDK 설명서 와 공식 CODE Docker 구성 가이드를 참조하십시오 . 여기에 인용된 가이드와 메뉴는 2026년 10월 6일에 확인되었으므로, 운영 서비스를 변경하기 전에 설치된 릴리스와 비교하여 확인하십시오.
ONLYOFFICE 데스크톱 편집기에서 플러그인 개발을 설정하려면 로컬 .plugin 아카이브를 설치하고, 소스 폴더를 연결하고, 개발자 도구를 활성화한 다음 변경 사항을 테스트하십시오.
Calc에서 Python 매크로를 직접 사용하는 시점과 LibreOffice Basic에서 Python 함수를 호출하는 방법을 UNO 및 ScriptForge 예제를 통해 알아보세요.
Collabora Online CODE의 "WOPI 호스트 권한 없음" 오류를 해결하려면 WOPI 호스트 이름을 일치시키고, Docker 호스트 그룹을 구성하고, Nextcloud의 별도 IP 허용 목록을 확인하고, 연결을 검증하십시오.
Nextcloud에서 ONLYOFFICE의 "토큰이 유효하지 않습니다" 오류를 해결하려면 JWT 비밀 키, 인증 헤더, Docker 설정, 프록시 동작 및 커넥터 상태를 확인하십시오.
Nextcloud에서 ONLYOFFICE "문서를 저장할 수 없습니다" 오류를 해결하려면 콜백, 내부 URL, JWT, TLS, 프록시 라우팅, 로그 및 스토리지를 확인하십시오.
Collabora Online 소켓 연결 오류를 해결하려면 26.04 WebSocket 변경 사항, 프록시 경로, 업그레이드 헤더, 시간 초과, TLS 및 로그를 확인하십시오.
Collabora Online에서 다국어 맞춤법 검사를 활성화하려면 서버 사전을 추가하고, 언어 코드를 허용하고, 텍스트에 언어를 지정하고, 혼합 언어 문서를 테스트하십시오.
Create a reliable LibreOffice Writer mail merge with per-record images using Calc data, a named image placeholder, and a Basic macro, with troubleshooting and verification steps.
WOPI, 역방향 프록시, TLS, DNS, WebSockets 및 서버 간 연결 가능성을 확인하여 Collabora Online 문서 연결 오류를 진단하고 해결합니다.
ONLYOFFICE 데스크톱 편집기를 오프라인에서 사용하여 PDF 파일을 편집 가능한 DOCX 파일로 변환하세요. '다른 이름으로 저장' 단계를 따라 PDF 파일이 스캔되었는지 확인하고 서식을 검토하세요.