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:

Nodejs leagan 14 nó níos airde.
Tá an bainisteoir pacáiste `` yarn`` suiteáilte ar do chóras.
Rith cliant cd.
Rith yarn install.

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ú:

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á).
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 comhaid ceadúnais isteach i additionalFiles in LicensePlugin in eagar `` breiseán`` in webpack.config.js.
- Cruthaigh feidhm `` <lib-name>LicenseTransfrom`` don chomhad ceadúnais a tugadh isteach sna céimeanna roimhe seo agus úsáid é.
Nóta: Cuir ainm iarbhír na leabharlainne 3ú 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:

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).
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 líneáil.

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'

Deilbhíní¶

Úsáideann Weblate deilbhíní dearaidh ábhar faoi láthair. I gcás go bhfuil siombail nua á lorg agat, seiceáil Deilbhíní Dearaidh Ábhar nó Acmhainní Dearaidh Ábhar.

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ú.