소스에서 설치

  1. Weblate 설치까지 시스템에 대한 설치 지침을 먼저 따르세요:

  2. Git을 사용하여 최신 Weblate 소스를 가져오거나 (또는 tarball을 다운로드하여 압축을 풉니다):

    git clone https://github.com/WeblateOrg/weblate.git weblate-src
    

    또는 출시된 아카이브를 사용할 수 있습니다. 웹사이트 <https://weblate.org/>에서 다운로드할 수 있습니다. 다운로드는 암호화적으로 서명되어 있습니다 ( Verifying release artifacts 참조).

  3. 현재 Weblate 코드를 Python 환경에 설치함:

    . ~/weblate-env/bin/activate
    uv pip install -e 'weblate-src[all]'
    

    소스 체크아웃에서 테스트 모음을 실행하려면 Weblate 로컬 테스트 에 설명된 대로 개발 의존성을 설치하세요.

  4. weblate/settings_example.pyweblate/settings.py 로 복사합니다.

  5. settings.py 파일의 값을 원하는 대로 조정합니다. 최소한 데이터베이스 자격 증명과 Django 시크릿 키를 제공해야 하지만, 프로덕션 설정에는 더 많은 변경이 필요합니다 ( 설정 조정 참조).

  6. Weblate에서 사용하는 데이터베이스를 만듭니다 ( Weblate 데이터베이스 설정 참조).

  7. Django 테이블, 정적 파일 및 초기 데이터를 빌드합니다 ( 데이터베이스 채우기정적 파일 제공 참조):

    weblate migrate
    weblate collectstatic
    

    참고

    이 단계는 저장소를 업데이트할 때마다 반복해야 합니다.

Packaging Weblate for distributions

The dependency versions in pyproject.toml describe the runtime environment tested by the Weblate project. They are intentionally strict for installs from PyPI and for the Weblate release process, because Weblate cannot validate every dependency-version combination covered by wider version ranges.

Distribution packages can replace those Python packages with versions from the distribution package set. When doing so, run Weblate’s test suite against the packaged dependency set and treat passing tests as the compatibility signal for the distribution package.

Keep Weblate’s tightly coupled companion packages in sync with the Weblate release:

Mismatched versions of these packages are more likely to break at runtime or during tests than other Python dependency substitutions.

더 보기

See Weblate 로컬 테스트 for test setup and 릴리스 주기 for Weblate’s release cadence.