SUSE 및 openSUSE에 설치¶

하드웨어 요구사항¶

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

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

참고

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

메모리 사용¶

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

힌트

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

CPU 사용¶

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

저장공간 사용¶

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

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

노드¶

중소규모 사이트(호스팅되는 단어 수백만 개)의 경우 모든 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
```
개발 서버를 시작합니다 ( 서버 실행 에 프로덕션 설정이 설명되어 있습니다):
```
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 저장소의 크기와 번역할 메시지 수에 따라 긴 프로세스가 될 수 있음) 번역을 시작할 수 있습니다.