Vendosja Dhe Në Internet
i18n.site miraton një arkitekturë aplikacioni me një faqe dhe faqja hyrëse e faqes në internet dhe përmbajtja e sajtit vendosen në mënyrë të pavarur.
Pas ekzekutimit të përkthimit të mësipërm, drejtoritë htm dhe v do të gjenerohen nën drejtorinë md/out/dev .
Këtu, dev do të thotë se është ndërtuar bazuar në skedarin e konfigurimit .i18n/htm/dev.yml .
Drejtoria dev :
Drejtoria htm është faqja hyrëse e faqes në internet.
Drejtoria v përmban përmbajtje të faqes së internetit me numrat e versioneve.
Vështrimi paraprak lokal nuk kujdeset për numrin e versionit dhe do të kopjojë të gjithë skedarët në drejtorinë out/dev/v/0.1.0 .
Për lëshimin zyrtar, skedarët e ndryshuar do të kopjohen në drejtorinë e re të numrave të versionit.
Specifikoni Skedarin E Konfigurimit Me -c
Skedarët e ndryshëm të konfigurimit do të krijojnë drejtoritë përkatëse në drejtorinë out .
Për shembull, .i18n/htm/main.yml do të krijojë drejtorinë out/main .
dev.yml dhe main.yml janë konfigurimet e paracaktuara.
dev është shkurtimi i development , që tregon mjedisin e zhvillimit, i përdorur për pamjen paraprake lokale, dhe është gjithashtu skedari i parazgjedhur i konfigurimit.
ol është shkurtimi i online , që tregon mjedisin online, i cili përdoret për lëshimin zyrtar. Është gjithashtu skedari i konfigurimit të paracaktuar kur përdoren parametrat e linjës së komandës -n deri në npm për lëshimin.
Ju gjithashtu mund të krijoni skedarë të tjerë të konfigurimit Përdorni --htm_conf në vijën e komandës për të specifikuar emrin e skedarit të konfigurimit që do të përdorni:
për shembull:
i18n.site --htm_conf dist --save
Këtu --save përfaqëson numrin e versionit të lëshimit të përditësimit.
Publikoni përmbajtjen në npmjs.com
Publikimi i përmbajtjes në npmjs.com
npm & Posto
Instaloni nodejs , hyni me npm login .
Ndryshoni md/.i18n/htm/main.yml dhe ndryshoni vlerën e md: YOUR_NPM_PACKAGE npmjs.com emrin tuaj të paketës npm .
Pastaj modifikoni md/.i18n/htm/main.package.json
Ekzekutoni i18n.site --npm ose i18n.site -n në drejtorinë md për ta përkthyer dhe publikuar.
Nëse përdorni një mjedis integrimi të vazhdueshëm për të publikuar, nuk ka nevojë të instaloni nodejs Thjesht kopjoni lejet e hyrjes dhe publikimit ~/.npmrc në mjedis.
Nëse modifikoni emrin e paketës v: në main.yml , ju lutemi sigurohuni që së pari të fshini .i18n/v/main dhe më pas ta publikoni.
Proxy Server I Publikuar Nga npm
Nëse përdoruesit në Kinën kontinentale hasin probleme në rrjet dhe nuk janë në gjendje të publikojnë npm paketa, ata mund të vendosin variablin e mjedisit https_proxy për të konfiguruar serverin proxy.
Duke supozuar se porti i serverit tuaj proxy është 7890 , mund të shkruani:
https_proxy=http://127.0.0.1:7890 i18n.site -n
Përmbajtje E Vetë-Strehuar
Nëse dëshironi të strehoni vetë përmbajtjen, së pari modifikoni md/.i18n/htm/main.yml dhe ndryshoni v: //unpkg.com/i18n.site në prefiksin tuaj të URL-së, si p.sh. v: //i18n-v.xxx.com .
Futni direktorinë md dhe ekzekutoni
i18n.site --htm_conf ol --save
ose shkurtim
i18n.site -c ol -s
Më pas, konfiguroni përmbajtjen në drejtorinë md/out/main/v në shtegun e prefiksit të URL-së të vendosur në v: .
Së fundi, konfiguroni kohën e cache të shtegut që përfundon me /.v deri në 1s , përndryshe përmbajtja e sapo lëshuar nuk mund të aksesohet menjëherë.
Koha e cache-it për shtigjet e tjera mund të vendoset në një vit ose më shumë për të reduktuar kërkesat e panevojshme.
Prisni Përmbajtjen Në s3
Për të vetë-strehuar përmbajtjen, përveç përdorimit të serverit tuaj, një opsion tjetër i CDN është përdorimi S3 +
Ju mund të përdorni rclone për t'u identifikuar në serverin S3 , më pas referojuni dhe modifikoni skriptin e mëposhtëm dhe kopjoni vetëm ndryshimet shtesë në S3 për çdo lëshim.
i18n.site -c ol -s
s3=your-s3
bucket=your-bucket
ver=$(head -1 .i18n/v/main/v.hash | cut -c 2-)
rclone copy --overwrite-dir out/main/htm/v/$ver $s3:/$bucket/$ver
rclone copy out/main/v/.v "$s3:/$bucket/"
Mos harroni të konfiguroni CDN në mënyrë që koha e cache-it të shtegut që përfundon me /.v të jetë 1s , përndryshe përmbajtja e sapo lëshuar nuk mund të aksesohet menjëherë.
Publikoni Faqen E Internetit
Faqja e internetit mund të vendoset kudo, github page cloudflare page janë zgjedhje të mira.
Për shkak se faqja e internetit përdor një arkitekturë aplikacioni me një faqe , mos harroni të rishkruani shtigjet e URL-së që nuk përmbajnë . deri në index.html .
Faqja e hyrjes në uebfaqe duhet të vendoset vetëm një herë dhe nuk ka nevojë të rishpërndahet faqja e hyrjes në uebsajt për përditësimet e mëvonshme të përmbajtjes.
Vendoseni Në Faqen github
Së pari klikoni github për të krijuar një organizatë Emri i mëposhtëm i organizatës është i18n-demo si shembull.
Më pas krijoni magazinë i18n-demo.github.io nën këtë organizatë (ju lutemi zëvendësoni i18n-demo me emrin e organizatës që keni krijuar):
Kur publikoni përmbajtjen në artikullin e : , out/main/htm është krijuar.
ln -s index.html 404.html
Për shkak se github page nuk mbështet rishkrimin e shtegut të URL-së, në vend të kësaj përdoret 404.html .
Pastaj ekzekutoni komandën e mëposhtme në drejtorinë htm (mos harroni të zëvendësoni i18n-demo/i18n-demo.github.io.git me adresën tuaj të magazinës) :
git init
git branch -M main
git remote add origin [email protected]:i18n-demo/i18n-demo.github.io.git
git push -u origin main -f
Pasi të keni shtypur kodin, prisni që vendosja e github page të funksionojë me sukses (siç tregohet më poshtë) përpara se të mund ta përdorni.
Për faqen demo, shikoni:
https://i18n-demo.github.io
Vendoseni Në Faqen cloudflare
cloudflare page me github page , ai siguron rishkrimin e rrugës dhe është më miqësor me Kinën kontinentale dhe rekomandohet të përdoret.
Vendosja e cloudflare page zakonisht bazohet në vendosjen e github page më sipër.
Krijo një projekt dhe lidh magazinë i18n-demo.github.io më sipër.
Procesi tregohet në figurën më poshtë:
Ju lutemi klikoni Add Account për t'i dhënë akses organizatës i18n-demo .
Nëse keni lidhur magazinën e një organizate tjetër, mund t'ju duhet të klikoni Add Account dy herë për të autorizuar dy herë përpara se të shfaqet organizata e re.
Më pas, zgjidhni magazinë i18n-demo.github.io , më pas klikoni Begin setup dhe përdorni vlerat e paracaktuara për hapat pasues.
Pas lidhjes për herë të parë, duhet të prisni disa minuta përpara se të mund ta përdorni.
Pas vendosjes, mund të lidhni një emër domaini me porosi.
Pasi të lidhni emrin e personalizuar të domenit, ju lutemi shkoni te emri i domenit për të konfiguruar rishkrimin e rrugës së aplikacionit me një faqe, siç tregohet më poshtë:
Rregullat në foton e mësipërme janë i18n.site më poshtë.
(http.host in {"i18n.site"}) and not (
substring(http.request.uri.path,-3) in {".js" ".gz"} or
substring(http.request.uri.path,-4) in {".htm" ".rss" ".css" ".svg" ".ico" ".png" ".xml" ".txt"} or
substring(http.request.uri.path,-5) in {".html" ".avif" ".json"} or
ends_with(http.request.uri.path,".webmanifest")
)
Për më tepër, ju lutemi konfiguroni rregullat e cache-it, siç tregohet më poshtë, dhe vendosni kohëzgjatjen e cache në një muaj.
Ju lutemi ndryshoni emrin e domenit që përputhet në hapin e dytë në figurën e mësipërme në emrin e domenit që keni lidhur.
Optimizimi I Vendosjes Së Faqes Në Internet Në Kinën Kontinentale
Nëse dëshironi të merrni një performancë më të mirë të aksesueshmërisë në mjedisin e rrjetit të Kinës kontinentale, ju lutemi regjistroni fillimisht një emër domaini .
Më pas, përdorni out/main/htm e objekteve të shitësve të cloud në Kinën kontinentale + Vendosni përmbajtjen e mëposhtme CDN .
Për shembull, Baidu Smart Cloud CDN mund të konfigurohet si kjo:
const uri = r.uri, p = uri.lastIndexOf(".");
if (
p < 0 ||
!"|js|css|htm|html|md|avif|json|ico|xml|rss|gz|mp4|png|svg|txt|webmanifest|".includes(
"|" + uri.slice(p + 1) + "|",
)
) {
const ua = r.headersIn["User-Agent"].toLowerCase()
if (/facebookexternalhit|slurp|bot|spider|curl/.test(ua)) {
r.return(
302,
(/baidu|yisou|sogou|360|byte/.test(ua) ? "/zh" : "/en") + r.uri + ".htm",
)
} else {
r.uri = "/index.html"
}
}
r.respHeader(() => {
const t = [], out = r.headersOut;
["Content-MD5", "Age", "Expires", "Last-Modified"].forEach(
i => delete out[i]
)
r.rawHeadersOut.forEach(i => {
const key = i[0].toLowerCase()
if (key.startsWith("x-") || key.startsWith("ohc-")) {
delete out[key]
}
})
out["Cache-Control"] = "max-age=" + 9e5
// Mund të vendosni kokën e përgjigjes që të korrigjojë daljen, si p.sh. out.XXX = 'MSG';
})
Për shkak se rekordi MX dhe rekordi CNAME nuk mund të bashkëjetojnë, nëse dëshironi të merrni email me emra domeni në të njëjtën kohë, duhet të bashkëpunoni me cname_flatten në nivelin CNAME në rekordin A .
Për më tepër, për shkak se tarifat e trafikut jashtë shtetit të shitësve të reve kompjuterike në territorin e Kinës janë relativisht të shtrenjta, nëse doni të optimizoni kostot, mund të përdorni rezolucionin gjeografik falas të Huawei DNS dhe emrin e personalizuar të domenit Cloudflare for SaaS (siç tregohet më poshtë). devijimi i trafikut──Trafiku i trafikut në kontinentin e Kinës Baidu Cloud CDN , trafiku ndërkombëtar shkon cloudflare .
Këto zgjidhje të optimizimit të vendosjes janë më komplekse dhe do të prezantohen në kapituj të veçantë në të ardhmen.
Ridrejtimi Gjenerik I Emrit Të Domenit
Nëse përdorni i18n.site për të gjeneruar një faqe interneti si uebsajtin tuaj kryesor, zakonisht duhet të konfiguroni ridrejtimin e pan-domainit, domethënë të ridrejtoni aksesin nga *.xxx.com (duke përfshirë www.xxx.com ) në xxx.com .
Kjo kërkesë mund të arrihet me ndihmën e Alibaba Cloud CDN EdgeScript ( dokument anglisht / dokument kinez )
Shtoni emrin e domenit në Alibaba CDN dhe vendosni emrin e domenit nga *.xxx.com në CNAME në Alibaba Cloud CDN .
Për shembull, konfigurimi i ridrejtimit të emrit të pan-domainit prej *.i18n.site në foton e mësipërme është si më poshtë:
rewrite(concat('https://i18n.site',$uri), 'redirect',301)
Vendoseni Me nginx
Ju lutemi shtoni një konfigurim të ngjashëm me atë të mëposhtëm në paragrafin server të nginx Ju lutemi ndryshoni /root/i18n/md/out/main/htm në rrugën e projektit tuaj out/main/htm :
location / {
root /root/i18n/md/out/main/htm;
add_header Cache-Control "max-age=9999999";
if ($uri !~* \.(avif|css|html|ico|js|json|png|svg|txt|webmanifest|xml)$) {
rewrite ^ /index.html last;
}
}
Bazuar Në github action Integrimin E Vazhdueshëm
Ju mund t'i referoheni sa më poshtë për të konfiguruar github action në tuaj:
name: i18n.site
on:
workflow_dispatch:
push:
branches:
- main
- dist
jobs:
i18n:
permissions:
repository-projects: write
contents: write
runs-on: ubuntu-latest
steps:
- name: checkout
uses: actions/checkout@v4
- name: https://i18n.site
uses: i18n-site/github-action-i18n.site@main
with:
I18N_SITE_TOKEN: ${{ secrets.I18N_SITE_TOKEN }}
NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
Siç mund të shihet në konfigurim, kjo rrjedhë pune aktivizohet kur shtyhet në degën main dhe degën dist .
Rrjedha e punës do të përdorë skedarin e konfigurimit që korrespondon me emrin e degës për të publikuar dokumentin Këtu, përkatësisht .i18n/htm/main.yml dhe .i18n/htm/dist.yml do të përdoren si konfigurim publikues.
Ne rekomandojmë praktikat më të mira të mëposhtme për procesin e lëshimit të dokumentit:
Kur ndryshimet shtyhen në degën main , dokumenti aktivizohet për t'u ndërtuar dhe vendosur në stacionin e paraafishimit (stacioni i shikimit paraprak është i disponueshëm github page ).
Pasi të konfirmohet se dokumenti është i saktë në faqen e shikimit paraprak, kodi do të bashkohet dhe do të shtyhet në degën dist , dhe ndërtimi dhe vendosja zyrtare do të shkojë në linjë.
Sigurisht, zbatimi i procesit të mësipërm kërkon shkrimin e më shumë konfigurimeve.
Ju mund t'i referoheni projektit aktual për skriptimin e rrjedhës së github.com/fcdoc/doc .
secrets.I18N_SITE_TOKEN dhe secrets.NPM_TOKEN në konfigurim kërkojnë që ju të konfiguroni variablat sekrete në bazën e kodit.
I18N_SITE_TOKEN i18n.site/token
NPM_TOKEN është shenja e publikimit të paketës npm në konfigurim. Vizitoni npmjs.com
Struktura E Drejtorisë
public
Skedarët statikë të faqes së internetit, si favicon.ico , robots.txt , etj.
Skedarët e ikonave këtu mund të krijohen me realfavicongenerator.net
.i18n
Nën drejtorinë .i18n janë skedarët e konfigurimit, cache e përkthimit, etj. të i18n.site Shihni kapitullin tjetër "Konfigurimi" për detaje.
en
Drejtoria e gjuhës burimore, që korrespondon me skedarin e konfigurimit en nga fromTo në .i18n/conf.yml
i18n:
fromTo:
en: zh
Ju lutemi referojuni konfigurimit të përkthimit i18