Konfigurasi

Semua pengaturan disimpan dalam settings.py (seperti biasa untuk Django).

Catatan

Setelah mengubah salah satu pengaturan ini, Anda perlu memulai ulang Weblate — baik proses WSGI maupun Celery.

Jika dijalankan sebagai mod_wsgi, Anda perlu memulai ulang Apache untuk memuat ulang konfigurasi.

Lihat juga

Silakan periksa juga dokumentasi Django untuk parameter yang mengkonfigurasikan Django itu sendiri.

ADMINS_CONTACT

Mengkonfigurasikan ke mana formulir kontak akan mengirimkan surel. Jika tidak dikonfigurasikan, alamat surel dari ADMINS akan digunakan.

Konfigurasikan ini sebagai daftar alamat surel:

ADMINS_CONTACT = ["admin@example.com", "support@example.com"]

Lihat juga

ALLOWED_ASSET_DOMAINS

Added in version 5.14.

Mengkonfigurasikan domain mana yang diizinkan untuk mengambil aset di Weblate.

Hal ini meningkatkan keamanan dengan mencegah pemuatan aset dari sumber yang tidak tepercaya. Aset diunduh sekali oleh server Weblate dan disimpan secara lokal, alih-alih disajikan langsung dari domain eksternal kepada pengguna.

The allowlist is applied to the initial URL and to every HTTP redirect target before Weblate follows it. Redirects to hosts outside of this allowlist are rejected.

Ia mengharapkan daftar nama hos/domain. Anda dapat menggunakan nama yang sepenuhnya memenuhi syarat (misalnya www.example.com) atau menambahkan titik sebagai karakter pengganti agar sesuai dengan semua subdomain (misalnya .example.com akan cocok dengan cdn.example.com atau static.example.com).

Defaults to ["*"], which allows all domains.

Contoh

ALLOWED_ASSET_DOMAINS = [
    # Allows only cdn.anotherdomain.org
    "cdn.anotherdomain.org",
    # Allows example.com and all its subdomains
    ".example.com",
]

Ini saat ini digunakan di tempat berikut:

Lihat juga

ALLOWED_MACHINERY_DOMAINS

Configures which custom machinery domains are explicitly allowed in project-level machine translation configuration.

This setting applies only to machinery services and does not affect ALLOWED_ASSET_DOMAINS.

It expects a list of host/domain names. You can use fully qualified names or prepend with a period as a wildcard to match all subdomains.

Bawaannya adalah [].

The allowlist affects project-managed machinery in two ways: it permits the configured endpoint during outbound validation, and it marks matching hosts as trusted when deciding whether remote provider error details or response bodies can be shown to the user. For direct connections, runtime checks still reject destinations that resolve to private or otherwise non-public addresses. When an HTTP(S) proxy is used, runtime validation falls back to hostname validation and does not perform the same local DNS or peer-IP checks.

ALLOWED_ASSET_SIZE

Added in version 5.14.

Configures size limit in bytes for fetching or uploading assets into Weblate. Defaults to 10 MB.

Lihat juga

ASSET_PRIVATE_ALLOWLIST

Added in version 2025.5.

Defines hostnames or domains exempt from ASSET_RESTRICT_PRIVATE for remote asset downloads that enforce private-target checks. Entries follow Django host matching semantics, so values such as assets.internal.example or .internal.example can be used.

This does not replace ALLOWED_ASSET_DOMAINS; remote assets must still match the asset domain allowlist.

Konfigurasi bawaan:

ASSET_PRIVATE_ALLOWLIST = []

Lihat juga

ASSET_RESTRICT_PRIVATE

Added in version 2025.5.

Reject remote asset URLs pointing to internal or non-public addresses unless the target host is included in ASSET_PRIVATE_ALLOWLIST. On by default.

When enabled, hostnames that cannot be resolved during validation are rejected unless they are explicitly included in ASSET_PRIVATE_ALLOWLIST. This currently applies to screenshot URL uploads and remote HTML downloads for the CDN lokalisasi JavaScript add-on.

Lihat juga

ALTCHA_COST

Added in version 2025.5.

Argon2id time cost for the ALTCHA proof-of-work challenge. Defaults to 3.

Replaces ALTCHA_MAX_NUMBER, which applied to the removed ALTCHA widget v2.

ALTCHA_MEMORY_COST

Added in version 2025.5.

Argon2id memory cost in KiB. Defaults to 65536.

ALTCHA_PARALLELISM

Added in version 2025.5.

Argon2id parallelism factor. Defaults to 1.

Lihat juga

Mekanisme Bukti Kerja ALTCHA

ANONYMOUS_USER_NAME

Nama pengguna dari pengguna yang tidak masuk.

Lihat juga

Kontrol akses

AUDITLOG_EXPIRY

Jumlah hari maksimum Weblate akan menyimpan catatan audit yang berisi informasi tentang aktivitas akun.

Bawaannya adalah 180 hari.

AUTH_LOCK_ATTEMPTS

Jumlah maksimum upaya autentikasi yang gagal sebelum pembatasan akses diterapkan.

Ini saat ini diterapkan di lokasi berikut:

  • Masuk. Menghapus kata sandi akun, mencegah pengguna masuk tanpa meminta kata sandi baru.

  • Pengaturan ulang kata sandi. Mencegah pengiriman surel baru, menghindari spam kepada pengguna dengan terlalu banyak upaya pengaturan ulang kata sandi.

Bawaannya adalah 10.

Lihat juga

Pembatasan akses

AUTO_UPDATE

Memperbarui semua repositori setiap hari.

Petunjuk

Berguna jika Anda tidak menggunakan Pengait notifikasi untuk memperbarui repositori Weblate secara otomatis.

Catatan

Pilihan nyala/mati tersedia sebagai tambahan pada pemilihan string untuk kompatibilitas mundur.

Pilihannya adalah:

"none"

Tidak ada pembaruan harian.

"remote" juga False

Hanya perbarui jarak jauh.

"full" juga True

Perbarui jarak jauh dan gabungkan salinan kerja.

Catatan

Ini memerlukan Tugas latar belakang menggunakan Celery berfungsi, dan akan berlaku setelah dimulai ulang.

AVATAR_URL_PREFIX

Perfiks untuk mengonstruksikan URL avatar adalah: ${AVATAR_URL_PREFIX}/avatar/${MAIL_HASH}?${PARAMS}. Layanan berikut diketahui berfungsi:

Gravatar (bawaan), sesuai https://gravatar.com/

AVATAR_URL_PREFIX = 'https://www.gravatar.com/'

Libravatar, sesuai https://www.libravatar.org/

AVATAR_URL_PREFIX = 'https://www.libravatar.org/'

Lihat juga

AUTH_TOKEN_VALID

Durasi validitas token autentikasi dan kata sandi sementara dari surel pengaturan ulang kata sandi. Diatur dalam hitungan detik, dengan bawaan 172800 (2 hari).

AUTH_PASSWORD_DAYS

Berapa hari Weblate menolak penggunaan kembali kata sandi yang digunakan sebelumnya untuk pengguna.

Pemeriksaan didasarkan pada catatan audit, AUDITLOG_EXPIRY harus setidaknya sama dengan ini.

Catatan

Perubahan kata sandi yang dibuat sebelum Weblate 2.15 tidak akan diperhitungkan dalam kebijakan ini.

Bawaannya adalah 180 hari.

AUTOFIX_LIST

Daftar perbaikan otomatis yang akan diterapkan saat menyimpan string.

Catatan

Berikan jalur yang sepenuhnya memenuhi syarat ke kelas Python yang mengimplementasikan antarmuka perbaikan otomatis.

Perbaikan yang tersedia dijelaskan di Perbaikan otomatis.

Anda dapat memilih mana yang akan digunakan:

AUTOFIX_LIST = (
    "weblate.trans.autofixes.whitespace.SameBookendingWhitespace",
    "weblate.trans.autofixes.chars.ReplaceTrailingDotsWithEllipsis",
)

Lihat juga

BACKGROUND_TASKS

Added in version 4.5.2.

Mendefinisikan seberapa sering tugas pemeliharaan yang panjang harus dipicu untuk suatu komponen.

Saat ini yang mengontrol:

Pilihan yang mungkin:

  • monthly (ini adalah bawaan)

  • weekly

  • daily

  • never

Catatan

Meningkatkan frekuensi tidak disarankan ketika Weblate berisi ribuan komponen.

BASIC_LANGUAGES

Added in version 4.4.

Daftar bahasa yang ditawarkan kepada pengguna untuk memulai terjemahan baru. Jika tidak dispesifikasikan, daftar bawaan akan digunakan (yang mencakup semua bahasa yang umum digunakan, tetapi tanpa varian spesifik negara).

Ini hanya membatasi pengguna non-hak akses untuk menambahkan bahasa yang tidak diinginkan. Administrator proyek masih dapat melihat pilihan lengkap bahasa yang telah ditentukan di Weblate.

Catatan

Ini tidak mendefinisikan bahasa baru untuk Weblate — ini hanya memfilter bahasa yang sudah ada dalam basis data.

Contoh:

BASIC_LANGUAGES = {"cs", "it", "ja", "en"}

Lihat juga

Definisi bahasa

BORG_EXTRA_ARGS

Added in version 4.9.

Anda dapat meneruskan argumen tambahan ke borg create ketika pencadangan bawaan dipicu.

Contoh:

BORG_EXTRA_ARGS = ["--exclude", "vcs/"]

Lihat juga

CACHE_DIR

Added in version 4.16.

Direktori tempat Weblate menyimpan berkas simpanan. Secara bawaan, submapnya adalah cache di DATA_DIR.

Ubah ini ke sistem berkas lokal atau sementara jika DATA_DIR ada di sistem berkas jaringan.

Weblate stores generated helper files here and executes some of them, so CACHE_DIR has to be writable and mounted on a filesystem that allows execution. Avoid using noexec mount options for this directory.

Kontainer Docker menggunakan volume terpisah untuk ini, lihat Volume kontainer Docker.

Subdirektori berikut biasanya ada:

ssh

Generated helper files used for VCS access.

fonts

font-config simpanan untuk Mengelola huruf.

avatar

Avatar pengguna yang disimpan, lihat Avatar.

static

Lokasi bawaan untuk berkas Django statis, ditentukan oleh STATIC_ROOT. Lihat Menyajikan berkas statis.

tesseract

Data terlatih OCR untuk Screenshots and visual context.

CSP_SCRIPT_SRC, CSP_IMG_SRC, CSP_CONNECT_SRC, CSP_STYLE_SRC, CSP_FONT_SRC, CSP_FORM_SRC

Sesuaikan kepala Content-Security-Policy untuk Weblate. Kepala dihasilkan secara otomatis berdasarkan integrasi yang diaktifkan dengan layanan pihak ketiga (Matomo, Google Analytics, Sentry, …).

Semua ini secara bawaan masuk ke dalam daftar kosong.

Contoh:

# Enable Cloudflare Javascript optimizations
CSP_SCRIPT_SRC = ["ajax.cloudflare.com"]

Lihat juga

CHECK_LIST

Daftar pemeriksaan kualitas yang harus dilakukan pada terjemahan.

Catatan

Sediakan jalur yang sepenuhnya memenuhi syarat ke kelas Python yang mengimplementasikan antarmuka pemeriksaan.

Sesuaikan daftar pemeriksaan untuk menyertakan pemeriksaan yang relevan bagi Anda.

Semua Pemeriksaan kualitas bawaan diaktifkan secara bawaan, dan Anda dapat mengubah pengaturan ini. Secara bawaan, pemeriksaan ini diberi komentar di Contoh konfigurasi sehingga nilai bawaan digunakan. Pemeriksaan baru kemudian dilakukan untuk setiap versi Weblate yang baru.

Anda dapat mematikan semua pemeriksaan:

CHECK_LIST = ()

Anda hanya dapat menyalakan beberapa:

CHECK_LIST = (
    "weblate.checks.chars.BeginNewlineCheck",
    "weblate.checks.chars.EndNewlineCheck",
    "weblate.checks.chars.MaxLengthCheck",
)

Catatan

Mengubah pengaturan ini hanya akan memengaruhi terjemahan yang baru diubah. Pemeriksaan yang sudah ada akan tetap disimpan dalam basis data. Untuk menerapkan perubahan pada terjemahan yang tersimpan, jalankan updatechecks.

Lihat juga

COMMIT_PENDING_HOURS

Jumlah jam antara melakukan perubahan yang tertunda melalui tugas latar belakang.

Lihat juga

COMPONENT_ZIP_UPLOAD_MAX_SIZE

Added in version 5.17.1.

Configures the maximum size, in bytes, for uploaded component ZIP files. Defaults to 50 MB.

In Docker, configure this using the WEBLATE_COMPONENT_ZIP_UPLOAD_MAX_SIZE environment variable.

Lihat juga

CONTACT_FORM

Added in version 4.6.

Mengkonfigurasikan cara pengiriman surel dari formulir kontak. Pilih konfigurasi yang sesuai dengan konfigurasi server surat Anda.

"reply-to"

The sender is used as Reply-To, this is the default behaviour.

"from"

The sender is used as From. Your mail server needs to allow sending such e-mails.

"disabled"

Menonaktifkan formulir kontak sepenuhnya.

Added in version 5.15.

Lihat juga

ADMINS_CONTACT

DATA_DIR

Map Weblate menyimpan semua data. Map ini berisi tautan ke repositori VCS, indeks teks lengkap, dan berbagai berkas konfigurasi untuk alat eksternal.

Subdirektori berikut biasanya ada:

home

Direktori beranda yang digunakan untuk menjalankan skrip.

ssh

Kunci SSH dan konfigurasi.

media

Lokasi bawaan untuk berkas media Django, ditentukan oleh MEDIA_ROOT. Berisi tangkapan layar yang diunggah, lihat Screenshots and visual context.

vcs

Repositori kontrol versi untuk terjemahan.

backups

Data cadangan harian. Silakan periksa Data yang dibuang untuk cadangan untuk rinciannya.

fonts:

Huruf yang diunggah pengguna, lihat Mengelola huruf.

cache

Berbagai simpanan. Dapat ditempatkan di tempat lain menggunakan CACHE_DIR.

Kontainer Docker menggunakan volume terpisah untuk ini, lihat Volume kontainer Docker.

Catatan

Direktori ini harus dapat ditulis oleh Weblate. Menjalankannya sebagai WSGI berarti pengguna www-data harus memiliki akses tulis ke direktorinya.

Cara termudah untuk mencapai hal ini adalah membuat pengguna sebagai pemilik direktori:

sudo chown www-data:www-data -R $DATA_DIR

Bawaannya adalah /home/weblate/data, tetapi diharapkan untuk dikonfigurasikan.

Lihat juga

DATABASE_BACKUP

Apakah pencadangan basis data harus disimpan sebagai teks biasa, dikompresi, atau dilewati. Nilai yang sah adalah:

  • "plain"

  • "compressed"

  • "none"

Lihat juga

Mencadangkan dan memindahkan Weblate

DEFAULT_ACCESS_CONTROL

Pengaturan kontrol akses bawaan untuk proyek baru:

0

Publik

1

Dilindungi

100

Privat

200

Kustom

Gunakan Kustom jika Anda mengelola ACL secara manual, yang berarti tidak bergantung pada pengelolaan Weblate internal.

Lihat juga

DEFAULT_AUTO_WATCH

Added in version 4.5.

Mengkonfigurasikan apakah Pantau proyek dalam kontribusi secara otomatis harus diaktifkan untuk pengguna baru. Nilai bawaannya adalah True.

Lihat juga

Notifikasi

DEFAULT_RESTRICTED_COMPONENT

Added in version 4.1.

Nilai bawaan untuk pembatasan komponen.

Lihat juga

DEFAULT_ADD_MESSAGE, DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE, DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE

Pesan komit bawaan untuk operasi yang berbeda, silakan periksa Konfigurasi komponen untuk rinciannya.

The built-in defaults follow Conventional Commits and include Weblate links where available. Changing these settings affects newly created defaults; existing message templates can be reset in the settings forms with Restore site default. For inherited values, restoring the site default also disables inheritance for that message.

Lihat juga

DEFAULT_ADDONS

Pengaya bawaan yang akan dipasang pada setiap komponen yang dibuat.

Catatan

Pengaturan ini hanya memengaruhi komponen yang baru dibuat.

Contoh:

DEFAULT_ADDONS = {
    # Add-on with no parameters
    "weblate.flags.target_edit": {},
    # Add-on with parameters
    "weblate.autotranslate.autotranslate": {
        "mode": "suggest",
        "filter_type": "todo",
        "auto_source": "mt",
        "component": "",
        "engines": ["weblate-translation-memory"],
        "threshold": "80",
    },
}

Lihat juga

DEFAULT_COMMITER_EMAIL

Alamat surel komiter, bawaannya adalah noreply@weblate.org.

Lihat juga

DEFAULT_COMMITER_NAME

DEFAULT_COMMITER_NAME

Nama komiter, bawaannya adalah Weblate.

Lihat juga

DEFAULT_COMMITER_EMAIL

DEFAULT_LANGUAGE

Added in version 4.3.2.

Bahasa sumber untuk komponen baru apa pun.

Bawaannya adalah en. Objek bahasa yang cocok harus ada di dalam basis data.

Lihat juga

DEFAULT_MERGE_STYLE

Gaya penggabungan untuk komponen baru apa pun.

  • basis ulang - bawaan

  • gabung

Lihat juga

DEFAULT_SHARED_TM

Mengkonfigurasikan nilai bawaan Gunakan memori terjemahan bersama dan Kontribusikan pada memori terjemahan bersama.

DEFAULT_TRANSLATION_REVIEW

Added in version 5.16.

Mengkonfigurasikan nilai bawaan untuk Aktifkan tinjauan, yang secara bawaan dimatikan.

DEFAULT_SOURCE_REVIEW

Added in version 5.16.

Mengkonfigurasikan nilai bawaan untuk Aktifkan tinjauan sumber, yang secara bawaan dimatikan.

DEFAULT_AUTOCLEAN_TM

Added in version 5.13.

Mengkonfigurasikan nilai bawaan Bersihkan otomatis memori terjemahan.

DEFAULT_TRANSLATION_PROPAGATION

Pengaturan bawaan untuk propagasi terjemahan, bawaannya adalah True.

Lihat juga

DEFAULT_PULL_MESSAGE

Mengkonfigurasikan judul dan pesan bawaan untuk permintaan tarik.

The built-in default follows Conventional Commits and includes Weblate links and translation status.

ENABLE_AVATARS

Apakah avatar berbasis Gravatar akan dinyalakan untuk pengguna. Nyala secara bawaan.

Avatar diambil dan disimpan di server, mengurangi risiko kebocoran informasi privat, dan mempercepat pengalaman pengguna.

Lihat juga

ENABLE_HOOKS

Apakah akan menyalakan kait jarak jauh anonim.

Lihat juga

Pengait notifikasi

ENABLE_HTTPS

Berubah pada versi 5.7: Weblate sekarang memerlukan https untuk dukungan WebAuthn.

Apakah tautan akan dikirim ke Weblate sebagai HTTPS atau HTTP. Pengaturan ini memengaruhi surel terkirim dan URL mutlak yang dihasilkan.

Dalam konfigurasi bawaan ini juga digunakan untuk beberapa pengaturan Django yang terkait dengan HTTPS — ini mengaktifkan kuki aman, mengubah HSTS atau mengaktifkan pengalihan ke URL HTTPS.

Pengalihan HTTPS mungkin bermasalah dalam beberapa kasus, dan Anda mungkin mengalami isu dengan pengalihan tak terbatas jika Anda menggunakan proksi terbalik yang melakukan penghentian SSL yang tidak meneruskan kepala protokol dengan benar ke Django. Silakan sesuaikan konfigurasi proksi terbalik Anda untuk menampilkan kepala X-Forwarded-Proto atau Forwarded atau konfigurasikan SECURE_PROXY_SSL_HEADER agar Django dapat mendeteksi status SSL dengan benar.

Jika ini dinonaktifkan, Weblate akan gagal memulai dengan galat otp_webauthn.E031. Anda dapat membisukan galat ini dengan menambahkannya ke SILENCED_SYSTEM_CHECKS, tetapi WebAuthn tetap tidak akan berfungsi untuk situs tanpa HTTPS.

Lihat juga

ENABLE_SHARING

Nyalakan/matikan Komunitas sehingga pengguna dapat berbagi progres terjemahan di jejaring sosial.

Lihat juga

Membangun komunitas terjemahan

EXTRA_HTML_HEAD

Added in version 4.15.

Sisipkan markah tambahan ke dalam kepala HTML. Dapat digunakan untuk verifikasi kepemilikan situs, misalnya:

EXTRA_HTML_HEAD = '<link href="https://fosstodon.org/@weblate" rel="me">'

Peringatan

Tidak ada sanitasi yang dilakukan pada string. String tersebut dimasukkan apa adanya ke dalam kepala HTML.

GET_HELP_URL

Added in version 4.5.2.

URL tempat dukungan untuk instansi Weblate Anda dapat ditemukan.

GITEA_CREDENTIALS

Added in version 4.12.

Daftar kredensial untuk server Gitea.

GITEA_CREDENTIALS = {
    "try.gitea.io": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

Kamus konfigurasi terdiri dari kredensial yang ditentukan untuk setiap hos API. Tata letaknya sama untuk hampir semua integrasi kontrol versi dan dijelaskan di Mengkonfigurasikan kredensial kontrol versi.

Lihat juga

GITLAB_CREDENTIALS

Added in version 4.3.

Daftar kredensial untuk server GitLab.

GITLAB_CREDENTIALS = {
    "gitlab.com": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

Catatan

Token akses pribadi memerlukan cakupan api agar dapat menggunakan API.

Kamus konfigurasi terdiri dari kredensial yang ditentukan untuk setiap hos API. Tata letaknya sama untuk hampir semua integrasi kontrol versi dan dijelaskan di Mengkonfigurasikan kredensial kontrol versi.

Lihat juga

GITHUB_CREDENTIALS

Added in version 4.3.

Daftar kredensial untuk server GitHub.

GITHUB_CREDENTIALS = {
    "api.github.com": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

Catatan

Anda dapat menggunakan token akses personal mendalam maupun token akses personal klasik. Token mendalam ini terbatas pada satu organisasi, sehingga tidak akan berfungsi jika Anda ingin Weblate melakukan forking repositori di luar organisasi (biasanya ke namespace pengguna).

Untuk mengkloning, mendorong, dan membuat permintaan tarik, akses baca dan tulis ke Konten dan Permintaan tarik diperlukan.

Administrasi mungkin juga diperlukan untuk melakukan forking repositori jika Anda bermaksud menggunakan forking dan repositori asli tidak bersifat publik.

Petunjuk

Use api.github.com as an API host for https://github.com/.

Kamus konfigurasi terdiri dari kredensial yang ditentukan untuk setiap hos API. Tata letaknya sama untuk hampir semua integrasi kontrol versi dan dijelaskan di Mengkonfigurasikan kredensial kontrol versi.

Lihat juga

BITBUCKETSERVER_CREDENTIALS

Added in version 4.16.

Daftar kredensial untuk Bitbucket Data Center.

BITBUCKETSERVER_CREDENTIALS = {
    "git.self-hosted.com": {
        "username": "weblate",
        "token": "http-access-token",
    },
}

Kamus konfigurasi terdiri dari kredensial yang ditentukan untuk setiap hos API. Tata letaknya sama untuk hampir semua integrasi kontrol versi dan dijelaskan di Mengkonfigurasikan kredensial kontrol versi.

Lihat juga

BITBUCKETCLOUD_CREDENTIALS

Added in version 5.8.

Daftar kredensial untuk server Bitbucket Cloud.

BITBUCKETCLOUD_CREDENTIALS = {
    "bitbucket.org": {
        "username": "your-email",
        "workspace": "your-workspace-slug",
        "token": "your-api-token",
    },
}

Kamus konfigurasi berisi kredensial yang ditentukan untuk setiap hos API. Hos API mungkin berbeda dari yang Anda gunakan di peramban web, misalnya API GitHub diakses sebagai api.github.com.

Konfigurasi berikut tersedia untuk setiap hos:

username

Pengguna API.

workspace

Slug ruang kerja pengguna.

token

Token API dengan izin pullrequest:write.

Pengaturan tambahan yang tidak dijelaskan di sini dapat ditemukan di Mengkonfigurasikan kredensial kontrol versi.

Lihat juga

AZURE_DEVOPS_CREDENTIALS

Added in version 5.2.

Daftar kredensial untuk server Azure DevOps.

AZURE_DEVOPS_CREDENTIALS = {
    "dev.azure.com": {
        "username": "project-name",
        "token": "your-api-token",
        "organization": "organization-name",
    },
}

Kamus konfigurasi berisi kredensial yang ditentukan untuk setiap hos API. Hos API mungkin berbeda dari yang Anda gunakan di peramban web, misalnya API GitHub diakses sebagai api.github.com.

Konfigurasi berikut tersedia untuk setiap hos:

username

Nama proyek Azure DevOps. Ini bukan nama repositori.

organization

Nama organisasi proyek.

workItemIds

Daftar opsional ID item pekerjaan dari organisasi Anda. Setelah disediakan, permintaan tarik baru akan menyertakannya.

token

Token API untuk pengguna API, diperlukan.

Pengaturan tambahan yang tidak dijelaskan di sini dapat ditemukan di Mengkonfigurasikan kredensial kontrol versi.

Lihat juga

GOOGLE_ANALYTICS_ID

ID Google Analytics untuk mengaktifkan pemantauan Weblate menggunakan Google Universal Analytics.

Catatan

Integrasi Google Analytics 4 saat ini tidak tersedia untuk Weblate, silakan lihat https://github.com/WeblateOrg/weblate/issues/14015.

HIDE_REPO_CREDENTIALS

Sembunyikan kredensial repositori dari antarmuka web. Jika Anda memiliki URL repositori dengan nama pengguna dan kata sandi, Weblate akan menyembunyikannya saat informasi terkait ditampilkan kepada pengguna.

Misalnya, alih-alih https://user:password@git.example.com/repo.git, https://git.example.com/repo.git akan ditampilkan. Itu juga mencoba membersihkan pesan galat VCS dengan cara yang serupa.

Catatan

Nyala secara bawaan.

VERSION_DISPLAY

Added in version 5.17.

Controls how prominently Weblate exposes its own version.

Supported values are:

show

Show the version in shared UI such as the footer and expose it in GET /api/metrics/.

soft

Hide the version from prominent shared UI, while keeping it discoverable on the About page and in GET /api/metrics/.

hide

Hide the version from shared UI and GET /api/metrics/. This also makes anonymous documentation links point to the latest documentation instead of the version matching the installed release.

Hiding the version is a recommended security practice in some corporations, but it does not prevent an attacker from inferring the version by probing behavior.

Catatan

The default is show.

HIDE_VERSION

Added in version 4.3.1.

Ditinggalkan sejak versi 5.17.

Compatibility alias for VERSION_DISPLAY. Set this to True to get the same behavior as VERSION_DISPLAY = "hide".

IP_BEHIND_REVERSE_PROXY

Menunjukkan apakah Weblate berjalan di belakang proksi terbalik.

Jika diatur ke True, Weblate mendapatkan alamat IP dari kepala yang didefinisikan oleh IP_PROXY_HEADER.

Peringatan

Pastikan Anda benar-benar menggunakan proksi terbalik dan mengatur kepala ini, jika tidak, pengguna akan dapat memalsukan alamat IP.

Catatan

Ini tidak menyala secara bawaan.

Lihat juga

IP_PROXY_HEADER

Menunjukkan kepala Weblate mana yang harus memperoleh alamat IP saat IP_BEHIND_REVERSE_PROXY dinyalakan.

Bawaannya adalah HTTP_X_FORWARDED_FOR.

Lihat juga

IP_PROXY_OFFSET

Berubah pada versi 5.0.1: Nilai bawaan berubah dari 1 menjadi -1.

Menunjukkan bagian mana dari IP_PROXY_HEADER yang digunakan sebagai alamat IP klien.

Bergantung pada pengaturan Anda, kepala ini mungkin terdiri dari beberapa alamat IP, (misalnya X-Forwarded-For: client-ip, proxy-a, proxy-b) dan Anda dapat mengkonfigurasikan alamat mana dari kepala yang digunakan sebagai alamat IP klien di sini.

Peringatan

Pengaturan ini akan memengaruhi keamanan pemasangan Anda. Anda sebaiknya hanya mengkonfigurasikannya untuk menggunakan proksi tepercaya dalam menentukan alamat IP. Silakan periksa <https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Forwarded-For#security_and_privacy_concerns> untuk rincian lebih lanjut.

Bawaannya adalah -1.

Lihat juga

LICENSE_EXTRA

Lisensi tambahan untuk disertakan dalam pilihan lisensi.

Catatan

Each license definition should be a tuple of its short name, a long name, a URL and a boolean, indicating whether it is a libre license.

Contoh:

LICENSE_EXTRA = [
    (
        "AGPL-3.0",
        "GNU Affero General Public License v3.0",
        "https://www.gnu.org/licenses/agpl-3.0-standalone.html",
        True,
    ),
]

LICENSE_FILTER

Berubah pada versi 4.3: Mengatur ini ke nilai kosong sekarang menonaktifkan peringatan lisensi.

Filter daftar lisensi yang akan ditampilkan. Ini juga menonaktifkan peringatan lisensi jika diatur kosong.

Catatan

Filter ini menggunakan nama lisensi pendek.

Contoh:

LICENSE_FILTER = {"AGPL-3.0", "GPL-3.0-or-later"}

Berikut menonaktifkan peringatan lisensi:

LICENSE_FILTER = set()

Lihat juga

Translation component diagnostics

LICENSE_REQUIRED

Mendefinisikan apakah atribut lisensi dalam Konfigurasi komponen diperlukan.

Catatan

Ini dimatikan secara bawaan.

LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH

Apakah panjang terjemahan tertentu harus dibatasi. Batasannya adalah panjang string sumber × 10 karakter.

Petunjuk

Atur ini ke False untuk memperbolehkan terjemahan yang lebih panjang (hingga 10.000 karakter) tanpa mempedulikan panjang string sumber.

Catatan

Bawaannya adalah True.

LOCALIZE_CDN_URL dan LOCALIZE_CDN_PATH

These settings configure the CDN add-ons, including CDN lokalisasi JavaScript and CDN berkas terjemahan. LOCALIZE_CDN_URL defines root URL where the localization CDN is available and LOCALIZE_CDN_PATH defines path where Weblate should store generated files which will be served at the LOCALIZE_CDN_URL. The files are served by your web server or CDN, not by Weblate; see CDN lokalisasi for secure serving guidance.

Petunjuk

Pada Hosted Weblate, ini menggunakan https://weblate-cdn.com/.

Lihat juga

MATOMO_SITE_ID

ID situs di Matomo (sebelumnya Piwik) yang ingin Anda gunakan untuk melacak Weblate.

Catatan

Integrasi ini tidak mendukung Matomo Tag Manager.

Lihat juga

MATOMO_URL

MATOMO_URL

URL lengkap (termasuk garis miring di akhir) instalasi Matomo (sebelumnya Piwik) yang ingin Anda gunakan untuk melacak penggunaan Weblate. Silakan periksa <https://matomo.org/> untuk rincian lebih lanjut.

Petunjuk

Integrasi ini tidak mendukung Matomo Tag Manager.

Contoh:

MATOMO_SITE_ID = 1
MATOMO_URL = "https://example.matomo.cloud/"

Lihat juga

MATOMO_SITE_ID

NEARBY_MESSAGES

Jumlah string terdekat untuk ditampilkan di tiap arah di dalam penyuntingan lengkap.

Ini hanyalah nilai bawaan, pengguna dapat menyesuaikannya di Profil pengguna.

DEFAULT_PAGE_LIMIT

Added in version 4.7.

Jumlah elemen bawaan yang akan ditampilkan saat paginasi aktif.

PAGURE_CREDENTIALS

Added in version 4.3.2.

Daftar kredensial untuk server Pagure.

PAGURE_CREDENTIALS = {
    "pagure.io": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

Kamus konfigurasi terdiri dari kredensial yang ditentukan untuk setiap hos API. Tata letaknya sama untuk hampir semua integrasi kontrol versi dan dijelaskan di Mengkonfigurasikan kredensial kontrol versi.

Lihat juga

PASSWORD_MINIMAL_STRENGTH

Added in version 5.10.2.

Skor kata sandi minimal sebagaimana dievaluasi oleh penaksir kekuatan kata sandi zxcvbn.

Bawaannya adalah 0, yang berarti pemeriksaan kekuatan dinonaktifkan.

Lihat juga

PASSWORD_RESET_URL

Added in version 5.17.

URL for password reset when authentication is handled by an external identity provider, such as LDAP, SAML, or OAuth.

When set, Forgot your password? on the sign-in page links to this URL instead of Weblate's built-in password reset page.

PRIVACY_URL

Added in version 4.8.1.

URL tempat instansi Weblate Anda menampilkan kebijakan privasinya.

Petunjuk

Useful if you host your privacy policy outside Weblate instead of using the Modul hukum module. When the legal module is enabled, Weblate links to the internal legal pages by default.

Contoh:

PRIVACY_URL = "https://weblate.org/terms/"

Lihat juga

LEGAL_URL

PRIVATE_COMMIT_EMAIL_OPT_IN

Added in version 4.15.

Mengkonfigurasikan apakah komit surel privat bersifat opt-in atau opt-out (secara bawaan bersifat opt-in).

Petunjuk

Pengaturan ini hanya berlaku bagi pengguna yang belum secara eksplisit memilih surel komit.

Lihat juga

PRIVATE_COMMIT_EMAIL_TEMPLATE

Added in version 4.15.

Templat untuk menghasilkan surel komit privat bagi pengguna. Bawaannya adalah "{username}@users.noreply.{site_domain}".

Itu dapat berisi {user_id}, {username}, {site_title}, dan {site_domain}.

Atur ke string kosong untuk menonaktifkan.

Catatan

Menggunakan surel komit yang berbeda merupakan opsi bagi pengguna, kecuali dikonfigurasikan oleh PRIVATE_COMMIT_EMAIL_OPT_IN. Pengguna dapat mengkonfigurasikan surel komit di Profil.

PRIVATE_COMMIT_NAME_OPT_IN

Added in version 5.16.

Mengkonfigurasikan apakah nama komit privat bersifat opt-in atau opt-out (secara bawaan bersifat opt-in).

Petunjuk

Pengaturan ini hanya berlaku untuk pengguna yang belum secara eksplisit memilih nama komit.

Lihat juga

PRIVATE_COMMIT_NAME_TEMPLATE

Added in version 5.16.

Templat untuk menghasilkan nama komit privat bagi pengguna. Bawaannya adalah "{site_title} user {user_id}".

Itu dapat berisi {user_id}, {username}, {site_title}, dan {site_domain}.

Atur ke string kosong untuk menonaktifkan.

Catatan

Menggunakan surel komit yang berbeda merupakan opsi bagi pengguna, kecuali dikonfigurasikan oleh PRIVATE_COMMIT_NAME_OPT_IN. Pengguna dapat mengkonfigurasikan surel komit di Profil.

PROJECT_BACKUP_KEEP_COUNT

Added in version 4.14.

Mendefinisikan jumlah cadangan per proyek yang disimpan di server. Bawaannya adalah 3.

Lihat juga

Cadangan tingkat proyek

PROJECT_BACKUP_KEEP_DAYS

Added in version 4.14.

Mendefinisikan berapa lama cadangan proyek akan disimpan di server. Bawaannya adalah 30 hari.

Lihat juga

Cadangan tingkat proyek

PROJECT_BACKUP_UPLOAD_MAX_SIZE

Added in version 5.17.1.

Configures the maximum size, in bytes, for uploaded project backup ZIP files. Defaults to 536870912 bytes (512 MiB).

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_UPLOAD_MAX_SIZE environment variable. Docker setups can also be constrained by CLIENT_MAX_BODY_SIZE; other deployments can be constrained by their reverse proxy request body-size limit.

Lihat juga

Cadangan tingkat proyek

PROJECT_BACKUP_IMPORT_MAX_MEMBERS

Added in version 5.17.

Defines the maximum number of ZIP entries allowed when importing a project backup.

This is a safeguard against malformed or intentionally fragmented archives. Defaults to 100000 entries.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_MEMBERS environment variable.

Lihat juga

Cadangan tingkat proyek

PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE

Added in version 5.17.1.

Defines the maximum total uncompressed size, in bytes, for ZIP entries in an imported project backup. Defaults to 536870912 bytes (512 MiB).

This limits archives that are small when uploaded but expand to much more data during validation or restore.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE environment variable.

Lihat juga

Cadangan tingkat proyek

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE

Added in version 5.17.

Defines the maximum uncompressed size, in bytes, for a single highly compressed ZIP entry in an imported project backup.

This limit is only applied to entries that are large enough and compress enough to look suspicious. Large low-compression files are intentionally allowed here and are expected to be constrained by the HTTP upload limit. Defaults to 262144000 bytes (250 MiB).

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE environment variable.

Lihat juga

Cadangan tingkat proyek

PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE

Added in version 5.17.

Defines the minimum uncompressed size, in bytes, at which Weblate starts considering the ZIP compression ratio during project backup import.

Smaller files are ignored for the compression-ratio-based validation to avoid rejecting reasonably sized files that compress well. Defaults to 1048576 bytes (1 MiB).

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE environment variable.

Lihat juga

Cadangan tingkat proyek

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO

Added in version 5.17.

Defines the maximum allowed ratio between the uncompressed and compressed size for a large ZIP entry during project backup import.

This is used together with PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE and PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE to detect suspiciously compressed entries while still allowing large repository pack files and other low-compression content. Defaults to 250.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO environment variable.

Lihat juga

Cadangan tingkat proyek

PROJECT_NAME_RESTRICT_RE

Added in version 4.15.

Mendefinisikan ekspresi reguler untuk membatasi penamaan proyek. Nama yang cocok akan ditolak.

Lihat juga

Nama proyek

PROJECT_WEB_RESTRICT_HOST

Added in version 4.16.2.

Tolak penggunaan hos tertentu di situs web proyek. Semua subdomain akan dicocokkan, jadi jika example.com disertakan, test.example.com juga akan diblokir. Daftar ini hanya boleh berisi string huruf kecil, domain yang diurai akan diubah menjadi huruf kecil sebelum dicocokkan.

Konfigurasi bawaan:

PROJECT_WEB_RESTRICT_HOST = {"localhost"}

Lihat juga

PROJECT_WEB_RESTRICT_ALLOWLIST

Added in version 5.17.

Defines a set of project slugs exempt from PROJECT_WEB_RESTRICT_HOST, PROJECT_WEB_RESTRICT_NUMERIC, PROJECT_WEB_RESTRICT_PRIVATE, and PROJECT_WEB_RESTRICT_RE when validating the project website. Project slugs are matched case-insensitively.

Hati-hati

This exemption weakens outbound URL protections for matching projects, including the private-target restriction enforced by PROJECT_WEB_RESTRICT_PRIVATE. Use it only for trusted, administrator-managed projects where bypassing these checks is intentional.

Konfigurasi bawaan:

PROJECT_WEB_RESTRICT_ALLOWLIST = set()

Lihat juga

PROJECT_WEB_RESTRICT_NUMERIC

Added in version 4.16.2.

Tolak penggunaan alamat IP numerik di situs web proyek. Aktif secara bawaan.

Lihat juga

PROJECT_WEB_RESTRICT_PRIVATE

Added in version 5.17.

Reject using project website and repository browser URLs pointing to internal or non-public addresses. On by default.

Lihat juga

PROJECT_WEB_RESTRICT_RE

Added in version 4.15.

Mendefinisikan ekspresi reguler untuk membatasi apa yang dapat dimasukkan sebagai Situs web proyek. URL yang cocok akan ditolak.

Lihat juga

WEBHOOK_PRIVATE_ALLOWLIST

Added in version 5.17.

Defines hostnames or domains exempt from WEBHOOK_RESTRICT_PRIVATE for outbound webhook delivery. Entries follow Django host matching semantics, so values such as hooks.internal.example or .internal.example can be used.

Konfigurasi bawaan:

WEBHOOK_PRIVATE_ALLOWLIST = []

Lihat juga

WEBHOOK_RESTRICT_PRIVATE

Added in version 5.17.

Reject webhook URLs pointing to internal or non-public addresses unless the target host is included in WEBHOOK_PRIVATE_ALLOWLIST. On by default.

When enabled, hostnames that cannot be resolved during validation are rejected unless they are explicitly included in WEBHOOK_PRIVATE_ALLOWLIST.

Lihat juga

PUBLIC_ENGAGE

Added in version 5.16.2.

Allows public engage page even with REQUIRE_LOGIN.

Lihat juga

RATELIMIT_NOTIFICATION_LIMITS

Added in version 5.14.

Membatasi berapa banyak notifikasi untuk satu pengguna yang akan dikirimkan.

Pengaturan bawaannya adalah:

# Multi-level rate limiting for email notifications
# Each tuple contains (max_emails, time_window_seconds)
RATELIMIT_NOTIFICATION_LIMITS = [
    # Prevent burst sends - 3 emails per 2 minutes
    (3, 120),
    # Equalize to avoid getting blocked for too long - 10 emails per hour
    (10, 3600),
    # Daily limit: 50 emails per day
    (50, 86400),
]

RATELIMIT_ATTEMPTS

Jumlah maksimum percobaan autentikasi sebelum pembatasan akses diterapkan.

Bawaannya adalah 5.

Lihat juga

RATELIMIT_WINDOW

Berapa lama autentikasi diterima setelah pembatasan akses berlaku.

Jumlah detik, bawaannya 300 (5 menit).

Lihat juga

RATELIMIT_LOCKOUT

Berapa lama autentikasi dikunci setelah pembatasan akses diterapkan.

Jumlah detik bawaannya 600 (10 menit).

Lihat juga

REGISTRATION_ALLOW_BACKENDS

Added in version 4.1.

Daftar backend autentikasi yang memungkinkan pendaftaran. Ini hanya membatasi pendaftaran baru, pengguna masih dapat mengautentikasi dan menambahkan autentikasi menggunakan semua backend autentikasi yang dikonfigurasikan.

Disarankan untuk tetap menyalakan REGISTRATION_OPEN saat membatasi backend pendaftaran, jika tidak, pengguna akan dapat mendaftar, tetapi Weblate tidak akan menampilkan tautan untuk mendaftar di antarmuka pengguna.

Contoh:

REGISTRATION_ALLOW_BACKENDS = ["azuread-oauth2", "azuread-tenant-oauth2"]

Petunjuk

Nama backend cocok dengan nama yang digunakan di URL untuk autentikasi.

Lihat juga

REGISTRATION_CAPTCHA

Apakah pendaftaran akun baru dilindungi oleh CAPTCHA. Bawaannya adalah diaktifkan.

If turned on, a CAPTCHA is added to all pages where a user enters their e-mail address:

  • Pendaftaran akun baru.

  • Pemulihan kata sandi.

  • Menambahkan surel ke akun.

  • Formulir kontak untuk pengguna yang tidak masuk.

Perlindungan saat ini terdiri dari langkah berikut:

REGISTRATION_EMAIL_MATCH

Mengizinkan Anda memfilter alamat surel mana yang dapat mendaftarkan.

Bawaannya adalah .*, yang memperbolehkan alamat surel apa pun untuk didaftarkan.

Anda dapat menggunakannya untuk membatasi pendaftaran ke satu domain surel:

REGISTRATION_EMAIL_MATCH = r"^.*@weblate\.org$"

REGISTRATION_ALLOW_DISPOSABLE_EMAILS

Added in version 5.16.1.

Allow registration with disposable e-mail domains. When enabled, the disposable domain blocklist is bypassed. Default is False.

Lihat juga

REGISTRATION_OPEN

Apakah pendaftaran akun baru saat ini diizinkan. Bawaannya adalah diaktifkan.

Pengaturan ini memengaruhi autentikasi bawaan melalui alamat surel atau melalui Python Social Auth (Anda dapat mengizinkan back-end tertentu menggunakan REGISTRATION_ALLOW_BACKENDS).

Catatan

Jika menggunakan metode autentikasi pihak ketiga seperti Autentikasi LDAP, ia hanya menyembunyikan formulir pendaftaran, tetapi pengguna baru mungkin masih dapat masuk dan membuat akun.

Lihat juga

REGISTRATION_REBIND

Added in version 4.16.

Izinkan pengikatan ulang backend autentikasi untuk pengguna yang sudah ada. Aktifkan ini saat bermigrasi antar penyedia autentikasi.

Catatan

Dimatikan secara bawaan untuk mencegah penambahan backend autentikasi lain ke akun yang sudah ada. Pengikatan ulang dapat menyebabkan akun disusupi saat menggunakan lebih banyak backend autentikasi pihak ketiga.

REPOSITORY_ALERT_THRESHOLD

Added in version 4.0.2.

Ambang batas untuk memicu peringatan repositori yang ketinggalan zaman, atau repositori yang berisi terlalu banyak perubahan. Bawaannya adalah 25.

Lihat juga

Translation component diagnostics

REQUIRE_LOGIN

Added in version 4.1.

Ini mengaktifkan django.contrib.auth.middleware.LoginRequiredMiddleware dan mengkonfigurasikan kerangka kerja REST untuk memerlukan autentikasi untuk semua titik akhir API.

Berubah pada versi 5.15: Weblate sekarang mengandalkan alat tengah bawaan Django.

Catatan

Ini diimplementasikan dalam Contoh konfigurasi. Untuk Docker, gunakan WEBLATE_REQUIRE_LOGIN.

GOOGLE_CLOUD_ERROR_REPORTING

Configuration for Mengumpulkan laporan galat dan memantau kinerja using Google Cloud Error Reporting. Set to None to disable the integration, or set to a dictionary of keyword arguments for the Google Cloud Error Reporting client.

Weblate automatically supplies service as weblate and version as the current Weblate version or Git revision. Explicit values in the dictionary override these defaults.

OPENTELEMETRY_ENABLED

Added in version 2026.6.

Enable backend tracing using OpenTelemetry. Disabled by default.

Traces are exported only when this is enabled and OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT is configured.

OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT

OTLP HTTP traces endpoint for OpenTelemetry, for example https://collector.example.com/v1/traces.

OPENTELEMETRY_EXPORTER_OTLP_HEADERS

Additional HTTP headers for the OpenTelemetry OTLP exporter. Defaults to an empty dictionary.

OPENTELEMETRY_EXTRA_RESOURCE_ATTRIBUTES

Additional OpenTelemetry resource attributes. Defaults to an empty dictionary.

OPENTELEMETRY_SERVICE_NAME

OpenTelemetry service name. Defaults to weblate.

OPENTELEMETRY_TRACES_SAMPLE_RATE

Configure sampling rate for OpenTelemetry traces. Set to 1 to trace all events, 0 (the default) disables tracing.

SENTRY_DSN

Sentry DSN yang digunakan untuk Mengumpulkan laporan galat dan memantau kinerja.

Lihat juga

Integrasi Django untuk Sentry

SENTRY_ENVIRONMENT

Mengkonfigurasikan lingkungan untuk Sentry. Bawaannya adalah devel.

SENTRY_MONITOR_BEAT_TASKS

Added in version 5.13.

Konfigurasikan apakah akan memantau tugas Celery Beat dengan Sentry. Bawaannya adalah Benar.

SENTRY_PROFILES_SAMPLE_RATE

Configure sampling rate for performance monitoring. Set to 1 to profile all traced events (the default), 0 disables profiling.

Lihat juga

Pemantauan Kinerja Sentry

SENTRY_SEND_PII

Izinkan Sentry mengumpulkan informasi identitas pribadi tertentu. Dinonaktifkan secara bawaan.

Berubah pada versi 5.7: Ini dimatikan secara bawaan sekarang, dulu dinyalakan secara bawaan.

SENTRY_TRACES_SAMPLE_RATE

Konfigurasikan akses sampel untuk pemantauan profil. Atur ke 1 untuk melacak semua peristiwa, 0 (bawaan) menonaktifkan pelacakan.

Lihat juga

Profil Sentry

SIMPLIFY_LANGUAGES

Gunakan kode bahasa sederhana untuk kombinasi bahasa/negara bawaan. Misalnya, terjemahan fr_FR akan menggunakan kode bahasa fr. Perilaku ini biasanya diinginkan karena menyederhanakan daftar bahasa untuk kombinasi bawaan ini.

Matikan ini jika Anda menginginkan terjemahan yang berbeda untuk setiap varian.

HIDE_SHARED_GLOSSARY_COMPONENTS

Added in version 5.16.

Komponen glosarium biasanya dibagikan ke proyek lain agar tersedia untuk pekerjaan terjemahan. Ketika komponen ini terlihat dalam daftar komponen proyek yang menggunakannya, itu dapat menyebabkan kebingungan atau mengalihkan perhatian penerjemah dari komponen sebenarnya yang seharusnya diterjemahkan.

Ini dimatikan secara bawaan, sehingga komponen glosarium bersama menjadi terlihat.

SITE_DOMAIN

Mengonfigurasi domain situs. Diperlukan untuk menghasilkan tautan mutlak yang benar dalam berbagai cakupan (misalnya surel aktivasi, notifikasi, atau umpan RSS).

Jika Weblate berjalan pada port non-standar, sertakan juga di sini.

Contoh:

# Production site with domain name
SITE_DOMAIN = "weblate.example.com"

# Local development with IP address and port
SITE_DOMAIN = "127.0.0.1:8000"

Catatan

Pengaturan ini hanya boleh berisi nama domain. Untuk mengkonfigurasikan protokol (menyalakan dan menerapkan HTTPS), gunakan ENABLE_HTTPS dan untuk mengubah URL, gunakan URL_PREFIX.

Petunjuk

Pada kontainer Docker, domain situs dikonfigurasikan melalui WEBLATE_ALLOWED_HOSTS.

Lihat juga

SITE_TITLE

Judul situs yang akan digunakan untuk situs web dan mengirim surel.

SPECIAL_CHARS

Karakter tambahan yang akan disertakan dalam papan ketik visual, Papan ketik visual.

Nilai bawaannya adalah:

SPECIAL_CHARS = ("\t", "\n", "\u00a0", "…")

SINGLE_PROJECT

Mengalihkan pengguna langsung ke proyek atau komponen, alih-alih menampilkan dasbor. Anda dapat mengaturnya ke True agar hanya berfungsi jika hanya ada satu proyek di Weblate. Alternatifnya, atur slug proyek, dan ini akan mengalihkan pengguna tanpa kondisi ke proyek ini.

Contoh:

SINGLE_PROJECT = "test"

SSH_EXTRA_ARGS

Added in version 4.9.

Mengizinkan penambahan parameter kustom saat Weblate memanggil SSH. Berguna saat menghubungkan ke server yang menggunakan enkripsi lawas atau fitur non-standar lainnya.

Misalnya, ketika sambungan SSH di Weblate gagal dengan pesan Tidak dapat bernegosiasi dengan legacyhost: tidak ditemukan metode pertukaran kunci yang cocok. Penawaran mereka: diffie-hellman-group1-sha1, Anda dapat mengaktifkannya menggunakan:

SSH_EXTRA_ARGS = "-oKexAlgorithms=+diffie-hellman-group1-sha1"

Petunjuk

String dievaluasi oleh shell, jadi pastikan semua spasi dan karakter khusus diberi tanda kutip.

Lihat juga

Opsi Lawas OpenSSH

STATUS_URL

URL tempat instansi Weblate Anda melaporkan statusnya.

SUPPORT_STATUS_CHECK

Added in version 5.5.

Menonaktifkan pemeriksaan status dukungan semi tahunan dan mengalihkan pengguna super saat masuk ke halaman donasi jika tidak ada langganan dukungan aktif.

Petunjuk

Tingkatkan pengalaman Weblate Anda dengan membeli langganan dukungan dan tingkatkan progres Weblate alih-alih mematikannya.

TRANSLATION_UPLOAD_MAX_SIZE

Added in version 5.17.1.

Configures the maximum size, in bytes, for uploaded translation files. Defaults to 50 MB.

In Docker, configure this using the WEBLATE_TRANSLATION_UPLOAD_MAX_SIZE environment variable.

UNUSED_ALERT_DAYS

Added in version 4.17.

Mengkonfigurasikan kapan peringatan Komponen tampaknya tidak digunakan dipicu.

Bawaannya adalah 365 hari, atur ke 0 untuk mematikannya.

UPDATE_LANGUAGES

Added in version 4.3.2.

Mengontrol apakah basis data bahasa harus diperbarui saat menjalankan migrasi basis data dan aktif secara bawaan. Pengaturan ini tidak memengaruhi pemanggilan setuplang.

Peringatan

Tampilan bahasa mungkin menjadi tidak konsisten dengan hal ini. Definisi bahasa Weblate berkembang seiring waktu dan tidak akan menampilkan kode bahasa untuk bahasa yang didefinisikan.

Lihat juga

Definisi bahasa bawaan

URL_PREFIX

Pengaturan ini memungkinkan Anda menjalankan Weblate pada jalur tertentu (jika tidak, ia bergantung pada jalur yang dijalankan dari root server web).

Catatan

Untuk menggunakan pengaturan ini, Anda juga perlu mengkonfigurasikan server Anda untuk menghapus prefiks ini. Misalnya, dengan WSGI, hal ini dapat dicapai dengan mengatur WSGIScriptAlias.

Petunjuk

Prefiks harus dimulai dengan /.

Contoh:

URL_PREFIX = "/translations"

Catatan

Pengaturan ini tidak berfungsi dengan server bawaan Django, Anda harus menyesuaikan urls.py untuk memuat prefiks ini.

VCS_ALLOW_HOSTS

Added in version 5.15.

A set of hosts to allow when configuring VCS URL. Defaults to an empty set, which does no filtering at all.

When VCS_RESTRICT_PRIVATE is enabled, matching hosts are also exempt from the private-target restriction.

VCS_ALLOW_SCHEMES

Added in version 5.15.

A set of URL schemes to allow when configuring VCS URL. Only https and ssh are allowed by default.

VCS_RESTRICT_PRIVATE

Added in version 5.17.

Reject VCS repository URLs pointing to internal or non-public addresses unless the target host is included in VCS_ALLOW_HOSTS. On by default.

When enabled, hostnames that cannot be resolved during validation are rejected unless they are explicitly included in VCS_ALLOW_HOSTS.

VCS_API_DELAY

Added in version 4.15.1.

Configures minimal delay in seconds between third-party API calls in Permintaan tarik GitHub, Permintaan penggabungan GitLab, Permintaan tarik Gitea, Permintaan penggabungan Pagure, and Permintaan penarikan Azure DevOps.

Ini membatasi akses panggilan API dari Weblate ke layanan ini untuk menghindari kelebihan beban.

Jika Anda dibatasi oleh pembatas akses sekunder di GitHub, meningkatkannya mungkin dapat membantu.

Nilai bawaannya adalah 10.

VCS_API_TIMEOUT

Added in version 5.15.

Configures timeout in seconds for third-party API calls such as forking or creating merge requests in Permintaan tarik GitHub, Permintaan penggabungan GitLab, Permintaan tarik Gitea, Permintaan penggabungan Pagure, and Permintaan penarikan Azure DevOps.

Nilai bawaannya adalah 10.

VCS_BACKENDS

Konfigurasi backend VCS yang tersedia.

Catatan

Weblate mencoba menggunakan semua back-end yang didukung yang alatnya Anda miliki.

Petunjuk

Anda dapat membatasi pilihan atau menambahkan back-end VCS kustom dengan menggunakan ini.

VCS_BACKENDS = ("weblate.vcs.git.GitRepository",)

Lihat juga

Integrasi kontrol versi

VCS_CLONE_DEPTH

Mengkonfigurasikan seberapa dalam kloning repositori yang harus dilakukan Weblate.

Catatan

Saat ini, fitur ini hanya didukung di Git. Secara bawaan, Weblate melakukan kloning dangkal repositori untuk mempercepat proses kloning dan menghemat ruang cakram. Tergantung penggunaan Anda (misalnya saat menggunakan Pengaya khusus), Anda mungkin ingin meningkatkan kedalaman atau mematikan kloning dangkal sepenuhnya dengan mengatur ini ke 0.

Petunjuk

Jika Anda mendapatkan galat fatal: protocol error: expected old/new/ref, got 'shallow <commit hash>' saat mendorong dari Weblate, matikan klon dangkal sepenuhnya dengan mengatur:

VCS_CLONE_DEPTH = 0

WEBLATE_ADDONS

Daftar pengaya yang tersedia untuk digunakan. Untuk menggunakannya, mereka harus diaktifkan untuk komponen terjemahan tertentu. Secara bawaan, ini mencakup semua pengaya bawaan, saat memperluas daftar, Anda mungkin ingin tetap mengaktifkan yang sudah ada, misalnya:

WEBLATE_ADDONS = (
    # Built-in add-ons
    "weblate.addons.gettext.GenerateMoAddon",
    "weblate.addons.gettext.UpdateLinguasAddon",
    "weblate.addons.gettext.UpdateConfigureAddon",
    "weblate.addons.gettext.MsgmergeAddon",
    "weblate.addons.gettext.GettextAuthorComments",
    "weblate.addons.cleanup.CleanupAddon",
    "weblate.addons.consistency.LanguageConsistencyAddon",
    "weblate.addons.discovery.DiscoveryAddon",
    "weblate.addons.flags.SourceEditAddon",
    "weblate.addons.flags.TargetEditAddon",
    "weblate.addons.flags.SameEditAddon",
    "weblate.addons.flags.BulkEditAddon",
    "weblate.addons.generate.GenerateFileAddon",
    "weblate.addons.properties.PropertiesSortAddon",
    "weblate.addons.git.GitSquashAddon",
    "weblate.addons.removal.RemoveComments",
    "weblate.addons.removal.RemoveSuggestions",
    "weblate.addons.resx.ResxUpdateAddon",
    "weblate.addons.autotranslate.AutoTranslateAddon",
    "weblate.addons.cdn.CDNJSAddon",
    # Add-on you want to include
    "weblate.addons.example.ExampleAddon",
)

Catatan

Menghapus pengaya dari daftar tidak akan menghapusnya dari komponen. Weblate akan mogok jika demikian. Silakan copot pengaya dari semua komponen sebelum menghapusnya dari daftar ini.

Lihat juga

ADDON_ACTIVITY_LOG_EXPIRY

Added in version 5.6.

Mengkonfigurasikan durasi penyimpanan catatan aktivitas untuk pengaya. Bawaannya adalah 180 hari.

WEBLATE_EXPORTERS

Added in version 4.2.

Daftar eksportir yang menawarkan unduhan terjemahan atau glosarium dalam berbagai format berkas.

Lihat juga

Format berkas lokalisasi

WEBLATE_FORMATS

Daftar format berkas yang tersedia untuk digunakan.

Catatan

Daftar bawaan sudah memiliki format umum.

Lihat juga

Format berkas lokalisasi

WEBLATE_MACHINERY

Added in version 4.13.

Daftar layanan mesin yang tersedia untuk digunakan.

Lihat juga

WEBLATE_GPG_IDENTITY

Identitas yang digunakan oleh Weblate untuk menandatangani komit Git, misalnya:

WEBLATE_GPG_IDENTITY = "Weblate <weblate@example.com>"

Pencarian kunci GPG Weblate dilakukan untuk kunci yang cocok (home/.gnupg di bawah DATA_DIR). Jika tidak ditemukan, kunci akan dibuat, silakan periksa Menandatangani komit Git dengan GnuPG untuk rincian lebih lanjut.

Lihat juga

Menandatangani komit Git dengan GnuPG

WEBSITE_REQUIRED

Mendefinisikan apakah Situs web proyek harus ditentukan saat membuat proyek. Nyala secara bawaan, karena hal itu sesuai dengan pengaturan server publik.

WEBSITE_ALERTS_ENABLED

Added in version 5.17.

Bawaan: True.

Defines whether Weblate should check project website availability and show alerts for unreachable project websites.

When set to False, Weblate will skip website availability checks and will not generate project website alerts. This is useful when:

  • Your websites are behind firewalls that block Weblate's requests

  • You want to avoid 403/503-type errors from bot protection

  • Project website availability is not a concern for your installation

Lihat juga

WEBSITE_REQUIRED

Mengkonfigurasikan kredensial kontrol versi

Petunjuk

Bagian ini menjelaskan variabel kredensial VCS sebagai GITHUB_CREDENTIALS, GITLAB_CREDENTIALS, GITEA_CREDENTIALS, PAGURE_CREDENTIALS, BITBUCKETSERVER_CREDENTIALS.

Kamus konfigurasi berisi kredensial yang ditentukan untuk setiap hos API. Hos API mungkin berbeda dari yang Anda gunakan di peramban web, misalnya API GitHub diakses sebagai api.github.com.

Kredensial juga dapat ditimpa dalam URL dorong repositori atau Repositori kode sumber (jika URL push tidak dikonfigurasi), ini diutamakan daripada yang ditentukan dalam berkas konfigurasi.

Konfigurasi berikut tersedia untuk setiap hos:

username

Pengguna API, diperlukan.

token

Token API untuk pengguna API, diperlukan.

scheme

Added in version 4.18.

Penimpaan Scheme. Weblate mencoba mengurai scheme dari URL repositori dan kembali ke https. Jika Anda menjalankan server API secara internal, Anda mungkin ingin menggunakan http, tetapi pertimbangkan keamanannya.

Petunjuk

Dalam kontainer Docker, kredensial dapat dikonfigurasikan menggunakan variabel lingkungan, lihat Kredensial situs pengehosan kode.