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.

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:

  • A supported Node.js release.

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

  • Rith cliant cd.

  • Run 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

Weblate relies on Biome for formatting and linting the JavaScript and CSS code. Django templates are formatted and linted separately by djade and 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ú.