Comhéadan gréasáin

Tá an t-éadanas tógtha faoi láthair ag baint úsáide as Bootstrap, jQuery agus beagán leabharlann tríú páirtí.

Brabhsálaithe tacaithe

Tacaíonn Weblate leis na heisiúintí cobhsaí is déanaí de gach mórbhrabhsálaí agus ardáin.

Ní thacaítear go sainráite le brabhsálaithe eile a úsáideann an leagan is déanaí de WebKit, Blink, nó Gecko, cibé acu go díreach nó trí API amharc gréasáin an ardáin. Mar sin féin, ba cheart do Weblate (i bhformhór na gcásanna) taispeáint agus feidhmiú i gceart sna brabhsálaithe seo freisin.

Seans go n-oibreoidh brabhsálaithe níos sine, ach d’fhéadfadh go mbeadh roinnt gnéithe teoranta.

Accessibility

Weblate targets WCAG 2.2 Level AA for new and changed user-facing functionality where practical. Use semantic HTML and Bootstrap components before adding custom interaction code.

When changing the frontend:

  • Make all interactive controls reachable and usable with a keyboard.

  • Keep focus order logical and preserve visible focus styling.

  • Prefer native buttons, links, inputs, selects, and tables over custom widgets.

  • Associate every form control with a label, help text, and validation errors where applicable.

  • Do not use color, icon shape, or position as the only way to convey state.

  • Announce dynamic status changes that are not otherwise visible to assistive technology.

  • Respect reduced-motion preferences for animation or scrolling behavior.

  • Test changed workflows with keyboard-only navigation and, when practical, a screen reader spot check.

Bainistíocht spleáchais

Is féidir le leabharlanna 3ú páirtí a shuiteáil agus a bhainistiú sa chliant de thionscadal Django a bheith beagán deacair. Soláthraíonn an rannán seo treoir céim ar chéim ar conas leabharlanna 3ú páirtí a shuiteáil agus a bhainistiú a úsáideann an taobh cliant de Weblate ag baint úsáide as Webpack.

Réamhriachtanais

Sula dtéann tú ar aghaidh le suiteáil, déan cinnte go bhfuil na réamhriachtanais seo a leanas agat:

  • Scaoileadh tacaithe de Node.js.

  • Tá an bainisteoir pacáiste yarn suiteáilte ar do chóras.

  • Rith cliant cd.

  • Rith yarn install --check-files.

Suiteáil

Chun leabharlann a shuiteáil, rith an t-ordú seo a leanas ar dtús:

yarn add <lib-name>

An Leabharlann a Iompórtáil

Ansin, tá dhá bhealach ann chun an leabharlann a allmhairiú:

  1. Más leabharlann ar fud an tionscadail í (tá sé in úsáid/ag teastáil i ngach leathanach/formhór na leathanach):

    • Iompórtáil an leabharlann i src/main.js.

    • Agus é a dhearbhú sa raon feidhme domhanda (más gá).

  2. Más leabharlann leathanach ar leith í (úsáidtear leabharlann i leathanach nó i dteimpléad ar leith):

    • Cruthaigh comhad nua darb ainm src/<lib-name>.js.

    • Iompórtáil an leabharlann ann. Ansin instealladh isteach sa réad window é le bheith inrochtana go domhanda.

    • Cuir iontráil isteach i webpack.config.js: <lib-name>: "src/<lib-name>.js".

    • Cuir ainm na leabharlainne leis san eagar excludePrefixes sa mainLicenseTransform i webpack.config.js.

    • Cuir ainm chliant an cheadúnais leis in additionalFiles in LicensePlugin san eagar plugins in webpack.config.js.

    • Cruthaigh feidhm <lib-name>LicenseTransform don chomhad ceadúnais a tugadh isteach sna céimeanna roimhe seo agus bain úsáid as.

    Nóta: Cuir ainm iarbhír na leabharlainne tríú páirtí in ionad <lib-name>.

Tógáil na Leabharlainne

Tóg na leabharlanna a úsáideann an tionscadal, tríd an ordú seo a leanas a rith:

yarn build

Lena n-áirítear an Leabharlann

Anois tá an leabharlann tógtha agus réidh le húsáid. Chun é a chur san áireamh lean na céimeanna seo:

  1. Má iompórtáladh an leabharlann in src/main.js, níl aon chéimeanna breise ag teastáil (toisc go bhfuil sé san áireamh cheana féin i base.html).

  2. Má iompórtáladh an leabharlann ina sainchomhad src/<lib-name>.js, in weblate/templates úsáid na clibeanna san áireamh chun nascadh leis an gcomhad JavaScript statach tógtha:

{% load static %}
<script src="{% static 'js/vendor/<lib-name>.js' %}"></script>

Stíl códaithe

Braitheann Weblate ar Biome chun an cód JavaScript agus CSS a fhormáidiú agus a lintiú. Déantar teimpléid Django a fhormáidiú agus a lintiú ar leithligh le djade agus djlint.

Aistriúchán

Más gá duit aon téacs infheicthe ón úsáideoir sa chód tosaigh, ba cheart go mbeadh sé in-áitiúil. I bhformhór na gcásanna, níl uait ach do théacs a chuimilt laistigh den fheidhm gettext, ach tá gnéithe níos casta ar fáil:

document.write(gettext("this is to be translated"));

var object_count = 1 // or 0, or 2, or 3, ...
s = ngettext("literal for the singular case",
        "literal for the plural case", object_count);

fmts = ngettext("There is %s object. Remaining: %s",
        "There are %s objects. Remaining: %s", 11);
s = interpolate(fmts, [11, 20]);
// s is "There are 11 objects. Remaining: 20"

See also

Topaic aistriúcháin i ndoiciméadú Django

Deilbhíní

Úsáideann Weblate Material Design Icons faoi láthair, más siombail nua atá uait, féach air sin.

Ina theannta sin, tá scripts/optimize-svg chun méid an SVG a laghdú toisc go bhfuil an chuid is mó de na deilbhíní leabaithe taobh istigh den HTML chun stíliú na gcosáin a cheadú.