Overleaf i18n 구성
이 문서는 자체 호스팅 Overleaf 인스턴스의 국제화(i18n)를 구성하는 방법을 설명합니다.
- Overleaf 인스턴스를 하나의 고정된 언어로 실행하거나,
- 여러 언어를 활성화하여
www.overleaf.com처럼 사용자가 언어를 동적으로 전환할 수 있도록 합니다.
단일 언어 구성
사이트 언어는 환경 변수OVERLEAF_SITE_LANGUAGE로 구성합니다.
지원되는 언어 코드는 다음과 같습니다.
en- 영어(기본값)es- 스페인어pt- 포르투갈어de- 독일어fr- 프랑스어cs- 체코어nl- 네덜란드어sv- 스웨덴어it- 이탈리아어tr- 튀르키예어zh-CN- 중국어(간체)no- 노르웨이어da- 덴마크어ru- 러시아어ko- 한국어ja- 일본어pl- 폴란드어fi- 핀란드어
config/variables.env에 다음 줄을 추가합니다.
config/variables.env
다중 언어 구성
사용자가 로그아웃하지 않고 언어를 전환할 수 있도록 하려면, 도메인 이름에 따라 서로 다른 언어를 제공하도록 Overleaf 인스턴스를 구성해야 합니다. 이 섹션에서는 다음을 가정합니다.- 기본 도메인이
overleaftest.com입니다. - 와일드카드 TLS 인증서(예:
*.overleaftest.com)가 있습니다. localhost를 사용하지 않습니다(하위 도메인 기반 언어 라우팅을 지원할 수 없기 때문입니다).
dev-overleaf.com과 같은 도메인을 사용할 수 있습니다.
1
TLS 프록시 구성(Nginx)
Overleaf가 사용자가 접속한 언어 도메인을 판단할 수 있도록 TLS 리버스 프록시가 원래의 다음은 Nginx 구성 예시입니다.
Host 헤더를 전달해야 합니다.다음 지시문이 있는지 확인하세요.2
쿠키 도메인 구성
언어를 전환할 때 사용자가 로그아웃되지 않도록 하려면 쿠키가 언어별 하위 도메인 간에 공유되어야 합니다.이렇게 하면 인증 쿠키가
config/variables.env에 다음 줄을 추가합니다.config/variables.env
overleaftest.com 아래의 모든 하위 도메인에서 유효합니다.3
4
apex 도메인 리디렉션
마지막으로 apex 도메인(
overleaftest.com)을 기본 언어 도메인(www.overleaftest.com)으로 리디렉션합니다.Q&A
언어 전환 버튼은 어디에 있나요?
언어 전환 버튼은 어디에 있나요?
답변: 언어 버튼(번역 아이콘)은 페이지 푸터에 있습니다. 예를 들어 프로젝트 목록 하단에 있습니다. 편집기에는 표시되지 않습니다.이 버튼은 다중 언어 구성에 설명된 대로
OVERLEAF_LANG_DOMAIN_MAPPING이 두 개 이상의 언어를 매핑할 때만 나타납니다. OVERLEAF_SITE_LANGUAGE만 설정된 경우 사이트 전체가 해당 언어 하나를 사용하며 버튼은 없습니다.언어를 선택하면 해당 언어의 도메인(예: cn.overleaftest.com)에서 같은 페이지가 열립니다. 사용자 설정으로 저장되지는 않습니다.선택기의 언어가 http://127.0.0.1:3000을 여는 이유는 무엇인가요?
선택기의 언어가 http://127.0.0.1:3000을 여는 이유는 무엇인가요?
답변:
OVERLEAF_LANG_DOMAIN_MAPPING에 www 키가 없기 때문입니다. 매핑은 기본 매핑과 병합되는데, 기본 매핑에는 내부 주소 http://127.0.0.1:3000을 사용하는 영어용 www 항목이 있습니다. 매핑에 cn과 en처럼 다른 키만 사용하면 이 기본 항목이 유지되어 선택기에 표시됩니다.OVERLEAF_SITE_URL의 주소로 www 키를 추가하고 같은 언어에 대한 두 번째 항목은 삭제한 후 bin/up -d를 실행하세요.
