Weblate a shaincheapadh¶

Síneadh agus a shaincheapadh ag baint úsáide as Django agus Python. Déan do chuid athruithe in aghaidh an tsrutha ionas gur féidir le gach duine leas a bhaint as. Laghdaíonn sé seo do chostais chothabhála; déantar cúram de chód in Weblate agus comhéadain inmheánacha á athrú nó nuair a dhéantar an cód a athfhachtóiriú.

Hint

Is féidir leat cuma Weblate a shaincheapadh freisin i Saincheapadh cuma.

Warning

Ní mheastar gur API cobhsaí iad comhéadain inmheánacha ná teimpléid. Athbhreithnigh do shaincheapadh le haghaidh gach uasghrádaithe, seans go n-athróidh na comhéadain nó a shéimeantaic gan fógra.

Modúl Python a chruthú¶

Mura bhfuil tú eolach ar Python, b'fhéidir gur mhaith leat breathnú ar Python For Beginners, ag míniú na bunghnéithe agus ag díriú ar ranganna teagaisc eile.

Chun comhad a scríobh le cód saincheaptha Python (ar a dtugtar modúl), teastaíonn áit chun é a stóráil, i gcosán an chórais (de ghnáth rud éigin cosúi /usr/lib/python3.12/site-packages/) nó san eolaire Weblate, a chuirtear leis an gcosán cuardaigh ateangaire freisin.

Hint

Nuair a using Docker, is féidir leat modúil Python a chur i /app/data/python/ (féach Toirteanna coimeádán docker), ionas gur féidir iad a luchtú le Clár Gréasáin, mar shampla ó settings override file.

Níos fearr fós, déan do shaincheapadh i bpacáiste ceart Python:

Cruthaigh fillteán do phacáiste (úsáidfimid weblate_customization).

Laistigh de, cruthaigh comhad pyproject.toml chun cur síos a dhéanamh ar an bpacáiste:

[build-system]
requires = ["uv_build>=0.8.18,<0.9.0"]
build-backend = "uv_build"

[project]
name = "weblate-customization"
version = "0.1.0"
description = "Add your description here"
requires-python = ">=3.13"
dependencies = []

Cruthaigh fillteán don mhodúl Python: src/weblate_customization
Laistigh de, cruthaigh comhad a __init__.py chun a chinntiú gur féidir le Python an modúl a iompórtáil.
Is féidir an pacáiste seo a shuiteáil anois ag baint úsáide as uv pip install -e. Tá tuilleadh eolais le fáil i Editable packages documentation.
Nuair a bheidh sé suiteáilte, is féidir an modúl a úsáid i gcumraíocht Weblate (mar shampla weblate_customization.checks.FooCheck).

Ba cheart go mbeadh cuma mar seo ar do struchtúr pacáiste:

weblate_customization
├── pyproject.toml
└── src
    └── weblate_customization
        ├── __init__.py
        ├── addons.py
        └── checks.py

Is féidir leat sampla de shaincheapadh Weblate a fháil ag <https://github.com/WeblateOrg/customize-example>, clúdaíonn sé na hábhair go léir a gcuirtear síos orthu thíos.

Athrú ar an lógó¶

Cruthaigh aip simplí Django ina bhfuil na comhaid statacha is mian leat a fhorscríobh (féach Modúl Python a chruthú).

Tá brandáil le feiceáil sna comhaid seo a leanas:

icons/weblate.svg
Taispeántar an lógó sa bharra nascleanúna.

logo-*.png
Deilbhíní Gréasáin ag brath ar thaifeach scáileáin agus brabhsálaí gréasáin.

favicon.ico
Deilbhín gréasáin a úsáideann brabhsálaithe oidhreachta.

weblate-*.png
Avatars le haghaidh róbónna nó úsáideoirí gan ainm. Úsáideann roinnt brabhsálaí gréasáin iad seo mar dheilbhíní aicearra.

email-logo.png
Úsáidtear é i r-phoist fógraí.

Cuir é chuig: INSTALLED_APPS:

INSTALLED_APPS = (
    # Add your customization as first
    "weblate_customization",
    # Weblate apps are here…
)

Rith weblate collectstatic --noinput, chun comhaid statacha a sheirbheáiltear do chliaint a bhailiú.

Seiceálacha cáilíochta saincheaptha, breiseáin, moltaí uathoibríocha agus ceartúcháin uathoibríocha¶

Chun do chód a shuiteáil le haghaidh Ceartúcháin uathoibríocha saincheaptha, Ag scríobh seiceanna féin, Aistriúchán meaisín saincheaptha nó Breiseán scríofa i Weblate:

Cuir na comhaid i do mhodúl Python ina bhfuil an saincheapadh Weblate (féach Modúl Python a chruthú nó Cód a shaincheapadh).
Cuir a chonair láncháilithe leis an rang Python sna socruithe tiomnaithe:

# Checks
CHECK_LIST += ("weblate_customization.checks.FooCheck",)

# Autofixes
AUTOFIX_LIST += ("weblate_customization.autofix.FooFixer",)

# Add-ons
WEBLATE_ADDONS += ("weblate_customization.addons.ExamplePreAddon",)

# Automatic suggestions
WEBLATE_MACHINERY += ("weblate_customization.machinery.SampleTranslation",)