Instalando a partir do código-fonte

  1. Siga as instruções de instalação do seu sistema primeiro até a primeira instalação:

  2. Pegue o código-fonte mais recente do Weblate usando Git (ou baixe um tarball e descompacte-o):

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

    Como alternativa, você pode usar as versões arquivadas. Faça o download em nosso site <https://weblate.org/>. Esses downloads são assinados criptograficamente, consulte Verificando assinaturas de lançamento.

  3. Install current Weblate code into the Python environment:

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

    If you intend to run the testsuite from the source checkout, install the development dependencies as described in Local testing of Weblate.

  4. Copie weblate/settings_example.py para weblate/settings.py.

  5. Ajuste os valores no novo arquivo settings.py de acordo com sua preferência. Você vai precisar fornecer pelo menos as credenciais de banco de dados e a chave secreta Django, mas você vai querer mais mudanças para configuração de produção, consulte Ajustando a configuração.

  6. Crie o banco de dados usado pelo Weblate, consulte Configuração de banco de dados para o Weblate.

  7. Construa tabelas Django, arquivos estáticos e dados iniciais (consulte Preenchendo o banco de dados e Servindo arquivos estáticos):

    weblate migrate
    weblate collectstatic
    weblate compress
    

    Nota

    Esta etapa deve ser repetida sempre que você atualizar o repositório.

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.

Ver também

See Local testing of Weblate for test setup and Release cycle for Weblate’s release cadence.