HTML agus JavaScript a aistriú ag úsáid Weblate CDN¶

Starting with Weblate 4.2 it is possible to export JavaScript and HTML localization to a CDN using Logánú JavaScript CDN add-on. To publish translation files without the JavaScript loader, use Translation files CDN.

Note

This feature is configured on Hosted Weblate. It requires additional configuration on your installation, see LOCALIZE_CDN_URL and LOCALIZE_CDN_PATH. See also Logánú CDN.

Upon installation into your component the JavaScript localization add-on will push committed translations (see Geallann leisciúil) to the CDN and these can be used in your web pages to localize them.

Comhpháirt a chruthú¶

Ar dtús, ní mór duit comhpháirt aonteangach a chruthú a choinneoidh do theaghráin, féach Tionscadail agus comhpháirteanna aistriúcháin a chur leis le haghaidh treoracha cineálacha air sin.

Sa chás go bhfuil stór agat cheana féin chun tús a chur leis (mar shampla an ceann ina bhfuil comhaid HTML), cruthaigh comhad JSON folamh sa stór don teanga fhoinseach (féach Teanga foinse), mar shampla locales/en.json. Ba cheart go mbeadh {} san ábhar chun réad folamh a chur in iúl. Nuair a bheidh sé sin agat, is féidir an stór a allmhairiú isteach i Weblate agus is féidir leat tosú le cumraíocht breiseán.

Hint

Sa chás go bhfuil aistriúcháin cheana féin agat, is féidir leat iad a chur isteach sa teanga comhaid JSON agus úsáidfear iad sin in Weblate.

Dóibh siúd nach bhfuil ag iarraidh an stór atá ann cheana a úsáid (nó nach bhfuil ceann acu), roghnaigh Tosaigh ón tús agus comhpháirt á chruthú agus roghnaigh comhad JSON mar fhormáid comhaid (tá sé ceart go leor formáid aonteangach a roghnú ag an pointe seo).

Breiseán Weblate CDN á chumrú¶

Is beag roghanna cumraíochta a sholáthraíonn an breiseán Logánú JavaScript CDN.

Tairseach aistriúcháin: Áireofar aistriúcháin a aistrítear os cionn na tairsí seo sa CDN.
Roghnóir CSS: Cumraíonn sé na teaghráin ó na doiciméid HTML atá inaistrithe, féach Eastóscadh teaghrán le haghaidh Weblate CDN agus Logánú HTML ag úsáid Weblate CDN.
Ainm fianán teanga: Ainm an fhianáin ina bhfuil teanga roghnaithe an úsáideora. Úsáidte sa bhlúire JavaScript le haghaidh Logánú HTML ag úsáid Weblate CDN.
Sliocht teaghráin ó chomhaid HTML: Liosta de na comhaid sa stór nó URLanna ina mbeidh Weblate ag lorg teaghráin inaistrithe agus á dtairiscint le haghaidh aistriúcháin, féach Eastóscadh teaghrán le haghaidh Weblate CDN.

Eastóscadh teaghrán le haghaidh Weblate CDN¶

Caithfidh na teaghráin aistriúcháin a bheith i láthair i Weblate. Is féidir leat iad seo a bhainistiú de láimh, API a úsáid chun iad a chruthú nó comhaid nó URLanna a liostáil ag baint úsáide as Sliocht teaghrán ó chomhaid HTML agus bainfidh Weblate iad go huathoibríoch. Caithfidh na comhaid a bheith i láthair sa stór nó URLanna iargúlta a bheith iontu a íoslódálfaidh agus a pharsálfaidh Weblate go rialta. Tá srian ar URLanna iargúlta le ALLOWED_ASSET_DOMAINS, lena n-áirítear aon spriocanna atreoraithe.

Baineann an chumraíocht réamhshocraithe le haghaidh CSS selector` eilimintí le aicme CSS l10n, mar shampla bainfeadh sé dhá shreangán ó bhraitheanna seo a leanas:

<section class="content">
    <div class="row">
        <div class="wrap">
            <h1 class="section-title min-m l10n">Maintenance in progress</h1>
            <div class="page-desc">
                <p class="l10n">We're sorry, but this site is currently down for maintenance.</p>
            </div>
        </div>
    </div>
</section>

Sa chás nach dteastaíonn uait an cód atá ann cheana a mhodhnú, is féidir leat * a úsáid mar roghnóir chun gach eilimint a phróiseáil.

Note

Faoi láthair, ní bhaintear ach téacs de na heilimintí. Ní thacaíonn an breiseán seo le logánú tréithe eiliminte nó eilimintí le leanaí.

Logánú HTML ag úsáid Weblate CDN¶

To localize an HTML document, you need to load the weblate.js script:

<script src="https://weblate-cdn.com/a5ba5dc29f39498aa734528a54b50d0a/weblate.js" async></script>

Ar lódáil, gheobhaidh sé seo go huathoibríoch gach eilimint inaistrithe atá comhoiriúnach (bunaithe ar chumraíocht roghnóir CSS) agus cuirfear aistriúchán ina ionad.

Braitear an teanga úsáideora ón bhfianán cumraithe agus tagann sé ar ais go dtí na teangacha is fearr leis an úsáideoir atá cumraithe sa bhrabhsálaí.

Is féidir leis an Ainm fianán teanga a bheith úsáideach chun comhtháthú le feidhmchláir eile (mar shampla roghnaigh django_language agus Django in úsáid).

Logánú JavaScript¶

Nochtar na haistriúcháin aonair mar chomhaid dhátheangacha JSON faoin CDN. Chun ceann a fháil is féidir leat an cód seo a leanas a úsáid:

fetch(("https://weblate-cdn.com/a5ba5dc29f39498aa734528a54b50d0a/cs.json")
  .then(response => response.json())
  .then(data => console.log(data));

Is gá an loighic logánaithe iarbhír a chur i bhfeidhm sa chás seo.

Publishing translation files¶

The Translation files CDN add-on publishes translation files directly to the CDN. It does not generate a JavaScript loader or convert translations into bilingual JSON.

Single-file translations are named using the language code and original file extension, for example cs.json or de.po. Multi-file translations are served below the language code using paths relative to the translation directory. Monolingual components include the source language file, while bilingual components publish only target-language files. See Logánú CDN for secure server setup.