SUSE 및 openSUSE에 설치¶

하드웨어 요구사항¶

Weblate는 모든 최신 하드웨어에서 문제없이 실행되어야 합니다. 다음은 단일 호스트(Weblate, 데이터베이스 및 웹 서버)에서 Weblate를 실행하는 데 필요한 최소 설정임:

RAM 3GB
CPU 코어 2개
저장 공간 1GB

참고

Weblate 설치의 실제 요구사항은 관리되는 번역의 크기에 따라 크게 달라집니다.

메모리 사용¶

메모리는 많을수록 좋습니다 - 모든 수준(파일 시스템, 데이터베이스 및 Weblate)에서 캐싱에 사용됩니다. 수백 개의 번역 구성요소의 경우 최소 4GB RAM이 권장됩니다.

힌트

권장보다 메모리가 적은 시스템에서는 단일 프로세스 Celery 설정 가 권장됩니다.

CPU 사용¶

많은 동시 사용자는 필요한 CPU 코어 수를 증가시킵니다.

저장공간 사용¶

일반적인 데이터베이스 저장 공간 사용량은 호스팅되는 단어 100만 개당 약 300MB입니다.

클론된 저장소에 필요한 저장 공간은 다양하지만, Weblate는 얕은 클론을 수행하여 크기를 최소화하려고 합니다.

Storage performance¶

Version control operations perform many filesystem metadata lookups. The vcs subdirectory in DATA_DIR therefore needs low read latency; storage with slow metadata access can make operations such as git status take a long time even when its bulk throughput is good. Keep CACHE_DIR on low-latency local or temporary storage when possible.

The deployment checks measure metadata lookup latency for both locations and warn when the median latency exceeds 10 milliseconds. This is an approximate point-in-time measurement affected by filesystem and system load. Rerun weblate check --deploy before changing the storage configuration.

노드¶

중소규모 사이트(호스팅되는 단어 수백만 개)의 경우 모든 Weblate 구성요소 ( 아키텍처 개요 참조)를 단일 노드에서 실행할 수 있습니다.

호스팅되는 단어가 수억 개로 늘어나면 데이터베이스 전용 노드를 두는 것이 권장됩니다 ( Weblate 데이터베이스 설정 참조).

설치¶

시스템 요구사항¶

Python 모듈을 빌드하는 데 필요한 종속성을 설치합니다 ( 소프트웨어 요구사항 참조):

zypper install \
   libxslt-devel libxml2-devel freetype-devel libjpeg-devel zlib-devel \
   libyaml-devel libffi-devel libacl-devel liblz4-devel libzstd-devel libxxhash-devel \
   python3-devel git

사용하려는 기능에 따라 원하는 선택적 종속성을 설치합니다 ( Python 종속성 참조):

zypper install libldap2-devel libsasl2-devel
zypper install libxmlsec1-devel

선택적으로 프로덕션 서버 실행을 위한 소프트웨어를 설치합니다 ( 서버 실행, Weblate 데이터베이스 설정, Celery를 사용한 백그라운드 작업 참조). 설치 규모에 따라 이러한 구성요소를 전용 서버에서 실행할 수 있습니다.

로컬 설치 지침:

# Web server option 1: NGINX and uWSGI
zypper install nginx uwsgi uwsgi-plugin-python3

# Web server option 2: Apache with ``mod_wsgi``
zypper install apache2 apache2-mod_wsgi

# Caching backend: Valkey
zypper install valkey-server

# Database server: PostgreSQL
zypper install postgresql postgresql-contrib

# SMTP server
zypper install postfix

# Gettext tools for gettext POT/PO update add-ons
zypper install gettext

uv 패키지 관리자¶

힌트

uv 패키지 관리자를 사용하여 Weblate를 설치합니다.

curl -LsSf https://astral.sh/uv/install.sh | sh

uv 설치

Python 모듈¶

힌트

별도의 Python 환경에 Weblate를 설치합니다.

Weblate용 Python 환경을 만듦:
```
uv venv ~/weblate-env
```
Weblate용 Python 환경을 활성화함:
```
. ~/weblate-env/bin/activate
```
모든 선택적 종속성을 포함하여 Weblate를 설치함:
```
# Install Weblate with all optional dependencies
uv pip install "weblate[all]"
```
선택적 종속성의 미세 조정은 Python 종속성 를 참조하세요.

Weblate 설정¶

참고

다음은 Weblate에서 사용하는 Python 환경이 활성화되어 있다고 가정합니다 (. ~/weblate-env/bin/activate 실행). 활성화되지 않은 경우 weblate 명령의 전체 경로를 ~/weblate-env/bin/weblate 로 지정하세요.

~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py 를 ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py 로 복사합니다.
새 settings.py 파일의 값을 원하는 대로 조정합니다. 최소한 데이터베이스 자격 증명과 Django 시크릿 키를 제공해야 하지만, 프로덕션 설정에는 더 많은 변경이 필요합니다 ( 설정 조정 참조).
Weblate용 데이터베이스와 그 구조를 만듭니다 (예시 설정은 PostgreSQL을 사용합니다. 프로덕션 준비 설정은 Weblate 데이터베이스 설정 참조):
```
weblate migrate
```
더 보기

migrate
관리자 사용자 계정 admin 을 만들고, 비밀번호를 생성하고, 클립보드에 복사합니다. 나중에 사용할 수 있도록 저장하는 것을 잊지 마세요:
```
weblate createadmin
```
힌트

이전에 관리자 비밀번호를 놓치거나 분실한 경우 다음 명령으로 새 비밀번호를 생성할 수 있음:
```
weblate createadmin --update
```
더 보기

createadmin
웹 서버용 정적 파일을 수집합니다 ( 서버 실행 및 정적 파일 제공 참조):
```
weblate collectstatic
```
Celery 워커를 시작합니다. 개발 목적으로는 필요하지 않지만, 그 외에는 강력히 권장됩니다. Celery를 사용한 백그라운드 작업 에更多信息 있음:
```
celery --app=weblate.utils worker --beat \
    --queues=celery,notify,memory,translate,backup \
    --prefetch-multiplier=1
```
개발 서버를 시작합니다 ( 서버 실행 에 프로덕션 설정이 설명되어 있습니다):
```
weblate runserver
```

설치 후¶

축하합니다. Weblate 서버가 이제 실행 중이며 사용을 시작할 수 있습니다.

이제 http://localhost:8000/ 에서 Weblate에 접근할 수 있습니다.
설치 중에 얻은 관리자 자격 증명으로 로그인하거나 새 사용자로 등록하세요.
Weblate Python 환경이 활성화된 상태에서 weblate 명령을 사용하여 Weblate 명령을 실행할 수 있습니다 ( 관리 명령어 참조).
Ctrl+C 로 테스트 서버를 중지할 수 있습니다.
/manage/performance/ URL ( 성능 보고서 참조) 또는 weblate check --deploy 를 사용하여 설치의 잠재적 문제를 검토하세요 ( 프로덕션 설정 참조).

번역 추가¶

관리자 인터페이스(http://localhost:8000/create/project/)를 열고 번역하려는 프로젝트를 만듭니다. 자세한 내용은 프로젝트 설정 를 참조하세요.

여기서 지정해야 할 것은 프로젝트 이름과 웹사이트입니다.
번역의 실제 객체인 구성요소를 만듭니다. VCS 저장소를 가리키고 번역할 파일을 선택합니다. 자세한 내용은 구성요소 설정 를 참조하세요.

여기서 중요한 필드는 구성요소 이름, 소스 코드 저장소 및 번역 가능한 파일을 찾기 위한 파일 마스크 입니다. Weblate는 GNU gettext PO (Portable Object), Android 문자열 리소스, Apple iOS 문자열, Java 속성, Stringsdict 형식 또는 Fluent 형식 를 포함한 다양한 형식을 지원합니다 (자세한 내용은 현지화 파일 형식 참조).
위 작업이 완료되면 (VCS 저장소의 크기와 번역할 메시지 수에 따라 긴 프로세스가 될 수 있음) 번역을 시작할 수 있습니다.