Collabora Online에서 다국어 맞춤법 검사 활성화 코드

Collabora Online에서 여러 언어의 맞춤법을 검사하려면, 필요한 각 언어 코드를 CODE 컨테이너 dictionaries설정에 추가하고, 컨테이너를 다시 시작한 다음, 각 텍스트 구절에 올바른 언어를 지정해야 합니다. 서버에서 사전을 사용할 수 있도록 제공해야 하고, 문서에서 영어, 프랑스어 또는 다른 언어로 구절을 표시해야 합니다. 컨테이너에 언어를 추가하는 것만으로는 문서의 모든 언어를 자동으로 식별하지 않습니다.

무엇을 설정해야 합니까?

고려해야 할 설정은 크게 두 가지입니다.

• 서버 사전: CODE Docker 이미지는 기본적으로 제한된 사전 목록을 사용합니다. dictionaries환경 변수를 통해 CODE에서 구성하는 사전 언어 목록을 변경할 수 있습니다. Collabora 25.04 SDK 설명서에는 공백으로 구분된 언어 코드(선택적으로 국가 코드 추가)를 사용하는 방법과 목록을 제한하면 불필요한 리소스 사용 및 시작 작업을 방지하는 데 도움이 된다는 내용이 나와 있습니다.
• 문서 언어: Collabora는 텍스트에 지정된 언어를 사용하여 맞춤법 사전을 선택합니다. 문서에는 선택 영역이나 단락마다 다른 언어가 포함될 수 있으므로 각 부분에 올바르게 태그를 지정해야 합니다.

예를 들어 영어(미국)와 프랑스어 구절이 포함된 문서의 경우 서버에서 두 언어 코드가 모두 활성화되어 있어야 하며, 영어 및 프랑스어 텍스트에도 해당 언어 설정이 적용되어 있어야 합니다. 사용자 인터페이스 언어 또는 키보드 레이아웃은 이러한 설정을 대체할 수 없습니다. 자세한 내용은 Collabora Online 25.04 SDK 설명서 와 Collabora 도움말 항목의 문서 언어 선택 부분을 참조하십시오 .

CODE Docker에서 언어 사전을 구성합니다.

Docker Compose 예제

Collabora 서비스 환경 변수에 원하는 로케일 코드를 공백으로 구분된 문자열로 추가하세요. 이 예시에서는 미국 영어, 영국 영어, 프랑스어만 나열합니다.

services:
  collabora:
    image: collabora/code
    restart: unless-stopped
    environment:
      dictionaries: "en_US en_GB fr_FR"
      domain: "cloud\.example\.com"
      username: "collabora_admin"
      password: "replace-with-a-long-unique-password"
    ports:
      - "127.0.0.1:9980:9980"

배포 환경에 맞게 도메인 패턴, 자격 증명, 이미지 태그 및 포트 매핑을 변경하세요. 기존 리버스 프록시 및 Nextcloud 연결 설정은 그대로 유지하세요. 이 예시는 사전 목록이 어디에 위치해야 하는지 보여주기 위한 것입니다. 이미 Compose 파일을 사용 중인 경우, 두 번째 컨테이너를 생성하는 대신 기존 Collabora 서비스를 편집하세요.

위의 언어 코드는 Collabora에서 제공하는 코드 체계를 따르며, 로케일에는 국가 코드가 포함될 수 있습니다. 사용자가 필요로 하는 문서 언어에 맞는 코드를 사용하십시오. 모든 CODE 이미지에 모든 가능한 코드에 사용 가능한 사전이 있다고 가정하지 마십시오. SDK 설명서에는 구성된 목록을 변경하는 방법이 나와 있지만, 실제로 사용 가능한 코드는 설치된 빌드와 해당 사전에서 결정됩니다. 사용 빈도가 낮은 로케일을 추가하기 전에 실행 중인 CODE 이미지 버전의 설명서를 확인하십시오.

변경 사항을 적용하세요

1. 변경 사항을 되돌릴 수 있도록 현재 Compose 파일을 백업하거나 커밋하세요.
2. dictionaries사용자가 필요로 하는 언어만 포함하여 값을 업데이트하십시오 . 다른 Collabora 환경 변수는 그대로 유지하십시오.
3. Docker가 업데이트된 환경을 컨테이너에 전달하도록 서비스를 다시 생성합니다. Compose 배포의 경우 docker compose up -d --force-recreate collaboraCompose 파일이 있는 디렉터리에서 실행하세요.
4. 시작 출력 결과를 확인하십시오 docker compose logs --tail=100 collabora. 시작 오류 또는 사전 로딩 오류를 찾아보세요. 컨테이너 상태가 성공적이라고 해서 특정 사전이 설치되었다고 단정짓지 마십시오.

배포 환경에서 docker run다른 방법을 사용하는 경우, 해당 -e dictionaries="en_US en_GB fr_FR"인수를 업데이트하고 동일한 네트워크, 볼륨, 프록시 및 보안 옵션을 사용하여 컨테이너를 다시 생성하십시오. 실행 중인 컨테이너의 환경을 변경해도 컨테이너가 시작될 때의 환경은 변경되지 않습니다.

각 구절에 언어를 지정하세요

서버가 준비되면 Nextcloud에서 문서를 열고 언어를 검사할 텍스트를 선택합니다. Collabora의 언어 설정에서 선택 영역 또는 단락에 적용할 언어를 선택합니다. 문서 전체가 한 가지 언어인 경우 모든 텍스트에 언어를 적용하는 옵션을 사용합니다. 명령 레이블은 버전 및 화면 레이아웃에 따라 약간씩 다를 수 있지만, 핵심은 인터페이스 언어만 변경하는 것이 아니라 문서 텍스트 언어를 설정하는 것입니다. Collabora 도움말에 따르면 문서 언어는 맞춤법 검사, 동의어 사전 및 하이픈 삽입에 사용되는 사전을 결정합니다.

여러 언어가 혼합된 문서의 경우, 언어를 부분적으로 적용하세요. 예를 들어, 프랑스어 단락을 선택하고 프랑스어(프랑스)로 설정한 다음, 영어 단락을 선택하고 영어(미국)로 설정합니다. 새 텍스트가 잘못된 언어를 상속받는 경우, 해당 단락에 커서를 놓고 입력하기 전에 언어를 변경하거나, 텍스트를 선택한 후 다시 태그를 지정하세요. 오타처럼 보이는 단어는 단순히 잘못된 언어로 표시된 텍스트일 수 있습니다.

선택 항목 또는 언어에 대해 맞춤법 검사를 비활성화할 수도 있습니다. Collabora의 언어 메뉴에서 "없음"을 선택하면 선택한 텍스트에 대한 맞춤법 검사 및 하이픈 삽입이 제외됩니다. 텍스트의 언어는 올바르지만 맞춤법 검사 표시가 나타나지 않는 경우, 해당 언어의 맞춤법 검사 상태를 확인하고 선택 항목이 제외되었는지 점검하십시오. Collabora 언어 도움말 페이지에서 언어 선택 항목과 "없음" 옵션에 대한 자세한 설명을 확인할 수 있습니다.

언어가 누락되었을 때 빠르게 확인할 수 있는 기능입니다.

Nextcloud 관리 설명서의 Office 구성에서 Collabora 서버 URL을 확인할 수 있습니다. 이 통합 설정은 사전 변경과 별도로 관리해야 합니다. 이전에 연결이 이미 정상적으로 작동했다면 일반적으로 맞춤법 검사 언어에 대해서는 설정을 변경할 필요가 없습니다. 자세한 내용은 Nextcloud Office 구성 문서를 참조하십시오 .

실제 문서에서 결과를 확인하십시오.

테스트 문서를 생성하거나 열고, 활성화된 각 언어에 의도적으로 오타를 입력합니다. 각 샘플 문단을 해당 언어로 설정한 다음, 맞춤법 검사에서 의도적인 오류를 표시하는지 확인합니다. 또한 각 언어에 올바르게 입력된 단어를 입력하여 외국어 텍스트로 인식되지 않는지 확인합니다. 계정 또는 문서별로 사용 ​​가능한 언어가 다른 경우, 다른 사용자를 사용하여 이 과정을 반복합니다.

특정 언어에서 여전히 오류가 발생하는 경우, 테스트 대상을 한 번에 하나의 로케일로 줄이고, 코드 로그를 확인한 후, 해당 이미지 버전의 문서와 코드를 비교하십시오. Collabora의 기본 사전 허용 목록과 이미지 콘텐츠는 릴리스 간에 변경될 수 있으므로, 25.04 매뉴얼에 명시된 기본값이 이후의 모든 태그에 적용된다고 가정해서는 안 됩니다. 명시적으로 태그된 각 구절에서 맞춤법 검사가 제대로 작동하면, 사용자의 요구 사항을 충족하는 최소한의 언어 목록을 유지하십시오.